Konfigurasi Operator

Android 6.0 dan yang lebih tinggi menyertakan kemampuan aplikasi istimewa untuk menyediakan konfigurasi khusus operator ke platform. Fungsionalitas ini, berdasarkan Hak Istimewa Operator UICC yang diperkenalkan di Android 5.1 (Lollipop MR1), memungkinkan konfigurasi operator dipindahkan dari overlay konfigurasi statis dan memberi operator dan OEM kemampuan untuk menyediakan konfigurasi operator secara dinamis ke platform melalui antarmuka yang ditentukan.

Aplikasi operator yang ditandatangani dengan benar dapat dimuat sebelumnya di citra sistem, diinstal secara otomatis, atau diinstal secara manual melalui toko aplikasi. Aplikasi ini diminta oleh platform untuk menyediakan konfigurasi untuk pengaturan termasuk:

• Jaringan jelajah/non jelajah
• Pesan suara visual
• Pengaturan jaringan SMS/MMS
• Konfigurasi VoLTE/IMS

Catatan: Aplikasi ini harus ditandatangani dengan sertifikat yang memiliki tanda tangan yang cocok dengan yang ada di SIM. Lihat Bagaimana hak istimewa diberikan ke aplikasi operator untuk detailnya.

Penentuan nilai apa yang akan dikembalikan sepenuhnya tergantung pada aplikasi operator dan dapat bersifat dinamis berdasarkan informasi mendetail yang diteruskan ke aplikasi melalui platform.

Manfaat utama dari pendekatan ini adalah:

• Konfigurasi dinamis - Dukungan untuk konsep seperti konfigurasi turunan non-MCCMNC, misalnya, operator jaringan virtual seluler (MVNO) atau pilihan pelanggan untuk layanan tambahan.
• Dukungan untuk perangkat yang dijual melalui saluran apa pun - Misalnya, telepon pasar terbuka dapat dikonfigurasi secara otomatis dengan pengaturan yang tepat dengan mengunduh aplikasi dari toko aplikasi.
• Keamanan - Hak istimewa untuk menyediakan konfigurasi ini hanya diberikan kepada aplikasi yang ditandatangani oleh operator.
• API yang Ditentukan - Sebelumnya konfigurasi ini sebagian besar disimpan dalam lapisan XML internal dalam kerangka kerja dan bukan melalui API publik. API konfigurasi operator di Android 6.0 bersifat publik dan didefinisikan dengan baik.

Bagaimana itu bekerja

Memuat konfigurasi

Konfigurasi operator yang disediakan oleh fitur ini adalah satu set pasangan nilai kunci yang mengubah berbagai perilaku terkait telepon di platform.

Kumpulan nilai untuk perangkat tertentu ditentukan dengan menanyakan komponen berikut secara berurutan:

1. Aplikasi operator (ini opsional, tetapi ini adalah lokasi yang disarankan untuk konfigurasi tambahan di luar apa yang ada di Android Open Source Project (AOSP))
2. Aplikasi konfigurasi platform yang dibundel dengan gambar sistem
3. Nilai default, di-hardcode ke dalam kerangka kerja (setara dengan perilaku sebelum Android 6.0)

Penting: Jika nilai untuk kunci tertentu dikembalikan pada tahap apa pun, nilai pertama yang ditemukan akan didahulukan dari tahap selanjutnya.

Aplikasi konfigurasi platform

Aplikasi konfigurasi platform generik dibundel dengan citra sistem. Aplikasi ini dapat memberikan nilai untuk variabel apa pun yang tidak dimiliki aplikasi operator reguler. Aplikasi konfigurasi platform dapat ditemukan (di Android 6.0) di: packages/apps/CarrierConfig

Tujuan aplikasi ini adalah untuk menyediakan beberapa konfigurasi per jaringan saat aplikasi operator tidak diinstal, dan operator/OEM hanya boleh membuat sedikit perubahan pada gambar mereka sendiri. Sebaliknya operator harus menyediakan aplikasi operator terpisah untuk kustomisasi operator, memungkinkan pembaruan untuk didistribusikan melalui jalan seperti toko aplikasi.

Bagaimana hak istimewa diberikan ke aplikasi operator

Aplikasi operator yang dimaksud harus ditandatangani dengan sertifikat yang sama yang ditemukan pada kartu SIM, seperti yang didokumentasikan dalam Hak Istimewa Operator UICC .

Informasi apa yang diteruskan ke aplikasi operator

Aplikasi operator dilengkapi dengan nilai berikut, memungkinkannya membuat keputusan dinamis tentang nilai yang akan dikembalikan:

• PKS
• MNC
• SPN
• IMSI
• GID1
• GID2
• ID Operator

Untuk informasi selengkapnya tentang mengintegrasikan ID operator, lihat Mengintegrasikan ID operator dengan CarrierConfig .

Saat memuat konfigurasi operator terjadi

Pembuatan daftar pasangan nilai kunci terjadi:

• Saat SIM dimuat (boot, atau hot swap SIM)
• Saat aplikasi operator secara manual memicu isi ulang
• Saat aplikasi operator diperbarui

Lihat referensi android.service.carrier.CarrierService#onLoadConfig() untuk detail selengkapnya.

Catatan: Platform menyimpan bundel konfigurasi operator dan memuat dari cache untuk perubahan status SIM. Ini untuk mempercepat booting dan hot swap SIM. Diasumsikan bahwa tanpa pembaruan paket atau notifyConfigChangedForSubId eksplisit, bundel konfigurasi belum dimodifikasi.

Menggunakan konfigurasi

Ketika konfigurasi dibangun, nilai-nilai yang terkandung di dalamnya digunakan untuk mengatur berbagai nilai konfigurasi sistem, termasuk:

• Pengaturan telepon kerangka internal
• Nilai konfigurasi yang dikembalikan SDK, misalnya, di SmsManager
• Pengaturan aplikasi seperti nilai koneksi VVM di Dialer

Kunci konfigurasi

Daftar kunci didefinisikan sebagai bagian dari SDK publik di android.telephony.CarrierConfigManager dan tidak dapat diubah dalam level API yang sama. Lihat tabel di bawah untuk ringkasan kunci.

Membangun aplikasi

Membuat aplikasi

Aplikasi Anda harus menargetkan Android 6.0 API level (23).

Mendeklarasikan kelas yang menimpa android.service.carrier.CarrierService

1. Ganti onLoadConfig untuk mengembalikan nilai yang ingin Anda berikan berdasarkan objek service.carrier.CarrierIdentifier yang diteruskan.
2. Tambahkan logika untuk memanggil notifyConfigChangedForSubId dalam skenario di mana konfigurasi operator dapat berubah seiring waktu (misalnya, saat pengguna menambahkan layanan tambahan ke akun mereka).

Contohnya di bawah ini:

public class SampleCarrierConfigService extends CarrierService {

    private static final String TAG = "SampleCarrierConfigService";

    public SampleCarrierConfigService() {
        Log.d(TAG, "Service created");
    }

    @Override
    public PersistableBundle onLoadConfig(CarrierIdentifier id) {
        Log.d(TAG, "Config being fetched");
        PersistableBundle config = new PersistableBundle();
        config.putBoolean(
            CarrierConfigManager.KEY_CARRIER_VOLTE_AVAILABLE_BOOL, true);
        config.putBoolean(
            CarrierConfigManager.KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL, false);
        config.putInt(CarrierConfigManager.KEY_VOLTE_REPLACEMENT_RAT_INT, 6);
        // Check CarrierIdentifier and add more config if needed…
        return config;
    }
}

Untuk detail selengkapnya, lihat referensi android.service.carrier.CarrierService .

Memberi nama kelas dalam manifes

Contohnya di bawah ini:

<service android:name=".SampleCarrierConfigService"
android:label="@string/service_name"
android:permission="android.permission.BIND_CARRIER_SERVICES">
      <intent-filter>
      <action android:name="android.service.carrier.CarrierService"/></intent-filter>
</service>

Menandatangani aplikasi dengan sertifikat yang sama di SIM

Lihat Hak Istimewa Operator UICC untuk persyaratannya.

Menambahkan APN dengan aplikasi operator

Untuk menambahkan APN secara terprogram dari aplikasi operator (misalnya, selama aktivasi SIM), gunakan ContentResolver API untuk menambahkan item APN ke penyedia konten yang diidentifikasi oleh URI android.provider.Telephony.Carriers.CONTENT_URI . Untuk informasi selengkapnya tentang struktur tabel URI konten, lihat Telephony.Carriers .

Untuk informasi lebih lanjut, lihat APN dan CarrierConfig .

Menguji aplikasi

Setelah membuat aplikasi konfigurasi, Anda dapat menguji kode dengan:

• SIM yang berisi tanda tangan sertifikat yang valid
• Perangkat yang menjalankan Android 6.0 dan yang lebih baru, misalnya perangkat Android