The MediaObject class

Media Data Producing Class

There is the class that produces the media data (often called a source in media frameworks).

Required Functions

• qint32 prefinishMark()
• void setPrefinishMark(qint32)

Optional Functions

• qint64 remainingTime()

Signals

• void totalTimeChanged(qint64 totalTime)
• void prefinishMarkReached(qint32 msec)
• void finished()

Member Function Documentation

See also

void totalTimeChanged(qint64 totalTime)

qint32 prefinishMark()

Returns the time in milliseconds the prefinishMarkReached signal is emitted before the playback if finished and finished is emitted.

void setPrefinishMark(qint32 msec)

Sets the time in milliseconds the prefinishMarkReached signal is emitted before the playback if finished and finished is emitted.

Parameters

msec	The time in milliseconds. If the value is less than or equal to 0 the prefinishMarkReached signal is disabled.

qint64 remainingTime()

Get the remaining time (in milliseconds) of the file currently being played. If the method is not implemented in the backend the frontend will use the difference between MediaObjectInterface::totalTime() and MediaObjectInterface::currentTime() .

Signals Documentation

void prefinishMarkReached(qint32 msec)

Emitted when the file has finished playing on its own. I.e. it is not emitted if you call stop(), pause() or load(), but only on end-of-file or a critical error. void finished()

Parameters

msec	The remaining time until the playback finishes

void totalTimeChanged(qint64 totalTime)

This signal is emitted as soon as the length of the media file is known or has changed. For most non-local media data the length of the media can only be known after some time. At that time the totalTime function can not return useful information. You have to wait for this signal to know the real length.

Parameters

totalTimeChanged

The total time of the media file in milliseconds.

See also

MediaObjectInterface::totalTime()

void finished()

This signal is emitted when the playback of the media finished (on its own). It is not emitted if stop() or pause() are called - only on end-of-file or a critical error (for example the media data stream is corrupted and playback of the media has to be finished).

See also

void prefinishMarkReached(qint32 msec)