Windows.Media.PlayTo namespace
Supports the streaming of audio, video, and images to remote devices.
Members
The Windows.Media.PlayTo namespace has these types of members:
Classes
The Windows.Media.PlayTo namespace has these classes.
| Class | Description |
|---|---|
| MuteChangeRequestedEventArgs | Provides information about the MuteChangeRequested event. |
| PlayToConnection | Provides information about a Play To connection. |
| PlayToConnectionErrorEventArgs | Provides information about the Error event. |
| PlayToConnectionStateChangedEventArgs | Provides information about the StateChanged event. |
| PlayToConnectionTransferredEventArgs | Provides information about the Transferred event. |
| PlayToManager | Provides access to Play To capabilities. |
| PlayToReceiver | Represents a Play To target. |
| PlayToSource | Represents a media element to connect to a Play To target. |
| PlayToSourceDeferral | Represents a deferred operation when you're supplying a source media element for Play To. |
| PlayToSourceRequest | Represents a request to connect a media element with a Play To target. |
| PlayToSourceRequestedEventArgs | Provides information about the SourceRequested event. |
| PlayToSourceSelectedEventArgs | Provides information about the SourceSelected event. |
| SourceChangeRequestedEventArgs | Provides information about the SourceChangeRequested event. |
Enumerations
The Windows.Media.PlayTo namespace has these enumerations.
| Enumeration | Description |
|---|---|
| PlayToConnectionError | Describes an error on a Play To connection. |
| PlayToConnectionState | Describes the status of a Play To connection. |
Structures
The Windows.Media.PlayTo namespace has these structures.
| Structure | Description |
|---|---|
| CurrentTimeChangeRequestedEventArgs | Provides information about the CurrentTimeChangeRequested event. |
| PlaybackRateChangeRequestedEventArgs | Provides information about the PlaybackRateChangeRequested event. |
| VolumeChangeRequestedEventArgs | Provides information about the VolumeChangeRequested event. |
Remarks
You can use Play To to enable users to easily stream audio, video, or images from their computer to devices in their home network. For example, a user who's watching a video in your application can stream that video to his or her TV so that everyone in the room can view it.
Play To streams audio, video, or images to a certified Play To receiver.
Play To is part of the Devices charm. For applications that contain audio, video, or images, users open the Devices charm to select devices from their home network that they can stream the media content to.
To enable Play To in your application, register for the SourceRequested event. To register for the SourceRequested event, get a reference to the current PlayToManagerclass by calling the GetForCurrentView method. You can then call addEventHandler on the PlayToManagerclass to associate your event handler with the SourceRequested event. In your event handler, pass the media element from your application to the SetSource method of the PlayToSourceRequestedEventArgs object that was passed to the event handler.
When a user selects a Play To target from the Devices charm, Play To fires the SourceRequested event. Play To then streams the media element that was passed to the SetSource method to the target device that the user has selected.
For an example of how to use Play To in an application, see Quickstart: Using Play To in applications (JavaScript) or Quickstart: Using Play To in applications (C#/VB).
Examples
// Play To Contract private Windows.Media.PlayTo.PlayToManager ptm = Windows.Media.PlayTo.PlayToManager.GetForCurrentView(); protected override void OnNavigatedTo(NavigationEventArgs e) { ptm.SourceRequested += sourceRequestHandler; } private void sourceRequestHandler( Windows.Media.PlayTo.PlayToManager sender, Windows.Media.PlayTo.PlayToSourceRequestedEventArgs e) { try { e.SourceRequest.SetSource(mediaElement.PlayToSource); } catch (Exception ex) { messageBlock.Text += "Exception encountered: " + ex.Message + "\n"; } }
Requirements
|
Minimum supported client | Windows 8 |
|---|---|
|
Minimum supported server | Windows Server 2012 |
|
Namespace |
|
|
Metadata |
|
See also
Build date: 12/4/2012
