.. _api_device_management:

Device Management Service
==========================

Once the SDK is instantiated, applications have access to the device management service. Currently, this allows managing audio input and output devices. This service provides the ability to:

 - Get the available audio devices
 - Set the preferred input and output devices
 - Check the currently set input and output device
 - Receive events about audio devices that have been added, removed, or changed as well as device failures

.. _devman_serv:

Device Management Interface
----------------------------
#include <dolbyio/comms/device_management.h>

.. doxygenclass:: dolbyio::comms::services::device_management

Device Events
-------------
The :ref:`api_device_management` events that are emitted by the SDK. They can be subscribed to using the
:cpp:func:`device_management::add_event_handler <dolbyio::comms::services::device_management::add_event_handler>` methods. 

.. doxygenstruct:: dolbyio::comms::audio_device_added
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::audio_device_removed
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::audio_device_changed
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::audio_device_timeout_failure
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::audio_volume_changed
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::video_device_added
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::video_device_removed
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::video_device_changed
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::video_device_error
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::screen_share_error
	:project: C++ SDK

.. _devman_models:

Device Structs
---------------
Other structures used by the :ref:`api_device_management` that are not defined in the :ref:`devman_serv` interface.

.. doxygenclass:: dolbyio::comms::audio_device
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::camera_device
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::screen_share_source
	:project: C++ SDK

.. doxygenenum:: dolbyio::comms::default_audio_device_policy
	:project: C++ SDK

.. doxygenstruct:: dolbyio::comms::linear_volume
        :project: C++ SDK