Class ScreenMirroring

Definition

Namespace:: Tizen.Multimedia.Remoting

Assembly:: Tizen.Multimedia.Remoting.dll

API Level:: 4

Provides the ability to connect to and disconnect from a screen mirroring source, start, pause, and resume the screen mirroring as a sink.

public class ScreenMirroring : IDisposable

Inheritance: Object

ScreenMirroring

Implements: IDisposable

Constructors

View Source

ScreenMirroring()

Initializes a new instance of the ScreenMirroring class.

Declaration

public ScreenMirroring()

Exceptions

Type	Condition
NotSupportedException	The feature is not supported.

API Level: 4

Feature: http://tizen.org/feature/network.wifi.direct.display

Properties

View Source

AudioInfo

Gets the negotiated audio info.

Declaration

public ScreenMirroringAudioInfo AudioInfo { get; }

Property Value

Type	Description
ScreenMirroringAudioInfo

API Level: 4

View Source

VideoInfo

Gets the negotiated video info.

Declaration

public ScreenMirroringVideoInfo VideoInfo { get; }

Property Value

Type	Description
ScreenMirroringVideoInfo

API Level: 4

Methods

View Source

ConnectAsync(String)

Creates the connection and ready for receiving data from a mirroring source.

Declaration

public Task ConnectAsync(string sourceIp)

Parameters

Type	Name	Description
String	sourceIp	The source ip address to connect.

Returns

Type	Description
Task	A task that represents the asynchronous operation.

Remarks

The state must be Prepared state by Prepare(Display, ScreenMirroringResolutions).

Exceptions

Type	Condition
ArgumentNullException	`sourceIp` is null.
InvalidOperationException	The current state is not in the valid. -or- An internal error occurs.
ArgumentException	`sourceIp` is a zero-length string, contains only white space.
ObjectDisposedException	The ScreenMirroring has already been disposed.
UnauthorizedAccessException	Caller does not have required permission.

API Level: 4

Privilege Level: public

Privilege: http://tizen.org/privilege/internet

View Source

Disconnect()

Disconnects from the source.

Declaration

public void Disconnect()

Remarks

The state must be Connected, Playing or Paused.

Exceptions

Type	Condition
InvalidOperationException	The current state is not in the valid. -or- An internal error occurs.
ObjectDisposedException	The ScreenMirroring has already been disposed.
UnauthorizedAccessException	Caller does not have required permission.

API Level: 4

Privilege Level: public

Privilege: http://tizen.org/privilege/internet

View Source

Dispose()

Releases all resource used by the ScreenMirroring object.

Declaration

public void Dispose()

Remarks

Call Dispose() when you are finished using the ScreenMirroring. The Dispose() method leaves the ScreenMirroring in an unusable state. After calling Dispose(), you must release all references to the ScreenMirroring so the garbage collector can reclaim the memory that the ScreenMirroring was occupying.

API Level: 4

View Source

Dispose(Boolean)

Releases the resources used by the ScreenMirroring.

Declaration

protected virtual void Dispose(bool disposing)

Parameters

Type	Name	Description
Boolean	disposing	true to release both managed and unmanaged resources; false to release only unmanaged resources.

API Level: 4

View Source

Finalize()

Finalizes an instance of the ScreenMirroring class.

Declaration

protected void Finalize()

View Source

PauseAsync()

Pauses mirroring from the source.

Declaration

public Task PauseAsync()

Returns

Type	Description
Task	A task that represents the asynchronous operation.

Remarks

The state must be Playing state by StartAsync().

Exceptions

Type	Condition
InvalidOperationException	The current state is not in the valid. -or- An internal error occurs.
ObjectDisposedException	The ScreenMirroring has already been disposed.
UnauthorizedAccessException	Caller does not have required permission.

API Level: 4

Privilege Level: public

Privilege: http://tizen.org/privilege/internet

View Source

Prepare(Display)

Prepares the screen mirroring with the specified display.

Declaration

public void Prepare(Display display)

Parameters

Type	Name	Description
Display	display	The display where the mirroring will be played on.

Remarks

The state must be Idle.

All supported resolutions will be candidates.

Exceptions

Type	Condition
ArgumentException	`display` has already been assigned to another.
ArgumentNullException	`display` is null.
InvalidOperationException	The current state is not in the valid. -or- An internal error occurs.
ObjectDisposedException	The ScreenMirroring has already been disposed.

API Level: 4

View Source

Prepare(Display, ScreenMirroringResolutions)

Prepares the screen mirroring with the specified display and resolutions.

Declaration

public void Prepare(Display display, ScreenMirroringResolutions resolutions)

Parameters

Type	Name	Description
Display	display	The display where the mirroring will be played on.
ScreenMirroringResolutions	resolutions	The desired resolutions.

Remarks

The state must be Idle.

Exceptions

Type	Condition
ArgumentException	`resolutions` contain invalid flags. -or- `display` has already been assigned to another.
ArgumentNullException	`display` is null.
InvalidOperationException	The current state is not in the valid. -or- An internal error occurs.
ObjectDisposedException	The ScreenMirroring has already been disposed.

API Level: 4

View Source

ResumeAsync()

Resumes mirroring from the source.

Declaration

public Task ResumeAsync()

Returns

Type	Description
Task	A task that represents the asynchronous operation.

Remarks

The state must be Paused state by PauseAsync().

Exceptions

Type	Condition
InvalidOperationException	The current state is not in the valid. -or- An internal error occurs.
ObjectDisposedException	The ScreenMirroring has already been disposed.
UnauthorizedAccessException	Caller does not have required permission.

API Level: 4

Privilege Level: public

Privilege: http://tizen.org/privilege/internet

View Source

StartAsync()

Starts mirroring from the source.

Declaration

public Task StartAsync()

Returns

Type	Description
Task	A task that represents the asynchronous operation.

Remarks

The state must be Connected state by ConnectAsync(String).

Exceptions

Type	Condition
InvalidOperationException	The current state is not in the valid. -or- An internal error occurs.
ObjectDisposedException	The ScreenMirroring has already been disposed.
UnauthorizedAccessException	Caller does not have required permission.

API Level: 4

Privilege Level: public

Privilege: http://tizen.org/privilege/internet

View Source

Unprepare()

Unprepares the screen mirroring.

Declaration

public void Unprepare()

Remarks

The state must be Prepared, or Disconnected.

Exceptions

Type	Condition
InvalidOperationException	The current state is not in the valid. -or- An internal error occurs.
ObjectDisposedException	The ScreenMirroring has already been disposed.

API Level: 4

Events

View Source

ErrorOccurred

Occurs when an error occurs.

Declaration

public event EventHandler<ScreenMirroringErrorOccurredEventArgs> ErrorOccurred

Event Type

Type	Description
EventHandler<ScreenMirroringErrorOccurredEventArgs>

API Level: 4

View Source

StateChanged

Occurs when the state is changed.

Declaration

public event EventHandler<ScreenMirroringStateChangedEventArgs> StateChanged

Event Type

Type	Description
EventHandler<ScreenMirroringStateChangedEventArgs>

API Level: 4

Implements

System.IDisposable