BluetoothLEAdvertisementPublisherTrigger Classe

Definição

Namespace:

Windows.ApplicationModel.Background

Representa um gatilho registrado para anunciar um anúncio de LE Bluetooth em 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

Herança

Object Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IBackgroundTrigger

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Uma tarefa em segundo plano é iniciada quando o status do editor em segundo plano é alterado.

Esse gatilho funciona de forma semelhante à classe BluetoothAdvertisementPublisher, com a exceção de que ele tem mais restrições, pois permite que o aplicativo mantenha a publicidade em segundo plano. Depois de registrado, o publicador em segundo plano é atendido da melhor maneira. Uma tarefa em segundo plano será iniciada para notificar o Aplicativo sobre o status do editor. Logo após o registro, espera-se que o status seja Iniciado ou Aguardando (se o gatilho não puder ser atendido no momento). O aplicativo também é notificado sobre falhas ou interrupção do editor em segundo plano por meio dos detalhes do gatilho fornecidos no contexto da tarefa em segundo plano. Para interromper a publicidade, a tarefa em segundo plano associada a esse gatilho deve ser cancelada.

O recurso de anúncio local é limitado na camada de protocolo. O uso desse recurso é mais adequado para cenários controlados, como casos de uso corporativo. Outros aplicativos podem competir por esse recurso limitado e a difusão regular de anúncios para qualquer caso de uso específico não pode ser garantida.

Os seguintes tipos de anúncio são permitidos:

• Informações específicas do fabricante (0xFF)
• Qualquer tipo não padrão não reservado pelo sistema, conforme mostrado na lista abaixo. Para obter mais informações sobre tipos não padrão, consulte a especificação Números atribuídos e Bluetooth GAP .

Os seguintes tipos de anúncio são reservados pelo sistema e não são permitidos:

• Sinalizadores (0x01)
• Lista incompleta de UUIDs de Serviço de 16 bits (0x02)
• Lista completa de UUIDs de Serviço de 16 bits (0x03)
• Lista incompleta de UUIDs de Serviço de 32 bits (0x04)
• Lista completa de UUIDs de Serviço de 32 bits (0x05)
• Lista incompleta de UUIDs de Serviço de 128 bits (0x06)
• Lista completa de UUIDs de Serviço de 128 bits (0x07)
• Nome local abreviado (0x08)
• Nome Local Completo (0x09)
• Nível de Energia Tx (0x0A)
• Classe de dispositivo (0x0D)
• Hash de emparelhamento simples C192 (0x0E)
• Randomizador de Emparelhamento Simples R192 (0x0F)
• Valores de TK do Gerenciador de Segurança (0x10)
• Sinalizadores fora de banda do Gerenciador de Segurança (0x11)
• Intervalo de intervalo de conexão periférico (0x12)
• Lista de UUIDs de Solicitação de Serviço de 16 bits (0x14)
• Lista de UUIDs de Solicitação de Serviço de 32 bits (0x1F)
• Lista de UUIDs de Solicitação de Serviço de 128 bits (0x15)
• UUID de 16 bits de Dados de Serviço (0x16)
• UUID de 32 bits dos Dados de Serviço (0x20)
• UUID de 128 bits de Dados de Serviço (0x21)
• Endereço de destino público (0x17)
• Endereço de destino aleatório (0x18)
• Aparência (0x19)
• Intervalo de publicidade (0x1A)
• Endereço do dispositivo Bluetooth LE (0x1B)
• Função LE (0x1C)
• Hash de emparelhamento simples C256 (0x1D)
• Randomizador de Emparelhamento Simples R256 (0x1E)
• Dados de informações 3D (0x3D)

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
2004	19041	IncludeTransmitPowerLevel
2004	19041	IsAnonymous
2004	19041	PreferredTransmitPowerLevelInDBm
2004	19041	UseExtendedFormat

Construtores

BluetoothLEAdvertisementPublisherTrigger()

Cria uma nova instância da classe BluetoothLEAdvertisementPublisherTrigger .

Propriedades

Advertisement	Obtém o anúncio de LE Bluetooth para configurar e publicar em segundo plano.
IncludeTransmitPowerLevel	Especifica se o nível de energia de transmissão está incluído no cabeçalho do anúncio. Usa False como padrão.
IsAnonymous	Especifica se o endereço do dispositivo está incluído ou não no cabeçalho do anúncio. Por padrão, o endereço é incluído.
PreferredTransmitPowerLevelInDBm	Se especificado, solicita que o rádio use o nível de energia de transmissão indicado para o anúncio. O padrão é Null.
UseExtendedFormat	Especifica que o editor de anúncios deve usar o formato publicidade estendida.

Confira também

• IBackgroundTrigger