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 に設定します。

アクセス機能：

Notifier シグナル：

[since 6.8] audioBufferOutput : QAudioBufferOutput*

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

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

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

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

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

QMediaPlayer でQAudioBufferOutput を利用する場合、以下のようなケースが考えられる：

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

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

アクセス関数です：

Notifier signal：

audioOutput : QAudioOutput*

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

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

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

アクセス機能：

Notifierシグナル：

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

メディア内の利用可能なオーディオトラックのセットをリストアップする。

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

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

アクセス関数：

Notifierシグナル：

[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

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

アクセス関数

Notifier シグナル：

error()も参照のこと 。

[read-only] errorString : const QString

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

アクセス関数：

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

[read-only] hasAudio : const bool

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

アクセス関数：

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

[read-only] hasVideo : const bool

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

アクセス関数

通知シグナル

loops : int

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

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

アクセス関数：

Notifier シグナル：

[read-only] mediaStatus : const MediaStatus

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

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

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

アクセス関数です：

Notifier シグナル：

[read-only] metaData : const QMediaMetaData

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

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

アクセス関数

Notifier シグナル：

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 には、個々のトラックのプロパティが記述される。

アクセス関数：

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