Blob: org.bluez.MediaFolder.rst

Blob id: d868c5ebb380aa0131814f0fb1d749c9bfbbda12

Size: 2.3 KB

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
=====================
org.bluez.MediaFolder
=====================

-----------------------------------------
BlueZ D-Bus MediaFolder API documentation
-----------------------------------------

:Version: BlueZ
:Date: September 2023
:Manual section: 5
:Manual group: Linux System Administration

Interface
=========

:Service:	unique name (Target role)
		org.bluez (Controller role)
:Interface:	org.bluez.MediaFolder1
:Object path:	freely definable (Target role)
		[variable prefix]/{hci0,hci1,...}/dev_{BDRADDR}/player# (Controller role)

Methods
-------

object Search(string value, dict filter)
````````````````````````````````````````

Return a folder object containing the search result.

To list the items found use the folder object returned and pass to
**ChangeFolder**.

Possible Errors:

:org.bluez.Error.NotSupported:
:org.bluez.Error.Failed:

array{objects, properties} ListItems(dict filter)
`````````````````````````````````````````````````

Return a list of items found

Possible Errors:

:org.bluez.Error.InvalidArguments:
:org.bluez.Error.NotSupported:
:org.bluez.Error.Failed:

void ChangeFolder(object folder)
````````````````````````````````

Change current folder.

Note: By changing folder the items of previous folder might be destroyed and
have to be listed again, the exception is NowPlaying folder which should be
always present while the player is active.

Possible Errors:

:org.bluez.Error.InvalidArguments:
:org.bluez.Error.NotSupported:
:org.bluez.Error.Failed:

Properties
----------

uint32 NumberOfItems [readonly]
```````````````````````````````

Number of items in the folder

string Name [readonly]
``````````````````````

Folder name:

Possible values:

:"/Filesystem/...":

	Filesystem scope

:"/NowPlaying/...":

	NowPlaying scope

Note: /NowPlaying folder might not be listed if player is stopped, folders
created by Search are virtual so once another Search is perform or the folder is
changed using ChangeFolder it will no longer be listed.

Filters
-------

:uint32 Start:

	Offset of the first item.

	Default value: 0

:uint32 End:

	Offset of the last item.

	Default value: NumbeOfItems

:array{string} Attributes:

	Item properties that should be included in the list.

	Possible Values:

		"title", "artist", "album", "genre", "number-of-tracks",
		"number", "duration"

		Default Value: All