D-Bus интерфейс LEAdvertisingManager1
Менеджер позволяет внешним приложениям регистрировать публичные данные, которые должны транслироваться на устройства.
| Шина: | системная |
| Служба: | org.bluez |
| Объект: | /org/bluez/{hci0,hci1,...} |
| Интерфейс: | org.bluez.LEAdvertisingManager1 |
Свойства
- ActiveInstances : byte
- SupportedCapabilities : dict [экспериментально]
- SupportedFeatures : array{string} [только для чтения, опционально, экспериментально]
- SupportedIncludes : array
- SupportedInstances : byte
- SupportedSecondaryChannels : array{string} [экспериментально]
Методы
- RegisterAdvertisement(object advertisement, dict options)
- UnregisterAdvertisement(object advertisement)
Подробное описание
Менеджер позволяет внешним приложениям регистрировать публичные данные,
которые должны транслироваться на устройства.
Параметры данных должны соответствовать интерфейсу LEAdvertisement1.
Описание свойств
ActiveInstances : byte
Количество активных экземпляров публичных данных.
SupportedCapabilities : dict [экспериментально]
Перечисляет связанные с публичными данными возможности контроллера, полезные для клиента. Возможные значения:
byte MaxAdvLen- Максимальная длина публичных данных.
byte MaxScnRspLen- Максимальная длина ответа сканирования публичных данных.
int16 MinTxPower- Минимальная мощность передачи публичных данных (дБм).
int16 MaxTxPower- Максимальная мощность передачи публичных данных (дБм).
SupportedFeatures : array{string} [только для чтения,опционально,экспериментально]
Список поддерживаемых функций платформы. Если на платформе нет доступных функций, массив будет пустым. Возможные значения:
CanSetTxPower- Указывает, может ли платформа указывать мощность передачи для каждого экземпляра публичных данных.
HardwareOffload- Указывает, будет ли несколько пакетов данных выгружаться на контроллер.
SupportedIncludes : array{string}
Список поддерживаемых систем.
Возможные значения: "tx-power", "appearance", "local-name".
SupportedInstances : byte
Количество доступных экземпляров публичных данных.
SupportedSecondaryChannels : array{string} [экспериментально]
Список поддерживаемых вторичных каналов. Вторичные каналы могут использоваться для публичных данных с соответствующим PHY.
Возможные значения: 1M, 2M, Coded.
Описание методов
RegisterAdvertisement(object advertisement, dict options)
Регистрирует публичный объект с данными для отправки по открытому каналу LE.
Служба должна быть экспортирована под интерфейсом LEAdvertisement1.
Ошибка InvalidArguments указывает на то, что объект имеет недопустимые
или конфликтующие свойства.
Ошибка InvalidLength указывает на то, что предоставленные данные собраны в слишком длинный пакет.
Свойства объекта с данными анализируются при его регистрации, и любые изменения игнорируются.
Если один и тот же объект будет зарегистрирован дважды, это приведет к ошибке AlreadyExists.
Если будет достигнуто максимальное количество экземпляров рекламы,
это приведёт к ошибке NotPermitted.
Возможные ошибки:
org.bluez.Error.InvalidArguments,org.bluez.Error.AlreadyExists,org.bluez.Error.InvalidLength,org.bluez.Error.NotPermitted.
UnregisterAdvertisement(object advertisement)
Отменяет регистрацию объекта с публичными данными, который был ранее зарегистрирован. Входной параметр пути к объекту должен соответствовать тому же значению, которое использовалось при регистрации.
Возможные ошибки:
org.bluez.Error.InvalidArguments,org.bluez.Error.DoesNotExist.