Поделиться через


BluetoothLEAdvertisementPublisherTrigger Класс

Определение

Представляет триггер, зарегистрированный для объявления объявления Bluetooth LE в фоновом режиме.

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
Наследование
Object Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger
Атрибуты
Реализации

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Фоновая задача запускается при изменении состояния издателя фона.

Этот триггер работает аналогично классу BluetoothAdvertisementPublisher, за исключением того, что он имеет больше ограничений, так как он позволяет приложению поддерживать рекламу в фоновом режиме. После регистрации фоновый издатель будет обслуживаться наилучшим образом. Будет запущена фоновая задача, чтобы уведомить приложение о состоянии издателя. Сразу после регистрации ожидается состояние "Запущено" или "Ожидание" (если в данный момент не удается обслужить триггер). Приложение также получает уведомление о сбоях или прерывании работы фонового издателя с помощью сведений о триггере, указанных в контексте фоновой задачи. Чтобы остановить рекламу, фоновая задача, связанная с этим триггером, должна быть отменена.

Локальный ресурс объявления ограничен на уровне протокола. Использование этого ресурса лучше всего подходит для управляемых сценариев, таких как корпоративные варианты использования. Другие приложения могут конкурировать за этот ограниченный ресурс, и регулярная трансляция рекламы для любого конкретного варианта использования не может быть гарантирована.

Допускаются следующие типы объявлений:

  • Сведения об изготовителе (0xFF)
  • Любой нестандартный тип, не зарезервированный системой, как показано в списке ниже. Дополнительные сведения о нестандартных типах см. в разделе Назначенные номера и спецификация Gap Bluetooth.

Следующие типы объявлений зарезервированы системой и не допускаются:

  • Флаги (0x01)
  • Неполный список 16-разрядных UUID служб (0x02)
  • Полный список 16-разрядных UUID служб (0x03)
  • Неполный список 32-разрядных UUID служб (0x04)
  • Полный список 32-разрядных UUID службы (0x05)
  • Неполный список 128-разрядных UUID службы (0x06)
  • Полный список 128-разрядных UUID служб (0x07)
  • Сокращенное локальное имя (0x08)
  • Полное локальное имя (0x09)
  • Tx Power Level (0x0A)
  • Класс устройства (0x0D)
  • Простой хэш связывания C192 (0x0E)
  • Простой парный рандомизатор R192 (0x0F)
  • Значения TK диспетчера безопасности (0x10)
  • Внеполосные флаги диспетчера безопасности (0x11)
  • Диапазон интервалов периферийных подключений (0x12)
  • Список 16-разрядных UUID для запроса службы (0x14)
  • Список 32-разрядных UUID для запроса службы (0x1F)
  • Список 128-разрядных UUID для запроса службы (0x15)
  • 16-разрядный UUID (0x16) данных службы
  • 32-разрядная версия UUID данных службы (0x20)
  • 128-разрядный UUID данных службы (0x21)
  • Общедоступный целевой адрес (0x17)
  • Случайный целевой адрес (0x18)
  • Внешний вид (0x19)
  • Интервал рекламы (0x1A)
  • Le Bluetooth Device Address (0x1B)
  • Роль LE (0x1C)
  • Простой хэш связывания C256 (0x1D)
  • Simple Pairing Randomizer R256 (0x1E)
  • Трехмерные информационные данные (0x3D)

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
2004 19041 IncludeTransmitPowerLevel
2004 19041 IsAnonymous
2004 19041 PreferredTransmitPowerLevelInDBm
2004 19041 UseExtendedFormat

Конструкторы

BluetoothLEAdvertisementPublisherTrigger()

Создает новый экземпляр класса BluetoothLEAdvertisementPublisherTrigger .

Свойства

Advertisement

Возвращает объявление Bluetooth LE для настройки и публикации в фоновом режиме.

IncludeTransmitPowerLevel

Указывает, включен ли уровень мощности передачи в заголовок объявления. Значение по умолчанию — False.

IsAnonymous

Указывает, включен ли адрес устройства в заголовок объявления. По умолчанию этот адрес включен.

PreferredTransmitPowerLevelInDBm

Если этот параметр указан, радиоприемный элемент использует указанный уровень мощности передачи для объявления. Значение по умолчанию — NULL.

PrimaryPhy

Представляет триггер, зарегистрированный для объявления объявления Bluetooth LE в фоновом режиме.

SecondaryPhy

Представляет триггер, зарегистрированный для объявления объявления Bluetooth LE в фоновом режиме.

UseExtendedFormat

Указывает, что издатель рекламы должен использовать формат расширенной рекламы.

Применяется к

См. также раздел