Symbian^3 Product Developer Library >

CUPnPMusicAdapter Class Reference

class CUPnPMusicAdapter : public CBase

A class providing play back services for playing within UPnP framework.

upnpmusicadapter.lib
Since
S60 v3.1

Inherits from

Public Member Functions
~CUPnPMusicAdapter()
MUPnPAVController &AVController()
MMPXCollectionUtility &CollectionUtility()
voidComplete(MUPnPPlaylistFiller *)
IMPORT_C voidDismiss(TInt)
IMPORT_C TIntExecuteMusicInLocalL(CEikAppUi *, CUPnPPlayListFiller *)
IMPORT_C TIntExecuteMusicInRemoteL(CEikAppUi *, CUPnPPlayListFiller *, const CUpnpAVDevice &)
IMPORT_C TIntExecuteMusicLiteInLocalL(CEikAppUi *, MUPnPPlaylistFiller *)
IMPORT_C TIntExecuteMusicLiteInRemoteL(CEikAppUi *, MUPnPPlaylistFiller *, const CUpnpAVDevice &)
IMPORT_C CUPnPMusicAdapter *NewL(MUPnPAVController &)
TUid PlaylistCollectionId()
Protected Member Functions
voidHandleCollectionMediaL(const CMPXMedia &, TInt)
voidHandleCollectionMessage(CMPXMessage *, TInt)
voidHandleCommandComplete(CMPXCommand *, TInt)
voidHandleMediaL(const CMPXMedia &, TInt)
voidHandleOpenL(const CMPXMedia &, TInt, TBool, TInt)
voidHandleOpenL(const CMPXCollectionPlaylist &, TInt)
voidHandlePlaybackMessage(CMPXMessage *, TInt)
voidHandlePropertyL(TMPXPlaybackProperty, TInt, TInt)
voidHandleSubPlayerNamesL(TUid, const MDesCArray *, TBool, TInt)
Private Member Functions
CUPnPMusicAdapter(MUPnPAVController &)
voidConstructL()
voidCreatePlayListL()
voidDisplayUI()
voidDoHandleCollectionMessageL(TInt, TInt, TInt)
voidDoHandlePlaybackMessageL(TInt, TInt, TInt)
voidDoHandleSubPlayerNamesL(TUid, const MDesCArray *, TBool, TInt)
voidExit(TInt)
voidInitState()
voidTakeOwnershipOfTheFiller(MUPnPPlaylistFiller *)
voidUiShowLoopL()
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Public Member Enumerations
enumTAdapterState {
EStateIdle = 0, EStatePreparing, EStatePreparingWait, EStateInitialising, EStateRunning, EStateClosing
}
enumTFillerState { EFillerStateIdle = 0, EFillerStateFilling, EFillerStateComplete }
Private Attributes
MUPnPAVController &iAVController
CEikAppUi *iAppUi
MMPXCollectionUtility *iCollectionUtility
MUPnPPlaylistFiller *iCurrentFiller
TFillerState iCurrentFillerState
CMPXMedia *iMedia
CUPnPMpxHelper *iMpxHelper
MMPXPlaybackUtility *iPlaybackUtility
CMPXCollectionPlaylist *iPlaylist
TUid iPlaylistCollectionId
TBool iRemotePlayer
TInt iReturnCode
TAdapterState iState
const CUpnpAVDevice *iTargetDevice
CMPXMediaArray *iTrackArray
MMPXViewUtility *iViewUtility
CActiveSchedulerWait *iWait

Constructor & Destructor Documentation

CUPnPMusicAdapter(MUPnPAVController &)

CUPnPMusicAdapter(MUPnPAVController &aAVController)[private]

Default constructor

Since
Series 60 3.1

Parameters

MUPnPAVController & aAVControllerreference to AVController resource.

~CUPnPMusicAdapter()

IMPORT_C~CUPnPMusicAdapter()[virtual]

Destructor

Since
Series 60 3.1

Member Functions Documentation

AVController()

MUPnPAVController &AVController()

The AVController resource (to be used by the fillers)

Since
Series 60 3.1

CollectionUtility()

MMPXCollectionUtility &CollectionUtility()

The MPX CollectionUtility. Accessor for the filler

Complete(MUPnPPlaylistFiller *)

voidComplete(MUPnPPlaylistFiller *aFiller)

Called when playlist fill has completed. Does not pass ownership.

Since
Series 60 3.1

Parameters

MUPnPPlaylistFiller * aFillerthe object that has completed its job.

ConstructL()

voidConstructL()[private]

2nd phase constructor

Since
Series 60 3.1

CreatePlayListL()

voidCreatePlayListL()[private]
Creates play list
Since
Series 60 3.1

Dismiss(TInt)

IMPORT_C voidDismiss(TIntaReturnCode =  KErrCancel )

Dismiss the music player UI. The Execute... method will immediately return with the given return code

Since
Series 60 3.1

Parameters

TInt aReturnCode =  KErrCancel Exit code for the execution thread

DisplayUI()

voidDisplayUI()[private]
Commands the UI to be shown in UiShowLoop
Since
Series 60 3.1

DoHandleCollectionMessageL(TInt, TInt, TInt)

voidDoHandleCollectionMessageL(TIntaEvent,
TIntaType,
TIntaData
)[private]

Locally handles the corresponding callback

Parameters

TInt aEvent
TInt aType
TInt aData

DoHandlePlaybackMessageL(TInt, TInt, TInt)

voidDoHandlePlaybackMessageL(TIntaEvent,
TIntaType,
TIntaData
)[private]

Locally handles the corresponding callback

Parameters

TInt aEvent
TInt aType
TInt aData

DoHandleSubPlayerNamesL(TUid, const MDesCArray *, TBool, TInt)

voidDoHandleSubPlayerNamesL(TUidaPlayer,
const MDesCArray *aSubPlayers,
TBoolaComplete,
TIntaError
)[private]

Locally handles the corresponding callback

Parameters

TUid aPlayer
const MDesCArray * aSubPlayers
TBool aComplete
TInt aError

ExecuteMusicInLocalL(CEikAppUi *, CUPnPPlayListFiller *)

IMPORT_C TIntExecuteMusicInLocalL(CEikAppUi *aAppUi,
CUPnPPlayListFiller *aFiller
)

Initiates music play in the local device The method will block until music player exits. Music adapter will take ownership of the filler in all conditions.

Since
Series 60 3.1

Parameters

CEikAppUi * aAppUithe app.ui in case we are displaying a view/dialog
CUPnPPlayListFiller * aFillerObject that contains playlist information

ExecuteMusicInRemoteL(CEikAppUi *, CUPnPPlayListFiller *, const CUpnpAVDevice &)

IMPORT_C TIntExecuteMusicInRemoteL(CEikAppUi *aParentUi,
CUPnPPlayListFiller *aFiller,
const CUpnpAVDevice &aRenderer
)

Initiates music play in a remote renderer. The method will block until music player exits. Music adapter will take ownership of the filler in all conditions.

Since
Series 60 3.1

Parameters

CEikAppUi * aParentUi
CUPnPPlayListFiller * aFillerObject that contains playlist information
const CUpnpAVDevice & aRendererthe selected renderer device

ExecuteMusicLiteInLocalL(CEikAppUi *, MUPnPPlaylistFiller *)

IMPORT_C TIntExecuteMusicLiteInLocalL(CEikAppUi *aAppUi,
MUPnPPlaylistFiller *aFiller
)

Initiates music play in the local device The method will block until music player exits. Music adapter will take ownership of the filler in all conditions.

Since
Series 60 3.1

Parameters

CEikAppUi * aAppUithe app.ui in case we are displaying a view/dialog
MUPnPPlaylistFiller * aFillerObject that contains playlist information

ExecuteMusicLiteInRemoteL(CEikAppUi *, MUPnPPlaylistFiller *, const CUpnpAVDevice &)

IMPORT_C TIntExecuteMusicLiteInRemoteL(CEikAppUi *aParentUi,
MUPnPPlaylistFiller *aFiller,
const CUpnpAVDevice &aRenderer
)

Initiates music play in a remote renderer. The method will block until music player exits. Music adapter will take ownership of the filler in all conditions.

Since
Series 60 3.1

Parameters

CEikAppUi * aParentUi
MUPnPPlaylistFiller * aFillerObject that contains playlist information
const CUpnpAVDevice & aRendererthe selected renderer device

Exit(TInt)

voidExit(TIntaReturnCode)[private]
Causes an internal exit
Since
Series 60 3.1

Parameters

TInt aReturnCodethe return code for the thread

HandleCollectionMediaL(const CMPXMedia &, TInt)

voidHandleCollectionMediaL(const CMPXMedia &aMedia,
TIntaError
)[protected]

see MMPXCollectionMediaObserver

Parameters

const CMPXMedia & aMedia
TInt aError

HandleCollectionMessage(CMPXMessage *, TInt)

voidHandleCollectionMessage(CMPXMessage *aMsg,
TIntaErr
)[protected]

see MMPXCollectionObserver

Parameters

CMPXMessage * aMsg
TInt aErr

HandleCommandComplete(CMPXCommand *, TInt)

voidHandleCommandComplete(CMPXCommand *aCommandResult,
TIntaError
)[protected]

MMPXPlaybackObserver

Parameters

CMPXCommand * aCommandResult
TInt aError

HandleMediaL(const CMPXMedia &, TInt)

voidHandleMediaL(const CMPXMedia &aProperties,
TIntaError
)[protected]

MMPXPlaybackCallback

Parameters

const CMPXMedia & aProperties
TInt aError

HandleOpenL(const CMPXMedia &, TInt, TBool, TInt)

voidHandleOpenL(const CMPXMedia &aEntries,
TIntaIndex,
TBoolaComplete,
TIntaError
)[protected]

see MMPXCollectionObserver

Parameters

const CMPXMedia & aEntries
TInt aIndex
TBool aComplete
TInt aError

HandleOpenL(const CMPXCollectionPlaylist &, TInt)

voidHandleOpenL(const CMPXCollectionPlaylist &aPlaylist,
TIntaError
)[protected]

MMPXPlaybackObserver

Parameters

const CMPXCollectionPlaylist & aPlaylist
TInt aError

HandlePlaybackMessage(CMPXMessage *, TInt)

voidHandlePlaybackMessage(CMPXMessage *aMsg,
TIntaErr
)[protected]

MMPXPlaybackObserver

Parameters

CMPXMessage * aMsg
TInt aErr

HandlePropertyL(TMPXPlaybackProperty, TInt, TInt)

voidHandlePropertyL(TMPXPlaybackPropertyaProperty,
TIntaValue,
TIntaError
)[protected]

MMPXPlaybackCallback

Parameters

TMPXPlaybackProperty aProperty
TInt aValue
TInt aError

HandleSubPlayerNamesL(TUid, const MDesCArray *, TBool, TInt)

voidHandleSubPlayerNamesL(TUidaPlayer,
const MDesCArray *aSubPlayers,
TBoolaComplete,
TIntaError
)[protected]

MMPXPlaybackCallback

Parameters

TUid aPlayer
const MDesCArray * aSubPlayers
TBool aComplete
TInt aError

InitState()

voidInitState()[private]

Initialises the state before execution

Since
Series 60 3.1

NewL(MUPnPAVController &)

IMPORT_C CUPnPMusicAdapter *NewL(MUPnPAVController &aAVController)[static]

1st phase constructor

Since
Series 60 3.1

Parameters

MUPnPAVController & aAVControllerreference to AVController resource.

PlaylistCollectionId()

TUid PlaylistCollectionId()

The Collection UID used for the playlist. Accessor for the filler

TakeOwnershipOfTheFiller(MUPnPPlaylistFiller *)

voidTakeOwnershipOfTheFiller(MUPnPPlaylistFiller *aFiller)[private]

Obtains ownership of the filler pointer.

Since
Series 60 3.1

Parameters

MUPnPPlaylistFiller * aFillerthe filler object to own

UiShowLoopL()

voidUiShowLoopL()[private]
A loop to show the UI
Since
Series 60 3.1

Member Enumerations Documentation

Enum TAdapterState

the adapter state

Enumerators

EStateIdle = 0
EStatePreparing
EStatePreparingWait
EStateInitialising
EStateRunning
EStateClosing

Enum TFillerState

Enumerators

EFillerStateIdle = 0
EFillerStateFilling
EFillerStateComplete

Member Data Documentation

MUPnPAVController & iAVController

MUPnPAVController &iAVController[private]

AVController resource

CEikAppUi * iAppUi

CEikAppUi *iAppUi[private]

Pointer to host application ui. NO OWNERSHIP

MMPXCollectionUtility * iCollectionUtility

MMPXCollectionUtility *iCollectionUtility[private]

For collection Own.

MUPnPPlaylistFiller * iCurrentFiller

MUPnPPlaylistFiller *iCurrentFiller[private]

The current playlist filler object

TFillerState iCurrentFillerState

TFillerState iCurrentFillerState[private]

Whether the filler is in working state

CMPXMedia * iMedia

CMPXMedia *iMedia[private]

For media object array

CUPnPMpxHelper * iMpxHelper

CUPnPMpxHelper *iMpxHelper[private]

For playlist creation Own.

MMPXPlaybackUtility * iPlaybackUtility

MMPXPlaybackUtility *iPlaybackUtility[private]

For playback Own.

CMPXCollectionPlaylist * iPlaylist

CMPXCollectionPlaylist *iPlaylist[private]

The current playlist

TUid iPlaylistCollectionId

TUid iPlaylistCollectionId[private]

Collection ID to use when communicating to MPX

TBool iRemotePlayer

TBool iRemotePlayer[private]

Tells are we using remote playback

TInt iReturnCode

TInt iReturnCode[private]

Exit code

TAdapterState iState

TAdapterState iState[private]

state of the adapter

const CUpnpAVDevice * iTargetDevice

const CUpnpAVDevice *iTargetDevice[private]

The renderer device we are rendering on NULL, if rendering locally NO OWNERSHIP

CMPXMediaArray * iTrackArray

CMPXMediaArray *iTrackArray[private]

The current temp playlist Own.

MMPXViewUtility * iViewUtility

MMPXViewUtility *iViewUtility[private]

View utility.

CActiveSchedulerWait * iWait

CActiveSchedulerWait *iWait[private]

Scheduler wait loop

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.