Pedoman AEP: Android Telecom Framework

Berintegrasi dengan framework Android Telecom menggunakan library Core-Telecom Jetpack untuk memastikan 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 jam tangan.

Implementasi yang diperlukan

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

  • Pendaftaran panggilan: Semua panggilan VoIP masuk dan keluar harus didaftarkan dengan framework Telecom menggunakan CallsManager#addCall API.
  • Pengelolaan status: Gunakan CallControlScope dan konstruksi library lainnya untuk mencerminkan dan mengelola siklus proses status panggilan secara akurat, termasuk status panggilan, berdering, aktif, ditahan, dan terputus.
  • Penanganan audio: Jangan langsung menggunakan Audio atau Bluetooth API untuk mengelola fokus audio dan perutean. Sebagai gantinya, gunakan framework Telecom untuk menangani skenario panggilan serentak dan perubahan perangkat audio.
  • Notifikasi: Gunakan callStyle API untuk menampilkan notifikasi gaya panggilan yang konsisten dengan sistem Android.
  • Siklus proses layanan latar depan: Kelola siklus proses Layanan Latar Depan yang diperlukan untuk panggilan sesuai dengan praktik terbaik dan batasan Android.
  • Integrasi platform jarak jauh: Sinkronkan status dan kontrol panggilan dengan platform jarak jauh yang terhubung, seperti headset Bluetooth, perangkat Wear OS, dan Android Auto.
  • Skenario multi-panggilan: Tangani interaksi dengan panggilan lain secara lancar, seperti panggilan SIM masuk atau panggilan dari aplikasi VoIP lainnya, sehingga memastikan perilaku audio dan pengalaman pengguna yang dapat diprediksi.

Penerapan panduan

Panduan ini berlaku untuk:

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

Pengecualian

Pengecualian berikut berlaku untuk panduan ini:

  • Aplikasi yang secara teknis tidak dapat menggunakan dependensi AndroidX karena hambatan teknis seperti:
    • Konflik dependensi SDK
    • Batasan Project Open Source Android (AOSP)
    • Batasan sistem build Produsen Peralatan Asli (OEM)
  • Pengecualian sementara dapat diberikan untuk aplikasi yang mengalami masalah platform atau library signifikan yang mencegah migrasi stabil, asalkan ada linimasa yang jelas untuk penyelesaian dan masalah tersebut telah diterima oleh Google.
  • 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 implementasi dan detail teknis tentang Android Telecom Framework. Referensi ini hanya untuk referensi Anda dan tidak berisi persyaratan program tambahan.