Mengimplementasikan 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 vendor atau operator.

Ringkasan ImsService

Gambar 1. Ringkasan ImsService

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

Contoh dan sumber

Android menyediakan aplikasi di AOSP yang mengimplementasikan bagian 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 di API.

Implementasi

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

Kompatibilitas dengan penerapan IMS lama

Meskipun Android 9 menyertakan ImsService API, perangkat yang menggunakan implementasi lama untuk IMS tidak dapat mendukung API. Untuk perangkat ini, antarmuka AIDL dan class wrapper 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 implementasi ImsService untuk diperluas dari API namespace android.telephony.ims.compat.
  • 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 agar berfungsi dengan penerapan ImsService lama.

Pendaftaran ImsService dengan framework

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

Definisi layanan

Aplikasi IMS mendaftarkan ImsService dengan framework dengan menambahkan entri service ke 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 informasi selengkapnya, lihat Mendukung mode Booting Langsung dan Enkripsi Berbasis File.
  • persistent="true": Memungkinkan layanan ini dijalankan secara terus-menerus dan tidak dihentikan oleh sistem untuk mengklaim kembali memori. Atribut ini HANYA berfungsi jika aplikasi di-build 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 nakal 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 terintegrasi ke dalam framework. Meskipun tidak ada RCS API yang terintegrasi ke dalam framework, masih ada keuntungan untuk mendeklarasikannya sebagai fitur ImsService.

Berikut adalah fitur valid yang ditentukan dalam android.telephony.ims.ImsFeature yang dapat disediakan 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 menerapkan fitur IMS MMTEL, yang berisi dukungan untuk semua media IMS (spesifikasi IR.92 dan IR.94) kecuali lampiran darurat ke PDN IMS untuk panggilan darurat. Setiap implementasi ImsService yang ingin mendukung fitur MMTEL harus memperluas class dasar android.telephony.ims.MmTelFeature dan menampilkan implementasi MmTelFeature kustom di ImsService#createMmTelFeature.

FEATURE_EMERGENCY_MMTEL

Mendeklarasikan fitur ini hanya memberi sinyal ke platform bahwa lampiran darurat ke PDN IMS untuk layanan darurat dapat dilakukan. Jika fitur ini tidak dideklarasikan untuk ImsService Anda, platform akan selalu ditetapkan secara default ke Circuit Switch Fallback untuk layanan darurat. Fitur FEATURE_MMTEL harus ditentukan agar fitur ini dapat ditentukan.

FEATURE_RCS

ImsService API tidak mengimplementasikan fitur IMS RCS apa pun, tetapi class dasar android.telephony.ims.RcsFeature masih dapat berguna. Framework 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 binding kustom yang harus disediakan oleh fitur RCS.

Pendaftaran fitur yang didukung

Framework telefoni pertama-tama terikat dengan ImsService untuk membuat kueri fitur yang didukungnya menggunakan ImsService#querySupportedImsFeatures API. Setelah menghitung fitur yang akan didukung ImsService, framework akan memanggil ImsService#create[...]Feature untuk setiap fitur yang akan ditangani ImsService. Jika fitur yang didukung aplikasi IMS berubah, Anda dapat menggunakan ImsService#onUpdateSupportedImsFeatures untuk memberi sinyal ke framework agar menghitung ulang fitur yang didukung. Lihat diagram berikut untuk mengetahui informasi selengkapnya tentang inisialisasi dan binding 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 (dengan aman) mengikat ke ImsService jika sesuai. Ada dua jenis ImsServices yang diikat oleh framework:

  1. ImsService "penggantian" operator: ImsService ini dimuat sebelumnya ke perangkat, tetapi dilampirkan ke satu atau beberapa operator seluler dan hanya akan diikat 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. Hal ini ditentukan dalam overlay perangkat menggunakan konfigurasi berikut:

Android tidak mendukung aplikasi dengan implementasi ImsService pihak ketiga yang dapat didownload, sehingga setiap implementasi 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 ponsel, mikrofon, lokasi, kamera, dan kontak). Dengan memverifikasi apakah nama paket implementasi IMS cocok dengan nilai overlay perangkat atau CarrierConfig yang ditentukan di atas, hanya aplikasi tepercaya yang diprainstal yang terikat.

Penyesuaian

Aplikasi yang mengimplementasikan ImsService hanya terikat pada perangkat tempat dikonfigurasi sebagai konfigurasi ImsService "penggantian" operator atau 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. Tindakan ini memicu framework untuk menghitung ulang ImsServices mana yang terikat dan fitur mana yang didukungnya. Jika aplikasi IMS mengupdate framework tanpa fitur yang didukung, ImsService akan di-unbound hingga ponsel dimulai ulang atau kartu SIM baru dimasukkan yang cocok dengan aplikasi IMS.

Prioritas binding untuk beberapa ImsService

Framework tidak dapat mendukung binding ke semua kemungkinan ImsServices yang dimuat sebelumnya ke perangkat dan akan mengikat hingga dua ImsServices 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 (single 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 Pembawa, framework akan kembali ke ImsService default Anda. Jadi, misalnya, tabel di bawah menjelaskan fitur IMS yang akan digunakan framework dengan tiga aplikasi IMS yang mengimplementasikan ImsServices yang diinstal di 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 telefoni merespons ImsService API dengan benar.

Mengembangkan aplikasi IMS

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

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

  • Fitur MMTEL atau RCS yang diaktifkan dan tersedia
  • Diperbarui 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 telefoni, 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 tersedia, 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 lagi, 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 telefoni 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.