Partilhar via


BluetoothLEAdvertisementPublisherTrigger Classe

Definição

Representa um gatilho registrado para anunciar um anúncio de LE Bluetooth em segundo plano.

public ref class BluetoothLEAdvertisementPublisherTrigger sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class BluetoothLEAdvertisementPublisherTrigger final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class BluetoothLEAdvertisementPublisherTrigger
[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
Implementações

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.

PrimaryPhy

Representa um gatilho registrado para anunciar um anúncio de LE Bluetooth em segundo plano.

SecondaryPhy

Representa um gatilho registrado para anunciar um anúncio de LE Bluetooth em segundo plano.

UseExtendedFormat

Especifica que o editor de anúncios deve usar o formato publicidade estendida.

Aplica-se a

Confira também