Menerapkan Affordance Darurat

Semua perangkat seluler yang dijual di India mulai 1 Januari 2017 harus menyediakan tombol darurat untuk memenuhi persyaratan Departemen Telekomunikasi (DoT) India. Untuk memenuhi persyaratan peraturan ini, Android menyertakan implementasi referensi fitur Tampilan Darurat untuk mengaktifkan tombol panik di perangkat Android.

Fitur ini diaktifkan secara default di rilis Android 8.0 dan yang lebih tinggi, tetapi harus di-patch ke build yang ada pada rilis sebelumnya. Fitur ini secara eksklusif ditujukan untuk perangkat yang dijual di pasar India, tetapi dapat disertakan di semua perangkat yang dijual di seluruh dunia karena fitur ini tidak berpengaruh di luar India.

Contoh dan sumber

Fitur Kemudahan Darurat diterapkan di project frameworks/base Project Open Source Android (AOSP). Fitur ini tersedia di cabang rilis terbaru Android dan diaktifkan secara default di rilis Android 8.0 dan yang lebih tinggi.

Fitur ini tersedia di cabang dan commit berikut. Informasi ini diberikan agar produsen perangkat dapat menerapkan perubahan yang diperlukan ke build yang ada. Produsen perangkat yang ingin menerapkan fitur Rujukan AOSP untuk Kemudahan Akses Darurat dapat memilih commit dari cabang yang berlaku ke dalam build mereka sendiri.

Tabel 1. Pilihan untuk fitur Rujukan AOSP terkait Kemudahan Darurat (Emergency Affordance)

Implementasi

Fitur Akses Cepat Darurat tidak membuat perubahan pada API yang diekspos melalui Android Software Development Kit (SDK). Jika diaktifkan, fitur ini menyediakan dua pemicu yang dapat memulai panggilan darurat ke 112, yang merupakan satu-satunya nomor darurat yang akan digunakan di India dan diwajibkan oleh peraturan DoT India.

Panggilan darurat dimulai oleh:

Menekan lama tombol DARURAT di layar kunci	Mengetuk opsi Darurat di Menu Tindakan Global
Gambar 1. Tombol DARURAT di layar kunci.	Gambar 2. Tindakan darurat di Menu Tindakan Global (dapat diakses dengan menekan lama tombol daya).

Fitur ini memperkenalkan komponen internal berikut:

• EmergencyAffordanceManager

      frameworks/base/core/java/com/android/internal/policy/EmergencyAffordanceManager.java
      

• EmergencyAffordanceService

      frameworks/base/services/core/java/com/android/server/emergency/EmergencyAffordanceService.java
      

EmergencyAffordanceManager

EmergencyAffordanceManager menyediakan API internal untuk menggunakan fitur Affordance Darurat. API ini menyediakan metode untuk memulai panggilan darurat dan mengkueri saat runtime jika fitur harus diaktifkan.

• void performEmergencyCall(). Memulai panggilan darurat.
• boolean needsEmergencyAffordance(). Menentukan apakah fitur harus aktif.

Fitur ini dapat dinonaktifkan secara permanen pada waktu build dengan mengubah konstanta EmergencyAffordanceManager.ENABLED menjadi false. Hal ini menyebabkan needsEmergencyAffordance() selalu menampilkan false dan mencegah EmergencyAffordanceService dimulai.

EmergencyAffordanceService

EmergencyAffordanceService adalah layanan sistem yang memantau Kode Negara Seluler (MCC) dari semua jaringan seluler yang terdeteksi dan MCC dari kartu SIM yang terpasang. Jika salah satu kartu SIM yang terpasang atau jaringan seluler yang terdeteksi memiliki MCC yang cocok dengan salah satu MCC India (404 atau 405), fitur ini akan diaktifkan. Artinya, fitur ini dapat diaktifkan di India meskipun tidak ada kartu SIM. Diasumsikan jaringan seluler mengizinkan pendaftaran untuk panggilan darurat meskipun tanpa kartu SIM yang terpasang. Fitur ini tetap diaktifkan hingga SIM non-India dipasang dan tidak ada jaringan yang terdeteksi memiliki MCC yang cocok.

Resource dan setelan berikut memengaruhi perilaku fitur Akses Darurat. Jika jenis konfigurasi adalah:

• Resource: Resource internal yang ditentukan dalam frameworks/base/core/res/res/values/config.xml.
• Setelan: Setelan yang disimpan di penyedia setelan sistem.

Tabel 2. Setelan yang memengaruhi perilaku fitur Akses Darurat

Mengaktifkan panggilan darurat ke 112

Fitur Kemudahan Darurat menghubungkan panggilan menggunakan pemanggil darurat sehingga panggilan dapat terhubung saat layar kunci aktif. Penelepon darurat menghubungkan panggilan hanya ke daftar nomor yang disediakan oleh Radio Interface Layer (RIL) melalui properti sistem:

• ril.ecclist saat tidak ada SIM yang terpasang.
• ril.ecclistSimSlotNumber saat SIM dimasukkan dan SimSlotNumber adalah ID slot pelanggan default.

Produsen perangkat yang menggunakan fitur Akses Cepat Darurat harus memverifikasi bahwa perangkat di India selalu mengaktifkan 112 sebagai nomor darurat di RIL.

Validasi

Saat menguji pada build yang dapat di-debug, nomor yang dipanggil dapat diubah dengan perintah berikut:

adb shell settings put global emergency_affordance_number NUMBER_TO_CALL

Meskipun setelan ini dapat disetel pada build pengguna normal, setelan ini akan diabaikan. Untuk benar-benar menghubungkan panggilan, nomor tersebut harus ada dalam daftar nomor darurat yang disediakan oleh RIL. Hal ini dapat ditetapkan untuk sementara menggunakan perintah berikut yang dijalankan dari shell root di perangkat userdebug:

setprop ril.ecclist "$(getprop ril.ecclist),NUMBER_TO_CALL"

Perintah berikut juga dapat digunakan untuk mengaktifkan fitur Keterjangkauan Darurat secara paksa meskipun tidak ada jaringan seluler India yang terdeteksi atau kartu SIM India yang dimasukkan.

adb shell settings put global force_emergency_affordance 1

Setidaknya, sebaiknya uji kasus berikut:

• Jika diaktifkan, menekan lama tombol DARURAT di layar kunci (Gambar 1) akan memulai panggilan ke nomor darurat yang ditentukan.
• Jika diaktifkan, item Darurat di Menu Tindakan Global akan muncul dan mengetuknya akan memulai panggilan ke nomor darurat yang ditentukan.
• Fitur tidak diaktifkan jika tidak ada Jaringan Seluler India yang terdeteksi dengan kartu SIM non-India yang terpasang.
• Fitur ini diaktifkan di perangkat saat kartu SIM India dipasang, terlepas dari jaringan seluler yang terdeteksi.
• Fitur diaktifkan di perangkat jika ada Jaringan Seluler India, terlepas dari kartu SIM yang terpasang.

Jika perangkat mendukung beberapa kartu SIM, pengujian harus memverifikasi bahwa deteksi MCC SIM berfungsi dengan benar di setiap slot SIM. Fitur Akses Cepat Darurat tidak diatur oleh Android Compatibility Test Suite (CTS), sehingga tidak ada pengujian CTS untuk fitur ini.

Pertanyaan umum (FAQ)

T: Nomor darurat 112 belum diaktifkan di India. Apakah masih boleh digunakan?

112 adalah nomor yang digunakan di India sebagai Titik Respons Keselamatan Publik (PSAP) sebagaimana ditentukan oleh Sistem Respons dan Komunikasi Darurat Terintegrasi (IECRS). Hingga PSAP diaktifkan, semua panggilan ke 112 dialihkan ke nomor darurat 100 yang ada (meskipun ini adalah tanggung jawab operator, bukan Android).

T: Bagaimana dengan pemicu lain seperti menekan tombol daya tiga kali?

Produsen perangkat dapat menerapkan pemicu tambahan. Namun, meskipun DoT India menyetujui pengetukan tiga kali tombol daya hardware, pemicu ini >tidak didukung> dalam implementasi referensi AOSP karena beberapa aplikasi yang banyak digunakan (misalnya, aplikasi Kamera) menggunakan gestur tombol daya yang mencakup pengetukan berulang tombol daya. Aplikasi semacam itu dapat mengganggu dialer darurat atau pengguna dapat secara tidak sengaja memicu tombol panik saat mencoba memicu tindakan di aplikasi ini.