Обеспечьте нативную видимость вашего VoIP-приложения с помощью последней альфа-версии от Telecom.

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

Building on this foundation, Jetpack Telecom v1.1.0 brings native-level visibility and convenience to third-party VoIP apps. This latest release introduces powerful new capabilities, including unified call history, call log exclusion, and native callback functionality, making call management more seamless than ever for users.

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

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

Historically, users have had to open individual third-party apps to view their VoIP call history or return a missed call. With the new integrated call logging feature, system dialer apps can now surface call logs directly from third-party VoIP apps.

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

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

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

1. Регистрация обратных вызовов: Ваше VoIP-приложение должно зарегистрировать новый защищенный системой интент: TelecomManager.ACTION_CALL_BACK .
2. Зарегистрируйте звонок: используйте TelecomManager.addCall (или аналогичные API Jetpack), чтобы система автоматически регистрировала звонок.
3. Управление идентификаторами вызовов: При регистрации вызова метод CallControlScope.getCallId предоставляет уникальный UUID. Системный дозвонщик использует именно этот TelecomManager.EXTRA_UUID при создании намерения обратного вызова.
4. Initiate the Callback: Your application must store and manage the call details associated with this UUID. When the system dialer fires the callback intent with the EXTRA_UUID , your app can seamlessly resolve the ID and initiate the call with the correct details.

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

We recognize that not every VoIP call should be visible in the system's native dialer history. Whether for privacy reasons, ephemeral communication, or app-specific behavior, you need control over what gets surfaced.

To address this, we are introducing Call Log Exclusion . You can now prevent specific calls from being logged into the system call logs by setting the isLogExcluded boolean to true within CallAttributesCompat . By configuring this flag, the call remains completely hidden from the system logs, and the native dialer will not display it.

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

Эти встроенные функции логирования и обратного вызова доступны для устройств под управлением 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 с открытым исходным кодом в качестве среды эмулятора.