Первоначально при запуске библиотеки Jetpack Telecom был представлен CallsManager , заменивший устаревший API ConnectionService для упрощения интеграции VoIP. CallsManager оптимизирует управление жизненным циклом вызовов и маршрутизацию звука, а также позволяет взаимодействовать с удаленными устройствами, такими как смарт-часы, устройства Bluetooth и Android Auto. Кроме того, он поддерживает расширения вызовов для более расширенных функций, таких как обработка участников, пользовательские значки, отключение звука вызова и сводка совещания на удаленных устройствах, — и все это с сохранением обратной совместимости вплоть до Android O (уровень API 26).

Основываясь на этом фундаменте, Jetpack Telecom v1.1.0 обеспечивает нативный уровень видимости и удобства для сторонних VoIP-приложений. В этом последнем релизе представлены новые мощные возможности, включая единую историю звонков, исключение звонков из журнала и встроенную функцию обратного вызова, что делает управление звонками более простым, чем когда-либо, для пользователей.

Давайте подробнее рассмотрим, что нового появилось и как вы можете внедрить эти функции в свои приложения.

Преодоление разрыва в доступности системы дозвона: единая история звонков и обратные звонки.

Исторически сложилось так, что пользователям приходилось открывать отдельные сторонние приложения, чтобы просмотреть историю своих VoIP-звонков или перезвонить на пропущенный вызов. Благодаря новой интегрированной функции регистрации звонков, системные приложения для набора номера теперь могут отображать журналы звонков непосредственно из сторонних VoIP-приложений.

Более того, теперь пользователи могут инициировать обратный звонок VoIP-контакту прямо из своего стандартного приложения для набора номера, что упрощает процесс общения.

Как это работает:

Чтобы включить эту функцию, выполните следующие действия:

1. Регистрация обратных вызовов: Ваше VoIP-приложение должно зарегистрировать новый защищенный системой интент: TelecomManager.ACTION_CALL_BACK .
2. Зарегистрируйте звонок: используйте TelecomManager.addCall (или аналогичные API Jetpack), чтобы система автоматически регистрировала звонок.
3. Управление идентификаторами вызовов: При регистрации вызова метод CallControlScope.getCallId предоставляет уникальный UUID. Системный дозвонщик использует именно этот TelecomManager.EXTRA_UUID при создании намерения обратного вызова.
4. Инициирование обратного вызова: Ваше приложение должно хранить и управлять данными вызова, связанными с этим UUID. Когда системный дозвонщик отправляет интент обратного вызова с EXTRA_UUID , ваше приложение может беспрепятственно определить идентификатор и инициировать вызов с правильными данными.

Детальный контроль: исключение записей из журнала звонков

Мы понимаем, что не каждый VoIP-звонок должен быть виден в истории звонков встроенного в систему средства набора номера. По соображениям конфиденциальности, из-за возможности передачи информации в течение короткого времени или особенностей работы приложения, вам необходимо контролировать то, что отображается.

Для решения этой проблемы мы представляем функцию исключения из журналов вызовов . Теперь вы можете предотвратить запись определенных вызовов в системные журналы вызовов, установив логическую переменную isLogExcluded в true в классе CallAttributesCompat . Настроив этот флаг, вы полностью скроете вызов от системных журналов, и встроенный номеронабиратель его не отобразит.

Важное примечание о совместимости

Эти встроенные функции логирования и обратного вызова доступны для устройств под управлением Android 16.1 (SDK 36.1) и выше. Инструкции по компиляции вашего приложения с помощью Android SDK 36.1 см. здесь .

Начать

Мы призываем разработчиков протестировать эти интеграции и изучить, как унифицированная история звонков и обратные вызовы могут улучшить повседневный пользовательский опыт ваших VoIP-приложений.

Чтобы помочь вам начать работу и увидеть эти API в действии, мы подготовили пример приложения, демонстрирующий новые интеграции.

• Посмотреть пример приложения можно здесь: https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

Ознакомьтесь с примечаниями к выпуску и документацией , чтобы начать внедрение этих функций уже сегодня!

Примечание: Хотя API Jetpack Telecom v1.1.0 доступны для интеграции, возможность отображения журналов вызовов в системном дозвонщике внедряется поэтапно, начиная с Google Meet. Для защиты от спама в нативных дозвонщиках используются защищенные списки разрешенных пакетов для управления отображением VoIP-сообщений. Для локального тестирования ваших реализаций обратного вызова и ведения журналов мы рекомендуем использовать приложение Telecom Sample Dialer с открытым исходным кодом в качестве среды эмулятора.