Call.AudioControl1
Интерфейс ru.auroraos.Call.AudioControl1 для работы с Call API.
Call.AudioControl1 используется для управления устройствами ввод и вывода звука.
Подробнее…
| Шина: | сессионная |
| Служба: | определяется приложением |
| Объект: | определяется приложением |
| Интерфейс: | ru.auroraos.Call.AudioControl1 |
Методы
- void UpdateAudioRouteState(vector<tuple<string, int, bool, bool, string, map<string, string>>>& devices, bool mute_microphone, string active_input_device_id, string active_output_device_id)
- void UpdateAudioRoute(bool mute_microphone, string active_input_device_id, string active_output_device_id)
Сигналы
- void RequestMute(bool mute)
- void RequestAudioRoute(string request_input_device_id, string request_output_device_id)
Подробное описание
С помощью интерфейса ru.auroraos.Call.AudioControl1 приложение может синхронизировать своё отображение
выбранного устройства вывода звука с приложением "Телефон".
При изменении текущего устройства через интерфейс "Телефона" операционная система вызывает метод
ru.auroraos.Call.AudioControl1.UpdateAudioRoute, а при добавлении/удалении
устройств (например, bluetooth-гарнитур) вызывает метод
ru.auroraos.Call.AudioControl1.UpdateAudioRouteState.
При изменении текущего устройства или приглушении микрофона через интерфейс VoIP приложения
следует испустить сигнал ru.auroraos.Call.AudioControl1.RequestAudioRoute и
ru.auroraos.Call.AudioControl1.RequestMute соответственно.
После обработки запроса операционная система сообщит об изменениях вызовом
ru.auroraos.Call.AudioControl1.UpdateAudioRoute.
Описание методов
void UpdateAudioRouteState (array<struct<string, int, bool, bool, string, dict<string, variant>>>& devices, bool mute_microphone, string active_input_device_id, string active_output_device_id)
Сообщает об изменениях в списке доступных аудиоустройств.
devices— массив структур, представляющих доступные аудиоустройства, где каждая стуктура содержит:string— уникальная строка для идентификации устройства;int— тип устройства, один из:- 0 — устройство отключено (отключён MDM или недоступно);
- 1 — встроенный микрофон;
- 2 — встроенный наушник;
- 3 — встроенный динамик громкой связи (hands-free);
- 4 — проводная гарнитура;
- 5 — USB-гарнитура;
- 6 — Bluetooth.
bool—true, если устройство имеет входные данные;bool—true, если устройство имеет выходные данные;string— удобочитаемое название устройства. Может быть пустым для устройств, не являющихся беспроводными;dict<string, variant>— дополнительная информация об устройстве. Зарезервировано для использования в будущем. Не поддерживается на данный момент.
mute_microphone—true, если микрофон отключён.active_input_device_id— идентификатор устройства ввода, используемого в данный момент.active_output_device_id— идентификатор устройства выхода, используемого в данный момент.
void UpdateAudioRoute(bool mute_microphone, string active_input_device_id, string active_output_device_id)
Сообщает об изменении маршрута аудиосигнала.
mute_microphone—true, если микрофон отключён.active_input_device_id— идентификатор устройства ввода, используемого в данный момент.active_output_device_id— идентификатор устройства выхода, используемого в данный момент.
Описание сигналов
void RequestMute(bool mute)
Запрос на включение/выключение звука микрофона.
mute—true, если необходимо отключить микрофон.
void RequestAudioRoute(string request_input_device_id, string request_output_device_id)
Запрос маршрутизации аудиоустройств с выбранными идентификаторами.
Устройство по умолчанию будет маршрутизировано, если указана пустая строка, несуществующий
ID или ID устройства Null.
request_input_device_id— идентификатор устройства ввода, на которое требуется направить звук.request_output_device_id— идентификатор устройства вывода, с которого требуется захватывать звук.