Qtopia Home - Classes - Hierachy - Annotated - Functions - Qt Embedded |

# MediaPlayerDecoder_1_6 Class Reference

The MediaPlayerDecoder_1_6 class provides an extension to the MediaPlayerDecoder class for Qtopia MediaPlayer decoder plugins. More...

`#include <qtopia/mediaplayerplugininterface.h>`

Inherits MediaPlayerDecoder.

List of all member functions.

## Public Members

- virtual bool supportsStreaming () = 0
- virtual bool canStreamURL ( const QUrl & url, const QString & mimetype ) = 0
- virtual bool openURL ( const QUrl & url, const QString & mimetype ) = 0
- virtual bool streamed () = 0
- virtual bool syncAvailable () = 0
- virtual bool sync () = 0
- virtual bool seekAvailable () = 0
- virtual bool seek ( long pos ) = 0
- virtual bool tellAvailable () = 0
- virtual long tell () = 0
- virtual bool lengthAvailable () = 0
- virtual long length () = 0
- virtual bool totalTimeAvailable () = 0
- virtual long totalTime () = 0
- virtual bool currentTimeAvailable () = 0
- virtual long currentTime () = 0

## Detailed Description

The MediaPlayerDecoder_1_6 class provides an extension to the MediaPlayerDecoder class for Qtopia MediaPlayer decoder plugins.

See also Qtopia Classes.

## Member Function Documentation

### bool MediaPlayerDecoder_1_6::canStreamURL ( const QUrl & url, const QString & mimetype )`[pure virtual]`

Returns TRUE if the decoder can support the given mimetype with the url provided.

### long MediaPlayerDecoder_1_6::currentTime ()`[pure virtual]`

Returns the current millisecond being played in the stream. The accuracy should only be considered good enough for the use in the display of the current play time and not used for the precise timing of syncing playback. Not all formats contain timestamps, therefore after seeking, not all formats and decoders will be able to support this function.

### bool MediaPlayerDecoder_1_6::currentTimeAvailable ()`[pure virtual]`

Returns TRUE if the decoder can support the currentTime() function for the given stream.

### long MediaPlayerDecoder_1_6::length ()`[pure virtual]`

Returns the length in bytes of the stream. For streamed data, the protocol may not always return how long the stream will be, therefore it should be assumed that this may not always be available with all decoder plugins.

### bool MediaPlayerDecoder_1_6::lengthAvailable ()`[pure virtual]`

Returns TRUE if the decoder can support the length() function for the given stream.

### bool MediaPlayerDecoder_1_6::openURL ( const QUrl & url, const QString & mimetype )`[pure virtual]`

Opens the url of given mimetype. Typically this information is provided by a web server to a web browser which could pass this on directly to the plugin or indirectly to the Qtopia Media Player through a QCop signal.

### bool MediaPlayerDecoder_1_6::seek ( long pos )`[pure virtual]`

Seeks to pos byte offset from the beginning of the stream.

### bool MediaPlayerDecoder_1_6::seekAvailable ()`[pure virtual]`

Returns TRUE if the stream is seekable or not. For streamed media, it is possible that seeking may not be able to be implemented in the plugin therefore the plugin returns FALSE, otherwise if it can, it returns TRUE.

### bool MediaPlayerDecoder_1_6::streamed ()`[pure virtual]`

Returns TRUE if the decoder is playing a streamed file opened using openURL(), or FALSE if the file was opened using the MediaPlayerDecoder::open() function used for files.

### bool MediaPlayerDecoder_1_6::supportsStreaming ()`[pure virtual]`

Returns TRUE if the decoder supports streaming.

### bool MediaPlayerDecoder_1_6::sync ()`[pure virtual]`

Sync up the video to match the timestamp of where the audio currently is playing. If the video is behind, this will skip forward to the correctly matching frame.

### bool MediaPlayerDecoder_1_6::syncAvailable ()`[pure virtual]`

Returns TRUE if the decoder supports for the given stream syncing the audio and video together with the sync() function.

### long MediaPlayerDecoder_1_6::tell ()`[pure virtual]`

Returns the current byte offset from the beginning of the stream.

### bool MediaPlayerDecoder_1_6::tellAvailable ()`[pure virtual]`

Returns TRUE if the decoder can support the tell() function for the given stream.

### long MediaPlayerDecoder_1_6::totalTime ()`[pure virtual]`

Returns the total time in milliseconds of the stream. For some file formats, the total play time may not be easily obtainable. Some formats use VBR (variable bit rate) encoding without timestamps making it uncertain as to exactly how long it takes to play the file without actually decoding or indexing it.

### bool MediaPlayerDecoder_1_6::totalTimeAvailable ()`[pure virtual]`

Returns TRUE if the decoder can support the totalTime() function for the given stream.

This file is part of the Qtopia platform, copyright © 1995-2004 Trolltech, all rights reserved.