D-Bus интерфейс MediaFolder1
Интерфейс позволяет управлять каталогами.
| Шина: | системная |
| Служба: | уникальное имя (у таргета), org.bluez (у контроллера) |
| Объект: | свободно определяемый (у таргета), [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX/playerX (у контроллера) |
| Интерфейс: | org.bluez.MediaFolder1 |
Свойства
- Name : string [только для чтения]
- NumberOfItems : uint32 [только для чтения]
Методы
- ChangeFolder(object folder)
- array{objects, properties} ListItems(dict filter)
- object Search(string value, dict filter)
Подробное описание
Интерфейс содержит свойства и методы для управления каталогами.
Методы ListItems() и Search() позволяют отсеивать
элементы с помощью следующих фильтров:
uint32 Start- Смещение первого элемента. Значение по умолчанию: 0.
uint32 End- Смещение последнего элемента. Значение по умолчанию: количество элементов.
array{string} Attributes- Свойства элемента, которые должны быть включены в список.
Возможные значения:
title,artist,album,genre,number-of-tracks,number,duration. Значение по умолчанию: все.
Описание свойств
Name : string [только для чтения]
Имя каталога. Возможные значения:
/Filesystem/...- область действия файловой системы.
/NowPlaying/...- область действия NowPlaying.
Примечание.
Каталог /NowPlaying может не отображаться в списке, если плеер остановлен.
Каталоги, созданные с помощью поиска, являются виртуальными, поэтому после выполнения
другого поиска или изменения каталога с помощью ChangeFolder
они больше не будут отображаться в списке.
NumberOfItems : uint32 [только для чтения]
Количество элементов в каталоге.
Описание методов
ChangeFolder(object folder)
Изменить текущий каталог.
Примечание. При смене каталога элементы из предыдущего каталога могут быть уничтожены и должны быть перечислены снова. Исключением является каталог NowPlaying, который всегда должен присутствовать, пока плеер активен.
Возможные ошибки:
org.bluez.Error.InvalidArguments,org.bluez.Error.NotSupported,org.bluez.Error.Failed.
array{objects, properties} ListItems(dict filter)
Возвращает список найденных элементов.
Возможные ошибки:
org.bluez.Error.InvalidArguments,org.bluez.Error.NotSupported,org.bluez.Error.Failed.
object Search(string value, dict filter)
Возвращает объект каталога, содержащий результат поиска.
Чтобы перечислить найденные элементы, следует использовать возвращённый объект и перейти
с помощью ChangeFolder.
Возможные ошибки:
org.bluez.Error.NotSupported,org.bluez.Error.Failed.