RemoteSystemSessionWatcher Classe

Definizione

Spazio dei nomi:

Windows.System.RemoteSystems

Controlla l'attività correlata all'individuazione di sessioni remote e genera gli eventi appropriati.

public ref class RemoteSystemSessionWatcher sealed

/// [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)]
public sealed class RemoteSystemSessionWatcher

Public NotInheritable Class RemoteSystemSessionWatcher

Ereditarietà

Object Platform::Object IInspectable RemoteSystemSessionWatcher

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 Creators Update (è stato introdotto in 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v4.0)
Funzionalità dell'app	remoteSystem

Esempio

Vedere l'esempio di codice seguente per il processo di individuazione di una sessione remota.

// 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();
}

Commenti

Questa classe viene creata un'istanza quando viene chiamato il metodo RemoteSystemSession.CreateWatcher .

Importante

È necessario confermare l'accesso alla piattaforma di sistema remota con una chiamata a RemoteSystem.RequestAccessAsync prima di creare un'istanza di questa classe.

Importante

Le condizioni seguenti devono essere soddisfatte affinché l'individuazione sessione remota funzioni come previsto:

1. Il Bluetooth deve essere attivato sia per i dispositivi client che per i dispositivi host. L'individuazione delle sessioni può funzionare tramite l'individuazione LAN, ma non è garantita (dipende dalla configurazione di rete).
2. Nell'app Impostazioni nel dispositivo host l'impostazione Condividi tra dispositivi in Sistema -> Esperienze condivise deve essere impostata su "Tutti nelle vicinanze".
3. Le app client e host devono avere lo stesso PackageFamilyName.

Proprietà

Status

Ottiene lo stato operativo di questo watcher sessione remoto.

Metodi

Start()	Inizia a guardare per le sessioni remote individuabili. Il processo di individuazione viene eseguito fino a quando non viene chiamato il metodo Stop . Un oggetto RemoteSystemSessionWatcher può chiamare nuovamente il metodo Start in un secondo momento.
Stop()	Arresta la ricerca di sessioni remote individuabili.

Eventi

Added	Generato quando una nuova sessione remota è stata individuata da RemoteSystemSessionWatcher.
Removed	Generato quando una sessione remota individuata in precedenza è scomparsa.
Updated	Generato quando una sessione remota individuata in precedenza include alcune informazioni aggiornate.