RemoteSystemSessionWatcher Clase

Definición

Espacio de nombres:

Windows.System.RemoteSystems

Supervisa la actividad relacionada con la detección de sesiones remotas y genera los eventos adecuados.

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

Herencia

Object Platform::Object IInspectable RemoteSystemSessionWatcher

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)
Características de aplicaciones	remoteSystem

Ejemplos

Consulte el ejemplo de código siguiente para ver el proceso de detección de una sesión 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();
}

Comentarios

Se crea una instancia de esta clase cuando se llama al método RemoteSystemSession.CreateWatcher .

Importante

Debe confirmar el acceso a la plataforma del sistema remoto con una llamada a RemoteSystem.RequestAccessAsync antes de crear una instancia de esta clase.

Importante

Se deben cumplir las condiciones siguientes para que la detección remota de sesiones funcione según lo previsto:

1. Bluetooth debe estar activado tanto para el cliente como para los dispositivos host. La detección de sesiones puede funcionar a través de la detección de LAN, pero no está garantizada (depende de la configuración de red).
2. En la aplicación Configuración del dispositivo host, la opción Compartir entre dispositivos en Experiencias compartidas del sistema> debe establecerse en "Todos los usuarios cercanos".
3. Las aplicaciones cliente y host deben tener el mismo packageFamilyName.

Propiedades

Status

Obtiene el estado operativo de este monitor de sesión remoto.

Métodos

Start()	Comienza a observar las sesiones remotas detectables. El proceso de detección se ejecuta hasta que se llama al método Stop . Un objeto RemoteSystemSessionWatcher puede llamar a su método Start de nuevo más adelante.
Stop()	Deja de observar las sesiones remotas detectables.

Eventos

Added	Se genera cuando el RemoteSystemSessionWatcher detecta una nueva sesión remota.
Removed	Se genera cuando una sesión remota detectada anteriormente ha desaparecido.
Updated	Se genera cuando una sesión remota detectada anteriormente tiene alguna parte de su información actualizada.