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(0.5);
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 が無効なフォーマットを返した場合は、対応するオーディオストリームに基づきます。出力されるオーディオデータは、現在の再生レートに応じてスケーリングされません。

QAudioBufferOutput とQMediaPlayer を組み合わせて利用可能なユースケースとしては、次のようなものが考えられます：

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

この列挙型は Qt 6.8 で導入されました。

アクセス関数：

Notifierシグナル：

audioOutput : QAudioOutput*

このプロパティには、メディアプレーヤーが使用するオーディオ出力デバイスが格納されます。

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

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

アクセス関数:

通知シグナル:

[read-only] audioTracks : QList<QMediaMetaData>

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

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

たとえば、異なるオーディオトラックには、異なる言語の音声が収録されている場合があります。

アクセス関数：

通知シグナル：

[read-only] bufferProgress : float

このプロパティは、再生の開始または再開前に一時バッファがどの程度満たされているかを表すパーセンテージを保持します。値の範囲は、0 （空）から1 （満杯）までです。

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

アクセス関数:

Notifierシグナル:

mediaStatus()も参照してください 。

[read-only] duration : qint64

このプロパティには、現在のメディアの再生時間が格納されます。

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

アクセス関数：

通知シグナル：

[read-only] error : Error

このプロパティには、最後のエラー状態を説明する文字列が格納されます。

アクセス関数：

通知シグナル:

関連項目: ` error()`。

[read-only] errorString : QString

このプロパティには、現在のエラー状態をより詳細に説明する文字列が格納されています。

アクセス関数：

通知信号：

[read-only] hasAudio : bool

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

アクセス関数：

通知シグナル：

[read-only] hasVideo : bool

このプロパティは、メディアに動画が含まれているかどうかを示します。

アクセス関数：

通知シグナル：

loops : int

プレーヤーが停止するまでのメディアの再生回数を指定します。「QMediaPlayer::Infinite 」に設定すると、現在のメディアファイルが無限にループ再生されます。

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

アクセス関数：

通知シグナル：

[read-only] mediaStatus : MediaStatus

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

ストリームのステータスは、現在のストリームの再生がどのように進行しているかを表します。

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

アクセス関数：

通知シグナル：

[read-only] metaData : QMediaMetaData

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

メタデータには、動画のタイトルや作成日などの情報が含まれる場合があります。

アクセス関数：

通知シグナル：

[since 6.10] pitchCompensation : bool

このプロパティは、メディアプレーヤーのピッチ補正の状態を保持します。

ピッチ補正が有効かどうかを示します。有効になっている場合、再生速度を変更してもオーディオ信号のピッチには影響しません。

デフォルトは、ピッチ補正が利用可能な場合は `true `、利用できない場合は `false` です。

この列挙型はQt 6.10で導入されました。

アクセス関数：

Notifierシグナル：

[read-only, since 6.10] pitchCompensationAvailability : const PitchCompensationAvailability

このプロパティは、現在のQtMultimedia バックエンドにおけるピッチ補正の利用可否を表します。

現在のバックエンドにおけるQMediaPlayer のピッチ補正機能の利用可否を示します。

詳細については、QMediaPlayer::PitchCompensationAvailability を参照してください。

この列挙型は Qt 6.10 で導入されました。

アクセス関数：

[since 6.10] playbackOptions : QPlaybackOptions

メディアの再生およびデコードを設定するための高度な再生オプション。

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

再生オプションは、次に `QMediaPlayer::setSource()` が呼び出されたときに有効になります。

この列挙型はQt 6.10で導入されました。

アクセス関数：

Notifierシグナル:

playbackRate : qreal

このプロパティは、現在のメディアの再生速度を保持します。

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

すべての再生サービスが再生速度の変更に対応しているわけではありません。早送りや巻き戻し時の音声および動画の状態や品質については、フレームワークによって定義されています。

アクセス関数：

Notifierシグナル:

[read-only] playbackState : PlaybackState

PlaybackState を返します。

アクセス関数：

通知シグナル：

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

[read-only, since 6.5] playing : bool

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

この列挙型は Qt 6.5 で導入されました。

アクセス関数：

Notifierシグナル:

playbackState およびPlayingStateも参照してください 。

position : qint64

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

値は、メディアの開始時点からの経過時間をミリ秒単位で表した現在の再生位置です。位置が定期的に変化した場合は、positionChanged() シグナルによって通知されます。

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

アクセス関数：

通知シグナル：

[read-only] seekable : bool

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

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

アクセス関数：

通知シグナル：

source : QUrl

このプロパティには、プレーヤーオブジェクトによって現在使用されているアクティブなメディアソースが格納されます。

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

デフォルトでは、このプロパティのQUrl はnullです。

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

アクセス関数：

通知シグナル：

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

[read-only] subtitleTracks : QList<QMediaMetaData>

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

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

アクセス関数：

通知シグナル：

videoOutput : QObject*

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

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

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

アクセス関数：

通知シグナル:

[read-only] videoTracks : QList<QMediaMetaData>

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

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

アクセス関数：

通知シグナル：