Back to Qt.io
Contact Us Blog Download Qt

MediaPlayer QML Type

シーンにメディア再生を追加します。詳細...

Import Statement: import QtMultimedia
In C++: QMediaPlayer

プロパティ

シグナル

メソッド

詳細説明

Text {
    text: "Click Me!";
    font.pointSize: 24;
    width: 150; height: 50;

    MediaPlayer {
        id: playMusic
        source: "music.wav"
        audioOutput: AudioOutput {}
    }
    MouseArea {
        anchors.fill: parent
        onPressed:  { playMusic.play() }
    }
}

MediaPlayer は、MultiMedia::AudioOutput と一緒に使用してオーディオ コンテンツを再生したり、Multimedia::VideoOutput と一緒に使用してビデオをレンダリングしたりできます。

Item {
    MediaPlayer {
        id: mediaplayer
        source: "groovy_video.mp4"
        audioOutput: AudioOutput {}
        videoOutput: videoOutput
    }

    VideoOutput {
        id: videoOutput
        anchors.fill: parent
    }

    MouseArea {
        anchors.fill: parent
        onPressed: mediaplayer.play();
    }
}

AudioOutput とVideoOutputも参照して ください。

プロパティの説明

activeAudioTrack : int

このプロパティは、現在アクティブなオーディオトラックのトラック番号を保持します。オーディオトラックを無効にするには、-1 を設定します。

デフォルトのプロパティ値は、0: 最初のオーディオトラックです。


activeSubtitleTrack : int

このプロパティは、現在アクティブな字幕トラックのトラック番号を保持する。字幕トラックを無効にするには、-1 に設定する。

デフォルトのプロパティ値は-1: アクティブな字幕はありません。


activeVideoTrack : int

このプロパティは、現在アクティブなビデオオーディオトラックのトラック番号を保持する。ビデオトラックを無効にするには、-1 に設定する。

デフォルトのプロパティ値は0: 最初のビデオトラック。


audioBufferOutput : QAudioBufferOutput [since 6.8]

このプロパティは、ターゲットオーディオバッファ出力を保持します。

QMLからのMediaPlayer の通常の使用では、このプロパティを使用する必要はありません。

このプロパティはQt 6.8で導入されました。

QMediaPlayer::audioBufferOutput()も参照してください 。


audioOutput : AudioOutput

このプロパティは、ターゲット音声出力を保持します。AudioOutput 要素を1つ受け取ります。

QMediaPlayer::setAudioOutput() も参照 。


audioTracks : list<mediaMetaData> [read-only]

このプロパティは、メタデータのリストを保持します。各インデックスはオーディオトラックを指します。

メタデータは、個々のトラックを記述するプロパティを保持する。オーディオトラックの場合、通常、Language が最も重要なプロパティです。

mediaMetaDataも参照 。


autoPlay : bool [since 6.7]

このプロパティは、メディアが読み込まれた後、自動的に再生を開始するかどうかを制御します。デフォルトはfalse です。

このプロパティは Qt 6.7 で導入されました。


bufferProgress : real [read-only]

このプロパティは、0.0 （空）から1.0 （満杯）まで、データ・バッファが現在どの程度埋まっているかを保持します。

再生は、バッファが完全に満たされたときにのみ開始または再開できます。バッファがいっぱいになると、MediaPlayer.Buffered が真になります。バッファの進捗が0.0 と1.0 の間にあるとき、MediaPlayer.Buffering はtrue に設定される。

1.0 よりも低い値は、プロパティMediaPlayer.StalledMedia がtrue であることを意味します。

mediaStatusも参照。


duration : int [read-only]

このプロパティは、メディアの継続時間をミリ秒単位で保持する。

メディアの継続時間が固定でない場合（ライブストリームなど）、これは0 に設定される。


error : enumeration [read-only]

このプロパティは、オーディオのエラー状態を保持します。以下のいずれかを指定します。

値説明
NoError現在のエラーはありません。
リソースエラーリソースの割り当てに問題があるため、音声を再生できません。
フォーマットエラー音声フォーマットがサポートされていません。
ネットワークエラーネットワークの問題で音声を再生できません。
アクセス拒否エラー権限が不足しているため、オーディオを再生できません。

errorString : string [read-only]

このプロパティは、現在のエラー状態の詳細を示す文字列を保持します。


hasAudio : bool [read-only]

このプロパティは、メディアにオーディオが含まれているかどうかを保持します。


hasVideo : bool [read-only]

このプロパティは、メディアがビデオを含むかどうかを保持します。


loops : int

プレーヤーが停止する前にメディアが再生される頻度を決定します。MediaPlayer::Infiniteに設定すると、現在のメディア・ファイルを永遠にループします。

デフォルト値は1 である。このプロパティを0 に設定しても効果はない。


mediaStatus : enumeration [read-only]

このプロパティは、メディアのロード状態を保持する。以下のいずれかになります：

プロパティ値説明
メディアなしメディアは設定されていません。
ローディングメディアメディアは現在ロード中です。
ロードメディアメディアがロードされました。
バッファリングメディアメディアはデータをバッファリング中です。
ストールメディア（StalledMediaメディアがデータをバッファリング中に再生が中断されました。
バッファリングメディアメディアがデータをバッファリングしています。
メディア終了メディアが最後まで再生されました。
無効メディアメディアは再生できません。

metaData : mediaMetaData [read-only]

メディアプレーヤーが使用する現在のメディアのメタデータを返します。

メタデータには、動画のタイトルや作成日などの情報を含めることができます。

注: Windows の実装では、ローカル ファイル システムにあるメディアに対してのみメタデータが提供されます。


playbackRate : real

このプロパティは、メディアの再生レートを通常のレートの倍数で保持します。

詳細については、QMediaPlayer::playbackRate を参照してください。

デフォルトは1.0 。


playbackState : enumeration [read-only]

このプロパティは、メディアの再生状態を保持します。以下のいずれかになります：

プロパティ値説明
再生状態メディアは現在再生中である。これは、playing プロパティと同じものを示す。
PausedStateメディアの再生が一時停止されている。
StoppedStateメディアの再生はまだ開始されていない。

playing : bool [read-only, since 6.5]

メディアが現在再生中かどうかを示す。

このプロパティは Qt 6.5 で導入されました。

playbackStateも参照してください 。


position : int

値は現在の再生位置で、メディアの開始からのミリ秒単位で表されます。定期的な位置の変更は、positionChanged() シグナルで示されます。

seekable プロパティが真の場合、このプロパティはミリ秒に設定することができる。


seekable : bool [read-only]

このプロパティは、メディアのposition を変更できるかどうかを保持する。


source : url

このプロパティは、メディアのソースURLを保持する。

Item {
    MediaPlayer {
        id: mediaplayer
        source: "file:///test.mp4"
        videoOutput: videoOutput
        audioOutput: AudioOutput {

        }
    }

    VideoOutput {
        id: videoOutput
        anchors.fill: parent
    }

    MouseArea {
        id: playArea
        anchors.fill: parent
        onPressed: mediaplayer.play();
    }
}

QMediaPlayer::setSource()も参照のこと 。


subtitleTracks : list<mediaMetaData> [read-only]

このプロパティは、メタデータのリストを保持する。各インデックスは、字幕トラックを指す。

メタデータは、個々のトラックを記述するプロパティを保持する。字幕トラックの場合、通常、Language が最も重要なプロパティです。

mediaMetaDataも参照 。


videoOutput : VideoOutput

このプロパティは、ターゲットビデオ出力を保持します。VideoOutput 要素を1つ受け取ります。

QMediaPlayer::setVideoOutput()も参照 。


videoTracks : list<mediaMetaData> [read-only]

このプロパティは、メタデータのリストを保持する。各インデックスはビデオトラックを指す。

メタデータは、個々のトラックを記述するプロパティを保持する。

mediaMetaData も参照 。


シグナル ドキュメント

errorOccurred(error, errorString)

このシグナルは、error が発生したときに発行される。errorString パラメータには、エラーの詳細情報を含めることができる。

注意: 対応するハンドラはonErrorOccurred です。

QMediaPlayer::Errorも参照。


playbackStateChanged()

このシグナルはplaybackState プロパティが変更されたときに発行されます。

注： 対応するハンドラはonPlaybackStateChanged 。


playingChanged()

このシグナルはplaying プロパティが変更されたときに発せられる。

注 ：対応するハンドラはonPlayingChanged 。


メソッドの説明

pause()

メディアの再生を一時停止します。

playbackState プロパティを PausedState に設定し、playing をfalse に変更する。


play()

メディアの再生を開始または再開する。

playbackState プロパティを PlayingState に設定し、playing をtrue に変更します。


stop()

メディアの再生を停止します。

playbackState プロパティを StoppedState に設定し、playing をfalse に変更します。


©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。