Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
44 lines (34 sloc) 1.42 KB

UPnP Services

Sonos devices offer several UPnP services which are accessible from classes in the :mod:`soco.services` module.

All services take a :class:`soco.SoCo` instance as their first parameter.

Inspecting

To get a list of supported actions you can call the service's :meth:`soco.services.Service.iter_actions`. It yields the service's actions with their in_arguments (ie parameters to pass to the action) and out_arguments (ie returned values).

Each action is an :class:`soco.services.Action` namedtuple, consisting of action_name (a string), in_args (a list of :class:`soco.services.Argument` namedtuples consisting of name and argtype), and out_args (ditto), eg:

Events

You can subscribe to the events of a service using the :meth:`soco.services.Service.subscribe` method. See :ref:`events` for details.