slapin/qtmultimedia
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Improve documentation for the QMediaPlayer::bufferStatus property.

Browse Source 
The corresponding properties in the Audio and MediaPlayer QML elements
are also updated.

Change-Id: I7104d274d431e7712db2f045c375756e8c2ac03a
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
This commit is contained in:
Yoann Lopes
2014-05-12 16:50:30 +02:00
committed by The Qt Project
parent 64726bfd15
commit 9cf77e3bb5
2 changed files with 21 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
src/imports/multimedia/qdeclarativeaudio.cpp
View File

@@ -601,8 +601,14 @@ bool QDeclarativeAudio::hasVideo() const
/*!
\qmlproperty real QtMultimedia::Audio::bufferProgress
This property holds how much of the data buffer is currently filled, from 0.0 (empty) to 1.0
(full).
This property holds how much of the data buffer is currently filled, from \c 0.0 (empty) to
\c 1.0 (full).
Playback can start or resume only when the buffer is entirely filled, in which case the
status is \c Audio.Buffered or \c Audio.Buffering. A value lower than \c 1.0 implies that
the status is \c Audio.Stalled.
\sa status
*/
/*!
@@ -1394,8 +1400,14 @@ void QDeclarativeAudio::_q_statusChanged()
/*!
\qmlproperty real QtMultimedia::MediaPlayer::bufferProgress
This property holds how much of the data buffer is currently filled, from 0.0 (empty) to 1.0
(full).
This property holds how much of the data buffer is currently filled, from \c 0.0 (empty) to
\c 1.0 (full).
Playback can start or resume only when the buffer is entirely filled, in which case the
status is \c MediaPlayer.Buffered or \c MediaPlayer.Buffering. A value lower than \c 1.0
implies that the status is \c MediaPlayer.Stalled.
\sa status
*/
/*!

8
src/multimedia/playback/qmediaplayer.cpp
View File

@@ -1238,12 +1238,14 @@ QMultimedia::AvailabilityStatus QMediaPlayer::availability() const
/*!
\property QMediaPlayer::bufferStatus
\brief the percentage of the temporary buffer filled before playback begins.
\brief the percentage of the temporary buffer filled before playback begins or resumes, from
\c 0 (empty) to \c 100 (full).
When the player object is buffering; this property holds the percentage of
the temporary buffer that is filled. The buffer will need to reach 100%
filled before playback can resume, at which time the MediaStatus will be
BufferedMedia.
filled before playback can start or resume, at which time mediaStatus() will return
BufferedMedia or BufferingMedia. If the value is anything lower than \c 100, mediaStatus() will
return StalledMedia.
\sa mediaStatus()
*/