Menghadirkan Visibilitas Native ke Pengalaman Aplikasi VoIP Anda dengan Telecom Alpha Terbaru

Peluncuran awal library Jetpack Telecom memperkenalkan CallsManager, yang menggantikan ConnectionService API lama untuk menyederhanakan integrasi VoIP. CallsManager menyederhanakan pengelolaan siklus proses panggilan dan pemilihan rute audio sekaligus memungkinkan interaksi dengan platform jarak jauh seperti smartwatch, perangkat Bluetooth, dan Android Auto. Selain itu, API ini mendukung ekstensi panggilan untuk fitur yang lebih lengkap—seperti penanganan peserta, ikon kustom, penonaktifan audio panggilan, dan ringkasan rapat di platform jarak jauh—sekaligus mempertahankan kompatibilitas mundur hingga Android O (API Level 26).

Berdasarkan fondasi ini, Jetpack Telecom v1.1.0 menghadirkan visibilitas dan kenyamanan tingkat native ke aplikasi VoIP pihak ketiga. Rilis terbaru ini memperkenalkan kemampuan baru yang canggih, termasuk histori panggilan terpadu, pengecualian log panggilan, dan fungsi callback native, sehingga pengelolaan panggilan menjadi lebih lancar dari sebelumnya bagi pengguna.

Berikut adalah penjelasan lebih lanjut tentang fitur baru dan cara menerapkannya di aplikasi Anda.

Menjembatani Kesenjangan Dialer: Histori panggilan terpadu dan Panggilan balik

Sebelumnya, pengguna harus membuka aplikasi pihak ketiga satu per satu untuk melihat histori panggilan VoIP atau membalas panggilan tak terjawab. Dengan fitur pencatatan panggilan terintegrasi yang baru, aplikasi telepon sistem kini dapat menampilkan log panggilan langsung dari aplikasi VoIP pihak ketiga.

Lebih baik lagi, pengguna kini dapat memulai panggilan balik ke kontak VoIP langsung dari dialer sistem bawaan mereka, sehingga menyederhanakan pengalaman komunikasi.

Cara kerjanya:

Untuk mengaktifkan fitur ini, lakukan hal berikut:

1. Mendaftar untuk Callback: Aplikasi VoIP Anda harus mendaftarkan intent baru yang dilindungi sistem: TelecomManager.ACTION_CALL_BACK.
2. Mencatat Panggilan: Gunakan TelecomManager.addCall (atau API Jetpack terkait) untuk memastikan sistem otomatis mencatat panggilan.
3. Mengelola ID Panggilan: Saat panggilan didaftarkan, CallControlScope.getCallId akan memberikan UUID unik. Penelepon sistem menggunakan TelecomManager.EXTRA_UUID ini persis seperti ini saat membuat maksud panggilan balik.
4. Mulai Panggilan Balik: Aplikasi Anda harus menyimpan dan mengelola detail panggilan yang terkait dengan UUID ini. Saat dialer sistem mengaktifkan intent callback dengan EXTRA_UUID, aplikasi Anda dapat menyelesaikan ID dengan lancar dan memulai panggilan dengan detail yang benar.

Kontrol Terperinci: Pengecualian Log Panggilan

Kami menyadari bahwa tidak semua panggilan VoIP harus terlihat di histori telepon bawaan sistem. Baik untuk alasan privasi, komunikasi sementara, atau perilaku khusus aplikasi, Anda memerlukan kontrol atas apa yang ditampilkan.

Untuk mengatasi hal ini, kami memperkenalkan Pengecualian Log Panggilan. Sekarang Anda dapat mencegah panggilan tertentu dicatat ke dalam log panggilan sistem dengan menyetel boolean isLogExcluded ke true dalam CallAttributesCompat. Dengan mengonfigurasi tanda ini, panggilan akan tetap sepenuhnya disembunyikan dari log sistem, dan telepon bawaan tidak akan menampilkannya.

Catatan Penting tentang Kompatibilitas

Fitur logging dan callback terintegrasi ini tersedia untuk perangkat yang menjalankan Android 16.1 (SDK 36.1) dan yang lebih baru. Lihat di sini untuk mengompilasi aplikasi Anda dengan Android SDK 36.1.

Mulai

Kami mendorong developer untuk menguji integrasi ini dan mempelajari cara histori panggilan dan panggilan balik terpadu dapat meningkatkan pengalaman pengguna harian aplikasi VoIP Anda.

Untuk membantu Anda memulai dan melihat cara kerja API ini, kami telah menyusun aplikasi contoh yang menunjukkan integrasi baru.

• Lihat aplikasi contoh di sini: https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

Lihat catatan rilis dan dokumentasi untuk mulai menerapkan fitur ini sekarang.

Catatan:: Meskipun API Jetpack Telecom v1.1.0 dapat diakses untuk integrasi, kemampuan aplikasi telepon sistem untuk merender log panggilan native diperkenalkan secara bertahap, dimulai dengan Google Meet. Untuk melindungi dari spam, aplikasi telepon bawaan menggunakan daftar aplikasi yang diizinkan paket yang aman untuk mengontrol tampilan VoIP. Untuk pengujian lokal terhadap implementasi callback dan logging, sebaiknya gunakan aplikasi Telecom Sample Dialer open source sebagai lingkungan emulator Anda.