MediaPlayer QML Type

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

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• activeAudioTrack : int
• activeSubtitleTrack : int
• activeVideoTrack : int
• audioBufferOutput : QAudioBufferOutput (since 6.8)
• audioOutput : AudioOutput
• audioTracks : list<mediaMetaData>
• autoPlay : bool (since 6.7)
• bufferProgress : real
• duration : int
• error : enumeration
• errorString : string
• hasAudio : bool
• hasVideo : bool
• loops : int
• mediaStatus : enumeration
• metaData : mediaMetaData
• pitchCompensation : bool (since 6.10)
• pitchCompensationAvailability : enumeration (since 6.10)
• playbackOptions : playbackOptions (since 6.10)
• playbackRate : real
• playbackState : enumeration
• playing : bool (since 6.5)
• position : int
• seekable : bool
• source : url
• subtitleTracks : list<mediaMetaData>
• videoOutput : VideoOutput
• videoTracks : list<mediaMetaData>

信号

• errorOccurred(error, errorString)
• playbackStateChanged()
• playingChanged()

方法

• void pause()
• void play()
• void stop()

詳しい説明

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]

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

errorString : string [read-only]

このプロパティは、現在のエラー状態を詳細に記述した文字列を保持する。

hasAudio : bool [read-only]

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

hasVideo : bool [read-only]

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

loops : int

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

デフォルト値は1 です。このプロパティを0 に設定しても効果はありません。

mediaStatus : enumeration [read-only]

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

metaData : mediaMetaData [read-only]

メディア プレーヤで使用されている現在のメディアのメタ データを返します。

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

pitchCompensation : bool [since 6.10]

このプロパティは、ピッチ補正が有効かどうかを保持します。

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

pitchCompensationAvailability : enumeration [read-only, since 6.10]

現在のバックエンドにおけるMediaPlayer のピッチ補正の可否を示す。列挙PitchCompensationAvailability はスコープされる。

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

playbackOptions : playbackOptions [since 6.10]

このプロパティは、メディア再生オプションの低レベル制御を提供する playbackOptions API を公開します。MediaPlayer のデフォルト設定に依存することを強く推奨しますが、このAPIを使用することで、デフォルトのオプションが理想的でない特定のユースケースに対して、メディア再生を最適化することができます。

再生オプションは、次にMediaPlayer::source が変更されたときに有効になります。

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

playbackRate : real

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

詳細については、QMediaPlayer::playbackRate を参照のこと。

デフォルトは1.0 。

playbackState : enumeration [read-only]

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

playing : bool [read-only, since 6.5]

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

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

playbackStateも参照してください 。

position : int

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

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

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 。

QMediaPlayer::setVideoOutput()も参照 。

videoTracks : list<mediaMetaData> [read-only]

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

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

mediaMetaDataも参照してください 。

信号ドキュメント

errorOccurred(error, errorString)

このシグナルは、error 。errorString パラメータには、エラーに関するより詳細な情報を含めることができる。

QMediaPlayer::Errorも参照のこと 。

playbackStateChanged()

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

playingChanged()

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

メソッド・ドキュメント

void pause()

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

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

void play()

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

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

void stop()

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

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