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.01.0 の間にあるとき、MediaPlayer.Bufferingtrue に設定される。

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

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 に設定し、playingfalse に変更します。


play()

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

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


stop()

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

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


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.