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


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
Наследование
Object Platform::Object IInspectable 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 , так как они представляют разделы данных объявления в необработанном виде.

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

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

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

  • Флаги (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 .

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

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