将媒体回放添加到场景。 更多...
import 语句: | import QtMultimedia |
实例化: | QMediaPlayer |
(从 6.7 起)
(从 6.5 起)
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() } } }
You can use MediaPlayer together with a MultiMedia::AudioOutput to play audio content, or you can use it in conjunction with a Multimedia::VideoOutput for rendering video.
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 and VideoOutput .
activeAudioTrack : int |
This property holds the track number of the currently active audio track. Set to
-1
to disable audio track.
默认特性值为
0
: the first audio track.
activeSubtitleTrack : int |
This property holds the track number of the currently active subtitle track. Set to
-1
to disable subtitle track.
默认特性值为
-1
: no subtitles active.
activeVideoTrack : int |
This property holds the track number of the currently active video audio track. Set to
-1
to disable video track.
默认特性值为
0
: the first video track.
audioOutput : AudioOutput |
This property holds the target audio output. Accepts one AudioOutput 元素。
另请参阅 QMediaPlayer::setAudioOutput ().
audioTracks
:
list
<
mediaMetaData
>
|
This property holds a list of metadata. Each index refers to an audio track.
The metadata holds properties describing the individual tracks. For audio tracks the 语言 is usually the most important property.
另请参阅 mediaMetaData .
autoPlay
:
bool
|
This property controls whether the media begins to play automatically after it gets loaded. Defaults to
false
.
This property was introduced in Qt 6.7.
bufferProgress
:
real
|
This property holds how much of the data buffer is currently filled, from
0.0
(空) 到
1.0
(完整)。
Playback can start or resume only when the buffer is entirely filled. When the buffer is filled,
MediaPlayer.Buffered
is true. When buffer progress is between
0.0
and
1.0
,
MediaPlayer.Buffering
被设为
true
.
值低于
1.0
implies that the property
MediaPlayer.StalledMedia
is
true
.
另请参阅 mediaStatus .
duration
:
int
|
This property holds the duration of the media in milliseconds.
If the media doesn't have a fixed duration (a live stream for example) this will be set to
0
.
error
:
enumeration
|
This property holds the error state of the audio. It can be one of the following.
值 | 描述 |
---|---|
NoError | There is no current error. |
ResourceError | The audio cannot be played due to a problem allocating resources. |
FormatError | The audio format is not supported. |
NetworkError | The audio cannot be played due to network issues. |
AccessDeniedError | The audio cannot be played due to insufficient permissions. |
errorString
:
string
|
This property holds a string describing the current error condition in more detail.
hasAudio
:
bool
|
This property holds whether the media contains audio.
hasVideo
:
bool
|
This property holds whether the media contains video.
loops : int |
Determines how often the media is played before the player stops. Set to MediaPlayer::Infinite to loop the current media file forever.
默认值为
1
。把此特性设为
0
不起作用。
mediaStatus
:
enumeration
|
This property holds the status of media loading. It can be one of the following:
Property value | 描述 |
---|---|
NoMedia | No media has been set. |
LoadingMedia | The media is currently being loaded. |
LoadedMedia | The media has been loaded. |
BufferingMedia | The media is buffering data. |
StalledMedia | Playback has been interrupted while the media is buffering data. |
BufferedMedia | The media has buffered data. |
EndOfMedia | The media has played to the end. |
InvalidMedia | The media cannot be played. |
metaData
:
mediaMetaData
|
返回媒体播放器当前所用的媒体元数据。
元数据可以包含如视频标题 (或其创建日期) 的信息。
注意: Windows 实现仅为位于本地文件系统中的媒体提供元数据。
playbackRate : real |
This property holds the rate at which media is played at as a multiple of the normal rate.
更多信息,见 QMediaPlayer::playbackRate .
默认为
1.0
.
playbackState
:
enumeration
|
This property holds the state of media playback. It can be one of the following:
Property value | 描述 |
---|---|
PlayingState | The media is currently playing. This indicates the same as the playing 特性。 |
PausedState | Playback of the media has been suspended. |
StoppedState | Playback of the media is yet to begin. |
playing
:
bool
|
Indicates whether the media is currently playing.
该特性在 Qt 6.5 引入。
另请参阅 playbackState .
position : int |
The value is the current playback position, expressed in milliseconds since the beginning of the media. Periodically changes in the position will be indicated with the positionChanged() signal.
若 seekable property is true, this property can be set to milliseconds.
seekable
:
bool
|
This property holds whether the position of the media can be changed.
source : url |
This property holds the source URL of the media.
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
>
|
This property holds a list of metadata. Each index refers to a subtitle track.
The metadata holds properties describing the individual tracks. For subtitle tracks the 语言 is usually the most important property.
另请参阅 mediaMetaData .
videoOutput : VideoOutput |
This property holds the target video output. Accepts one VideoOutput 元素。
另请参阅 QMediaPlayer::setVideoOutput ().
videoTracks
:
list
<
mediaMetaData
>
|
This property holds a list of metadata. Each index refers to a video track.
The metadata holds properties describing the individual tracks.
另请参阅 mediaMetaData .
errorOccurred ( error , errorString ) |
此信号发射当 error has occurred. The errorString parameter may contain more detailed information about the error.
注意:
相应处理程序是
onErrorOccurred
.
另请参阅 QMediaPlayer::Error .
playbackStateChanged () |
此信号发射当 playbackState property is altered.
注意:
相应处理程序是
onPlaybackStateChanged
.
playingChanged () |
此信号发射当 playing 特性改变。
注意:
相应处理程序是
onPlayingChanged
.
pause () |
Pauses playback of the media.
设置
playbackState
property to PausedState, and changes
playing
to
false
.
play () |
Starts or resumes playback of the media.
设置
playbackState
property to PlayingState, and changes
playing
to
true
.
stop () |
Stops playback of the media.
设置
playbackState
property to StoppedState, and changes
playing
to
false
.