Menerapkan IMS

Android 9 memperkenalkan antarmuka SystemApi yang disebut ImsService untuk membantu Anda menerapkan IP Multimedia Subsystem (IMS). ImsService API adalah antarmuka yang ditentukan dengan baik antara platform Android dan implementasi IMS yang disediakan oleh vendor atau operator.

Ringkasan ImsService

Gambar 1. Ringkasan ImsService

Dengan menggunakan antarmuka ImsService, penerap IMS dapat memberikan informasi pensinyalan penting ke platform, seperti informasi pendaftaran IMS, integrasi SMS melalui IMS, dan integrasi fitur MmTel untuk menyediakan panggilan suara dan video. ImsService API juga merupakan Android System API, yang berarti API ini dapat dibangun langsung terhadap Android SDK, bukan terhadap sumber. Aplikasi IMS yang telah diinstal sebelumnya di perangkat juga dapat dikonfigurasi agar dapat diupdate melalui Play Store.

Contoh dan sumber

Android menyediakan aplikasi di AOSP yang mengimplementasikan sebagian ImsService API untuk tujuan pengujian dan pengembangan. Anda dapat menemukan aplikasi di /testapps/ImsTestService.

Anda dapat menemukan dokumentasi untuk ImsService API di ImsService dan di class lain dalam API.

Implementasi

ImsService API adalah API tingkat tinggi yang memungkinkan Anda menerapkan IMS dengan berbagai cara, bergantung pada hardware yang tersedia. Misalnya, penerapan berubah bergantung pada apakah penerapan IMS sepenuhnya berada di prosesor aplikasi atau apakah sebagian atau sepenuhnya di-offload ke modem. Android tidak menyediakan HAL publik untuk melakukan offload ke prosesor baseband, sehingga setiap offload harus terjadi menggunakan ekstensi HAL Anda ke modem.

Kompatibilitas dengan penerapan IMS lama

Meskipun Android 9 menyertakan ImsService API, perangkat yang menggunakan penerapan IMS yang lebih lama tidak dapat mendukung API tersebut. Untuk perangkat ini, antarmuka AIDL dan class wrapper yang lebih lama telah dipindahkan ke namespace android.telephony.ims.compat. Saat mengupgrade ke Android 9, perangkat lama harus melakukan hal berikut untuk melanjutkan dukungan API lama.

  • Ubah namespace penerapan ImsService untuk diperluas dari android.telephony.ims.compat namespace API.
  • Ubah definisi layanan ImsService di AndroidManifest.xml untuk menggunakan tindakan filter intent android.telephony.ims.compat.ImsService, bukan tindakan android.telephony.ims.ImsService.

Framework kemudian akan terikat ke ImsService menggunakan lapisan kompatibilitas yang disediakan di Android 9 untuk bekerja dengan implementasi ImsService lama.

Pendaftaran ImsService dengan framework

ImsService API diimplementasikan sebagai layanan, yang diikat oleh framework Android untuk berkomunikasi dengan implementasi IMS. Tiga langkah diperlukan untuk mendaftarkan aplikasi yang menerapkan ImsService dengan framework. Pertama, penerapan ImsService harus mendaftarkan dirinya ke platform menggunakan AndroidManifest.xml aplikasi; kedua, penerapan harus menentukan fitur IMS yang didukung (MmTel atau RCS); dan ketiga, penerapan harus diverifikasi sebagai penerapan IMS tepercaya baik dalam konfigurasi operator maupun overlay perangkat.

Definisi layanan

Aplikasi IMS mendaftarkan ImsService dengan framework dengan menambahkan entri service ke dalam manifes menggunakan format berikut:

<service
    android:name="com.egcorp.ims.EgImsService"
    android:directBootAware="true"
    Android:persistent="true"
    ...
    android:permission="android.permission.BIND_IMS_SERVICE" >
    ...
    <intent-filter>
        <action android:name="android.telephony.ims.ImsService" />
    </intent-filter>
</service>

Definisi service di AndroidManifest.xml menentukan atribut berikut, yang diperlukan untuk pengoperasian yang benar:

  • directBootAware="true": Memungkinkan layanan ditemukan dan dijalankan oleh telephony sebelum pengguna membuka kunci perangkat. Layanan tidak dapat mengakses penyimpanan yang dienkripsi perangkat sebelum pengguna membuka kunci perangkat. Untuk mengetahui informasi selengkapnya, lihat Mendukung mode Boot Langsung dan Enkripsi Berbasis File.
  • persistent="true": Memungkinkan layanan ini dijalankan secara persisten dan tidak dihentikan oleh sistem untuk mendapatkan kembali memori. Atribut ini HANYA berfungsi jika aplikasi dibangun sebagai aplikasi sistem.
  • permission="android.permission.BIND_IMS_SERVICE": Memastikan bahwa hanya proses yang telah diberi izin BIND_IMS_SERVICE yang dapat mengikat ke aplikasi. Hal ini mencegah aplikasi berbahaya mengikat ke layanan, karena hanya aplikasi sistem yang dapat diberi izin oleh framework.

Layanan juga harus menentukan elemen intent-filter dengan tindakan android.telephony.ims.ImsService. Hal ini memungkinkan framework menemukan ImsService.

Spesifikasi fitur IMS

Setelah ImsService ditentukan sebagai layanan Android di AndroidManifest.xml, ImsService harus menentukan fitur IMS yang didukungnya. Android saat ini mendukung fitur MmTel dan RCS, tetapi hanya MmTel yang diintegrasikan ke dalam framework. Meskipun tidak ada API RCS yang terintegrasi ke dalam framework, tetap ada keuntungan untuk mendeklarasikannya sebagai fitur ImsService.

Berikut adalah fitur valid yang ditentukan dalam android.telephony.ims.ImsFeature yang dapat disediakan oleh ImsService, serta penjelasan dan contoh alasan aplikasi IMS ingin menerapkan satu atau semua fitur ini. Setelah setiap fitur ditentukan, halaman ini menguraikan cara ImsService mendeklarasikan kumpulan fitur yang ditentukan untuk setiap slot SIM.

FEATURE_MMTEL

ImsService mengimplementasikan fitur MMTEL IMS, yang berisi dukungan untuk semua media IMS (spesifikasi IR.92 dan IR.94) kecuali lampiran darurat ke PDN IMS untuk panggilan darurat. Setiap penerapan ImsService yang ingin mendukung fitur MMTEL harus memperluas class dasar android.telephony.ims.MmTelFeature dan menampilkan penerapan MmTelFeature kustom di ImsService#createMmTelFeature.

FEATURE_EMERGENCY_MMTEL

Mendeklarasikan fitur ini hanya memberi sinyal kepada platform bahwa layanan darurat dapat terhubung ke PDN IMS untuk layanan darurat. Jika fitur ini tidak dideklarasikan untuk ImsService Anda, platform akan selalu menggunakan Pengalihan Jaringan untuk Layanan Darurat secara default. Fitur FEATURE_MMTEL harus ditentukan agar fitur ini dapat ditentukan.

FEATURE_RCS

ImsService API tidak menerapkan fitur IMS RCS apa pun, tetapi class dasar android.telephony.ims.RcsFeature masih dapat berguna. Framework secara otomatis terikat ke ImsService dan memanggil ImsService#createRcsFeature saat mendeteksi bahwa paket harus menyediakan RCS. Jika kartu SIM yang terkait dengan layanan RCS dihapus, framework akan otomatis memanggil RcsFeature#onFeatureRemoved, lalu membersihkan ImsService yang terkait dengan fitur RCS. Fungsi ini dapat menghapus beberapa logika deteksi atau pengikatan kustom yang seharusnya disediakan oleh fitur RCS.

Pendaftaran fitur yang didukung

Framework telepon pertama-tama mengikat ke ImsService untuk mengkueri fitur yang didukungnya menggunakan API ImsService#querySupportedImsFeatures. Setelah framework menghitung fitur mana yang akan didukung ImsService, framework akan memanggil ImsService#create[...]Feature untuk setiap fitur yang akan menjadi tanggung jawab ImsService. Jika fitur yang didukung aplikasi IMS berubah, Anda dapat menggunakan ImsService#onUpdateSupportedImsFeatures untuk memberi sinyal kepada framework agar menghitung ulang fitur yang didukung. Lihat diagram berikut untuk mengetahui informasi selengkapnya tentang inisialisasi dan pengikatan ImsService.

Inisialisasi dan pengikatan ImsService

Gambar 2. Inisialisasi dan pengikatan ImsService

Deteksi dan verifikasi framework penerapan ImsService

Setelah ImsService ditentukan dengan benar di AndroidManifest.xml, platform harus dikonfigurasi untuk mengikat (secara aman) ke ImsService jika sesuai. Ada dua jenis ImsService yang diikat framework:

  1. Layanan IMS "pengganti" operator: Layanan IMS ini telah dimuat sebelumnya ke dalam perangkat, tetapi terpasang ke satu atau beberapa operator seluler dan hanya akan terikat saat kartu SIM yang cocok dimasukkan. Hal ini dikonfigurasi menggunakan
  2. ImsService "default" perangkat: Ini adalah ImsService default yang dimuat ke perangkat oleh OEM dan harus dirancang untuk menyediakan layanan IMS dalam semua situasi saat ImsService operator tidak tersedia dan berguna dalam situasi saat perangkat tidak memiliki kartu SIM yang dimasukkan atau kartu SIM yang dimasukkan tidak memiliki ImsService operator yang diinstal bersamanya. Ini ditentukan dalam overlay perangkat menggunakan konfigurasi berikut:

Android tidak mendukung aplikasi dengan penerapan ImsService yang dapat didownload pihak ketiga, sehingga setiap penerapan ImsService yang ditentukan di sini harus berupa aplikasi Sistem dan harus berada di folder /system/priv-app/ atau /product/priv-app/ untuk memberikan izin yang sesuai (yaitu izin telepon, mikrofon, lokasi, kamera, dan kontak). Dengan memverifikasi apakah nama paket penerapan IMS cocok dengan nilai overlay CarrierConfig atau perangkat yang ditentukan di atas, hanya aplikasi bawaan yang tepercaya yang terikat.

Penyesuaian

Aplikasi yang menerapkan ImsService hanya terikat pada perangkat yang dikonfigurasi sebagai ImsService "pengganti" operator atau konfigurasi ImsService "default" perangkat untuk fungsi MMTEL atau RCS. ImsService juga memungkinkan fitur IMS yang didukungnya (MMTEL dan RCS) diaktifkan atau dinonaktifkan secara dinamis menggunakan update menggunakan metode ImsService#onUpdateSupportedImsFeatures. Hal ini memicu framework untuk menghitung ulang ImsService mana yang terikat dan fitur mana yang didukungnya. Jika aplikasi IMS mengupdate framework tanpa fitur yang didukung, ImsService akan dibatalkan ikatannya hingga ponsel di-reboot atau kartu SIM baru yang cocok dengan aplikasi IMS dimasukkan.

Prioritas pengikatan untuk beberapa ImsService

Framework tidak dapat mendukung pengikatan ke semua ImsService yang mungkin dimuat sebelumnya ke perangkat dan akan mengikat hingga dua ImsService per slot SIM (satu ImsService untuk setiap fitur) dalam urutan berikut berdasarkan per fitur:

  1. Nama paket ImsService yang ditentukan oleh nilai CarrierConfig config_ims_[mmtel/rcs]_package_override_string saat ada kartu SIM yang dimasukkan.
  2. Nama paket ImsService yang ditentukan dalam nilai overlay perangkat untuk config_ims_[mmtel/rcs]_packagetermasuk kasus saat tidak ada kartu SIM yang dimasukkan. ImsService ini HARUS mendukung fitur MmTel Darurat.

Anda harus memiliki nama paket ImsService yang ditentukan dalam CarrierConfig untuk setiap operator yang akan menggunakan paket tersebut atau dalam overlay perangkat jika ImsService Anda akan menjadi default, seperti yang ditentukan di atas.

Mari kita uraikan untuk setiap fitur. Untuk perangkat (SIM tunggal atau multi-SIM) dengan satu kartu SIM yang dimuat, dua fitur IMS dapat digunakan: MMTel dan RCS. Framework akan mencoba mengikat dalam urutan yang ditentukan di atas untuk setiap fitur dan jika fitur tidak tersedia untuk ImsService yang ditentukan dalam penggantian Konfigurasi Operator, framework akan melakukan penggantian ke ImsService default Anda. Jadi, misalnya, tabel di bawah ini menjelaskan fitur IMS mana yang akan digunakan framework mengingat tiga aplikasi IMS yang menerapkan ImsServices diinstal pada sistem dengan fitur berikut:

  • ImsService Operator A mendukung RCS
  • ImsService Operator B mendukung RCS dan MMTel
  • ImsService OEM mendukung RCS dan MMTel
Kartu SIM Dimasukkan Fitur RCS Fitur MMTel
Operator A Operator A OEM
Operator B Operator B Operator B
Tidak ada SIM OEM OEM

Validasi

Alat untuk memverifikasi penerapan IMS itu sendiri tidak disertakan karena spesifikasi IMS sangat besar dan menggunakan peralatan verifikasi khusus. Pengujian hanya dapat memverifikasi bahwa framework telephony merespons dengan benar terhadap ImsService API.

Mengembangkan aplikasi IMS

Saat mengembangkan aplikasi IMS yang berinteraksi dengan stack teleponi Android, sebaiknya tentukan bahwa aplikasi dapat memproses atau mengubah status instance ImsService yang dilampirkan untuk langganan operator tertentu.

Untuk memantau atau mengubah status ImsService untuk fitur MMTEL dan RCS, gunakan class ImsManager untuk mendapatkan instance ImsMmTelManager, ImsRcsManager, atau ProvisioningManager khusus IMS. Selanjutnya, aplikasi dapat memproses status layanan dan penyediaan khusus IMS seperti:

  • Fitur MMTEL atau RCS yang diaktifkan dan tersedia
  • Memperbarui saat status pendaftaran IMS berubah
  • Status penyediaan fitur IMS
  • Fitur IMS yang telah diaktifkan pengguna

Menggunakan ImsStateCallback

Meskipun ImsService adalah layanan yang terikat secara persisten, layanan yang terikat dapat berubah saat kartu SIM baru atau langganan tersemat menjadi aktif atau saat konfigurasi operator berubah. Karena ImsService bukan bagian dari proses teleponi, aplikasi mungkin mengalami pengecualian yang tidak terduga saat mencoba mengakses IMS API jika ImsService mengalami error secara tidak terlihat atau tidak terikat karena perubahan langganan atau konfigurasi.

Di perangkat yang menjalankan Android 13 atau yang lebih tinggi, untuk memantau apakah instance ImsService untuk langganan terkait tersedia atau tidak, aplikasi dapat menggunakan class ImsStateCallback. Saat mendapatkan instance ImsMmTelManager atau ImsRcsManager, sebaiknya aplikasi mendaftar terlebih dahulu untuk callback status IMS menggunakan ImsMmTelManager#registerImsStateCallback atau ImsRcsManager#registerImsStateCallback. Untuk terus menerima update callback untuk langganan tertentu saat ImsService tersedia kembali, aplikasi harus membatalkan pendaftaran atau menghapus callback yang ada yang terdaftar melalui ImsMmTelManager, ImsRcsManager, atau ProvisioningManager; dan mendaftarkan callback baru.

Jika ada langganan yang tidak mendukung IMS, framework akan memanggil ImsStateCallback#onUnavailable dengan alasan REASON_NO_IMS_SERVICE_CONFIGURED. Artinya, ImsService dan API terkait IMS tidak tersedia untuk langganan.

Jika proses teleponi mengalami error, aplikasi akan menerima ImsStateCallback#onError dan tidak lagi menerima update pada instance ImsStateCallback yang terdaftar. Untuk memulihkan dari kondisi ini, daftarkan ulang instance ImsStateCallback untuk langganan terkait dengan memanggil ImsMmTelManager#registerImsStateCallback atau ImsRcsManager#registerImsStateCallback.