Compartilhar via


BluetoothLEAdvertisementPublisher Classe

Definição

Um objeto para enviar anúncios de LE (Bluetooth de baixa energia).

public ref class BluetoothLEAdvertisementPublisher sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.Bluetooth.Advertisement.IBluetoothLEAdvertisementPublisherFactory, 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 BluetoothLEAdvertisementPublisher 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(Windows.Devices.Bluetooth.Advertisement.IBluetoothLEAdvertisementPublisherFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BluetoothLEAdvertisementPublisher final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.Bluetooth.Advertisement.IBluetoothLEAdvertisementPublisherFactory), 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 BluetoothLEAdvertisementPublisher
[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
Herança
Object Platform::Object IInspectable BluetoothLEAdvertisementPublisher
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo
bluetooth

Comentários

A classe BluetoothLEAdvertisementPublisher permite a configuração e a publicidade de um pacote de anúncio bluetooth LE. A solicitação de publicidade é atendida com o melhor esforço e os parâmetros de publicidade são definidos por uma política de publicidade.

O conteúdo do anúncio é configurado quando o BluetoothLEAdvertisementPublisher é construído. O conteúdo pode ser recuperado pela propriedade Advertisement do BluetoothLEAdvertisementPublisher. A classe BluetoothLEAdvertisement deve ser gerenciada pelo chamador se usada dessa forma. Por exemplo, não é recomendável reutilizar diretamente um BluetoothLEAdvertisement obtido de um BluetoothLEAdvertisementReceivedEventArgs porque ele contém duplicação de conteúdo real para facilitar o acesso a seções de dados comuns. Se um BluetoothLEAdvertisement recebido precisar ser duplicado, somente a propriedade DataSections deverá ser copiada, pois elas representam as seções de dados de anúncio em sua forma bruta.

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 de 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)
  • Randomizer 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 de 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)
  • Randomizer 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 UseExtendedAdvertisement

Construtores

BluetoothLEAdvertisementPublisher()

Cria um novo objeto BluetoothLEAdvertisementPublisher .

BluetoothLEAdvertisementPublisher(BluetoothLEAdvertisement)

Cria um novo objeto BluetoothLEAdvertisementPublisher com o anúncio bluetooth LE a ser publicado.

Propriedades

Advertisement

Obtém uma cópia do anúncio bluetooth LE a ser publicado.

Ao configurar o objeto publisher, você não pode adicionar tipos de seção restritos (BluetoothLEAdvertisementPublisher.Advertisement.Flags e BluetoothLEAdvertisementPublisher.Advertisement.LocalName). Tentar definir esses valores de propriedade resulta em uma exceção de runtime. Você ainda pode definir a seção de dados do fabricante ou quaisquer outras seções não definidas pela lista de restrições.

IncludeTransmitPowerLevel

Especifica se o nível de energia de transmissão está incluído no cabeçalho de 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

Um objeto para enviar anúncios de LE (Bluetooth de baixa energia).

SecondaryPhy

Um objeto para enviar anúncios de LE (Bluetooth de baixa energia).

Status

Obtém o status atual do BluetoothLEAdvertisementPublisher.

UseExtendedAdvertisement

Especifica que o editor de anúncios deve usar o formato de Publicidade Estendida.

Métodos

Start()

Comece a anunciar um conteúdo de anúncio de Bluetooth LE.

Stop()

Interrompa o editor e pare de anunciar um conteúdo de anúncio bluetooth LE.

Eventos

StatusChanged

Notificação de que o status do BluetoothLEAdvertisementPublisher foi alterado.

Aplica-se a

Confira também