Class MediaControlServer

Definition

Namespace:
Tizen.Multimedia.Remoting
Assembly:
Tizen.Multimedia.Remoting.dll
API Level:
4

Provides a means to set playback information and metadata and receive commands from clients.

public static class MediaControlServer
Inheritance
Object
MediaControlServer

Properties

View Source

IsRunning

Gets a value indicating whether the server is running.

Declaration
public static bool IsRunning { get; }
Property Value
Type Description
Boolean

true if the server has started; otherwise, false.
See Also
API Level: 4

Methods

View Source

GetActivatedClients()

Gets the active clients.

Declaration
public static IEnumerable<string> GetActivatedClients()
Returns
Type Description
IEnumerable<String>

the activated client ids.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 5
View Source

RemovePlaylist(MediaControlPlaylist)

Delete playlist.

Declaration
public static void RemovePlaylist(MediaControlPlaylist playlist)
Parameters
Type Name Description
MediaControlPlaylist playlist

The name of playlist.
Remarks

Currently, only server can remove the playlist.

Exceptions
Type Condition
ArgumentNullException

playlist is null.
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 5
View Source

RequestAsync(Command, String)

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

Requests commands to the client.

Declaration
[Obsolete("Deprecated since API8; Will be removed in API10. Please use RequestCommandAsync(Command command) instead.")]
public static Task<Bundle> RequestAsync(Command command, string clientId)
Parameters
Type Name Description
Command command

A Command class.
String clientId

The client Id to send command.
Returns
Type Description
Task<Bundle>

Bundle represents the extra data from client and it can be null.
Exceptions
Type Condition
ArgumentNullException

command or clientId is null.
InvalidOperationException

The server has already been stopped.
-or-
An internal error occurs.
See Also
API Level: 5
View Source

RequestCommandAsync(Command, String)

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

Declaration
public static Task<(Bundle bundle, int result)> RequestCommandAsync(Command command, string clientId)
Parameters
Type Name Description
Command command

A Command class.
String clientId

The client Id to send command.
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 or clientId is null.
InvalidOperationException

The server has already been stopped.
-or-
An internal error occurs.
NotImplementedException

The command which is not supported is used.
See Also
API Level: 8
View Source

Response(Command, Int32)

Sends the result of each command.

Declaration
public static 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 static 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 static 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 static 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

SetAgeRating(Int32)

Sets the age rating of latest played media.

Declaration
public static void SetAgeRating(int ageRating)
Parameters
Type Name Description
Int32 ageRating

The Age rating of latest played media. The valid range is 0 to 19, inclusive. Especially, 0 means that media is suitable for all ages.
Exceptions
Type Condition
ArgumentOutOfRangeException

The specified ageRating is not valid.
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 5
View Source

SetDisplayMode(MediaControlDisplayMode)

Sets the display mode.

Declaration
public static void SetDisplayMode(MediaControlDisplayMode mode)
Parameters
Type Name Description
MediaControlDisplayMode mode

A value indicating the MediaControlDisplayMode.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 6
View Source

SetDisplayModeCapabilities(IDictionary<MediaControlDisplayMode, MediaControlCapabilitySupport>)

Sets the supported list of MediaControlDisplayMode.

Declaration
public static void SetDisplayModeCapabilities(IDictionary<MediaControlDisplayMode, MediaControlCapabilitySupport> capabilities)
Parameters
Type Name Description
IDictionary<MediaControlDisplayMode, MediaControlCapabilitySupport> capabilities

The supported list of MediaControlDisplayMode.
Remarks

NotDecided is not allowed in display mode capability. The default value of each MediaControlDisplayMode is not supported.

Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

capabilities is invalid.
API Level: 6
View Source

SetDisplayModeCapability(MediaControlDisplayMode, MediaControlCapabilitySupport)

Sets the mode is supported or not.

Declaration
public static void SetDisplayModeCapability(MediaControlDisplayMode mode, MediaControlCapabilitySupport support)
Parameters
Type Name Description
MediaControlDisplayMode mode

The MediaControlDisplayMode.
MediaControlCapabilitySupport support

A value indicating whether the mode is supported or not.
Remarks

NotDecided is not allowed in display mode capability.
The default value of each MediaControlDisplayMode is not supported.

Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

mode or support is invalid.
API Level: 6
View Source

SetDisplayRotation(Rotation)

Sets the display rotation.

Declaration
public static void SetDisplayRotation(Rotation rotation)
Parameters
Type Name Description
Rotation rotation

A value indicating the Rotation.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 6
View Source

SetDisplayRotationCapabilities(IDictionary<Rotation, MediaControlCapabilitySupport>)

Sets the supported list of Rotation.

Declaration
public static void SetDisplayRotationCapabilities(IDictionary<Rotation, MediaControlCapabilitySupport> capabilities)
Parameters
Type Name Description
IDictionary<Rotation, MediaControlCapabilitySupport> capabilities

The supported list of Rotation.
Remarks

NotDecided is not allowed in display rotation capability.
The default value of each Rotation is not supported.

Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

capabilities is invalid.
API Level: 6
View Source

SetDisplayRotationCapability(Rotation, MediaControlCapabilitySupport)

Sets the rotation is supported or not.

Declaration
public static void SetDisplayRotationCapability(Rotation rotation, MediaControlCapabilitySupport support)
Parameters
Type Name Description
Rotation rotation

The Rotation.
MediaControlCapabilitySupport support

A value indicating whether the rotation is supported or not..
Remarks

NotDecided is not allowed in display rotation capability.
The default value of each Rotation is not supported.

Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

rotation or support is invalid.
API Level: 6
View Source

SetIconPath(String)

Sets the path of icon.

Declaration
public static void SetIconPath(string path)
Parameters
Type Name Description
String path

The path of icon.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentNullException

path is invalid.
API Level: 5
View Source

SetIndexOfCurrentPlayingMedia(String)

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

Sets the index of current playing media.

Declaration
[Obsolete("Please do not use! This will be deprecated. Please use SetInfoOfCurrentPlayingMedia instead.")]
public static void SetIndexOfCurrentPlayingMedia(string index)
Parameters
Type Name Description
String index

The index of current playing media.
Exceptions
Type Condition
ArgumentNullException

index is null.
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 5
View Source

SetInfoOfCurrentPlayingMedia(String, String)

Sets the playlist name and index of current playing media.

Declaration
public static void SetInfoOfCurrentPlayingMedia(string playlistName, string index)
Parameters
Type Name Description
String playlistName

The playlist name of current playing media.
String index

The index of current playing media.
Exceptions
Type Condition
ArgumentNullException

playlistName or index is null.
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 5
View Source

SetMetadata(MediaControlMetadata)

Updates metadata information.

Declaration
public static void SetMetadata(MediaControlMetadata metadata)
Parameters
Type Name Description
MediaControlMetadata metadata

The metadata to update.
Exceptions
Type Condition
ArgumentNullException

metadata is null.
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 4
View Source

SetMode360(Boolean)

Sets the 360 mode.

Declaration
public static void SetMode360(bool isEnabled)
Parameters
Type Name Description
Boolean isEnabled

A value indicating whether the 360 mode is enabled.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 6
View Source

SetMode360Capability(MediaControlCapabilitySupport)

Sets the MediaControlCapabilitySupport indicating whether 360 mode is supported or not.

Declaration
public static void SetMode360Capability(MediaControlCapabilitySupport support)
Parameters
Type Name Description
MediaControlCapabilitySupport support

A value indicating whether the 360 mode is supported or not.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

support is invalid.
API Level: 6
View Source

SetPlaybackCapabilities(Dictionary<MediaControlPlaybackCommand, MediaControlCapabilitySupport>)

Sets the capabilities by MediaControlPlaybackCommand.

Declaration
public static void SetPlaybackCapabilities(Dictionary<MediaControlPlaybackCommand, MediaControlCapabilitySupport> capabilities)
Parameters
Type Name Description
Dictionary<MediaControlPlaybackCommand, MediaControlCapabilitySupport> capabilities

The set of MediaControlPlaybackCommand and MediaControlCapabilitySupport.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

capabilities is invalid.
API Level: 5
View Source

SetPlaybackCapability(MediaControlPlaybackCommand, MediaControlCapabilitySupport)

Sets the capabilities by MediaControlPlaybackCommand.

Declaration
public static void SetPlaybackCapability(MediaControlPlaybackCommand action, MediaControlCapabilitySupport support)
Parameters
Type Name Description
MediaControlPlaybackCommand action

A playback command.
MediaControlCapabilitySupport support

A value indicating whether the action is supported or not.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

action or support is invalid.
API Level: 5
View Source

SetPlaybackContentType(MediaControlContentType)

Sets the content type of latest played media.

Declaration
public static void SetPlaybackContentType(MediaControlContentType type)
Parameters
Type Name Description
MediaControlContentType type

A value indicating the content type of the latest played media.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

type is invalid.
API Level: 5
View Source

SetPlaybackState(MediaControlPlaybackState, Int64)

Updates playback state and playback position.

Declaration
public static void SetPlaybackState(MediaControlPlaybackState state, long position)
Parameters
Type Name Description
MediaControlPlaybackState state

The playback state.
Int64 position

The playback position in milliseconds.
Exceptions
Type Condition
ArgumentException

state is not valid.
ArgumentOutOfRangeException

position is less than zero.
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 4
View Source

SetRepeatMode(MediaControlRepeatMode)

Updates the repeat mode.

Declaration
public static void SetRepeatMode(MediaControlRepeatMode mode)
Parameters
Type Name Description
MediaControlRepeatMode mode

A value indicating the repeat mode.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

mode is invalid.
API Level: 4
View Source

SetRepeatModeCapability(MediaControlCapabilitySupport)

Sets the MediaControlCapabilitySupport indicating repeat mode is supported or not.

Declaration
public static void SetRepeatModeCapability(MediaControlCapabilitySupport support)
Parameters
Type Name Description
MediaControlCapabilitySupport support

A value indicating whether the MediaControlRepeatMode is supported or not.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

support is invalid.
API Level: 5
View Source

SetShuffleModeCapability(MediaControlCapabilitySupport)

Sets the MediaControlCapabilitySupport indicating shuffle mode is supported or not.

Declaration
public static void SetShuffleModeCapability(MediaControlCapabilitySupport support)
Parameters
Type Name Description
MediaControlCapabilitySupport support

A value indicating whether the shuffle mode is supported or not.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

support is invalid.
API Level: 5
View Source

SetShuffleModeEnabled(Boolean)

Updates the shuffle mode.

Declaration
public static void SetShuffleModeEnabled(bool enabled)
Parameters
Type Name Description
Boolean enabled

A value indicating whether the shuffle mode is enabled.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 4
View Source

SetSubtitleMode(Boolean)

Sets the subtitle mode.

Declaration
public static void SetSubtitleMode(bool isEnabled)
Parameters
Type Name Description
Boolean isEnabled

A value indicating whether the subtitle mode is enabled.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
API Level: 6
View Source

SetSubtitleModeCapability(MediaControlCapabilitySupport)

Sets the MediaControlCapabilitySupport indicating whether subtitle mode is supported or not.

Declaration
public static void SetSubtitleModeCapability(MediaControlCapabilitySupport support)
Parameters
Type Name Description
MediaControlCapabilitySupport support

A value indicating whether the subtitle mode is supported or not.
Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
ArgumentException

support is invalid.
API Level: 6
View Source

Start()

Starts the media control server.

Declaration
public static void Start()
Remarks

When the server starts, ServerStarted will be raised.

Exceptions
Type Condition
InvalidOperationException

An internal error occurs.
UnauthorizedAccessException

Caller does not have required privilege.
See Also
API Level: 4
Privilege Level: public
Privilege: http://tizen.org/privilege/mediacontroller.server
View Source

Stop()

Stops the media control server.

Declaration
public static void Stop()
Remarks

When the server stops, ServerStopped will be raised.

Exceptions
Type Condition
InvalidOperationException

The server is not running .
-or-
An internal error occurs.
See Also
API Level: 4

Events

View Source

CustomCommandReceived

Occurs when a client sends custom command.

Declaration
public static event EventHandler<CustomCommandReceivedEventArgs> CustomCommandReceived
Event Type
Type Description
EventHandler<CustomCommandReceivedEventArgs>
API Level: 5
View Source

DisplayModeCommandReceived

Occurs when a client sends display mode command.

Declaration
public static event EventHandler<DisplayModeCommandReceivedEventArgs> DisplayModeCommandReceived
Event Type
Type Description
EventHandler<DisplayModeCommandReceivedEventArgs>
API Level: 6
View Source

DisplayRotationCommandReceived

Occurs when a client sends display rotation command.

Declaration
public static event EventHandler<DisplayRotationCommandReceivedEventArgs> DisplayRotationCommandReceived
Event Type
Type Description
EventHandler<DisplayRotationCommandReceivedEventArgs>
API Level: 6
View Source

Mode360CommandReceived

Occurs when a client sends mode 360 command.

Declaration
public static event EventHandler<Mode360CommandReceivedEventArgs> Mode360CommandReceived
Event Type
Type Description
EventHandler<Mode360CommandReceivedEventArgs>
API Level: 6
View Source

PlaybackActionCommandReceived

Occurs when a client sends playback command.

Declaration
public static event EventHandler<PlaybackActionCommandReceivedEventArgs> PlaybackActionCommandReceived
Event Type
Type Description
EventHandler<PlaybackActionCommandReceivedEventArgs>
API Level: 5
View Source

PlaybackCommandReceived

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

Occurs when a client sends playback command.

Declaration
[Obsolete("Please do not use! This will be deprecated. Please use PlaybackActionCommandReceived instead.")]
public static event EventHandler<PlaybackCommandReceivedEventArgs> PlaybackCommandReceived
Event Type
Type Description
EventHandler<PlaybackCommandReceivedEventArgs>
API Level: 4
View Source

PlaybackPositionCommandReceived

Occurs when a client sends playback position command.

Declaration
public static event EventHandler<PlaybackPositionCommandReceivedEventArgs> PlaybackPositionCommandReceived
Event Type
Type Description
EventHandler<PlaybackPositionCommandReceivedEventArgs>
API Level: 5
View Source

PlaylistCommandReceived

Occurs when a client sends playlist command.

Declaration
public static event EventHandler<PlaylistCommandReceivedEventArgs> PlaylistCommandReceived
Event Type
Type Description
EventHandler<PlaylistCommandReceivedEventArgs>
API Level: 5
View Source

RepeatModeCommandReceived

Occurs when a client sends repeat mode command.

Declaration
public static event EventHandler<RepeatModeCommandReceivedEventArgs> RepeatModeCommandReceived
Event Type
Type Description
EventHandler<RepeatModeCommandReceivedEventArgs>
API Level: 5
View Source

SearchCommandReceived

Occurs when a client sends search command.

Declaration
public static event EventHandler<SearchCommandReceivedEventArgs> SearchCommandReceived
Event Type
Type Description
EventHandler<SearchCommandReceivedEventArgs>
API Level: 5
View Source

ShuffleModeCommandReceived

Occurs when a client sends shuffle mode command.

Declaration
public static event EventHandler<ShuffleModeCommandReceivedEventArgs> ShuffleModeCommandReceived
Event Type
Type Description
EventHandler<ShuffleModeCommandReceivedEventArgs>
API Level: 5
View Source

SubtitleModeCommandReceived

Occurs when a client sends subtitle mode command.

Declaration
public static event EventHandler<SubtitleModeCommandReceivedEventArgs> SubtitleModeCommandReceived
Event Type
Type Description
EventHandler<SubtitleModeCommandReceivedEventArgs>
API Level: 6

See Also