MPlayerCapabilitiesObserver Class Reference

#include <playerinformationtargetobserver.h>

Link against: remconplayerinformation.lib

class MPlayerCapabilitiesObserver
Public Attributes
const TIntKMaxCompanyID
const TIntKMaxNrOfCompanyIDs
Public Member Functions
IMPORT_C TIntAddCompanyId(TInt)
IMPORT_C TIntAddEvent(TRegisterNotificationEvent)
IMPORT_C voidClearCompanyIds()
IMPORT_C voidClearEvents()
IMPORT_C TIntRemoveCompanyID(TInt)
IMPORT_C TIntRemoveEvent(TRegisterNotificationEvent)

Detailed 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.

Member Attribute Documentation

KMaxCompanyID

const TIntKMaxCompanyID[static]

KMaxNrOfCompanyIDs

const TIntKMaxNrOfCompanyIDs[static]

Member Function Documentation

AddCompanyId ( TInt )

IMPORT_C TIntAddCompanyId(TIntaID)

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 AddCompanyId() is called with this company id.

Parameters
aIDthe id to add
Return Value
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.

AddEvent ( TRegisterNotificationEvent )

IMPORT_C TIntAddEvent(TRegisterNotificationEventaEvent)

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 AddEvent() is called with either of these events.

Parameters
aEventthe event to add
Return Value
KErrAlreadyExists if the event is already present. KErrNotSupported if the event isn't supported by the implementation, e.g.. ESystemStatusChanged

ClearCompanyIds ( )

IMPORT_C voidClearCompanyIds()

Remove all additional company IDs from the supported list

ClearEvents ( )

IMPORT_C voidClearEvents()

Remove all notification events from the supported list

RemoveCompanyID ( TInt )

IMPORT_C TIntRemoveCompanyID(TIntaID)

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
aIDthe id to remove
Return Value
KErrNone if this completes successfully, KErrNotFound if aID was not in the list, or any other system wide error code.

RemoveEvent ( TRegisterNotificationEvent )

IMPORT_C TIntRemoveEvent(TRegisterNotificationEventaEvent)

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 RemoveEvent() is called with either of these events.

Parameters
aEventthe event to remove
Return Value
KErrNone if this completes successfully, KErrNotFound if aID was not in the list, or any other system wide error code.