PlayToReceiver Classe

Référence

Définition

Espace de noms:: Windows.Media.PlayTo

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Représente une cible Play To.

public ref class PlayToReceiver sealed

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class PlayToReceiver final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class PlayToReceiver final

[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class PlayToReceiver

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class PlayToReceiver

function PlayToReceiver()

Public NotInheritable Class PlayToReceiver

Héritage: Object Platform::Object IInspectable PlayToReceiver

Attributs: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	privateNetworkClientServer

Remarques

Vous pouvez utiliser la classe PlayToReceiver pour créer un récepteur play to personnalisé qui est un convertisseur multimédia numérique pour les ordinateurs de votre réseau. Vous pouvez inclure un objet PlayToReceiver dans votre application pour gérer la communication avec les ordinateurs clients Play To, puis lire ou afficher le contenu diffusé à partir de ces ordinateurs à l’aide de vos propres éléments multimédias ou contrôles.

Les membres de la classe PlayToReceiver se composent des éléments suivants :

Propriété FriendlyName qui identifie le nom du récepteur Lire à lorsqu’il est publié sur le réseau.
Propriétés qui identifient le type de média pris en charge par votre récepteur Lecture à : SupportsAudio, SupportsVideo, SupportsImage.
Méthode StartAsync qui démarre le récepteur Lire à et le publie sur le réseau en tant que convertisseur multimédia numérique. Méthode StopAsync qui arrête le récepteur Lire à et arrête sa publicité sur le réseau.
Événement SourceChangeRequested qui se produit lorsque vous recevez un flux multimédia à partir d’un ordinateur, et des événements qui se produisent lorsqu’une action est demandée par l’ordinateur client Lire sur l’ordinateur client, comme un changement de volume, ou une modification de l’emplacement de lecture du média diffusé : CurrentTimeChangeRequested, MuteChangeRequested, PauseRequested, PlayRequested, StopRequested, VolumeChangeRequested, TimeUpdateRequested.
Méthodes que vous pouvez appeler pour notifier le client Play To lorsqu’une modification se produit pour votre récepteur Play To : NotifyDurationChange, NotifyEnded, NotifyError, NotifyLoadedMetadata, NotifyPaused, NotifyPlaying, NotifyRateChange, NotifySeeked, NotifySeeking, NotifySetopped, NotifyTimeUpdate, NotifyVolumeChange.

Dans Lire à, la vidéo démarre à partir de la position actuelle. Si vous souhaitez démarrer la vidéo à partir du début, il vous suffit de rechercher le début de la vidéo dès que la connexion Lire à est établie.

Pour obtenir un exemple de création d’un récepteur lecture sur un logiciel, consultez Casting multimédia.

Windows.Media.PlayTo.PlayToReceiver receiver;
Windows.System.Display.DisplayRequest display;
Windows.UI.Core.CoreDispatcher dispatcher;
bool seeking = false;

private async void StartReceiverButton_Click(object sender, RoutedEventArgs e)
{
    try
    {
        dispatcher = Window.Current.CoreWindow.Dispatcher;

        if (receiver == null)
        {
            receiver = new Windows.Media.PlayTo.PlayToReceiver();
        }

        // Add Play To Receiver events and properties
        receiver.CurrentTimeChangeRequested += receiver_CurrentTimeChangeRequested;
        receiver.MuteChangeRequested += receiver_MuteChangeRequested;
        receiver.PauseRequested += receiver_PauseRequested;
        receiver.PlaybackRateChangeRequested += receiver_PlaybackRateChangeRequested;
        receiver.PlayRequested += receiver_PlayRequested;
        receiver.SourceChangeRequested += receiver_SourceChangeRequested;
        receiver.StopRequested += receiver_StopRequested;
        receiver.TimeUpdateRequested += receiver_TimeUpdateRequested;
        receiver.VolumeChangeRequested += receiver_VolumeChangeRequested;

        receiver.FriendlyName = "Sample Play To Receiver";
        receiver.SupportsAudio = false;
        receiver.SupportsVideo = true;
        receiver.SupportsImage = false;

        // Add MediaElement events
        VideoPlayer.CurrentStateChanged += VideoPlayer_CurrentStateChanged;
        VideoPlayer.MediaEnded += VideoPlayer_MediaEnded;
        VideoPlayer.MediaFailed += VideoPlayer_MediaFailed;
        VideoPlayer.MediaOpened += VideoPlayer_MediaOpened;
        VideoPlayer.RateChanged += VideoPlayer_RateChanged;
        VideoPlayer.SeekCompleted += VideoPlayer_SeekCompleted;
        VideoPlayer.VolumeChanged += VideoPlayer_VolumeChanged;

        // Advertise the receiver on the local network and start receiving commands
        await receiver.StartAsync();

        // Prevent the screen from locking
        if (display == null)
            display = new Windows.System.Display.DisplayRequest();
        display.RequestActive();

        StatusTextBlock.Text = "'" + receiver.FriendlyName + "' started.";
    }
    catch
    {
        receiver = null;
        StatusTextBlock.Text = "Failed to start receiver.";
    }
}

private async void StopReceiverButton_Click(object sender, RoutedEventArgs e)
{
    try
    {
        if (receiver != null)
        {
            await receiver.StopAsync();

            if (display != null)
                display.RequestRelease();

            // Remove Play To Receiver events
            receiver.CurrentTimeChangeRequested -= receiver_CurrentTimeChangeRequested;
            receiver.MuteChangeRequested -= receiver_MuteChangeRequested;
            receiver.PauseRequested -= receiver_PauseRequested;
            receiver.PlaybackRateChangeRequested -= receiver_PlaybackRateChangeRequested;
            receiver.PlayRequested -= receiver_PlayRequested;
            receiver.SourceChangeRequested -= receiver_SourceChangeRequested;
            receiver.StopRequested -= receiver_StopRequested;
            receiver.TimeUpdateRequested -= receiver_TimeUpdateRequested;
            receiver.VolumeChangeRequested -= receiver_VolumeChangeRequested;

            //  Remove MediaElement events
            VideoPlayer.Pause();

            VideoPlayer.CurrentStateChanged -= VideoPlayer_CurrentStateChanged;
            VideoPlayer.MediaEnded -= VideoPlayer_MediaEnded;
            VideoPlayer.MediaFailed -= VideoPlayer_MediaFailed;
            VideoPlayer.MediaOpened -= VideoPlayer_MediaOpened;
            VideoPlayer.RateChanged -= VideoPlayer_RateChanged;
            VideoPlayer.SeekCompleted -= VideoPlayer_SeekCompleted;
            VideoPlayer.VolumeChanged -= VideoPlayer_VolumeChanged;

            StatusTextBlock.Text = "Stopped '" + receiver.FriendlyName + "'.";
        }
    }
    catch
    {
        StatusTextBlock.Text = "Failed to stop '" + receiver.FriendlyName + "'.";
    }
}

Private receiver As Windows.Media.PlayTo.PlayToReceiver
Private display As Windows.System.Display.DisplayRequest
Private seeking As Boolean = False

Private Async Sub StartReceiverButton_Click()
    Try
        If receiver Is Nothing Then
            receiver = New Windows.Media.PlayTo.PlayToReceiver()
        End If

        ' Add Play To Receiver events and properties
        AddHandler receiver.CurrentTimeChangeRequested, AddressOf receiver_CurrentTimeChangeRequested
        AddHandler receiver.MuteChangeRequested, AddressOf receiver_MuteChangeRequested
        AddHandler receiver.PauseRequested, AddressOf receiver_PauseRequested
        AddHandler receiver.PlaybackRateChangeRequested, AddressOf receiver_PlaybackRateChangeRequested
        AddHandler receiver.PlayRequested, AddressOf receiver_PlayRequested
        AddHandler receiver.SourceChangeRequested, AddressOf receiver_SourceChangeRequested
        AddHandler receiver.StopRequested, AddressOf receiver_StopRequested
        AddHandler receiver.TimeUpdateRequested, AddressOf receiver_TimeUpdateRequested
        AddHandler receiver.VolumeChangeRequested, AddressOf receiver_VolumeChangeRequested

        receiver.FriendlyName = "Sample Play To Receiver"
        receiver.SupportsAudio = False
        receiver.SupportsVideo = True
        receiver.SupportsImage = False

        ' Add MediaElement events
        AddHandler VideoPlayer.CurrentStateChanged, AddressOf VideoPlayer_CurrentStateChanged
        AddHandler VideoPlayer.MediaEnded, AddressOf VideoPlayer_MediaEnded
        AddHandler VideoPlayer.MediaFailed, AddressOf VideoPlayer_MediaFailed
        AddHandler VideoPlayer.MediaOpened, AddressOf VideoPlayer_MediaOpened
        AddHandler VideoPlayer.RateChanged, AddressOf VideoPlayer_RateChanged
        AddHandler VideoPlayer.SeekCompleted, AddressOf VideoPlayer_SeekCompleted
        AddHandler VideoPlayer.VolumeChanged, AddressOf VideoPlayer_VolumeChanged

        ' Advertise the receiver on the local network and start receiving commands
        Await receiver.StartAsync()

        ' Prevent the screen from locking
        If display Is Nothing Then
            display = New Windows.System.Display.DisplayRequest()
            display.RequestActive()

            StatusTextBlock.Text = "'" & receiver.FriendlyName & "' started."
        End If
    Catch
        receiver = Nothing
        StatusTextBlock.Text = "Failed to start receiver. "
    End Try
End Sub

Private Async Sub StopReceiverButton_Click()
    Try
        If receiver IsNot Nothing Then
            Await receiver.StopAsync()

            If display IsNot Nothing Then display.RequestRelease()

            ' Remove Play To Receiver events
            RemoveHandler receiver.CurrentTimeChangeRequested, AddressOf receiver_CurrentTimeChangeRequested
            RemoveHandler receiver.MuteChangeRequested, AddressOf receiver_MuteChangeRequested
            RemoveHandler receiver.PauseRequested, AddressOf receiver_PauseRequested
            RemoveHandler receiver.PlaybackRateChangeRequested, AddressOf receiver_PlaybackRateChangeRequested
            RemoveHandler receiver.PlayRequested, AddressOf receiver_PlayRequested
            RemoveHandler receiver.SourceChangeRequested, AddressOf receiver_SourceChangeRequested
            RemoveHandler receiver.StopRequested, AddressOf receiver_StopRequested
            RemoveHandler receiver.TimeUpdateRequested, AddressOf receiver_TimeUpdateRequested
            RemoveHandler receiver.VolumeChangeRequested, AddressOf receiver_VolumeChangeRequested

            '  Remove MediaElement events
            VideoPlayer.Pause()

            RemoveHandler VideoPlayer.CurrentStateChanged, AddressOf VideoPlayer_CurrentStateChanged
            RemoveHandler VideoPlayer.MediaEnded, AddressOf VideoPlayer_MediaEnded
            RemoveHandler VideoPlayer.MediaFailed, AddressOf VideoPlayer_MediaFailed
            RemoveHandler VideoPlayer.MediaOpened, AddressOf VideoPlayer_MediaOpened
            RemoveHandler VideoPlayer.RateChanged, AddressOf VideoPlayer_RateChanged
            RemoveHandler VideoPlayer.SeekCompleted, AddressOf VideoPlayer_SeekCompleted
            RemoveHandler VideoPlayer.VolumeChanged, AddressOf VideoPlayer_VolumeChanged

            StatusTextBlock.Text = "Stopped '" & receiver.FriendlyName & "'."
        End If
    Catch
        StatusTextBlock.Text = "Failed to stop '" & receiver.FriendlyName & "'."
    End Try
End Sub

Les applications PlayTo ne sont pas suspendues tant que la vidéo ou la musique sont lues sur le récepteur Lire à ou que les images sont continuellement envoyées au récepteur Lire à. Les applications disposent d’environ 10 secondes pour envoyer une nouvelle image après l’affichage de l’image actuelle et environ 10 secondes pour envoyer l’audio ou la vidéo suivante une fois la dernière image terminée.

Notes

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX) et Using Windows Runtime objects in a multithreaded environment (.NET).

Constructeurs

PlayToReceiver()

Crée une instance d’un récepteur Lire à.

Propriétés

FriendlyName	Obtient ou définit le nom d’affichage de la cible Lire à.
Properties	Obtient un ensemble de propriétés personnalisées pour le récepteur Lire à.
SupportsAudio	Obtient ou définit une valeur qui indique si la cible Lire à prend en charge l’audio.
SupportsImage	Obtient ou définit une valeur qui indique si la cible Lire à prend en charge les images.
SupportsVideo	Obtient ou définit une valeur qui indique si la cible Lire à prend en charge la vidéo.

Méthodes

NotifyDurationChange(TimeSpan)	Avertit le récepteur Lire à que la durée de lecture audio ou vidéo a changé.
NotifyEnded()	Avertit le récepteur Lire à que la lecture audio ou vidéo est terminée.
NotifyError()	Avertit le récepteur Lire à qu’une erreur s’est produite lors de l’affichage ou de la lecture du média.
NotifyLoadedMetadata()	Avertit le récepteur Lire à que le chargement des métadonnées du média est terminé.
NotifyPaused()	Avertit le récepteur Lire à que la lecture audio ou vidéo a été suspendue.
NotifyPlaying()	Avertit le récepteur Lire sur que la lecture audio ou vidéo a démarré.
NotifyRateChange(Double)	Avertit le récepteur Lire à que le taux de lecture audio ou vidéo a changé.
NotifySeeked()	Avertit le récepteur Lire à que l’élément de lecture audio ou vidéo a démarré à un nouvel emplacement de lecture.
NotifySeeking()	Avertit le récepteur Lire à que l’élément de lecture audio ou vidéo recherche un nouvel emplacement de lecture.
NotifyStopped()	Avertit le récepteur Lire à que la lecture audio ou vidéo s’est arrêtée.
NotifyTimeUpdate(TimeSpan)	Avertit le récepteur Lire à que l’emplacement d’heure de la lecture audio ou vidéo a changé.
NotifyVolumeChange(Double, Boolean)	Avertit le récepteur Lire à que le volume de la lecture audio ou vidéo a changé.
StartAsync()	Commencez à recevoir des commandes Lire à.
StopAsync()	Arrêtez de recevoir des commandes Lire à.

Événements

CurrentTimeChangeRequested	Se produit lorsque l’emplacement de la lecture a changé.
MuteChangeRequested	Se produit lorsque l’audio a été désactivé ou désactivé.
PauseRequested	Se produit lorsque la lecture audio ou vidéo a été suspendue.
PlaybackRateChangeRequested	Se produit lorsque le taux de lecture audio ou vidéo a changé.
PlayRequested	Se produit lorsque la lecture audio ou vidéo démarre.
SourceChangeRequested	Se produit lorsque le média source du récepteur Lire à a changé.
StopRequested	Se produit lorsqu’une demande a été faite pour que le récepteur Lire à cesse de lire le média diffusé en continu.
TimeUpdateRequested	Se produit lorsque la position de lecture actuelle a changé.
VolumeChangeRequested	Se produit lorsque le volume de l’audio ou de la vidéo source a changé.

S’applique à

Partager via