D-Bus интерфейс AgentManager1
Интерфейс позволяет управлять регистрацией агентов.
| Шина: | системная |
| Служба: | org.bluez |
| Объект: | /org/bluez |
| Интерфейс: | org.bluez.AgentManager1 |
Методы
- RegisterAgent(object agent, string capability)
- RequestDefaultAgent(object agent)
- UnregisterAgent(object agent)
Подробное описание
Интерфейс содержит методы для регистрации агента и её отмены, а также назначения агента вариантом по умолчанию.
Описание методов
RegisterAgent(object agent, string capability)
Регистрирует обработчик агента.
Путь к объекту определяет путь к агенту, который будет вызываться, когда потребуется ввод данных от пользователя.
Каждое приложение может зарегистрировать своего собственного агента, и для всех действий, запускаемых этим приложением, используется его агент.
Приложение не требует регистрации агента. Если приложение решает не регистрировать агент, используется агент по умолчанию. В большинстве случаев это хорошая идея. Только такое приложение, как мастер сопряжения, должно регистрировать собственного агента.
Приложение может зарегистрировать только одного агента. Несколько агентов для приложения не поддерживаются.
Параметр capability может иметь значения DisplayOnly, DisplayYesNo, KeyboardOnly,
NoInputNoOutput и KeyboardDisplay, которые отражают возможности ввода и вывода агента.
Если используется пустая строка, она будет обозначать сброс к варианту KeyboardDisplay.
Возможные ошибки:
org.bluez.Error.InvalidArguments,org.bluez.Error.AlreadyExists.
RequestDefaultAgent(object agent)
Метод должен сделать агента приложения агентом по умолчанию. Для регистрации агента необходимо приложение.
Чтобы стать агентом по умолчанию, может потребоваться специальное разрешение.
Возможные ошибки:
org.bluez.Error.DoesNotExist.
UnregisterAgent(object agent)
Отменяет регистрацию ранее зарегистрированного агента. Параметр пути к объекту должен соответствовать тому же значению, которое использовалось при регистрации.
Возможные ошибки:
org.bluez.Error.DoesNotExist.