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

Интерфейс позволяет управлять регистрацией объектов для работы с медиа.

Шина:	системная
Служба:	org.bluez
Объект:	[variable prefix]/{hci0,hci1,...}
Интерфейс:	org.bluez.Media1

Методы

• RegisterApplication(object root, dict options)
• RegisterEndpoint(object endpoint, dict properties)
• RegisterPlayer(object player, dict properties)
• UnregisterApplication(object application)
• UnregisterEndpoint(object endpoint)
• UnregisterPlayer(object player)

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

Интерфейс содержит методы для управления регистрацией приложения, плеера и конечной точки.

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

RegisterApplication(object root, dict options)

Регистрирует конечные точки объектов плеера в корневом объекте, который должен реализовывать ObjectManager.

Путь к объекту приложения вместе с идентификатором соединения системной шины D-Bus определяют идентификацию приложения.

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

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

RegisterEndpoint(object endpoint, dict properties)

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

Примечание. Если отправитель отключается, регистрация конечных точек автоматически отменяется.

Возможные свойства:

string UUID

UUID профиля, для которого предназначена конечная точка.

byte Codec

Назначенный номер кодека, который реализует конечная точка. Значения должны соответствовать спецификации профиля, указанной UUID.

array{byte} Capabilities

Возможности массива двоичных данных (blob). Массив используется таким, какой он есть, поэтому размер и порядок байтов должны совпадать.

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

• org.bluez.Error.InvalidArguments,
• org.bluez.Error.NotSupported — генерируется, когда интерфейс для конечной точки отключён.

RegisterPlayer(object player, dict properties)

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

Объект должен реализовывать как минимум org.mpris.MediaPlayer2.Player, как определено в спецификации MPRIS 2.2.

Примечание. Если отправитель отключается, регистрация плееров автоматически отменяется.

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

• org.bluez.Error.InvalidArguments,
• org.bluez.Error.NotSupported.

UnregisterApplication(object application)

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

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

• org.bluez.Error.InvalidArguments,
• org.bluez.Error.DoesNotExist.

UnregisterEndpoint(object endpoint)

Отменяет регистрацию конечной точки отправителя.

UnregisterPlayer(object player)

Отменяет регистрацию медиаплеера отправителя.