Jetpack Telecom ライブラリの最初のリリースでは、CallsManager が導入され、従来の ConnectionService API に代わって 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（または関連する Jetpack API）を使用して、システムが通話を自動的に記録するようにします。
3. 通話 ID を管理する: 通話が登録されると、CallControlScope.getCallId によって一意の UUID が提供されます。システムの電話アプリは、コールバック インテントを作成するときに、この TelecomManager.EXTRA_UUID をそのまま使用します。
4. コールバックを開始する: アプリケーションは、この UUID に関連付けられた通話の詳細情報を保存して管理する必要があります。システムの電話アプリが EXTRA_UUID を使用してコールバック インテントを起動すると、アプリは ID をシームレスに解決し、正しい詳細情報を使用して通話を開始できます。

きめ細かい制御: 通話履歴の除外

すべての VoIP 通話がシステムのネイティブ電話アプリの履歴に表示されるべきではないことは、Google も十分に認識しています。プライバシー上の理由、一時的な通信、アプリ固有の動作など、表示される内容を制御する必要があります。

この問題を解決するために、通話履歴の除外 を導入します。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 アプリをエミュレータ環境として使用することをおすすめします。