使用 Core-Telecom Jetpack 库与 Android Telecom 框架集成,以确保操作系统将 IP 语音 (VoIP) 通话视为核心功能,与基于 SIM 卡的传统通话同等对待。此集成可统一通话管理、改进音频处理,并实现与头戴式耳机和手表等远程设备的兼容性。
必需的实现
如需符合 AEP 条件,您的应用必须遵守以下要求:
| ID | 指南 |
|---|---|
| AEP-TC-GAA | 通话注册:所有来电和去电 VoIP 通话都必须使用 CallsManager#addCall API 向 Telecom 框架注册。 |
| AEP-TC-GAB | 状态管理:使用 CallControlScope 和其他库构造来准确反映和管理通话状态生命周期,包括拨号、响铃、通话中、保持和断开连接状态。 |
| AEP-TC-GAC | 音频处理:请勿直接使用音频或蓝牙 API 来管理音频焦点和路由;而应依赖 Telecom 框架来处理并发通话场景和音频设备更改。 |
| AEP-TC-GAD | 通知:使用 callStyle API 显示与 Android 系统一致的通话风格通知。 |
| AEP-TC-GAE | 前台服务生命周期:根据 Android 最佳实践和限制,管理通话所需的任何前台服务的生命周期。 |
| AEP-TC-GAF | 远程界面集成:与已连接的远程界面(如蓝牙耳机、Wear OS 设备和 Android Auto)同步通话状态和控件。 |
| AEP-TC-GAG | 多通电话场景:妥善处理与其他通话的互动,例如来电的 SIM 卡通话或其他 VoIP 应用的通话,确保音频行为和用户体验可预测。 |
指南适用性
本准则适用于:
- 应用提供 IP 语音 (VoIP) 通话功能。
- 应用可供使用的所有设备规格。
豁免
以下情况可免于遵守此准则:
| ID | 豁免 |
|---|---|
| 由于技术障碍而无法在技术上采用 AndroidX 依赖项的应用,例如: | |
| AEP-TC-EAA | SDK 依赖项冲突。 |
| AEP-TC-EAB | Android 开源项目 (AOSP) 限制。 |
| AEP-TC-EAC | 原始设备制造商 (OEM) 构建系统限制。 |
| AEP-TC-EAD | 如果应用遇到严重的平台或库问题,导致无法稳定迁移,则可以申请临时豁免。但前提是,必须有明确的问题解决时间表,并且 Google 已接受该问题。 |
| AEP-TC-EAE | 应用可以使用同等替代框架,该框架可在整个生态系统中提供类似的质量、用户功能、稳定性和兼容性。如果您有合适的框架可供考虑,请与支持团队联系。 |
功能文档和资源
以下资源提供了有关 Android Telecom 框架的实现指南和技术详情。这些资源仅供参考,不包含其他计划要求。