MPlayerEventsObserver Class Reference
#include
<mw/playerinformationtargetobserver.h>
Link against: remconplayerinformation.lib
| class MPlayerEventsObserver |
| Public Member Enumerations |
|---|
| enum | TPlayPosition { EStart, EMiddle, EEnd } |
| enum | TPlaybackStatus { EStopped, EPlaying, EPaused, EFwdSeek, ..., EError } |
| enum | TTargetBatteryStatus { ENormal, EWarning, ECritical, EExternal, ..., EUnknown } |
Detailed Description
This class supports the notification PDUs in AVRCP1.3 specification section 5.4, with the following exceptions: EVENT_SYSTEM_STATUS_CHANGED is not supported, it is only for adaptors that plug into a media player EVENT_PLAYER_APPLICATION_SETTING_CHANGED is supported through the CPlayerApplicationSettings API
Events are pushed by the media player calling functions in this API, where they are cached until the controller pulls them via a GetPlayStatus or RegisterNotification PDU
See also: CPlayerApplicationSettings
Member Attribute Documentation
KNoTrackSelected
| const TUint64 | KNoTrackSelected | [static] |
KPlaybackPositionUnknown
| const TUint32 | KPlaybackPositionUnknown | [static] |
Member Enumeration Documentation
Enum TPlayPosition
| Enumerator | Value | Description |
|---|
| EStart | 0 | |
| EMiddle | 1 | |
| EEnd | 2 | |
Enum TPlaybackStatus
| Enumerator | Value | Description |
|---|
| EStopped | 0 | |
| EPlaying | 1 | |
| EPaused | 2 | |
| EFwdSeek | 3 | |
| ERevSeek | 4 | |
| EError | 0xFF | |
Enum TTargetBatteryStatus
| Enumerator | Value | Description |
|---|
| ENormal | 0 | |
| EWarning | 1 | |
| ECritical | 2 | |
| EExternal | 3 | |
| EFullCharge | 4 | |
| EUnknown | 5 | |
Member Function Documentation
PlaybackStatusChanged ( TPlaybackStatus )
Call this function whenever the playback status changes. It will be used to complete pending EVENT_PLAYBACK_STATUS_CHANGED and EVENT_PLAYBACK_POS_CHANGED notifications. The value is used to generate the response to a GetPlayStatus PDU.
| Parameter | Description | | aStatus | The specification defined playback status |
SetBatteryStatus ( TTargetBatteryStatus )
Call this function to report the current battery status
| Parameter | Description | | aBatteryStatus | The current battery status. |
SetPlaybackPosition ( TUint32 )
| IMPORT_C void | SetPlaybackPosition | ( | TUint32 | aMilliseconds | ) | |
Call this function during playback or seek operations, to indicate the current position within the track. It will be used to complete a pending EVENT_PLAYBACK_POS_CHANGED notification. The value is used to generate the response to a GetPlayStatus PDU.
| Parameter | Description | | aMilliseconds | The current playback position. It is recommended to call with a resolution <=1000ms to satisfy the 1s resolution of the notification playback interval. |
TrackChanged ( TUint64, TUint32 )
| IMPORT_C void | TrackChanged | ( | TUint64 | aTrackId, |
| | TUint32 | aLengthInMilliseconds |
| | ) | |
Call this function whenever the current media track is changed. use KNoTrackSelected to indicate that there is no media selected. This is the default value on construction. It will be used to complete pending EVENT_TRACK_CHANGED and EVENT_PLAYBACK_POS_CHANGED notifications. The values are used to generate the response to a GetPlayStatus PDU.
| Parameter | Description | | aTrackId | A handle to the current track. |
| aLengthInMilliseconds | The length of the current track. |
TrackReachedEnd ( )
| IMPORT_C void | TrackReachedEnd | ( | ) | |
Call this function whenever the current track reaches the end position, e.g. due to playback or forward seek. It will be used to complete pending EVENT_TRACK_REACHED_END and EVENT_PLAYBACK_POS_CHANGED notifications.
TrackReachedStart ( )
| IMPORT_C void | TrackReachedStart | ( | ) | |
Call this function whenever the current track reaches the start position, e.g. due to reverse seek (rewind). It will be used to complete pending EVENT_TRACK_REACHED_START and EVENT_PLAYBACK_POS_CHANGED notifications.