Class MediaController

Definition

Namespace:: Tizen.Multimedia.Remoting

Assembly:: Tizen.Multimedia.Remoting.dll

API Level:: 4

Provides a means to send commands to and handle events from media control server.

public class MediaController

Inheritance: Object

MediaController

Properties

View Source

IsStopped

Gets a value indicating whether the sever has been stopped.

Declaration

public bool IsStopped { get; }

Property Value

Type	Description
Boolean	true if the server has been stopped; otherwise, false.

API Level: 4

View Source

ServerAppId

Gets the application id of the server.

Declaration

public string ServerAppId { get; }

Property Value

Type	Description
String	The server application id.

API Level: 4

Methods

View Source

GetAgeRatingOfCurrentPlayingMedia()

Gets the age rating of current playing media.

Declaration

public int GetAgeRatingOfCurrentPlayingMedia()

Returns

Type	Description
Int32	The Age rating of current playing media. The range is 0 to 19, inclusive.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 5

View Source

GetContentTypeOfCurrentPlayingMedia()

Gets the content type of current playing media.

Declaration

public MediaControlContentType GetContentTypeOfCurrentPlayingMedia()

Returns

Type	Description
MediaControlContentType	The MediaControlContentType.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 5

View Source

GetDisplayMode()

Gets the current display mode.

Declaration

public MediaControlDisplayMode GetDisplayMode()

Returns

Type	Description
MediaControlDisplayMode	The MediaControlDisplayMode.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 6

View Source

GetDisplayModeCapability()

Gets the value whether the repeat mode is supported or not.

Declaration

public IEnumerable<MediaControlDisplayMode> GetDisplayModeCapability()

Returns

Type	Description
IEnumerable<MediaControlDisplayMode>	If there's no supported display mode by server, it will return null. otherwise, it will return the supported list of MediaControlDisplayMode.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 6

View Source

GetDisplayRotation()

Gets the current display rotation.

Declaration

public Rotation GetDisplayRotation()

Returns

Type	Description
Rotation	The Rotation.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 6

View Source

GetDisplayRotationCapability()

Gets the value whether the display mode is supported or not.

Declaration

public IEnumerable<Rotation> GetDisplayRotationCapability()

Returns

Type	Description
IEnumerable<Rotation>	If there's no supported display rotation by server, it will return null. otherwise, it will return the supported list of Rotation.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 6

View Source

GetIconPath()

Gets the icon path.

Declaration

public string GetIconPath()

Returns

Type	Description
String	The icon path.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 5

View Source

GetIndexOfCurrentPlayingMedia()

Returns the index of current playing media.

Declaration

public string GetIndexOfCurrentPlayingMedia()

Returns

Type	Description
String	The index of current playing media.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 5

View Source

GetMetadata()

Returns the metadata set by the server.

Declaration

public MediaControlMetadata GetMetadata()

Returns

Type	Description
MediaControlMetadata	The metadata.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

GetMode360Capability()

Gets the value whether the 360 mode is supported or not.

Declaration

public MediaControlCapabilitySupport GetMode360Capability()

Returns

Type	Description
MediaControlCapabilitySupport	A MediaControlCapabilitySupport.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 6

View Source

GetPlaybackCapabilities()

Gets the value whether MediaControlPlaybackCommand is supported or not.

Declaration

public Dictionary<MediaControlPlaybackCommand, MediaControlCapabilitySupport> GetPlaybackCapabilities()

Returns

Type	Description
Dictionary<MediaControlPlaybackCommand, MediaControlCapabilitySupport>	the set of MediaControlPlaybackCommand and MediaControlCapabilitySupport.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 5

View Source

GetPlaybackCapability(MediaControlPlaybackCommand)

Gets the value whether action is supported or not.

Declaration

public MediaControlCapabilitySupport GetPlaybackCapability(MediaControlPlaybackCommand action)

Parameters

Type	Name	Description
MediaControlPlaybackCommand	action	A playback command.

Returns

Type	Description
MediaControlCapabilitySupport	A MediaControlCapabilitySupport.

Exceptions

Type	Condition
ArgumentException	`action` is not valid.
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 5

View Source

GetPlaybackPosition()

Returns the playback position set by the server.

Declaration

public long GetPlaybackPosition()

Returns

Type	Description
Int64	The playback position in milliseconds.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

GetPlaybackState()

Returns the playback state set by the server.

Declaration

public MediaControlPlaybackState GetPlaybackState()

Returns

Type	Description
MediaControlPlaybackState	The playback state.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

GetPlaylistOfCurrentPlayingMedia()

Returns the playlist name of current playing media.

Declaration

public MediaControlPlaylist GetPlaylistOfCurrentPlayingMedia()

Returns

Type	Description
MediaControlPlaylist	The playlist name.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 5

View Source

GetPlaylists()

Returns the all playlists.

Declaration

public IEnumerable<MediaControlPlaylist> GetPlaylists()

Returns

Type	Description
IEnumerable<MediaControlPlaylist>	The set of MediaControlPlaylist.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 5

View Source

GetRepeatMode()

Returns the repeat mode.

Declaration

public MediaControlRepeatMode GetRepeatMode()

Returns

Type	Description
MediaControlRepeatMode	A MediaControlRepeatMode set by the server.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

GetRepeatModeCapability()

Gets the value whether the repeat mode is supported or not.

Declaration

public MediaControlCapabilitySupport GetRepeatModeCapability()

Returns

Type	Description
MediaControlCapabilitySupport	A MediaControlCapabilitySupport.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 5

View Source

GetShuffleModeCapability()

Gets the value whether the shuffle mode is supported or not.

Declaration

public MediaControlCapabilitySupport GetShuffleModeCapability()

Returns

Type	Description
MediaControlCapabilitySupport	A MediaControlCapabilitySupport.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 5

View Source

GetSubtitleModeCapability()

Gets the value whether the subtitle mode is supported or not.

Declaration

public MediaControlCapabilitySupport GetSubtitleModeCapability()

Returns

Type	Description
MediaControlCapabilitySupport	A MediaControlCapabilitySupport.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 6

View Source

IsMode360Enabled()

Gets whether the 360 mode is enabled or not.

Declaration

public bool IsMode360Enabled()

Returns

Type	Description
Boolean	A value indicating whether the 360 mode is enabled or not.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 6

View Source

IsShuffleModeEnabled()

Returns whether the shuffle mode is enabled.

Declaration

public bool IsShuffleModeEnabled()

Returns

Type	Description
Boolean	A value indicating whether the shuffle mode is enabled.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

IsSubtitleModeEnabled()

Gets whether the subtitle mode is enabled or not.

Declaration

public bool IsSubtitleModeEnabled()

Returns

Type	Description
Boolean	A value indicating whether the subtitle mode is enabled or not.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

API Level: 6

View Source

RequestAsync(Command)

Deprecated since API8; Will be removed in API10. Please use RequestCommandAsync(Command command) instead.

Requests command to the server.

Declaration

[Obsolete("Deprecated since API8; Will be removed in API10. Please use RequestCommandAsync(Command command) instead.")]
public Task<Bundle> RequestAsync(Command command)

Parameters

Type	Name	Description
Command	command	A Command class.

Returns

Type	Description
Task<Bundle>	Bundle represents the extra data from server and it can be null.

Exceptions

Type	Condition
ArgumentNullException	`command` is null.
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

RequestCommandAsync(Command)

Requests a command to the server and client receives the result of each request(command).

Declaration

public Task<(Bundle bundle, int result)> RequestCommandAsync(Command command)

Parameters

Type	Name	Description
Command	command	A Command class.

Returns

Type	Description
Task<ValueTuple<Bundle, Int32>>	The type of return value is Tuple. First item of Tuple represents the Bundle and it represents the extra data from client. It can be null. Second item of Tuple represents the result of each request(command).

Exceptions

Type	Condition
ArgumentNullException	`command` is null.
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ObjectDisposedException	The MediaControllerManager has already been disposed.

Response(Command, Int32)

Sends the result of each command.

Declaration

public void Response(Command command, int result)

Parameters

Type	Name	Description
Command	command	The command that return to client.
Int32	result	The result of `command`.

Exceptions

Type	Condition
ArgumentNullException	`command` is null.
InvalidOperationException	The server is not running . -or- An internal error occurs.

API Level: 5

View Source

Response(Command, Int32, Bundle)

Sends the result of each command.

Declaration

public void Response(Command command, int result, Bundle bundle)

Parameters

Type	Name	Description
Command	command	The command that return to client.
Int32	result	The result of `command`.
Bundle	bundle	The extra data.

Exceptions

Type	Condition
ArgumentNullException	`command` is null.
InvalidOperationException	The server is not running . -or- An internal error occurs.

API Level: 5

View Source

Response(Command, MediaControlResult)

Sends the result of each command.

Declaration

public void Response(Command command, MediaControlResult result)

Parameters

Type	Name	Description
Command	command	The command that return to client.
MediaControlResult	result	The MediaControlResult of `command`.

Exceptions

Type	Condition
ArgumentNullException	`command` is null.
InvalidOperationException	The server is not running . -or- An internal error occurs.

API Level: 8

View Source

Response(Command, MediaControlResult, Bundle)

Sends the result of each command.

Declaration

public void Response(Command command, MediaControlResult result, Bundle bundle)

Parameters

Type	Name	Description
Command	command	The command that return to client.
MediaControlResult	result	The MediaControlResult of `command`.
Bundle	bundle	The extra data.

Exceptions

Type	Condition
ArgumentNullException	`command` is null.
InvalidOperationException	The server is not running . -or- An internal error occurs.

API Level: 8

View Source

SendPlaybackCommand(MediaControlPlaybackCommand)

Please do not use! This will be deprecated. Please use Request instead.

Sends playback command to the server.

Declaration

[Obsolete("Please do not use! This will be deprecated. Please use Request instead.")]
public void SendPlaybackCommand(MediaControlPlaybackCommand command)

Parameters

Type	Name	Description
MediaControlPlaybackCommand	command	A playback command.

Exceptions

Type	Condition
InvalidOperationException	The server has already been stopped. -or- An internal error occurs.
ArgumentException	`command` is not valid.
ObjectDisposedException	The MediaControllerManager has already been disposed.

Events

View Source

CustomCommandReceived

Occurs when a server sends custom event.

Declaration

public event EventHandler<CustomCommandReceivedEventArgs> CustomCommandReceived

Event Type

Type	Description
EventHandler<CustomCommandReceivedEventArgs>

API Level: 5

View Source

DisplayModeCapabilityUpdated

Occurs when the display mode capabilities are updated.

Declaration

public event EventHandler<DisplayModeCapabilityUpdatedEventArgs> DisplayModeCapabilityUpdated

Event Type

Type	Description
EventHandler<DisplayModeCapabilityUpdatedEventArgs>

API Level: 6

View Source

DisplayModeUpdated

Occurs when the display mode is updated.

Declaration

public event EventHandler<DisplayModeUpdatedEventArgs> DisplayModeUpdated

Event Type

Type	Description
EventHandler<DisplayModeUpdatedEventArgs>

API Level: 6

View Source

DisplayRotationCapabilityUpdated

Occurs when the display rotation capabilities are updated.

Declaration

public event EventHandler<DisplayRotationCapabilityUpdatedEventArgs> DisplayRotationCapabilityUpdated

Event Type

Type	Description
EventHandler<DisplayRotationCapabilityUpdatedEventArgs>

API Level: 6

View Source

DisplayRotationUpdated

Occurs when the display rotation is updated.

Declaration

public event EventHandler<DisplayRotationUpdatedEventArgs> DisplayRotationUpdated

Event Type

Type	Description
EventHandler<DisplayRotationUpdatedEventArgs>

API Level: 6

View Source

MetadataUpdated

Occurs when the metadata is updated.

Declaration

public event EventHandler<MetadataUpdatedEventArgs> MetadataUpdated

Event Type

Type	Description
EventHandler<MetadataUpdatedEventArgs>

API Level: 4

View Source

Mode360Updated

Occurs when the 360 mode is updated.

Declaration

public event EventHandler<Mode360UpdatedEventArgs> Mode360Updated

Event Type

Type	Description
EventHandler<Mode360UpdatedEventArgs>

API Level: 6

View Source

PlaybackCapabilityUpdated

Occurs when the playback capabilities are updated.

Declaration

public event EventHandler<PlaybackCapabilityUpdatedEventArgs> PlaybackCapabilityUpdated

Event Type

Type	Description
EventHandler<PlaybackCapabilityUpdatedEventArgs>

API Level: 5

View Source

PlaybackStateUpdated

Occurs when the playback state is updated.

Declaration

public event EventHandler<PlaybackStateUpdatedEventArgs> PlaybackStateUpdated

Event Type

Type	Description
EventHandler<PlaybackStateUpdatedEventArgs>

API Level: 4

View Source

PlaylistUpdated

Occurs when the playlist is updated.

Declaration

public event EventHandler<PlaylistUpdatedEventArgs> PlaylistUpdated

Event Type

Type	Description
EventHandler<PlaylistUpdatedEventArgs>

API Level: 5

View Source

RepeatModeCapabilityUpdated

Occurs when the repeat mode capabilities are updated.

Declaration

public event EventHandler<RepeatModeCapabilityUpdatedEventArgs> RepeatModeCapabilityUpdated

Event Type

Type	Description
EventHandler<RepeatModeCapabilityUpdatedEventArgs>

API Level: 5

View Source

RepeatModeUpdated

Occurs when the repeat mode is updated.

Declaration

public event EventHandler<RepeatModeUpdatedEventArgs> RepeatModeUpdated

Event Type

Type	Description
EventHandler<RepeatModeUpdatedEventArgs>

API Level: 4

View Source

ServerStopped

Occurs when the server is stopped.

Declaration

public event EventHandler ServerStopped

Event Type

Type	Description
EventHandler

API Level: 4

View Source

ShuffleModeCapabilityUpdated

Occurs when the shuffle mode capabilities are updated.

Declaration

public event EventHandler<ShuffleModeCapabilityUpdatedEventArgs> ShuffleModeCapabilityUpdated

Event Type

Type	Description
EventHandler<ShuffleModeCapabilityUpdatedEventArgs>

API Level: 5

View Source

ShuffleModeUpdated

Occurs when the shuffle mode is updated.

Declaration

public event EventHandler<ShuffleModeUpdatedEventArgs> ShuffleModeUpdated

Event Type

Type	Description
EventHandler<ShuffleModeUpdatedEventArgs>

API Level: 4

View Source

SubtitleModeUpdated

Occurs when the subtitle mode is updated.

Declaration

public event EventHandler<SubtitleModeUpdatedEventArgs> SubtitleModeUpdated

Event Type

Type	Description
EventHandler<SubtitleModeUpdatedEventArgs>

Class MediaController

Definition

Properties

IsStopped

Declaration

Property Value

API Level: 4

ServerAppId

Declaration

Property Value

API Level: 4

Methods

GetAgeRatingOfCurrentPlayingMedia()

Declaration

Returns

Exceptions

API Level: 5

GetContentTypeOfCurrentPlayingMedia()

Declaration

Returns

Exceptions

API Level: 5

GetDisplayMode()

Declaration

Returns

Exceptions

API Level: 6

GetDisplayModeCapability()

Declaration

Returns

Exceptions

API Level: 6

GetDisplayRotation()

Declaration

Returns

Exceptions

API Level: 6

GetDisplayRotationCapability()

Declaration

Returns

Exceptions

API Level: 6

GetIconPath()

Declaration

Returns

Exceptions

API Level: 5

GetIndexOfCurrentPlayingMedia()

Declaration

Returns

Exceptions

API Level: 5

GetMetadata()

Declaration

Returns

Exceptions

See Also

API Level: 4

GetMode360Capability()

Declaration

Returns

Exceptions

API Level: 6

GetPlaybackCapabilities()

Declaration

Returns

Exceptions

API Level: 5

GetPlaybackCapability(MediaControlPlaybackCommand)

Declaration

Parameters

Returns

Exceptions

API Level: 5

GetPlaybackPosition()

Declaration

Returns

Exceptions

See Also

API Level: 4