BluetoothLEAdvertisementPublisher Класс

Определение

Пространство имен:

Windows.Devices.Bluetooth.Advertisement

Объект для отправки объявлений Bluetooth Low Energy (LE).

public ref class BluetoothLEAdvertisementPublisher 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(Windows.Devices.Bluetooth.Advertisement.IBluetoothLEAdvertisementPublisherFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BluetoothLEAdvertisementPublisher 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(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

Наследование

Object Platform::Object IInspectable BluetoothLEAdvertisementPublisher

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Семейство устройств	Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)
Возможности приложения	bluetooth

Комментарии

Класс BluetoothLEAdvertisementPublisher позволяет настраивать и рекламировать рекламный пакет Bluetooth LE. Запрос на рекламу обслуживается наилучшим образом, а параметры рекламы определяются политикой рекламы.

Полезные данные объявления настраиваются при создании BluetoothLEAdvertisementPublisher. Полезные данные можно получить с помощью свойства Объявление объекта BluetoothLEAdvertisementPublisher. Класс BluetoothLEAdvertisement должен управляться вызывающей стороной, если он используется таким образом. Например, не рекомендуется напрямую повторно использовать BluetoothLEAdvertisement , полученный из BluetoothLEAdvertisementReceivedEventArgs , так как он содержит дублирование фактических полезных данных для упрощения доступа к общим разделам данных. Если нужно дублировать полученный объект BluetoothLEAdvertisement , необходимо скопировать только свойство DataSections , так как они представляют разделы данных объявления в необработанном виде.

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

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

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

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

• Флаги (0x01)
• Неполный список 16-разрядных UUID служб (0x02)
• Полный список 16-разрядных пользовательских идентификаторов службы (0x03)
• Неполный список 32-разрядных UUID служб (0x04)
• Полный список 32-разрядных UID служб (0x05)
• Неполный список 128-разрядных UUID служб (0x06)
• Полный список 128-разрядных UUID служб (0x07)
• Сокращенное локальное имя (0x08)
• Полное локальное имя (0x09)
• Tx Power Level (0x0A)
• Класс устройства (0x0D)
• Простой связывание хэш C192 (0x0E)
• Simple Pairing Randomizer 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)
• Адрес устройства Bluetooth le (0x1B)
• Роль LE (0x1C)
• Простой связывание хэш C256 (0x1D)
• Simple Pairing Randomizer R256 (0x1E)
• Трехмерные информационные данные (0x3D)

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

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

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

BluetoothLEAdvertisementPublisher()	Создает объект BluetoothLEAdvertisementPublisher .
BluetoothLEAdvertisementPublisher(BluetoothLEAdvertisement)	Создает объект BluetoothLEAdvertisementPublisher с объявлением Bluetooth LE для публикации.

Свойства

Advertisement	Возвращает копию объявления Bluetooth LE для публикации. При настройке объекта издателя нельзя добавлять ограниченные типы разделов (BluetoothLEAdvertisementPublisher.Advertisement.Flags и BluetoothLEAdvertisementPublisher.Advertisement.LocalName). Попытка задать эти значения свойств приводит к исключению среды выполнения. Вы по-прежнему можете задать раздел данных производителя или любые другие разделы, не определенные списком ограничений.
IncludeTransmitPowerLevel	Указывает, включен ли уровень питания передачи в заголовок объявления. Значение по умолчанию — False.
IsAnonymous	Указывает, включен ли адрес устройства в заголовок объявления. По умолчанию этот адрес включен.
PreferredTransmitPowerLevelInDBm	Если этот параметр указан, запрашивает, чтобы радио использовал указанный уровень мощности передачи для объявления. По умолчанию имеет значение Null.
Status	Возвращает текущее состояние Объекта BluetoothLEAdvertisementPublisher.
UseExtendedAdvertisement	Указывает, что издатель объявления должен использовать формат расширенной рекламы.

Методы

Start()	Начните рекламировать полезные данные объявления Bluetooth LE.
Stop()	Остановите издателя и прекратите рекламировать полезные данные рекламы Bluetooth LE.

События

StatusChanged

Уведомление об изменении состояния BluetoothLEAdvertisementPublisher .

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

• BluetoothLEAdvertisement
• DataSections
• BluetoothLEAdvertisementReceivedEventArgs