WiFiDirectServiceAdvertiser Clase

Definición

Espacio de nombres:

Windows.Devices.WiFiDirect.Services

Representa un anunciante del servicio. El código usa esta clase en un dispositivo que anuncia Wi-Fi Direct Services para anunciar el servicio.

public ref class WiFiDirectServiceAdvertiser sealed

/// [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.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

Herencia

Object Platform::Object IInspectable WiFiDirectServiceAdvertiser

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Se trata de una de varias clases que admiten la conexión de dos dispositivos con una preferencia para la que el dispositivo debe ser el propietario del grupo. Consulte el tema Windows.Devices.WiFiDirect.Service para obtener información sobre el emparejamiento de dispositivos y cómo puede hacer que se omita la preferencia del propietario del grupo (y cómo corregirlo).

El nombre del servicio se establece en el constructor WiFiDirectServiceAdvertiser . Los nombres de servicio son cadenas UTF-8 que no tienen más de 255 caracteres. Se recomienda que los nombres usen la notación inversa de nombres de dominio, donde el nombre DNS del propietario del servicio (como "contoso.com") se invierte y se usa como el principio del nombre del servicio (por ejemplo, "com.contoso.serviceX"). Esta convención está pensada para facilitar la elección de nombres de servicio únicos. Los nombres de servicio que comienzan por "org.wi-fi.wfds" están reservados para su uso por parte de la alianza Wi-Fi, y es posible que no use estos nombres para su servicio.

Constructores

WiFiDirectServiceAdvertiser(String)

Crea una instancia de la clase WiFiDirectServiceAdvertiser. Para empezar a anunciar un servicio directo de Wi-Fi, cree una instancia de esta clase, establezca sus propiedades apropiadamente para el servicio y, a continuación, llame a su método Start .

Propiedades

AdvertisementStatus	Obtiene un valor que describe el estado actual del anuncio.
AutoAcceptSession	Obtiene o establece la propiedad Auto Accept para este anuncio de servicio.
CustomServiceStatusCode	Obtiene o establece un código de estado de servicio personalizado. Solo es válido si el valor de la propiedad ServiceStatus es Custom.
DeferredSessionInfo	Obtiene o establece la información específica del servicio que se pasa a un solicitante de sesión al establecer una sesión no se completará inmediatamente, como cuando, por ejemplo, el servicio está esperando a que la entrada del usuario complete la solicitud. Un solicitante debe implementar un tiempo de espera de 120 segundos cuando se aplaza su solicitud.
PreferGroupOwnerMode	Obtiene o establece un valor que indica si el servicio requiere que sea el Wi-Fi propietario del grupo del mismo nivel directo a punto (P2P). El propietario del grupo permite al servicio ejercer más control sobre la configuración de conexión P2P y el proceso de conexión. Para obtener más información, consulte las especificaciones técnicas de Wi-Fi Direct P2P, disponibles en Wi-Fi Alliance.
PreferredConfigurationMethods	Obtiene una lista (que implementa la interfaz IVector ) de los métodos de configuración de sesión preferidos. El código usa operaciones IVector en la lista para agregar o quitar elementos de la lista.
ServiceError	Obtiene un código de error específico cuando Se anulaAdvertisementStatus.
ServiceInfo	Obtiene o establece el blob de información de servicio. El formato y el contenido del blob están determinados por el servicio individual y están diseñados para que los solicitantes los usen durante la detección del servicio.
ServiceName	Obtiene el nombre del servicio.
ServiceNamePrefixes	Obtiene una lista de prefijos de nombre de servicio que deben coincidir con este servicio cuando un buscador usa la búsqueda de prefijos. El código usa métodos IVector para agregar o quitar elementos de la lista.
ServiceStatus	Obtiene o establece el estado del servicio.

Métodos

ConnectAsync(DeviceInformation)	Acepta una solicitud de sesión sin necesidad de un PIN.
ConnectAsync(DeviceInformation, String)	Acepta una solicitud de sesión mediante la conexión con el PIN especificado.
Start()	Inicia la publicidad del servicio, usando los valores de propiedad actuales para establecer los parámetros del anuncio.
Stop()	Detiene la publicidad del servicio. Esto no afecta a las sesiones existentes que están conectadas al servicio.

Eventos

AdvertisementStatusChanged	Evento generado cuando cambia el valor de la propiedad AdvertisementStatus .
AutoAcceptSessionConnected	Evento generado cuando el servicio ha aceptado automáticamente una solicitud de sesión. El controlador de eventos debe establecer conexiones de socket para los pares de punto de conexión enumerados en el objeto de argumentos de evento.
SessionRequested	Evento generado cuando un Buscador ha solicitado que se establezca una sesión con el servicio asociado a esta instancia de WiFiDirectServiceAdvertiser. Para aceptar la solicitud, llame a WiFiDirectServiceAdvertiser.ConnectAsync en el controlador de eventos.