RemoteSystemSessionWatcher Classe
Définition
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.
Surveille l’activité liée à la découverte de sessions à distance et déclenche les événements appropriés.
public ref class RemoteSystemSessionWatcher sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RemoteSystemSessionWatcher final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RemoteSystemSessionWatcher final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class RemoteSystemSessionWatcher[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RemoteSystemSessionWatcherPublic NotInheritable Class RemoteSystemSessionWatcher- Héritage
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 Creators Update (introduit dans 10.0.15063.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v4.0)
|
| Fonctionnalités de l’application |
remoteSystem
|
Exemples
Consultez l’exemple de code ci-dessous pour connaître le processus de découverte d’une session distante.
// Discover an existing shared experience.
public void DiscoverExistingSessions() {
// create a watcher for remote system sessions
RemoteSystemSessionWatcher sessionWatcher = RemoteSystemSession.CreateWatcher();
// register a handler for the "added" event
sessionWatcher.Added += async (sender, args) => {
// get a reference to the info about the discovered session
RemoteSystemSessionInfo sessionInfo = args.RemoteSystemSessionInfo;
// update the UI with the sessionInfo.DisplayName and
// sessionInfo.ControllerDisplayName strings. Save a reference to
// this RemoteSystemSessionInfo, to use when the user selects
// this session from the UI
//...
};
// Begin watching
sessionWatcher.Start();
}
Remarques
Cette classe est instanciée lorsque la méthode RemoteSystemSession.CreateWatcher est appelée.
Important
Vous devez confirmer l’accès à la plateforme système distante avec un appel à RemoteSystem.RequestAccessAsync avant d’instancier cette classe.
Important
Les conditions suivantes doivent être remplies pour que la découverte de session à distance fonctionne comme prévu :
- Bluetooth doit être activé pour les appareils client et hôte. La découverte de session peut fonctionner via la découverte LAN, mais elle n’est pas garantie (elle dépend de la configuration réseau).
- Dans l’application Paramètres sur l’appareil hôte, le paramètre Partager entre les appareils sous Système -> Expériences partagées doit être défini sur « Tout le monde à proximité ».
- Les applications clientes et hôtes doivent avoir le même PackageFamilyName.
Propriétés
| Status |
Obtient la status opérationnelle de cet observateur de session à distance. |
Méthodes
| Start() |
Commence à regarder les sessions à distance détectables. Le processus de découverte s’exécute jusqu’à ce que la méthode Stop soit appelée. Un objet RemoteSystemSessionWatcher peut avoir sa méthode Start appelée à nouveau ultérieurement. |
| Stop() |
Arrête l’observation des sessions à distance détectables. |
Événements
| Added |
Déclenché lorsqu’une nouvelle session à distance a été découverte par RemoteSystemSessionWatcher. |
| Removed |
Déclenché lorsqu’une session distante précédemment découverte a disparu. |
| Updated |
Déclenché lorsqu’une session à distance précédemment découverte a une partie de ses informations mises à jour. |