BluetoothLEAdvertisementPublisherTrigger Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Background

Representa un desencadenador registrado para anunciar un anuncio bluetooth LE en segundo plano.

public ref class BluetoothLEAdvertisementPublisherTrigger 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(65536, "Windows.Foundation.UniversalApiContract")]
class BluetoothLEAdvertisementPublisherTrigger 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(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BluetoothLEAdvertisementPublisherTrigger

function BluetoothLEAdvertisementPublisherTrigger()

Public NotInheritable Class BluetoothLEAdvertisementPublisherTrigger

Herencia

Object Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IBackgroundTrigger

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Se inicia una tarea en segundo plano cuando cambia el estado del publicador en segundo plano.

Este desencadenador funciona de forma similar a la clase BluetoothAdvertisementPublisher con la excepción de que tiene más restricciones, ya que permite a la aplicación mantener la publicidad en segundo plano. Una vez registrado, el publicador en segundo plano se atenderá de la mejor manera. Se iniciará una tarea en segundo plano para notificar a la aplicación el estado del publicador. Justo después del registro, se espera que el estado sea Iniciado o En espera (si el desencadenador no se puede atender en este momento). La aplicación también recibe una notificación de errores o de interrupción del publicador en segundo plano a través de los detalles del desencadenador proporcionados en el contexto de la tarea en segundo plano. Para detener la publicidad, se debe anular el registro de la tarea en segundo plano asociada a este desencadenador.

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	UseExtendedFormat

Constructores

BluetoothLEAdvertisementPublisherTrigger()

Crea una nueva instancia de la clase BluetoothLEAdvertisementPublisherTrigger .

Propiedades

Advertisement	Obtiene el anuncio de Bluetooth LE para configurar y publicar en segundo plano.
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.
UseExtendedFormat	Especifica que el publicador de anuncios debe usar el formato de publicidad extendida.

Consulte también

• IBackgroundTrigger