RemoteSystemSessionWatcher Classe

Definição

Namespace:

Windows.System.RemoteSystems

Observa a atividade relacionada à descoberta de sessões remotas e gera os eventos apropriados.

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

Herança

Object Platform::Object IInspectable RemoteSystemSessionWatcher

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v4.0)
Funcionalidades do aplicativo	remoteSystem

Exemplos

Consulte o exemplo de código abaixo para o processo de descoberta de uma sessão 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();
}

Comentários

Essa classe é instanciada quando o método RemoteSystemSession.CreateWatcher é chamado.

Importante

Você deve confirmar o acesso à plataforma do sistema remoto com uma chamada para RemoteSystem.RequestAccessAsync antes de instanciar essa classe.

Importante

As seguintes condições devem ser atendidas para que a descoberta de sessão remota funcione conforme o esperado:

1. O Bluetooth deve ser ativado para os dispositivos cliente e host. A descoberta de sessão pode funcionar por meio da descoberta de LAN, mas não é garantida (depende da configuração de rede).
2. No aplicativo Configurações no dispositivo host, a configuração Compartilhar entre dispositivos em Sistema –> Experiências Compartilhadas deve ser definida como "Todos nas proximidades".
3. Os aplicativos cliente e host devem ter o mesmo PackageFamilyName.

Propriedades

Status

Obtém o status operacional deste observador de sessão remota.

Métodos

Start()	Começa a observar sessões remotas detectáveis. O processo de descoberta é executado até que o método Stop seja chamado. Um objeto RemoteSystemSessionWatcher pode ter seu método Start chamado novamente posteriormente.
Stop()	Para de observar sessões remotas detectáveis.

Eventos

Added	Gerado quando uma nova sessão remota foi descoberta pelo RemoteSystemSessionWatcher.
Removed	Gerado quando uma sessão remota descoberta anteriormente desapareceu.
Updated	Gerado quando uma sessão remota descoberta anteriormente tem alguma parte de suas informações atualizadas.