Gambaran umum API Windows Runtime broadband seluler

  • Artikel

Tabel berikut mencantumkan API untuk menulis aplikasi broadband seluler.

API Deskripsi

API Profil Koneksi

Menyediakan informasi tentang status koneksi (misalnya, ke Internet)

API Ekstensi Layanan Perangkat

Memungkinkan ekstensi khusus perangkat, seperti unduhan SIM Toolkit dan Preferred Roaming List (PRL).

API Provisi

Memungkinkan Anda memprovisikan Windows dengan data provisi akun dan informasi penggunaan data.

SIM PIN API

Memungkinkan Anda mengaktifkan, menonaktifkan, atau mengubah PIN SIM.

SMS API

Menyediakan fungsi yang diperlukan untuk mengimplementasikan klien SMS.

API Pelanggan dan Informasi Perangkat

Menyediakan informasi pelanggan untuk INFORMASI SIM dan perangkat untuk perangkat broadband seluler.

USSD API

Memungkinkan Anda membuat sesi Data Layanan Tambahan Tidak Terstruktur (USSD) dengan jaringan (klien dan jaringan yang dimulai).

Bagian berikut tersedia dalam topik ini:

API Akun Broadband Seluler

Karena memiliki metode yang dapat digunakan untuk mendapatkan informasi identitas pribadi tentang pelanggan dan mengubah pengaturan jaringan pada perangkat broadband seluler, MOBILE Broadband Account API adalah API istimewa. Ini berarti bahwa sebagian besar aplikasi UWP tidak dapat memanggil metodenya tanpa mendapatkan kesalahan "akses ditolak". Agar dapat memanggil API ini, aplikasi UWP harus memenuhi kriteria berikut:

  • Aplikasi harus memiliki metadata perangkat atau paket metadata layanan yang terkait dengannya, dan harus tercantum dalam elemen XML PrivilegedApplications dari file SoftwareInfo.xml di dalam paket. Paket tidak harus eksklusif untuk aplikasi; dimungkinkan bagi aplikasi UWP tertentu untuk dicantumkan dalam elemen PrivilegedApplications dari beberapa paket. Paket tersebut harus dikaitkan dengan penyedia layanan untuk perangkat broadband seluler yang telah aktif setidaknya sekali di komputer, sehingga telah diinstal.

  • File appxmanifest aplikasi memerlukan <entri DeviceCapability> untuk API Akun Broadband Seluler. Anda dapat melakukan ini dengan menambahkan elemen XML berikut sebagai anak dari <elemen Kapabilitas> dalam file appxmanifest aplikasi:

    <DeviceCapability Name="BFCD56F7-3943-457F-A312-2E19BB6DC648" />

    Untuk informasi selengkapnya tentang <elemen Kapabilitas>, lihat File Manifes Aplikasi Untuk Windows 8.

Catatan Aplikasi yang bukan aplikasi UWP (misalnya, layanan Microsoft Win32 atau aplikasi desktop) memiliki akses tak terbatas ke API Akun Broadband Seluler. Ini karena aplikasi ini dapat menggunakan API Win32 dan Component Object Model (COM) yang ada untuk mendapatkan akses penuh ke jaringan broadband seluler. API ini tidak dapat digunakan dari aplikasi UWP.

ID Akun Jaringan

ID akun jaringan adalah pengidentifikasi unik untuk akun broadband seluler. Ini menyediakan ID terpadu yang dapat digunakan tanpa perlu mengetahui apakah ID berasal dari jaringan GSM, CDMA, atau WiMAX. Windows menghasilkan ID akun jaringan setiap kali menemukan pengidentifikasi langganan jaringan yang disediakan perangkat keras yang belum pernah ditemui sebelumnya. Daftar berikut mengidentifikasi ID akun jaringan untuk setiap jenis jaringan yang didukung:

  • Jaringan GSM: ICCID SIM digunakan untuk membedakan antara langganan.

  • Jaringan CDMA: Nomor identifikasi seluler (MIN) digunakan.

Ketika Windows menemukan salah satu jenis jaringan sebelumnya untuk pertama kalinya, Windows membuat ID akun jaringan baru dan memetakannya ke hash SHA-256 dari pengidentifikasi langganan yang disediakan perangkat keras, lalu menyimpan keduanya di registri. Sebaliknya, jika Windows menemukan hash pengidentifikasi langganan yang disediakan perangkat keras di registri, windows menggunakan ID akun jaringan yang terkait dengan hash tersebut. ID akun jaringan harus unik secara global (didasarkan pada GUID), tetapi karena apa yang disimpan adalah hash dari pengidentifikasi yang disediakan perangkat keras, perangkat keras jaringan harus ada ketika mencoba memetakan ID akun jaringan kembali ke ICCID atau MIN tempat asalnya dibuat.

Penting Meskipun mendapatkan ICCID dari ID akun jaringan memerlukan akses ke komputer dan perangkat jaringan yang digunakan untuk memetakannya bersama-sama, ID akun jaringan secara unik mengidentifikasi pengguna individu. Oleh karena itu, kami sarankan Anda mengikuti kebijakan organisasi Anda untuk menangani informasi yang dapat diidentifikasi secara pribadi saat Anda bekerja dengan mereka.

ID akun jaringan dipisahkan oleh operator jaringan seluler (MNO), sehingga jika pengguna akhir memiliki perangkat broadband seluler Provider1 dan Provider2 dan aplikasi broadband seluler yang sesuai diinstal, aplikasi Provider1 tidak akan dapat menggunakan ID akun jaringan Provider2 apa pun, dan sebaliknya. Fungsi yang mengembalikan semua ID akun jaringan hanya akan mengembalikan ID akun jaringan untuk MNO yang aplikasinya memanggil fungsi . Upaya untuk menggunakan ID akun jaringan milik MNO yang berbeda akan mengakibatkan kesalahan "akses ditolak".

Catatan Aplikasi yang bukan aplikasi UWP (misalnya, layanan Win32 atau aplikasi desktop) memiliki akses ke semua akun jaringan terlepas dari penyedia layanan jaringan.

Gambaran umum API WinRT broadband seluler