Konfigurasi operator

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Android 6.0 dan yang lebih baru menyertakan kemampuan untuk aplikasi berhak istimewa guna memberikan konfigurasi khusus operator ke platform. Fungsi 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 dipramuat dalam image sistem, diinstal secara otomatis, atau diinstal secara manual melalui app store. Aplikasi dibuat kueri oleh platform untuk memberikan konfigurasi setelan termasuk:

• Jaringan roaming/non-roaming
• Pesan suara visual
• Setelan jaringan SMS/MMS
• Konfigurasi VoLTE/IMS

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

Manfaat utama pendekatan ini adalah:

• Konfigurasi dinamis - Dukungan untuk konsep seperti konfigurasi turunan non-MCCMNC, misalnya, operator jaringan virtual seluler (MVNO) atau pelanggan yang memilih untuk menggunakan layanan tambahan.
• Dukungan untuk perangkat yang dijual melalui saluran apa pun - Misalnya, ponsel pasar terbuka dapat dikonfigurasi secara otomatis dengan setelan yang tepat dengan mendownload aplikasi dari app store.
• Keamanan - Hak istimewa untuk memberikan konfigurasi ini hanya diberikan ke aplikasi yang ditandatangani oleh operator.
• API yang Ditetapkan - Sebelumnya, konfigurasi ini sebagian besar disimpan dalam overlay XML internal dalam framework, bukan melalui API publik. API konfigurasi operator di Android 6.0 bersifat publik dan ditentukan dengan baik.

Cara kerjanya

Memuat konfigurasi

Konfigurasi operator yang disediakan oleh fitur ini adalah kumpulan pasangan nilai kunci yang mengubah berbagai perilaku terkait telefoni di platform.

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

1. Aplikasi operator (opsional, tetapi merupakan lokasi yang direkomendasikan untuk konfigurasi tambahan di luar yang ada di Project Open Source Android (AOSP))
2. Aplikasi konfigurasi platform yang dipaketkan dengan image sistem
3. Nilai default, di-hardcode ke dalam framework (setara dengan perilaku sebelum Android 6.0)

Aplikasi konfigurasi platform

Aplikasi konfigurasi platform generik dipaketkan dengan image sistem. Aplikasi ini dapat menyediakan 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 melakukan perubahan minimal pada aplikasi tersebut dalam image mereka sendiri. Sebagai gantinya, operator harus menyediakan aplikasi operator terpisah untuk penyesuaian operator, sehingga update dapat didistribusikan melalui saluran seperti app store.

Cara hak istimewa diberikan ke aplikasi operator

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

Informasi yang diteruskan ke aplikasi operator

Aplikasi operator dilengkapi dengan nilai berikut, sehingga dapat membuat keputusan dinamis tentang nilai yang akan ditampilkan:

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

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

Saat memuat konfigurasi operator

Pembuatan daftar key-value pair terjadi:

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

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

Menggunakan konfigurasi

Saat konfigurasi dibuat, nilai yang ada di dalamnya digunakan untuk menetapkan berbagai nilai konfigurasi sistem, termasuk:

• Setelan telepon framework internal
• Nilai konfigurasi yang ditampilkan SDK, misalnya, di SmsManager
• Setelan aplikasi seperti nilai koneksi VVM di Telepon

Kunci konfigurasi

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

Mem-build aplikasi

Membuat aplikasi

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

Deklarasikan class yang mengganti android.service.carrier.CarrierService

1. Ganti onLoadConfig untuk menampilkan nilai yang ingin Anda pasok berdasarkan objek service.carrier.CarrierIdentifier yang diteruskan.
2. Tambahkan logika untuk memanggil notifyConfigChangedForSubId dalam skenario saat konfigurasi operator dapat berubah dari waktu ke waktu (misalnya, saat pengguna menambahkan layanan tambahan ke akunnya).

Contohnya adalah 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 class dalam manifes

Contohnya adalah 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 mengetahui informasi selengkapnya tentang struktur tabel untuk URI konten, lihat Telephony.Carriers.

Untuk mengetahui informasi selengkapnya, lihat APN dan CarrierConfig.

Menguji aplikasi

Setelah mem-build aplikasi konfigurasi, Anda dapat menguji kode dengan:

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

Menetapkan kemampuan layanan operator

Di Android, kemampuan layanan operator menjelaskan apakah layanan suara, pesan, dan data didukung di perangkat. Operator dapat menentukan kemampuan layanan operator untuk perangkat di tingkat perangkat dan di tingkat langganan (Android 15 atau yang lebih tinggi).

Kemampuan layanan tingkat perangkat

Kemampuan layanan tingkat perangkat dikonfigurasi saat perangkat diproduksi (tidak dapat diubah setelah produksi). Operator dapat menentukan kemampuan tingkat perangkat melalui penggantian resource sistem berikut:

• config_voice_capable
• config_sms_capable
• config_mobile_data_capable

Aplikasi dapat mengkueri kemampuan layanan tingkat perangkat melalui API berikut:

• TelephonyManager.isVoiceCapable
• TelephonyManager.isSmsCapable
• TelephonyManager.isDataCapable

Kemampuan layanan tingkat langganan

Untuk perangkat yang menjalankan Android 15 atau yang lebih tinggi, operator dapat menentukan kemampuan layanan perangkat di tingkat langganan. Untuk menentukan kemampuan layanan tingkat langganan, gunakan API CarrierConfigManager.KEY_CELLULAR_SERVICE_CAPABILITIES_INT_ARRAY. Misalnya, untuk menentukan bahwa langganan hanya berisi data, tetapkan nilai ke SubscriptionManager#SERVICE_CAPABILITY_DATA.

Aplikasi (aplikasi sistem yang dimuat sebelumnya dan aplikasi pihak ketiga) dapat mengkueri kemampuan layanan operator untuk langganan yang ditentukan melalui metode SubscriptionInfo.getServiceCapabilities(). Hal ini memungkinkan developer aplikasi menyesuaikan pengalaman pengguna aplikasi berdasarkan kemampuan yang tersedia untuk langganan. Misalnya, developer aplikasi dapat memastikan bahwa aplikasi telepon tidak mengizinkan panggilan jika pengguna menggunakan langganan khusus data.

API kemampuan layanan yang tidak digunakan lagi

Mulai Android 15, Android menyediakan kemampuan layanan tingkat perangkat dan tingkat langganan. Karena perubahan ini, API kemampuan level perangkat yang ada diganti namanya agar lebih mudah dibaca. Tabel berikut mencantumkan API yang tidak digunakan lagi dan API yang diganti namanya yang diperkenalkan di Android 15: