MMPXPlayerManager Class Reference
Manages the players. Golden rules: by default, all players of type EPbLocal are tried and the first one found which can handle the content is used; when a specific player is selected by uid, (i.e. SelectPlayerL(TUid aPlayer)) then only that player will be considered in the search; when players are selected by type (i.e. SelectPlayersL(TMPXPlaybackPlayerType aType)), then only players with that type are considered; When a sub player is explicitly selected (i.e. SelectSubPlayerL()), then only that player and its sub player are considered.
mpxplaybackutility.lib
Member Functions Documentation
ClearSelectPlayersL()
| void | ClearSelectPlayersL | ( | ) | [pure virtual] |
Clears all selection criteria. Essentially the same as SelectPlayersL(EPbLocal).
CurrentPlayer()
The current player, may change with each item, NULL if none found.
GetPlayerListL(RArray< TUid > &)
| void | GetPlayerListL | ( | RArray< TUid > & | aPlayers | ) | [pure virtual] |
Get the list of UIDs of all players.
Parameters
| RArray< TUid > & aPlayers | All the players' uids in the system |
GetPlayerListL(RArray< TUid > &, TMPXPlaybackPlayerType)
Get the list of UIDs of players with the specific type.
GetPlayerTypesL(RArray< TMPXPlaybackPlayerType > &)
Typically, a client will obtain the list of all the (non-duplicated) player 'types' in the system from GetPlayerTypesL and present localized type names (e.g. "Local","Home network", if possible, else if non-standard type,should use PlayerTypeDisplayNameL to get text from player).
User should be given opportunity to choose IF there is more than one type available, or if there is one type but more than one sub players, the user could be presented with the sub player list.
GetSelectionL(TMPXPlaybackPlayerType &, TUid &, TInt &, HBufC *&)
Retreives the current selection: KNullUid and KErrNotFound are possible return values for aPlayer and aSubPlayerIndex respectively if none are explicitly selected.
Parameters
| TMPXPlaybackPlayerType & aType | player type |
| TUid & aPlayer | the UID of player |
| TInt & aSubPlayerIndex | index of the subplayer |
| HBufC *& aSubPlayerName | friendly name of the subplayer. Notes: Client owns the returned aSubPlayerName object. |
PlayerTypeDisplayNameL(TMPXPlaybackPlayerType)
Returns display name for custom types; standard types should be recognized by client and localized - calling this method would then not be required.
SelectPlayerL(TUid)
| void | SelectPlayerL | ( | TUid | aPlayer | ) | [pure virtual] |
Client selects a specific player. NOTE: Once a player is manually selected by UID, all subsequent InitL() will continue to use that player, it will not try to resolve a plugin. If the client later wants the engine to auto resolve the proper plugin, the client must call ClearSelectPlayersL() to reset the engine.
Parameters
| TUid aPlayer | the UID of the player |
SelectPlayersL(TMPXPlaybackPlayerType)
Client selects all players with the type aType, the specific player used then being resolved on the basis of the content.
SelectSubPlayerL(TUid, TInt)
| void | SelectSubPlayerL | ( | TUid | aPlayer, |
| | TInt | aSubPlayerIndex |
| | ) | [pure virtual] |
Client selects specific player aPlayer and sub player aSubPlayerIndex from array returned by SubPlayerNamesL. NOTE: Once a player is manually selected by UID, all subsequent InitL() will continue to use that player, it will not try to resolve a plugin. If the client later wants the engine to auto resolve the proper plugin, the client must call ClearSelectPlayersL() to reset the engine.
Parameters
| TUid aPlayer | the UID of player |
| TInt aSubPlayerIndex | the index of the sub player |
SubPlayerNamesL(MMPXPlaybackCallback &, TUid)
| void | SubPlayerNamesL | ( | MMPXPlaybackCallback & | aCallback, |
| | TUid | aPlayer |
| | ) | [pure virtual] |
Get the list of sub player names, Async.
Parameters
| MMPXPlaybackCallback & aCallback | sub players returned in call back interface |
| TUid aPlayer | UID of the player |
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.