Pedoman AEP: Android Telecom Framework

Lakukan integrasi dengan framework Telecom Android menggunakan library Jetpack Core-Telecomuntuk memastikan bahwa panggilan Voice over IP (VoIP) diperlakukan sebagai fitur inti oleh sistem operasi, setara dengan panggilan berbasis SIM tradisional. Integrasi ini menyatukan pengelolaan panggilan, meningkatkan penanganan audio, dan memungkinkan kompatibilitas dengan perangkat jarak jauh seperti headset dan smartwatch.

Implementasi yang diperlukan

Agar memenuhi syarat untuk AEP, aplikasi Anda harus mematuhi persyaratan berikut:

ID Panduan
AEP-TC-GAA Pendaftaran panggilan: Semua panggilan VoIP masuk dan keluar harus didaftarkan dengan framework Telecom menggunakan CallsManager#addCall API.
AEP-TC-GAB Pengelolaan status: Gunakan CallControlScope dan konstruksi library lainnya untuk secara akurat mencerminkan dan mengelola siklus proses status panggilan, termasuk status melakukan panggilan, berdering, aktif, ditahan, dan terputus.
AEP-TC-GAC Penanganan audio: Jangan langsung menggunakan Audio atau Bluetooth API untuk mengelola fokus audio dan pemilihan rute; sebagai gantinya, andalkan framework Telecom untuk menangani skenario panggilan serentak dan perubahan perangkat audio.
AEP-TC-GAD Notifikasi: Gunakan callStyle API untuk menampilkan notifikasi gaya panggilan yang konsisten dengan sistem Android.
AEP-TC-GAE Siklus proses layanan latar depan: Kelola siklus proses Layanan Latar Depan yang diperlukan untuk panggilan sesuai dengan praktik terbaik dan batasan Android.
AEP-TC-GAF Integrasi platform jarak jauh: Menyinkronkan status panggilan dan kontrol dengan platform jarak jauh yang terhubung, seperti headset Bluetooth, perangkat Wear OS, dan Android Auto.
AEP-TC-GAG Skenario multi-panggilan: Menangani interaksi dengan panggilan lain dengan baik, seperti panggilan SIM masuk atau panggilan dari aplikasi VoIP lain, sehingga memastikan perilaku audio dan pengalaman pengguna yang dapat diprediksi.

Penerapan pedoman

Pedoman ini berlaku untuk:

  • Aplikasi menyediakan kemampuan panggilan Voice over IP (VoIP).
  • Semua faktor bentuk tempat aplikasi tersedia.

Pengecualian

Pengecualian berikut berlaku untuk panduan ini:

ID Pembebasan
Aplikasi yang secara teknis tidak dapat mengambil dependensi AndroidX karena hambatan teknis seperti:
AEP-TC-EAA Konflik dependensi SDK.
AEP-TC-EAB Batasan Project Open Source Android (AOSP).
AEP-TC-EAC Batasan sistem build Produsen Peralatan Asli (OEM).
AEP-TC-EAD Pengecualian sementara dapat diberikan untuk aplikasi yang mengalami masalah platform atau library signifikan yang mencegah migrasi yang stabil, asalkan ada jadwal yang jelas untuk penyelesaian dan masalah tersebut telah diterima oleh Google.
AEP-TC-EAE Aplikasi dapat menggunakan framework alternatif yang setara yang memberikan kualitas, kemampuan pengguna, stabilitas, dan kompatibilitas serupa di seluruh ekosistem. Hubungi dukungan jika Anda memiliki framework yang sesuai untuk dipertimbangkan.

Dokumentasi dan referensi fitur

Referensi berikut memberikan panduan penerapan dan detail teknis tentang Android Telecom Framework. Referensi ini hanya untuk Anda dan tidak berisi persyaratan program tambahan.