5 out of 8 rated this helpful - Rate this topic

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.

ClassDescription
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.

EnumerationDescription
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.

StructureDescription
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

Windows.Media.PlayTo
Windows::Media::PlayTo [C++]

Metadata

Windows.winmd

See also

Samples
Play To sample
PlayToReceiver sample
Media Server sample

 

 

Build date: 12/4/2012

© 2013 Microsoft. All rights reserved.