Windows.Media.PlayTo Namespace

Supports the streaming of audio, video, and images to remote devices.

Classes

CurrentTimeChangeRequestedEventArgs	Provides information about the CurrentTimeChangeRequested event.
MuteChangeRequestedEventArgs	Provides information about the MuteChangeRequested event.
PlaybackRateChangeRequestedEventArgs	Provides information about the PlaybackRateChangeRequested 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.
VolumeChangeRequestedEventArgs	Provides information about the VolumeChangeRequested event.

Enums

PlayToConnectionError	Describes an error on a Play To connection.
PlayToConnectionState	Describes the status of a Play To connection.

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";
    }
}

' Play To Contract

Private ptm As Windows.Media.PlayTo.PlayToManager =
        Windows.Media.PlayTo.PlayToManager.GetForCurrentView()

Protected Overrides Sub OnNavigatedTo(e As Navigation.NavigationEventArgs)
    AddHandler ptm.SourceRequested, AddressOf sourceRequestHandler
End Sub

Private Sub sourceRequestHandler(
    sender As Windows.Media.PlayTo.PlayToManager,
    e As Windows.Media.PlayTo.PlayToSourceRequestedEventArgs)

    Try
        e.SourceRequest.SetSource(mediaElement.PlayToSource)
    Catch ex As Exception
        messageBlock.Text &= "Exception encountered: " & ex.Message & vbCrLf
    End Try
End Sub

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 PlayToManager class by calling the GetForCurrentView method. You can then call addEventHandler on the PlayToManager class 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 PlayReady DRM.

See also

• Play To sample
• PlayToReceiver sample
• Media Server sample