Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <playerinformationtargetobserver.h>
Link against: remconplayerinformation.lib
This item is not part of the S60 5th Edition SDK

Class MPlayerCapabilitiesObserver

class MPlayerCapabilitiesObserver;

Description

This class is used to define the capabilities of the current application, and the implementation will generate AVRCP responses to the controller. For the event part of the API, it is recommended to add all events which make sense for the media player. In general, this will be everything except ESystemStatusChanged. The company ID part of the API is only needed if the media player needs to support vendor extensions other than bluetooth SIG. The bluetooth SIG company ID is always included in responses to a COMPANY_ID request.

Members

Defined in MPlayerCapabilitiesObserver:


Member functions


ClearEvents()

IMPORT_C void ClearEvents();

Description

Remove all notification events from the supported list


AddEvent(TRegisterNotificationEvent)

IMPORT_C TInt AddEvent(TRegisterNotificationEvent aEvent);

Description

Add a notification event to the supported list of events The AVRCP 1.3 specification mandates that PlaybackStatusChanged and TrackChanged events must be supported; KErrAlreadyExists will be returned if MPlayerCapabilitiesObserver::AddEvent(TRegisterNotificationEvent) is called with either of these events.

Parameters

TRegisterNotificationEvent aEvent

the event to add

Return value

TInt

KErrAlreadyExists if the event is already present. KErrNotSupported if the event isn't supported by the implementation, e.g.. ESystemStatusChanged


RemoveEvent(TRegisterNotificationEvent)

IMPORT_C TInt RemoveEvent(TRegisterNotificationEvent aEvent);

Description

Remove a notification event from the supported list of events The AVRCP 1.3 specification mandates that PlaybackStatusChanged and TrackChanged events must be supported; KErrNotSupported will be returned if MPlayerCapabilitiesObserver::RemoveEvent(TRegisterNotificationEvent) is called with either of these events.

Parameters

TRegisterNotificationEvent aEvent

the event to remove

Return value

TInt

KErrNone if this completes successfully, KErrNotFound if aID was not in the list, or any other system wide error code.


ClearCompanyIds()

IMPORT_C void ClearCompanyIds();

Description

Remove all additional company IDs from the supported list


AddCompanyId(TInt)

IMPORT_C TInt AddCompanyId(TInt aID);

Description

Add a company id to the supported list of company ids. The AVRCP 1.3 specification mandates that the Bluetooth SIG vendor id must be supported; KErrAlreadyExists will be returned if MPlayerCapabilitiesObserver::AddCompanyId(TInt) is called with this company id.

Parameters

TInt aID

the id to add

Return value

TInt

KErrNone if this completes successfully, KErrAlreadyExists if aID is already present, KErrOverflow if the maximum number of company ids are already listed, or any other system wide error code.


RemoveCompanyID(TInt)

IMPORT_C TInt RemoveCompanyID(TInt aID);

Description

Remove a company id from the list of supported vendor extensions. The Bluetooth SIG id can't be removed, as this must always be supported

Parameters

TInt aID

the id to remove

Return value

TInt

KErrNone if this completes successfully, KErrNotFound if aID was not in the list, or any other system wide error code.


DoClearEvents()

private: virtual void DoClearEvents()=0;

Description


DoAddEvent(TRegisterNotificationEvent)

private: virtual TInt DoAddEvent(TRegisterNotificationEvent aEvent)=0;

Description

Parameters

TRegisterNotificationEvent aEvent

Return value

TInt


DoRemoveEvent(TRegisterNotificationEvent)

private: virtual TInt DoRemoveEvent(TRegisterNotificationEvent aEvent)=0;

Description

Parameters

TRegisterNotificationEvent aEvent

Return value

TInt


DoClearCompanyIds()

private: virtual void DoClearCompanyIds()=0;

Description


DoAddCompanyId(TInt)

private: virtual TInt DoAddCompanyId(TInt aID)=0;

Description

Parameters

TInt aID

Return value

TInt


DoRemoveCompanyID(TInt)

private: virtual TInt DoRemoveCompanyID(TInt aID)=0;

Description

Parameters

TInt aID

Return value

TInt

[Top]


Member data


KMaxCompanyID

const TInt KMaxCompanyID=0xFFFFFF;

Description


KMaxNrOfCompanyIDs

const TInt KMaxNrOfCompanyIDs=255;

Description