QMediaPlayer Class

player = new QMediaPlayer;
audioOutput = new QAudioOutput;
player->setAudioOutput(audioOutput);
connect(player, &QMediaPlayer::positionChanged, this, &MediaExample::positionChanged);
player->setSource(QUrl::fromLocalFile("/Users/me/Music/coolsong.mp3"));
audioOutput->setVolume(50);
player->play();

プロパティの説明

activeAudioTrack : int

現在アクティブなオーディオトラックを返します。

デフォルトでは、最初に利用可能なオーディオトラックが選択されます。

すべてのオーディオトラックを無効にするには、index を-1 に設定します。

アクセス機能：

通知シグナル：

activeSubtitleTrack : int

現在アクティブな字幕トラックを返す。

字幕を無効にするには、index を-1 に設定します。

デフォルトでは字幕は無効です。

アクセス機能：

通知シグナル：

activeVideoTrack : int

現在アクティブなビデオトラックを返します。

デフォルトでは、最初に使用可能なオーディオトラックが選択されます。

すべてのビデオトラックを無効にするには、index を-1 に設定します。

アクセス機能：

通知信号：

[since 6.8] audioBufferOutput : QAudioBufferOutput*

このプロパティは、メディアプレーヤーによって使用される出力オーディオバッファを保持する。

メディアプレーヤーにオーディオバッファoutput を設定する。

QAudioBufferOutput が指定され、メディアソースがオーディオストリームを含む場合、メディアプレーヤーは、デコードされたオーディオデータを含むオーディオバッファを持つ信号QAudioBufferOutput::audioBufferReceived を発する。オーディオストリームの終わりには、QMediaPlayer は空のQAudioBuffer を発する。

QMediaPlayer は、オーディオ・バッファが指定されている場合、一致するデータをオーディオ出力にプッシュすると同時に、オーディオ・バッファを出力します。ただし、オーディオバッファ化により、サウンドは少し遅れて再生されます。

放出されるオーディオバッファのフォーマットは、指定されたoutput 、またはoutput が無効なフォーマットを返した場合は、一致するオーディオストリームから取得されます。放出されるオーディオデータは、現在の再生レートによってスケーリングされることはありません。

QMediaPlayer でQAudioBufferOutput を利用する使用例としては、以下のようなものが考えられる：

• オーディオの視覚化。メディアプレーヤーの再生レートが1 でない場合、ビジュアライザーの要件に応じて、出力画像の寸法や画像の更新間隔をスケーリングすることができます。
• AIによる音声処理（音声認識など）。
• 外部音声出力へのデータ送信。再生レートの変更、ビデオとの同期、停止やシーク時の手動フラッシュを考慮する必要があります。特別な理由がない限り、この目的でオーディオバッファ出力を使用することはお勧めしません。

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

アクセス関数です：

通知シグナル

audioOutput : QAudioOutput*

このプロパティは、メディアプレーヤーが使用するオーディオ出力デバイスを保持する。

メディア再生時に使用される現在のオーディオ出力。新しいオーディオ出力を設定すると、現在使用されている出力が置き換えられます。

このプロパティをnullptr に設定すると、すべてのオーディオ出力が無効になります。

アクセス機能：

ノーティファイア信号：

[read-only] audioTracks : const QList<QMediaMetaData>

メディア内の利用可能なオーディオトラックのセットを一覧表示する。

返されるQMediaMetaData には、個々のトラックのプロパティが記述されています。

異なるオーディオトラックは、例えば、異なる言語のオーディオを含むことができる。

アクセス関数：

通知シグナル：

[read-only] bufferProgress : const float

このプロパティは、再生が開始または再開される前に、テンポラリ・バッファが満たされたパーセンテージを保持します。0. (空)から1. (満)までです。

プレーヤ オブジェクトがバッファリングしている場合、このプロパティは、一時バッファが満たされている割合を保持します。再生開始または再開するには、バッファが100%満たされる必要があり、その時点でmediaStatus() はBufferedMedia またはBufferingMedia を返します。値が100 より小さい場合、mediaStatus() はStalledMedia を返します。

アクセス関数：

通知シグナル：

mediaStatus()も参照のこと 。

[read-only] duration : const qint64

このプロパティは、現在のメディアの継続時間を保持する。

値は、現在のメディアのミリ秒単位の総再生時間である。この値は、QMediaPlayer オブジェクトのライフタイムに渡って変化する可能性があり、最初の再生開始時には利用できない可能性があります。ステータス通知を受け取るには、durationChanged() シグナルに接続してください。

アクセス関数：

Notifierシグナル：

[read-only] error : const Error

このプロパティは、最後のエラー状態を示す文字列を保持する。

アクセス関数

ノーティファイア・シグナル：

error()も参照 。

[read-only] errorString : const QString

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

アクセス関数

通知シグナル

[read-only] hasAudio : const bool

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

アクセス関数：

通知シグナル

[read-only] hasVideo : const bool

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

アクセス関数：

通知シグナル

loops : int

プレーヤーが停止するまでの、メディアの再生回数を決定します。QMediaPlayer::Infinite に設定すると、現在のメディアファイルを永遠にループ再生します。

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

アクセス関数：

通知シグナル：

[read-only] mediaStatus : const MediaStatus

このプロパティは、現在のメディアストリームの状態を保持する。

ストリームの状態は、現在のストリームの再生がどのように進行しているかを示す。

デフォルトでは、このプロパティはQMediaPlayer::NoMedia

アクセス関数である：

Notifierシグナル：

[read-only] metaData : const QMediaMetaData

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

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

アクセス関数

通知シグナル：

playbackRate : qreal

このプロパティは、現在のメディアの再生レートを保持する。

この値は、メディアの標準再生速度に適用される乗数である。デフォルトでは、この値は1.0であり、メディアが標準速度で再生されていることを示す。1.0より大きい値を指定すると再生速度が速くなり、0.0から1.0の間の値を指定すると遅くなります。負の再生速度はサポートされていません。

すべての再生サービスが再生速度の変更をサポートしているわけではない。早送りや巻き戻し中のオーディオやビデオの状態や品質については、フレームワークで定義されています。

アクセス機能

通知信号

[read-only] playbackState : const PlaybackState

PlaybackState を返します。

アクセス関数：

通知シグナル：

playingも参照 。

[read-only, since 6.5] playing : const bool

このプロパティは、メディアが再生中かどうかを保持します。

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

アクセス関数です：

アクセス関数: Notifierシグナル：

playbackState とPlayingStateも参照してください 。

position : qint64

このプロパティは、現在のメディアの再生位置を保持する。

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

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

アクセス関数

Notifier シグナル：

[read-only] seekable : const bool

このプロパティは、現在のメディアのシーク可能状態を保持する。

シークがサポートされている場合、このプロパティはtrueとなり、そうでない場合はfalseとなる。このプロパティの状態は、QMediaPlayer オブジェクトのライフタイムに渡って変化する可能性があります。seekableChanged シグナルを使用して、変化を監視します。

アクセス関数：

Notifier シグナル：

source : QUrl

このプロパティは、プレーヤオブジェクトが使用するアクティブなメディアソースを保持します。

プレーヤオブジェクトは、再生するコンテンツの選択にQUrl を使用します。

デフォルトでは、このプロパティはNULLQUrl を持ちます。

このプロパティをNULLQUrl に設定すると、プレーヤは現在のメディアソースに関連するすべての情報を破棄し、そのメディアに関連するすべてのI/O操作を停止します。

アクセス関数：

Notifierシグナル：

QUrlも参照のこと 。

[read-only] subtitleTracks : const QList<QMediaMetaData>

メディア内の利用可能な字幕トラックのセットを一覧表示する。

返されるQMediaMetaData 、個々のトラックのプロパティを記述する。

アクセス関数：

Notifier シグナル：

videoOutput : QObject*

このプロパティは、メディアプレーヤーが使用するビデオ出力を保持します。

メディアプレーヤーは、1つのビデオ出力しか接続できないため、このプロパティを設定すると、以前に接続されていたビデオ出力が置き換えられます。

このプロパティをnullptr に設定すると、ビデオ出力は無効になります。

アクセス関数

通知シグナル

[read-only] videoTracks : const QList<QMediaMetaData>

メディア内の利用可能なビデオトラックのセットを一覧表示する。

返されるQMediaMetaData には、個々のトラックのプロパティが記述される。

アクセス関数：

Notifier シグナル：