借助 Telecom 的最新 Alpha 版，为 VoIP 应用体验带来原生可见性

Jetpack Telecom 库的初始版本推出了 CallsManager，取代了旧版 ConnectionService API，以简化 VoIP 集成。CallsManager 可简化通话生命周期管理和音频路由，同时支持与智能手表、蓝牙设备和 Android Auto 等远程界面进行互动。此外，它还支持通话扩展，可提供更丰富的功能，例如参与者处理、自定义图标、通话静音和远程界面上的会议摘要，同时还能向后兼容至 Android O（API 级别 26）。

在此基础上，Jetpack Telecom v1.1.0 为第三方 VoIP 应用带来了原生级别的可见性和便利性。最新版本引入了强大的新功能，包括统一的通话记录、通话记录排除和原生回拨功能，让用户能够比以往更顺畅地管理通话。

下面我们来详细了解一下新功能以及如何在应用中实现这些功能。

弥合拨号器差距：统一通话记录和回调

过去，用户必须打开各个第三方应用才能查看其 VoIP 通话记录或回拨未接电话。借助新的集成式通话记录功能，系统拨号器应用现在可以直接显示来自第三方 VoIP 应用的通话记录。

更棒的是，用户现在可以直接从原生系统拨号器向 VoIP 联系人发起回拨，从而简化通信体验。

工作方式：

如需选择启用此功能，请执行以下操作：

1. 注册回调：您的 VoIP 应用必须注册一个新的系统保护 intent：TelecomManager.ACTION_CALL_BACK。
2. 记录通话：使用 TelecomManager.addCall（或相关 Jetpack API）确保系统自动记录通话。
3. 管理通话 ID：注册通话后，CallControlScope.getCallId 会提供一个唯一的 UUID。系统拨号器在创建回拨 intent 时会使用此确切的 TelecomManager.EXTRA_UUID。
4. 发起回调：您的应用必须存储和管理与此 UUID 关联的通话详情。当系统拨号器使用 EXTRA_UUID 触发回调 intent 时，您的应用可以无缝解析该 ID，并使用正确的详细信息发起通话。

精细控制：通话记录排除

我们知道，并非所有 VoIP 通话都应显示在系统的原生拨号器历史记录中。无论是出于隐私原因、临时通信还是应用特定的行为，您都需要控制显示的内容。

为了解决此问题，我们推出了通话记录排除功能。现在，您可以通过在 CallAttributesCompat 中将 isLogExcluded 布尔值设置为 true，来防止特定通话记录到系统通话记录中。配置此标志后，通话将完全隐藏在系统日志中，原生拨号器也不会显示该通话。

关于兼容性的重要说明

这些集成的日志记录和回调功能适用于搭载 Android 16.1 (SDK 36.1) 及更高版本的设备。请参阅此处，了解如何使用 Android SDK 36.1 编译应用。

使用入门

我们建议开发者测试这些集成，并探索统一的通话记录和回拨功能如何改善 VoIP 应用的日常用户体验。

为了帮助您入门并了解这些 API 的实际应用，我们整理了一个演示新集成的示例应用。

• 如需查看示例应用，请访问： https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

请查看版本说明和文档，立即开始实现这些功能！

注意：虽然 Jetpack Telecom v1.1.0 API 可供集成，但系统拨号器呈现原生通话记录的功能正在分阶段推出，首先从 Google Meet 开始。为了防范垃圾内容，原生拨号器会利用安全软件包许可清单来控制 VoIP 显示。如需在本地测试回调和日志记录实现，我们建议您使用开源Telecom Sample Dialer 应用作为模拟器环境。