Video QML Type

指定したビデオを表示するための便利な型。詳細...

Import Statement:	`import QtMultimedia`
Inherits:	Item

継承されたメンバを含む、すべてのメンバの一覧

プロパティ

autoPlay : bool (since 6.7)
bufferProgress : real
duration : int
endOfStreamPolicy : enumeration (since 6.9)
error : enumeration
errorString : string
fillMode : enumeration
hasAudio : bool
hasVideo : bool
loops : int
metaData : mediaMetaData
mirrored : int
muted : bool
orientation : int (since 6.9)
playbackRate : real
playbackState : enumeration
position : int
seekable : bool
source : url
volume : real

信号

errorOccurred(error, errorString)
paused()
playing()
stopped()

方法

clearOutput() (since 6.9)
pause()
play()
seek(offset)
stop()

詳細説明

Video は、との機能をひとつにまとめた便利な型です。複数の型を宣言することなく、シンプルなビデオ再生機能を提供します。MediaPlayer VideoOutput

以下は、シーンに動画再生を実装するサンプルコードです。

Video {
    id: video
    width : 800
    height : 600
    source: "video.avi"

    MouseArea {
        anchors.fill: parent
        onClicked: {
            video.play()
        }
    }

    focus: true
    Keys.onSpacePressed: video.playbackState == MediaPlayer.PlayingState ? video.pause() : video.play()
    Keys.onLeftPressed: video.position = video.position - 5000
    Keys.onRightPressed: video.position = video.position + 5000
}

ソースファイルであるvideo.avi は、MouseArea の親をクリックすると再生されます。ビデオは 800 × 600 ピクセルの領域で再生され、id プロパティの値はvideo です。

Keys を押すと、一時停止ボタンが切り替わります：

Spacebar を押すと、一時停止ボタンが切り替わる。
Left Arrow を押すと、ビデオの現在位置が5秒前に移動する。
Right Arrow ビデオの現在位置を5秒進める。

Videoは、非変換、伸張、および一様にスケーリングされたビデオ表示をサポートしています。伸張された一様なスケールのプレゼンテーションについては、fillMode プロパティの説明を参照してください。

MediaPlayer とVideoOutputも参照。

プロパティの説明

autoPlay : bool [since 6.7]

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

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

bufferProgress : real

このプロパティは、データバッファが現在どれくらい埋まっているかを保持します。

duration : int

このプロパティは、メディアの継続時間をミリ秒単位で保持します。

メディアの継続時間が決まっていない場合（ライブストリームなど）、これは0になります。

endOfStreamPolicy : enumeration [since 6.9]

このプロパティは、ビデオストリームの終了時に適用するポリシーを指定します。

endOfStreamPolicy には、次のいずれかを指定します：

定数	説明
`ClearOutput`	ビデオ出力はクリアされる。
`KeepLastFrame`	ビデオ出力は最後のフレームを表示し続けます。出力を手動でクリアするには、clearOutput() メソッドを使用します。

デフォルト値はVideoOutput.ClearOutput です。

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

error : enumeration

このプロパティは、ビデオのエラー状態を保持します。このプロパティは、ビデオのエラー状態を保持します：

MediaPlayer NoError.- 現在のエラーはありません。
MediaPlayer.ResourceError - リソースの割り当てに問題があるため、動画を再生できません。
MediaPlayer.FormatError - 動画形式がサポートされていません。
MediaPlayer.NetworkError - ネットワークの問題で動画を再生できません。
MediaPlayer.AccessDenied - アクセス許可が不足しているため、動画を再生できません。
MediaPlayer.ServiceMissing - メディアサービスがインスタンス化できなかったため、動画を再生できません。

errorString : string

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

fillMode : enumeration

このプロパティを設定して、ターゲット領域に合わせて動画を拡大縮小する方法を定義します。

VideoOutput.Stretch - 動画がフィットするように拡大縮小されます。
VideoOutput.PreserveAspectFit - 動画をトリミングせずに一律に拡大縮小します。
VideoOutput.PreserveAspectCrop - 必要に応じてトリミングされます。

この型は QML の利便性を高めるためのものであり、列挙を直接サポートしていないため、利用可能な塗りつぶしモードへのアクセスにはVideoOutput の列挙が使用されます。

デフォルトの塗りつぶしモードはpreserveAspectFitです。

hasAudio : bool

このプロパティは、現在のメディアにオーディオコンテンツがあるかどうかを保持する。

hasVideo : bool

このプロパティは、現在のメディアにビデオコンテンツがあるかどうかを保持します。

loops : int

メディアを停止するまでの再生頻度を指定します。MediaPlayer.Infiniteに設定すると、現在のメディアファイルを永遠にループ再生します。

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

metaData : mediaMetaData

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

各メタデータキーの詳細については、MediaPlayer.metaData を参照してください。

mediaMetaDataも参照。

mirrored : int

表示される動画が垂直軸を中心にミラーリングされるかどうかを決定する。ミラーリングは、orientation の後に適用されます。デフォルト値はfalse 。

muted : bool

このプロパティは、音声出力がミュートされるかどうかを保持する。

orientation : int [since 6.9]

このプロパティは、表示されたビデオがビデオ座標で時計回りに回転する角度を度単位で決定します。方向変換は、mirrored の前に適用される。

0、90、-90、180、270 など、90 度の倍数のみがサポートされます。それ以外の場合、指定された値は無視されます。

デフォルト値は0 です。

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

playbackRate : real

このプロパティは、ビデオが再生されるレートを、通常のレートの倍数として保持します。

playbackState : enumeration

この読み取り専用プロパティは、メディアの再生状態を示します。

MediaPlayer.PlayingState - メディアは再生中です。
MediaPlayer.PausedState - メディアは一時停止中です。
MediaPlayer.StoppedState - メディアは停止しています。

デフォルトの状態は、MediaPlayer.StoppedStateです。

position : int

このプロパティは、現在の再生位置をミリ秒単位で保持する。

seekable : bool

このプロパティは、動画の再生位置を変更できるかどうかを保持します。

True の場合、seek （）メソッドを呼び出すか、position プロパティを変更すると、再生が新しい位置にシークされます。

source : url

このプロパティは、メディアのソース URL を保持する。

volume : real

このプロパティは、オーディオ音量を保持する。

音量は、0.0 （無音）から1.0 （フル音量）まで直線的にスケーリングされる。この範囲外の値はクランプされます。

デフォルトの音量は1.0 です。

UIの音量コントロールは通常、非線形にスケーリングされるべきです。例えば、対数スケールを使用すると、知覚されるラウドネスが直線的に変化します。詳しくはQtAudio::convertVolume() を参照してください。

シグナル・ドキュメント

errorOccurred(error, errorString)

このシグナルは、error 。errorString パラメータには、エラーの詳細情報が含まれている場合があります。

注意： 対応するハンドラはonErrorOccurred です。

paused()

このシグナルは再生が一時停止されたときに発せられます。

注：対応するハンドラはonPaused です。

playing()

このシグナルは、再生が開始または継続されたときに発せられます。

注：対応するハンドラはonPlaying です。

stopped()

このシグナルは、再生が停止されたときに発せられます。

注：対応するハンドラはonStopped です。

メソッドのドキュメント

[since 6.9] clearOutput()

現在のビデオフレームを削除してビデオ出力をクリアする。このメソッドは、endOfStreamPolicy Video プロパティがKeepLastFrame に設定された状態でビデオストリームが終了した後、最後のビデオフレームを削除する必要がある場合に推奨されます。

このメソッドは Qt 6.9 で導入されました。

pause()

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

play()

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

seek(offset)

seekable プロパティが true の場合、現在の再生位置をoffset にシークします。

seekable およびpositionも参照してください。

stop()

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

© 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.