D-Bus интерфейс ProfileManager1

Интерфейс позволяет управлять регистрацией профиля.

Шина:	системная
Служба:	org.bluez
Объект:	/org/bluez
Интерфейс:	org.bluez.ProfileManager1

Методы

• RegisterProfile(object profile, string uuid, dict options)
• UnregisterProfile(object profile)

Подробное описание

Интерфейс содержит методы для регистрации профиля и её отмены.

Описание методов

RegisterProfile(object profile, string uuid, dict options)

Регистрирует реализацию профиля.

Если приложение отключится от шины, все его зарегистрированные профили будут удалены.

Некоторые предопределённые службы:

UUID AG HFP

0000111f-0000-1000-8000-00805f9b34fb Версия профиля по умолчанию — 1.7, характеристики профиля — 0b001001, а канал RFCOMM — 13. Требуется аутентификация.

HFP HS UUID

0000111e-0000-1000-8000-00805f9b34fb Версия профиля по умолчанию — 1.7, характеристики профиля — 0b000000, а канал RFCOMM — 7. Требуется аутентификация.

UUID HSP AG

00001112-0000-1000-8000-00805f9b34fb Версия профиля по умолчанию — 1.2, канал RFCOMM — 12, требуется аутентификация. Не поддерживает какие-либо функции, параметр Features игнорируется.

HSP HS UUID

00001108-0000-1000-8000-00805f9b34fb Версия профиля по умолчанию — 1.2, характеристики профиля — 0b0, а канал RFCOMM — 6. Требуется аутентификация. Характеристики — однобитовое значение, указывает возможность удалённого управления громкостью звука (по умолчанию отключено).

Доступные опции для словаря options:

string Name

Удобочитаемое имя для профиля.

string Service

UUID основного класса обслуживания (если он отличается от UUID фактического профиля).

string Role

Для асимметричных профилей, у которых нет доступных UUID для уникальной идентификации каждой стороны, этот параметр позволяет указать точную локальную роль. Возможные значения: "client", "server".

uint16 Channel

Номер канала RFCOMM, который используется для UUID клиента и сервера. Если опция применима, он также будет использоваться в записи SDP.

uint16 PSM

Номер PSM, который используется для UUID клиента и сервера. Если опция применима, он также будет использоваться в записи SDP.

boolean RequireAuthentication

Прежде чем будут установлены соединения, необходимо выполнить сопряжение. Никакие устройства не будут подключены, если они не сопряжены.

boolean RequireAuthorization

Запрашивать авторизацию до того, как будет установлено какое-либо соединение.

boolean AutoConnect

В случае клиентского UUID опция приведёт к принудительному подключению каналов RFCOMM или L2CAP при подключении удалённого устройства.

string ServiceRecord

Нужно предоставить запись SDP вручную.

uint16 Version

Версия профиля (для записи SDP).

uint16 Features

Функции профиля (для записи SDP).

Возможные ошибки:

• org.bluez.Error.InvalidArguments,
• org.bluez.Error.AlreadyExists.

UnregisterProfile(object profile)

Отменяет регистрацию ранее зарегистрированного профиля. Параметр пути к объекту должен соответствовать тому же значению, которое использовалось при регистрации.

Возможные ошибки:

• org.bluez.Error.DoesNotExist.