BluetoothLEAdvertisementPublisher Clase

Definición

Espacio de nombres:

Windows.Devices.Bluetooth.Advertisement

Objeto para enviar anuncios de Bluetooth Low Energy (LE).

public ref class BluetoothLEAdvertisementPublisher sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.Bluetooth.Advertisement.IBluetoothLEAdvertisementPublisherFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BluetoothLEAdvertisementPublisher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.Bluetooth.Advertisement.IBluetoothLEAdvertisementPublisherFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BluetoothLEAdvertisementPublisher

function BluetoothLEAdvertisementPublisher(advertisement)

Public NotInheritable Class BluetoothLEAdvertisementPublisher

Herencia

Object Platform::Object IInspectable BluetoothLEAdvertisementPublisher

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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)
Características de aplicaciones	bluetooth

Comentarios

La clase BluetoothLEAdvertisementPublisher permite la configuración y publicidad de un paquete de anuncios bluetooth LE. La solicitud de publicidad se atenderá con el mejor esfuerzo y los parámetros publicitarios se definen mediante una política de publicidad.

La carga del anuncio se configura cuando se construye BluetoothLEAdvertisementPublisher. La carga se puede recuperar mediante la propiedad Advertisement del BluetoothLEAdvertisementPublisher. El autor de la llamada debe administrar la clase BluetoothLEAdvertisement de esta manera. Por ejemplo, no se recomienda reutilizar directamente un BluetoothLEAdvertisement obtenido de un BluetoothLEAdvertisementReceivedEventArgs porque contiene duplicación de la carga real para facilitar el acceso a secciones de datos comunes. Si es necesario duplicar un BluetoothLEAdvertisement recibido, solo se debe copiar la propiedad DataSections , ya que representan las secciones de datos de anuncio en su formato sin procesar.

El recurso de anuncio local está limitado en la capa de protocolo. El uso de este recurso es más adecuado para escenarios controlados, como casos de uso empresariales. Otras aplicaciones pueden competir por este recurso limitado y la difusión regular de anuncios para cualquier caso de uso específico no se puede garantizar.

Se permiten los siguientes tipos de anuncios:

• Información específica del fabricante (0xFF)
• Cualquier tipo no estándar no reservado por el sistema, como se muestra en la lista siguiente. Para obtener más información sobre los tipos no estándar, consulte la especificación De bluetooth GAP y números asignados .

Los siguientes tipos de anuncios están reservados por el sistema y no se permiten:

• Marcas (0x01)
• Lista incompleta de UUID de servicio de 16 bits (0x02)
• Lista completa de UUID de servicio de 16 bits (0x03)
• Lista incompleta de UUID de servicio de 32 bits (0x04)
• Lista completa de UUID de servicio de 32 bits (0x05)
• Lista incompleta de UUID de servicio de 128 bits (0x06)
• Lista completa de UUID de servicio de 128 bits (0x07)
• Nombre local abreviado (0x08)
• Nombre local completo (0x09)
• Nivel de potencia tx (0x0A)
• Clase de dispositivo (0x0D)
• Hash de emparejamiento simple C192 (0x0E)
• Aleatorización de emparejamiento simple R192 (0x0F)
• Valores de TK de Security Manager (0x10)
• Marcas fuera de banda (0x11) del Administrador de seguridad
• Intervalo de intervalo de conexión periférico (0x12)
• Lista de UUID de solicitud de servicio de 16 bits (0x14)
• Lista de UUID de solicitud de servicio de 32 bits (0x1F)
• Lista de UUID de solicitud de servicio de 128 bits (0x15)
• UUID de datos de servicio de 16 bits (0x16)
• UUID de datos de servicio de 32 bits (0x20)
• UUID de datos de servicio de 128 bits (0x21)
• Dirección de destino pública (0x17)
• Dirección de destino aleatoria (0x18)
• Apariencia (0x19)
• Intervalo de publicidad (0x1A)
• Dirección del dispositivo Bluetooth LE (0x1B)
• Rol LE (0x1C)
• Hash de emparejamiento simple C256 (0x1D)
• Aleatorización de emparejamiento simple R256 (0x1E)
• Datos de información 3D (0x3D)

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
2004	19041	IncludeTransmitPowerLevel
2004	19041	IsAnonymous
2004	19041	PreferredTransmitPowerLevelInDBm
2004	19041	UseExtendedAdvertisement

Constructores

BluetoothLEAdvertisementPublisher()	Crea un nuevo objeto BluetoothLEAdvertisementPublisher .
BluetoothLEAdvertisementPublisher(BluetoothLEAdvertisement)	Crea un nuevo objeto BluetoothLEAdvertisementPublisher con el anuncio de Bluetooth LE que se va a publicar.

Propiedades

Advertisement	Obtiene una copia del anuncio de Bluetooth LE que se va a publicar. Al configurar el objeto publisher, no se pueden agregar tipos de sección restringidos (BluetoothLEAdvertisementPublisher.Advertisement.Flags y BluetoothLEAdvertisementPublisher.Advertisement.LocalName). Al intentar establecer esos valores de propiedad, se produce una excepción en tiempo de ejecución. Todavía puede establecer la sección de datos del fabricante o cualquier otra sección que no esté definida por la lista de restricciones.
IncludeTransmitPowerLevel	Especifica si el nivel de energía de transmisión se incluye en el encabezado del anuncio. El valor predeterminado es False.
IsAnonymous	Especifica si la dirección del dispositivo se incluye o no en el encabezado del anuncio. De forma predeterminada, se incluye la dirección.
PreferredTransmitPowerLevelInDBm	Si se especifica, solicita que la radio utilice el nivel de potencia de transmisión indicado para el anuncio. El valor predeterminado es Null.
Status	Obtiene el estado actual de BluetoothLEAdvertisementPublisher.
UseExtendedAdvertisement	Especifica que el publicador de anuncios debe usar el formato de publicidad extendida.

Métodos

Start()	Comience a anunciar una carga de anuncios bluetooth LE.
Stop()	Detenga el publicador y deje de anunciar una carga de anuncios bluetooth LE.

Eventos

StatusChanged

Notificación de que el estado de BluetoothLEAdvertisementPublisher ha cambiado.

Consulte también

• BluetoothLEAdvertisement
• DataSections
• BluetoothLEAdvertisementReceivedEventArgs