Compartilhar via

WiFiDirectServiceAdvertiser Classe

  • Referência

Definição

Namespace:
Windows.Devices.WiFiDirect.Services
Editar

Representa um Anunciante de Serviço. Essa classe é usada pelo código em um dispositivo que anuncia Wi-Fi Direct Services, para anunciar o serviço.

public ref class WiFiDirectServiceAdvertiser sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WiFiDirectServiceAdvertiser final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class WiFiDirectServiceAdvertiser final
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WiFiDirectServiceAdvertiser
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WiFiDirectServiceAdvertiser
function WiFiDirectServiceAdvertiser(serviceName)
Public NotInheritable Class WiFiDirectServiceAdvertiser
Herança
Object Platform::Object IInspectable WiFiDirectServiceAdvertiser
Atributos
ActivatableAttribute 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).)

O nome do serviço é definido no construtor WiFiDirectServiceAdvertiser . Os nomes de serviço são cadeias de caracteres UTF-8 com no máximo 255 caracteres. É recomendável que os nomes usem notação de nome de domínio reverso, em que o nome DNS do proprietário do serviço (como "contoso.com") é invertido e usado como o início do nome do serviço (como "com.contoso.serviceX"). Essa convenção destina-se a facilitar a escolha de nomes de serviço exclusivos. Os nomes de serviço que começam com "org.wi-fi.wfds" são reservados para uso pelo Wi-Fi Alliance e você pode não usar esses nomes para seu serviço.

Construtores

WiFiDirectServiceAdvertiser(String)

Cria uma instância da classe WiFiDirectServiceAdvertiser. Para começar a anunciar um Wi-Fi Direct Service, crie uma instância dessa classe, defina suas propriedades adequadamente para seu serviço e, em seguida, chame seu método Start .

Propriedades

AdvertisementStatus

Obtém um valor que descreve o status atual do anúncio.
AutoAcceptSession

Obtém ou define a propriedade Auto Accept para este anúncio de serviço.
CustomServiceStatusCode

Obtém ou define um serviço personalizado status código. Válido somente se o valor da propriedade ServiceStatus for Personalizado.
DeferredSessionInfo

Obtém ou define as informações específicas do serviço que são passadas para um solicitante de sessão ao estabelecer uma sessão não serão concluídas imediatamente, como quando, por exemplo, o serviço está aguardando a entrada do usuário para concluir a solicitação. Um solicitante deve implementar um tempo limite de 120 segundos quando sua solicitação for adiada.
PreferGroupOwnerMode

Obtém ou define um valor que indica se o serviço requer que ele seja o Wi-Fi Proprietário do Grupo Ponto a Ponto Direto (P2P).

Ser o Proprietário do Grupo permite que o serviço exerça mais controle sobre a configuração de conexão P2P e o processo de conexão. Para obter detalhes, consulte as especificações técnicas do Wi-Fi Direct P2P, disponíveis no Wi-Fi Alliance.
PreferredConfigurationMethods

Obtém uma lista (que implementa a interface IVector ) de métodos de configuração de sessão preferenciais. Seu código usa operações IVector na lista para adicionar ou remover elementos da lista.
ServiceError

Obtém um código de erro específico quando AdvertisementStatus é anulado.
ServiceInfo

Obtém ou define o blob de informações de serviço. O formato e o conteúdo do blob são determinados pelo serviço individual e devem ser usados pelos Buscadores durante a descoberta do serviço.
ServiceName

Obtém o nome do serviço.
ServiceNamePrefixes

Obtém uma lista de prefixos de nome de serviço que devem corresponder a esse serviço quando um buscador estiver usando a pesquisa de prefixo. Seu código usa métodos IVector para adicionar ou remover elementos da lista.
ServiceStatus

Obtém ou define o serviço status.

Métodos

ConnectAsync(DeviceInformation)

Aceita uma solicitação de sessão sem exigir um PIN.
ConnectAsync(DeviceInformation, String)

Aceita uma solicitação de sessão conectando-se com o PIN fornecido.
Start()

Começa a anunciar o serviço usando valores de propriedade atuais para definir os parâmetros do anúncio.
Stop()

Para de anunciar o serviço. Isso não afeta as sessões existentes que estão conectadas ao serviço.

Eventos

AdvertisementStatusChanged

Evento gerado quando o valor da propriedade AdvertisementStatus é alterado.
AutoAcceptSessionConnected

Evento gerado quando o serviço aceita automaticamente uma solicitação de sessão. Seu manipulador de eventos deve estabelecer conexões de soquete para os pares de ponto de extremidade listados no objeto event arguments.
SessionRequested

Evento gerado quando um Seeker solicitou que uma sessão fosse estabelecida com o serviço associado a essa instância de WiFiDirectServiceAdvertiser. Para aceitar a solicitação, chame WiFiDirectServiceAdvertiser.ConnectAsync no manipulador de eventos.

Aplica-se a