AEP ガイドライン: Android Telecom Framework

Core-Telecom Jetpack ライブラリを使用して Android Telecom フレームワークと統合し、VoIP(Voice over IP)通話がオペレーティング システムによって従来の SIM ベースの通話と同等のコア機能として扱われるようにします。この統合により、通話管理が統合され、音声処理が改善され、ヘッドセットやスマートウォッチなどのリモート デバイスとの互換性が実現します。

実装の要件

AEP の対象となるには、アプリが次の要件を満たしている必要があります。

  • 通話の登録: すべての VoIP 着信通話と発信通話は、CallsManager#addCall API を使用して Telecom フレームワークに登録する必要があります。
  • 状態管理: CallControlScope やその他のライブラリ コンストラクトを使用して、通話状態のライフサイクル(発信、着信、通話中、保留、切断など)を正確に反映し、管理します。
  • 音声処理: 音声フォーカスとルーティングを管理するために、Audio API または Bluetooth API を直接使用しないでください。代わりに、Telecom フレームワークを使用して、同時通話のシナリオとオーディオ機器の変更を処理してください。
  • 通知: callStyle API を使用して、Android システムと一貫性のある通話スタイルの通知を表示します。
  • フォアグラウンド サービスのライフサイクル: Android のベスト プラクティスと制限事項に従って、通話に必要なフォアグラウンド サービスのライフサイクルを管理します。
  • リモート サーフェス統合: 通話状態とコントロールを、Bluetooth ヘッドセット、Wear OS デバイス、Android Auto などの接続されたリモート サーフェスと同期します。
  • 複数通話のシナリオ: 着信 SIM 通話や他の VoIP アプリケーションからの通話など、他の通話とのやり取りを適切に処理し、予測可能な音声動作とユーザー エクスペリエンスを確保します。

ガイドラインの適用範囲

このガイドラインは、以下に適用されます。

  • アプリは Voice over IP(VoIP)通話機能を提供します。
  • アプリを利用できるすべてのフォーム ファクタ。

除外

このガイドラインには、次の例外が適用されます。

  • 技術的な障壁(以下など)により、技術的に AndroidX 依存関係を取得できないアプリ。
    • SDK の依存関係の競合
    • Android オープンソース プロジェクト(AOSP)の制約
    • 相手先ブランド製品製造企業(OEM)のビルドシステムの制限
  • プラットフォームまたはライブラリの重大な問題により安定した移行が妨げられているアプリについては、一時的な免除が認められる場合があります。ただし、解決の明確なスケジュールがあり、Google が問題を認めていることが条件となります。
  • アプリは、エコシステム全体で同等の品質、ユーザー機能、安定性、互換性を提供する同等の代替フレームワークを使用できます。検討に適したフレームワークをお持ちの場合は、サポートにお問い合わせください。

機能のドキュメントとリソース

以下のリソースでは、Android Telecom Framework の実装ガイダンスと技術的な詳細について説明します。これらのリソースは参考用であり、追加のプログラム要件は含まれていません。