BluetoothLEAdvertisementPublisher Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Объект для отправки объявлений Bluetooth Low Energy (LE).
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
- Наследование
- Атрибуты
Требования к 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. |
PrimaryPhy |
Объект для отправки объявлений Bluetooth Low Energy (LE). |
SecondaryPhy |
Объект для отправки объявлений Bluetooth Low Energy (LE). |
Status |
Возвращает текущее состояние Объекта BluetoothLEAdvertisementPublisher. |
UseExtendedAdvertisement |
Указывает, что издатель объявления должен использовать формат расширенной рекламы. |
Методы
Start() |
Начните рекламировать полезные данные объявления Bluetooth LE. |
Stop() |
Остановите издателя и прекратите рекламировать полезные данные рекламы Bluetooth LE. |
События
StatusChanged |
Уведомление об изменении состояния BluetoothLEAdvertisementPublisher . |