Condividi tramite

RemoteSystemSessionWatcher Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.System.RemoteSystems
Modifica

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)]
/// [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 RemoteSystemSessionWatcher
Public NotInheritable Class RemoteSystemSessionWatcher
Ereditarietà
Object Platform::Object IInspectable RemoteSystemSessionWatcher
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Si applica a