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
- Наследование
- Атрибуты
- Реализации
Требования к 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 |
Указывает, что издатель рекламы должен использовать формат расширенной рекламы. |