Jetpack Telecom 程式庫的初始版本推出 CallsManager，取代舊版 ConnectionService API，簡化 VoIP 整合作業。CallsManager 可簡化通話生命週期管理和音訊轉送作業，同時與智慧手錶、藍牙裝置和 Android Auto 等遠端介面互動。此外，這項功能還支援通話擴充功能，提供更豐富的功能，例如處理參與者、自訂圖示、通話靜音，以及在遠端介面上顯示會議摘要，同時維持回溯相容性，支援 Android O (API 級別 26)。

Jetpack Telecom 1.1.0 版以這個基礎為建構依據，為第三方 VoIP 應用程式帶來原生層級的能見度和便利性。這個最新版本導入了強大的新功能，包括統一通話記錄、通話記錄排除功能和原生回撥功能，讓使用者能以前所未有的順暢方式管理通話。

以下將詳細介紹這些新功能，以及如何在應用程式中導入這些功能。

Bridging the Dialer Gap: Unified call history and Callbacks

過去，使用者必須開啟個別第三方應用程式，才能查看 VoIP 通話記錄或回撥未接來電。透過全新整合的通話記錄功能，系統撥號應用程式現在可以直接顯示第三方 VoIP 應用程式的通話記錄。

更棒的是，使用者現在可以直接透過原生系統撥號程式，對 VoIP 聯絡人發起回撥，進一步簡化通訊體驗。

運作方式：

如要啟用這項功能，請按照下列步驟操作：

1. 註冊回呼：VoIP 應用程式必須註冊新的系統保護意圖：TelecomManager.ACTION_CALL_BACK。
2. 記錄通話：使用 TelecomManager.addCall (或相關的 Jetpack API)，確保系統自動記錄通話。
3. 管理通話 ID：註冊通話時，CallControlScope.getCallId 會提供專屬 UUID。系統撥號程式會在建立回呼意圖時使用這個 TelecomManager.EXTRA_UUID。
4. 啟動回呼：應用程式必須儲存及管理與這個 UUID 相關聯的通話詳細資料。當系統撥號器觸發含有 EXTRA_UUID 的回呼意圖時，應用程式可以順利解析 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 應用程式做為模擬器環境。