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.


                C#
                
                    Copy
                    
                
            
public static class MediaControlServer

Inheritance: Object

MediaControlServer

Properties

View Source

IsRunning

Gets a value indicating whether the server is running.

Declaration


                C#
                
                    Copy
                    
                
            
public static bool IsRunning { get; }

Property Value

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

Methods

View Source

GetActivatedClients()

Gets the active clients.

Declaration


                C#
                
                    Copy
                    
                
            
public static IEnumerable<string> GetActivatedClients()

Returns

Type	Description
System.Collections.Generic.IEnumerable<System.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


                C#
                
                    Copy
                    
                
            
public static void RemovePlaylist(MediaControlPlaylist playlist)

Parameters

Type	Name	Description
MediaControlPlaylist	playlist	The name of 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)

Requests commands to the client.

Declaration


                C#
                
                    Copy
                    
                
            
public static Task<Bundle> RequestAsync(Command command, string clientId)

Parameters

Type	Name	Description
Command	command	A Command class.
System.String	clientId	The client Id to send command.

Returns

Type	Description
System.Threading.Tasks.Task<Bundle>	Bundle represents the extra data from client and it can be null.

Remarks

The client can request the command to execute Command,
and then, the server receive 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.

API Level: 5

View Source

Response(Command, Int32)

Sends the result of each command.

Declaration


                C#
                
                    Copy
                    
                
            
public static void Response(Command command, int result)

Parameters

Type	Name	Description
Command	command	The command that return to client.
System.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


                C#
                
                    Copy
                    
                
            
public static void Response(Command command, int result, Bundle bundle)

Parameters

Type	Name	Description
Command	command	The command that return to client.
System.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

SetAgeRating(Int32)

Sets the age rating of latest played media.

Declaration


                C#
                
                    Copy
                    
                
            
public static void SetAgeRating(int ageRating)

Parameters

Type	Name	Description
System.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

SetIconPath(String)

Sets the path of icon.

Declaration


                C#
                
                    Copy
                    
                
            
public static void SetIconPath(string path)

Parameters

Type	Name	Description
System.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)

Sets the index of current playing media.

Declaration


                C#
                
                    Copy
                    
                
            
[Obsolete("Please do not use! This will be deprecated. Please use SetInfoOfCurrentPlayingMedia instead.")]
public static void SetIndexOfCurrentPlayingMedia(string index)

Parameters

Type	Name	Description
System.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


                C#
                
                    Copy
                    
                
            
public static void SetInfoOfCurrentPlayingMedia(string playlistName, string index)

Parameters

Type	Name	Description
System.String	playlistName	The playlist name of current playing media.
System.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


                C#
                
                    Copy
                    
                
            
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

SetPlaybackCapabilities(Dictionary<MediaControlPlaybackCommand, MediaControlCapabilitySupport>)

Sets the capabilities by MediaControlPlaybackCommand.

Declaration


                C#
                
                    Copy
                    
                
            
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.
System.ArgumentException	`capabilities` is invalid.

API Level: 5

View Source

SetPlaybackCapability(MediaControlPlaybackCommand, MediaControlCapabilitySupport)

Sets the capabilities by MediaControlPlaybackCommand.

Declaration


                C#
                
                    Copy
                    
                
            
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.
System.ArgumentException	`action` or `support` is invalid.

API Level: 5

View Source

SetPlaybackContentType(MediaControlContentType)

Sets the content type of latest played media.

Declaration


                C#
                
                    Copy
                    
                
            
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.
System.ArgumentException	`type` is invalid.

API Level: 5

View Source

SetPlaybackState(MediaControlPlaybackState, Int64)

Updates playback state and playback position.

Declaration


                C#
                
                    Copy
                    
                
            
public static void SetPlaybackState(MediaControlPlaybackState state, long position)

Parameters

Type	Name	Description
MediaControlPlaybackState	state	The playback state.
System.Int64	position	The playback position in milliseconds.

Exceptions

Type	Condition
System.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


                C#
                
                    Copy
                    
                
            
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.
System.ArgumentException	`mode` is invalid.

API Level: 4

View Source

SetRepeatModeCapability(MediaControlCapabilitySupport)

Sets the content type of latest played media.

Declaration


                C#
                
                    Copy
                    
                
            
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.
System.ArgumentException	`support` is invalid.

API Level: 5

View Source

SetShuffleModeCapability(MediaControlCapabilitySupport)

Sets the MediaControlCapabilitySupport indicating shuffle mode is supported or not.

Declaration


                C#
                
                    Copy
                    
                
            
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.
System.ArgumentException	`support` is invalid.

API Level: 5

View Source

SetShuffleModeEnabled(Boolean)

Updates the shuffle mode.

Declaration


                C#
                
                    Copy
                    
                
            
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

Start()

Starts the media control server.

Declaration


                C#
                
                    Copy
                    
                
            
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.

Stop()

Stops the media control server.

Declaration


                C#
                
                    Copy
                    
                
            
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.

Events

View Source

CustomCommandReceived

Occurs when a client sends custom command.

Declaration


                C#
                
                    Copy
                    
                
            
public static event EventHandler<CustomCommandReceivedEventArgs> CustomCommandReceived

Event Type

Type	Description
System.EventHandler<CustomCommandReceivedEventArgs>

API Level: 5

View Source

PlaybackActionCommandReceived

Occurs when a client sends playback command.

Declaration


                C#
                
                    Copy
                    
                
            
public static event EventHandler<PlaybackActionCommandReceivedEventArgs> PlaybackActionCommandReceived

Event Type

Type	Description
System.EventHandler<PlaybackActionCommandReceivedEventArgs>

API Level: 5

View Source

PlaybackCommandReceived

Occurs when a client sends playback command.

Declaration


                C#
                
                    Copy
                    
                
            
[Obsolete("Please do not use! This will be deprecated. Please use PlaybackActionCommandReceived instead.")]
public static event EventHandler<PlaybackCommandReceivedEventArgs> PlaybackCommandReceived

Event Type

Type	Description
System.EventHandler<PlaybackCommandReceivedEventArgs>

API Level: 4

View Source

PlaybackPositionCommandReceived

Occurs when a client sends playback position command.

Declaration


                C#
                
                    Copy
                    
                
            
public static event EventHandler<PlaybackPositionCommandReceivedEventArgs> PlaybackPositionCommandReceived

Event Type

Type	Description
System.EventHandler<PlaybackPositionCommandReceivedEventArgs>

API Level: 5

View Source

PlaylistCommandReceived

Occurs when a client sends playlist command.

Declaration


                C#
                
                    Copy
                    
                
            
public static event EventHandler<PlaylistCommandReceivedEventArgs> PlaylistCommandReceived

Event Type

Type	Description
System.EventHandler<PlaylistCommandReceivedEventArgs>

API Level: 5

View Source

RepeatModeCommandReceived

Occurs when a client sends repeat mode command.

Declaration


                C#
                
                    Copy
                    
                
            
public static event EventHandler<RepeatModeCommandReceivedEventArgs> RepeatModeCommandReceived

Event Type

Type	Description
System.EventHandler<RepeatModeCommandReceivedEventArgs>

API Level: 5

View Source

SearchCommandReceived

Occurs when a client sends search command.

Declaration


                C#
                
                    Copy
                    
                
            
public static event EventHandler<SearchCommandReceivedEventArgs> SearchCommandReceived

Event Type

Type	Description
System.EventHandler<SearchCommandReceivedEventArgs>

API Level: 5

View Source

ShuffleModeCommandReceived

Occurs when a client sends shuffle mode command.

Declaration


                C#
                
                    Copy
                    
                
            
public static event EventHandler<ShuffleModeCommandReceivedEventArgs> ShuffleModeCommandReceived

Event Type

Type	Description
System.EventHandler<ShuffleModeCommandReceivedEventArgs>

Class MediaControlServer

Definition

Properties

IsRunning

Declaration

Property Value

See Also

API Level: 4

Methods

GetActivatedClients()

Declaration

Returns

Exceptions

API Level: 5

RemovePlaylist(MediaControlPlaylist)

Declaration

Parameters

Exceptions

API Level: 5

RequestAsync(Command, String)

Declaration

Parameters

Returns

Remarks

Exceptions

API Level: 5

Response(Command, Int32)

Declaration

Parameters

Exceptions

API Level: 5

Response(Command, Int32, Bundle)

Declaration

Parameters

Exceptions

API Level: 5

SetAgeRating(Int32)

Declaration

Parameters

Exceptions

API Level: 5

SetIconPath(String)

Declaration

Parameters

Exceptions

API Level: 5

SetIndexOfCurrentPlayingMedia(String)

Declaration

Parameters

Exceptions

API Level: 5

SetInfoOfCurrentPlayingMedia(String, String)

Declaration

Parameters

Exceptions

API Level: 5

SetMetadata(MediaControlMetadata)

Declaration

Parameters

Exceptions

API Level: 4

SetPlaybackCapabilities(Dictionary<MediaControlPlaybackCommand, MediaControlCapabilitySupport>)

Declaration

Parameters

Exceptions

API Level: 5

SetPlaybackCapability(MediaControlPlaybackCommand, MediaControlCapabilitySupport)

Declaration

Parameters

Exceptions

API Level: 5

SetPlaybackContentType(MediaControlContentType)

Declaration

Parameters

Exceptions

API Level: 5

SetPlaybackState(MediaControlPlaybackState, Int64)

Declaration

Parameters

Exceptions