WiFiDirectService Classe

Definição

Namespace:

Windows.Devices.WiFiDirect.Services

Representa um serviço Wi-Fi Direct. Essa classe é usada pelo código em um dispositivo que busca usar um serviço Wi-Fi Direct, para estabelecer uma sessão de serviço direto Wi-Fi com o provedor de serviços.

public ref class WiFiDirectService sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WiFiDirectService final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WiFiDirectService

Public NotInheritable Class WiFiDirectService

Herança

Object Platform::Object IInspectable WiFiDirectService

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Essa é uma das várias classes que dão suporte à conexão de dois dispositivos com uma preferência para qual dispositivo deve ser o Proprietário do Grupo. Consulte o tópico Windows.Devices.WiFiDirect.Service para obter uma discussão sobre o emparelhamento de dispositivos e como ele pode fazer com que a preferência do Proprietário do Grupo seja ignorada (e como corrigir isso).)

Seu código não cria uma instância dessa classe diretamente. Em vez disso, seu código segue esse processo para obter uma instância dessa classe e usá-la para estabelecer um Wi-Fi sessão de Serviço Direto.

1. Usar um dos métodos GetSelector para obter uma cadeia de caracteres de consulta para um serviço específico
2. Crie um DeviceWatcher que observe os Anunciantes que correspondem à cadeia de caracteres de consulta. Quando um Anunciante for encontrado, decida se deseja usar esse Anunciante, programaticamente ou solicitando que o usuário indique uma opção.
3. Depois que o Seeker tiver identificado o anunciante de serviço desejado, chame o método FromIdAsync estático com a ID do dispositivo do dispositivo de anunciante escolhido. FromIdAsync recupera uma instância de WiFiDirectService para o serviço solicitado no dispositivo solicitado.
4. Prossiga para estabelecer uma sessão chamando WiFiDirectService.ConnectAsync.

Propriedades

PreferGroupOwnerMode	Obtém ou define um valor que especifica se a instância de serviço deve escolher Wi-Fi modo GO (Proprietário do Grupo ponto a ponto) direto (P2P).
RemoteServiceInfo	Obtém o blob de informações de serviço dessa instância de serviço.
ServiceError	Informações de erro sobre a última tentativa de conexão com o serviço.
SessionInfo	Obtém ou define informações de sessão específicas do aplicativo passadas para o servidor ao iniciar uma sessão.
SupportedConfigurationMethods	Obtém uma lista de métodos de configuração com suporte, ordenados por preferência. Seu código usa operações IVector para modificar o conteúdo da lista.

Métodos

ConnectAsync()	Inicia o estabelecimento de uma sessão de serviço com o Wi-Fi Serviço Direto representado por essa instância.
ConnectAsync(String)	Inicia o estabelecimento de uma sessão de serviço com o Wi-Fi Serviço Direto representado por essa instância, usando um PIN para configurar a sessão.
FromIdAsync(String)	Método estático que recupera uma instância de WiFiDirectService para um Wi-Fi Serviço Direto oferecido pelo dispositivo com uma determinada ID do dispositivo.
GetProvisioningInfoAsync(WiFiDirectServiceConfigurationMethod)	Recupera assíncronamente Wi-Fi informações de provisionamento de sessão do Serviço Direto.
GetSelector(String)	Obtém uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) a ser usada para localizar Wi-Fi anunciantes do Serviço Direto para um determinado serviço.
GetSelector(String, IBuffer)	Obtém uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) a ser usada para localizar Wi-Fi anunciantes do Serviço Direto para um determinado serviço, em que uma determinada sequência de bytes aparece no blob de informações de serviço do anunciante.

Eventos

SessionDeferred

Evento gerado quando uma solicitação de sessão foi adiada. Observe que isso não significa que a solicitação falhou ou foi negada. É uma notificação de que o servidor está executando uma operação longa, como esperar que um usuário insira um PIN. O buscador que recebe essa mensagem deve iniciar uma espera de 120 segundos antes de atingir o tempo limite da solicitação de sessão, para dar ao servidor tempo para concluir sua operação. Os argumentos de evento incluem um buffer fornecido pelo servidor na notificação de adiamento com informações adicionais.