PlayToManager PlayToManager PlayToManager PlayToManager Class


Provides access to Play To capabilities.

public : sealed class PlayToManager : IPlayToManagerpublic sealed class PlayToManager : IPlayToManagerPublic NotInheritable Class PlayToManager Implements IPlayToManager// You can use this class in JavaScript.
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


// Play To Contract

private Windows.Media.PlayTo.PlayToManager ptm = 

protected override void OnNavigatedTo(NavigationEventArgs e)
    ptm.SourceRequested += sourceRequestHandler;

private void sourceRequestHandler(
    Windows.Media.PlayTo.PlayToManager sender,
    Windows.Media.PlayTo.PlayToSourceRequestedEventArgs e)
    catch (Exception ex)
        messageBlock.Text += "Exception encountered: " + ex.Message + "\n";
// Play To Contract

var ptm = Windows.Media.PlayTo.PlayToManager.getForCurrentView();
ptm.addEventListener("sourcerequested", sourceRequestHandler, false);

function sourceRequestHandler(e) {
    try {

    } catch (ex) {
        id("messageDiv").innerHTML += "Exception encountered: " + ex.message + "<br/>";
' Play To Contract

Private ptm As Windows.Media.PlayTo.PlayToManager =

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)

    Catch ex As Exception
        messageBlock.Text &= "Exception encountered: " & ex.Message & vbCrLf
    End Try
End Sub


If your application includes audio, video, or image elements, users can stream the media source for those elements to a Play To target device. You can use the PlayToManager class to customize the Play To experience for users. You can disable the default behavior by using the DefaultSourceSelection property.You can select which media is streamed by using the SourceRequested event. And you can display the Play To UI in place of the Devices charm by using the ShowPlayToUI method.

In Play To, video starts from the current position. If you want to start the video from the beginning, simply seek to the beginning of the video as soon as the Play To connection is established.

PlayTo apps will not be suspended as long as video or music is playing on the Play To receiver or images are continuously sent to the Play To receiver. Apps have approximately 10 seconds to send a new image after the current one is displayed and approximately 10 seconds to send the next audio or video after the current one has ended.

For an example of how to use Play To in an application, see Quickstart: Using Play To in applications (JavaScript) or PlayReady DRM.


DefaultSourceSelection DefaultSourceSelection DefaultSourceSelection DefaultSourceSelection

Enables or disables the default source selection for Play To.

public : PlatForm::Boolean DefaultSourceSelection { get; set; }public bool DefaultSourceSelection { get; set; }Public ReadWrite Property DefaultSourceSelection As bool// You can use this property in JavaScript.
PlatForm::Boolean bool bool bool

True to enable default source selection; otherwise false. The default is true.


An app that contains media elements has Play To enabled by default. If a user invokes the Devices charm while running the app and selects a target device to stream media to, Play To will stream the media from the first audio, video, or image element on the current page. You can disable this default behavior by setting the DefaultSourceSelection property to false.

var ptm = Windows.Media.PlayTo.PlayToManager.getForCurrentView();
ptm.defaultSourceSelection = false;

You can exclude individual HTML elements from the default Play To behavior by adding the -ms-playToDisabled attribute in your HTML markup.

<video src="" x-ms-playToDisabled/>
See Also


GetForCurrentView() GetForCurrentView() GetForCurrentView() GetForCurrentView()

Gets the Play To manager for the current view.

public : static PlayToManager GetForCurrentView()public static PlayToManager GetForCurrentView()Public Static Function GetForCurrentView() As PlayToManager// You can use this method in JavaScript.

The Play To manager for the current view.


You can use the PlayToManager instance for the current view to establish the Play To contract for the app and customize which media Play To streams to a target device. You supply the media to be streamed during the SourceRequested event by using the SetSource method.

See Also

ShowPlayToUI() ShowPlayToUI() ShowPlayToUI() ShowPlayToUI()

Displays the Play To UI.

public : static void ShowPlayToUI()public static void ShowPlayToUI()Public Static Function ShowPlayToUI() As void// You can use this method in JavaScript.


By default, users invoke the Devices charm to select a Play To target device to stream media to. You can also display the UI to enable users to select a Play To target device by using the ShowPlayToUI method.

See Also


SourceRequested SourceRequested SourceRequested SourceRequested

Occurs when a user requests media to stream to a Play To target device.

public : event TypedEventHandler SourceRequested<PlayToManager,  PlayToSourceRequestedEventArgs>public event TypedEventHandler SourceRequested<PlayToManager,  PlayToSourceRequestedEventArgs>Public Event SourceRequested<PlayToManager,  PlayToSourceRequestedEventArgs>// You can use this event in JavaScript.


The SourceRequested event is fired when a user selects the Devices charm in a Play To– enabled application. You supply the audio, video, or image that Play To will stream to a target device during the SourceRequested event.

If you do not supply a media source within 200 milliseconds, the SourceRequested event will time out and the Devices charm will not display any Play To targets for your app.

The SourceRequested event occurs before the user selects the target device. After the user has selected the target device, the SourceSelected event is fired. If the user exits the Devices charm without selecting a target device, the SourceSelected event isn't fired.

See Also

SourceSelected SourceSelected SourceSelected SourceSelected

Occurs when a Play To source element has been selected.

public : event TypedEventHandler SourceSelected<PlayToManager,  PlayToSourceSelectedEventArgs>public event TypedEventHandler SourceSelected<PlayToManager,  PlayToSourceSelectedEventArgs>Public Event SourceSelected<PlayToManager,  PlayToSourceSelectedEventArgs>// You can use this event in JavaScript.


In a Play To– enabled app, the user selects the Devices charm (or the Play To UI) to stream audio, video, or images from the app to a target device. The SourceSelected event is fired after the user has selected a target device. If the user exits the Devices charm or the Play To UI without selecting a target device, the SourceSelected event isn't fired.

See Also

See Also