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()
• tracksChanged()

方法

• 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]

このプロパティには、メタデータのリストが格納されています。各インデックスは、1つのオーディオトラックを指します。

メタデータには、個々のトラックを記述するプロパティが含まれています。オーディオトラックの場合、通常、「Language 」が最も重要なプロパティとなります。

このプロパティは、変更された際に `tracksChanged ` シグナルを発生させます。

「mediaMetaData」も参照してください 。

autoPlay : bool [since 6.7]

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

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

bufferProgress : real [read-only]

このプロパティは、データバッファが現在どの程度満たされているかを表します。値は、0.0 （空）から1.0 （満杯）までの範囲です。

再生の開始または再開は、バッファが完全に満たされた場合にのみ行われます。バッファが満たされると、MediaPlayer.Buffered はtrueになります。バッファの進行状況が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]

このプロパティには、メタデータのリストが格納されています。各インデックスは、1つの字幕トラックに対応しています。

メタデータには、個々のトラックを記述するプロパティが含まれています。字幕トラックの場合、通常、「Language 」が最も重要なプロパティとなります。

このプロパティは、変更された際に「tracksChanged 」シグナルを発行します。

「mediaMetaData」も参照してください 。

videoOutput : VideoOutput

このプロパティは、出力先の動画データを保持します。VideoOutput 要素を1つ受け付けます。

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

videoTracks : list<mediaMetaData> [read-only]

このプロパティには、メタデータのリストが格納されています。各インデックスは、1つのビデオトラックを指します。

メタデータには、個々のトラックを記述するプロパティが含まれています。

このプロパティは、変更された際に「tracksChanged 」シグナルを発行します。

「mediaMetaData」も参照してください 。

シグナルのドキュメント

errorOccurred(error, errorString)

このシグナルは、error が発生した際に発行されます。errorString パラメータには、エラーに関するより詳細な情報が含まれている場合があります。

「QMediaPlayer::Error」も参照してください 。

playbackStateChanged()

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

playingChanged()

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

tracksChanged()

このシグナルは、audioTracks 、subtitleTracks 、またはvideoTracks のプロパティが変更されたときに発生します。

メソッドのドキュメント

void pause()

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

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

void play()

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

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

void stop()

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

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