1ORG.BLUEZ.MEDIA(5)        Linux System Administration       ORG.BLUEZ.MEDIA(5)
2
3
4

NAME

6       org.bluez.Media - BlueZ D-Bus Media API documentation
7

INTERFACE

9       Service
10              org.bluez
11
12       Interface
13              org.bluez.Media1
14
15       Object path
16              [variable prefix]/{hci0,hci1,...}
17
18   Methods
19   void RegisterEndpoint(object endpoint, dict properties)
20          Register  a  local  end  point to sender, the sender can register as
21          many end points as it likes.
22
23          Note: If the sender disconnects the end points are automatically un‐
24          registered.
25
26          possible properties:
27
28          string UUID
29                 UUID of the profile which the endpoint is for.
30
31                 UUID must be in the list of SupportedUUIDS.
32
33          byte Codec
34                 Assigned  number  of  codec that the endpoint implements. The
35                 values should match the profile specification which is  indi‐
36                 cated by the UUID.
37
38          uint32_t Vendor [Optional]
39                 Vendor-specific  Company ID, Codec ID tuple that the endpoint
40                 implements.
41
42                 It shall be set to appropriate  value  when  Vendor  Specific
43                 Codec (0xff) is used.
44
45          array{byte} Capabilities
46                 Capabilities  blob,  it is used as it is so the size and byte
47                 order must match.
48
49          array{byte} Metadata [Optional]
50                 Metadata blob, it is used as it is so the size and byte order
51                 must match.
52
53          Possible Errors:
54
55          org.bluez.Error.InvalidArguments
56
57          org.bluez.Error.NotSupported
58                 emitted when interface for the end-point is disabled
59
60   void UnregisterEndpoint(object endpoint)
61          Unregister sender end point.
62
63   void RegisterPlayer(object player, dict properties)
64          Register a media player object to sender, the sender can register as
65          many objects as it likes.
66
67          Object must implement at least org.mpris.MediaPlayer2.Player as  de‐
68          fined in MPRIS 2.2 spec:
69              http://specifications.freedesktop.org/mpris-spec/latest/
70
71          Note: If the sender disconnects its objects are automatically unreg‐
72          istered.
73
74          Possible Errors:
75
76          org.bluez.Error.InvalidArguments
77
78          org.bluez.Error.NotSupported
79
80   void UnregisterPlayer(object player)
81          Unregister sender media player.
82
83   void RegisterApplication(object root, dict options)
84          Register endpoints an player objects within root object  which  must
85          implement ObjectManager.
86
87          The  application object path together with the D-Bus system bus con‐
88          nection ID define the identification of the application.
89
90          Possible errors:
91
92          org.bluez.Error.InvalidArguments
93
94          org.bluez.Error.AlreadyExists
95
96   void UnregisterApplication(object application)
97          This unregisters the services that has been  previously  registered.
98          The  object  path  parameter must match the same value that has been
99          used on registration.
100
101          Possible errors:
102
103          org.bluez.Error.InvalidArguments
104
105          org.bluez.Error.DoesNotExist
106
107   Properties
108   array{string} SupportedUUIDs [readonly]
109          List of 128-bit UUIDs that represents the supported Endpoint  regis‐
110          tration.
111
112
113
114
115BlueZ                           September 2023              ORG.BLUEZ.MEDIA(5)