Gambaran umum metadata layanan

  • Artikel

Peringatan penghentian MBAE

Penting

Mulai Windows 10, versi 1803, pengalaman aplikasi MBAE digantikan oleh aplikasi MO UWP. Untuk informasi selengkapnya tentang aplikasi MO UWP, lihat aplikasi broadband seluler UWP.

Anda dapat membuat dan mengirimkan paket metadata layanan untuk menciptakan pengalaman yang sangat terintegrasi dengan Windows. Ketika Windows mendeteksi perangkat keras broadband seluler yang cocok dengan paket metadata layanan operator, Windows secara otomatis mengunduh metadata layanan dan aplikasi broadband seluler yang ditentukan.

Metadata layanan berisi informasi yang menjelaskan layanan, termasuk yang berikut ini:

Informasi dalam metadata digunakan untuk menyesuaikan aspek pengalaman pengguna Windows 8, Windows 8.1, dan Windows 10 dan menyediakan integrasi dengan aplikasi broadband seluler, yang sebelumnya dikenal sebagai aplikasi operator seluler.

Paket metadata layanan terdiri dari beberapa dokumen XML yang disimpan dalam file .devicemetadata-ms. Setiap dokumen menentukan berbagai komponen atribut layanan. Dokumen XML ini menyediakan Pengelola Sambungan Windows dengan kustomisasi yang muncul kepada pengguna, serta informasi konfigurasi jaringan.

Untuk informasi referensi tentang dokumen XML dalam paket metadata layanan, lihat Referensi skema paket metadata layanan.

Konten metadata layanan

Ringkasan berikut menjelaskan beberapa bidang paling menarik yang terkandung dan didefinisikan di dalam paket metadata layanan:

  • ID Perangkat Keras
    Untuk jaringan GSM, Anda dapat mengirimkan paket metadata yang menjelaskan rentang IMSI atau ICCID yang Anda inginkan untuk mencocokkan paket metadata layanan Anda. Jika Anda adalah MVNO, Anda dapat menentukan satu atau beberapa rentang IMSI atau ID SIM ICC yang telah Anda sewa dari MNO. Untuk jaringan CDMA, Anda dapat mengirimkan paket dengan menggunakan ID Penyedia (SID/NID) atau Nama Penyedia. ID perangkat keras sesuai dengan elemen HardwareID dalam skema paket metadata layanan. Untuk informasi selengkapnya tentang cara merencanakan rentang Identifikasi Perangkat Keras (HWID) Anda untuk skenario MNO dan MVNO, lihat Memberikan pengalaman untuk MVNO

  • Nomor layanan
    ID unik untuk penyedia layanan broadband seluler. GUID ini juga digunakan untuk mengidentifikasi operator saat menggunakan Metadata Provisi Akun. Jika Anda memperbarui paket metadata perangkat, GUID ini harus tetap sama. Nomor layanan sesuai dengan elemen ServiceNumber dalam skema paket metadata layanan.

  • Logo operator Logo kustom yang muncul di Windows Pengelola Sambungan di samping entri jaringan Anda. (Logo disembunyikan ketika pengguna berada di jaringan roaming.) Logo operator sesuai dengan elemen ServiceIconFile dalam skema paket metadata layanan. Untuk informasi selengkapnya tentang persyaratan logo, lihat Persyaratan Ikon Layanan.

    Penting

    Dalam Windows 10, versi 1709 dan yang lebih baru, bidang ini telah digantikan oleh branding melalui COSA. Bidang di COSA untuk branding dijelaskan pada Merencanakan pengiriman database COSA/APN desktop Anda. Jika Anda menargetkan versi Windows sebelum Windows 10, versi 1709, Anda masih akan membuat paket metadata seperti yang dijelaskan di bagian ini. Untuk informasi selengkapnya tentang COSA, lihat Gambaran umum COSA.

  • Aplikasi broadband seluler
    Aplikasi perangkat UWP yang secara otomatis diunduh dan diterapkan ke komputer. Aplikasi ini dapat memberikan pengalaman utama seperti pembelian paket, penggunaan data, dan bantuan dan dukungan, dan dapat menyoroti layanan bernilai tambah.

  • Profil Pembelian MB
    Profil pembelian yang digunakan untuk membangun konektivitas terbatas untuk membeli langganan.

    Jika Anda adalah operator GSM yang hanya memiliki satu APN Pembelian untuk semua pelanggan, Anda dapat menggunakan metadata layanan untuk menyediakannya ke komputer. Jika Anda memiliki beberapa APN Pembelian, Anda harus menggunakan metadata provisi akun untuk mengatur APN pembelian yang sesuai. Atau, Anda tidak dapat melakukan apa pun dan menggunakan entri yang disimpan dalam database APN untuk memberikan informasi konektivitas APN.

  • Profil Internet MB
    Setiap langganan broadband seluler dapat memiliki satu profil default yang digunakan untuk terhubung ke operator jaringan rumah. Windows Pengelola Sambungan menggunakan profil ini untuk menyambungkan otomatis ke jaringan.

    Jika Anda adalah operator GSM yang hanya memiliki satu APN Internet untuk semua pelanggan, Anda dapat menggunakan metadata layanan untuk memprovisikan komputer. Jika Anda memiliki beberapa APN Internet, Anda harus menggunakan metadata provisi akun untuk mengatur APN internet yang sesuai. Atau, Anda tidak dapat melakukan apa pun dan menggunakan entri yang disimpan dalam database APN untuk memberikan informasi konektivitas APN.

  • Data sertifikat
    Informasi sertifikat yang digunakan untuk provisi. Ini termasuk Nama Penerbit Sertifikat dan Nama Subjek. Informasi ini digunakan untuk memastikan bahwa operasi provisi akun yang dimulai oleh situs web dikeluarkan oleh operator tepercaya.

  • Nama operator kustom
    Perangkat broadband seluler biasanya menyediakan nama operator, yang ditampilkan Windows di Windows Pengelola Sambungan. Anda dapat mengganti nama ini dengan menentukan nama kustom dalam metadata. Nama ini hanya ditampilkan jika pengguna berada di jaringan rumah dan tidak berada di jaringan roaming. Nama jaringan roaming yang ditampilkan didasarkan pada informasi yang diterima dari perangkat. Ini sesuai dengan elemen ServiceProvider dalam skema metadata paket layanan.

    Penting

    Dalam Windows 10, Versi 1709 dan yang lebih baru, bidang ini telah digantikan oleh branding melalui COSA. Bidang di COSA untuk branding dijelaskan pada Merencanakan pengiriman database COSA/APN desktop Anda. Jika Anda menargetkan versi Windows sebelum Windows 10, Versi 1709, Anda masih akan membuat paket metadata seperti yang dijelaskan di bagian ini. Untuk informasi selengkapnya tentang COSA, lihat Gambaran umum COSA.

  • Penangan pemberitahuan perangkat
    Secara umum, aplikasi harus dijalankan oleh pengguna setidaknya satu kali sebelum dapat mendaftarkan item kerja dengan broker Peristiwa Sistem. Namun, aplikasi broadband seluler mungkin perlu menerima peristiwa penting sebelum pengguna dapat menjalankan aplikasi. Anda dapat menentukan elemen DeviceNotificationHandler dalam metadata layanan, yang akan digunakan Windows untuk mendaftarkan beberapa peristiwa penting. Untuk informasi selengkapnya tentang pemberitahuan SMS, lihat Memberikan pengalaman untuk MVNO.

  • Daftar aplikasi istimewa dengan akses ke antarmuka terbatas broadband seluler
    API dan antarmuka Broadband Seluler (termasuk Provisi Akun dan SMS) dibatasi dan hanya tersedia untuk aplikasi broadband seluler. Daftar aplikasi istimewa yang memiliki akses ke API istimewa ini dapat ditentukan dalam paket metadata layanan di elemen PrivilegedApplications . Aplikasi istimewa dapat men-debug atau menguji aplikasi; mereka tidak diharuskan untuk didistribusikan melalui Microsoft Store.

Struktur Paket Metadata Layanan

Komponen paket metadata layanan disimpan dalam file kabinet terkompresi dan harus memiliki ekstensi file .devicemetadata-ms. Paket metadata layanan menggunakan ekstensi file ini karena menggunakan platform yang mendasar yang sama dengan paket metadata perangkat. Sebelum membuat file .devicemetadata-ms , Anda harus terlebih dahulu membuat pengidentifikasi unik global (GUID) untuk paket metadata. Kemudian, Anda harus menggunakan konvensi penamaan berikut saat membuat file .devicemetadata-ms: <GUID.devicemetadata-ms>.

Catatan Meskipun ekstensi file biasa dari file kabinet .cab, ekstensi file untuk file paket metadata layanan harus .devicemetadata-ms. Ini dimaksudkan untuk menggaris bawahi fakta bahwa pengguna akhir tidak boleh mendekompresi atau memodifikasi paket ini.

Ada dua jenis paket metadata layanan: satu paket metadata layanan lokal dan beberapa paket metadata layanan lokal.

Paket Metadata Layanan Lokal Tunggal

Sumber daya yang dapat dilokalkan dalam paket metadata layanan adalah nama operator yang muncul di Pengelola Sambungan Windows dan ikon layanan yang muncul di sampingnya. Jika Anda tidak perlu melokalisasi nama atau mengubah ikon berdasarkan informasi lokal dari PC, buat satu paket metadata layanan lokal. Terlepas dari lokal apa yang digunakan pengguna pada PC mereka, mereka akan mendapatkan nama operator dan ikon layanan yang ditentukan dalam paket metadata layanan lokal tunggal.

Satu paket metadata layanan lokal harus memiliki struktur file berikut:

Diagram memperlihatkan struktur file dari satu paket metadata layanan lokal.

Beberapa pertimbangan untuk satu paket metadata lokal:

  • File ikon dapat memiliki nama file apa pun. Namun, dokumen XML individual harus diberi nama PackageInfo.xml, ServiceInfo.xml, WindowsInfo.xml, dan SoftwareInfo.xml.

  • Nama file MobileBroadbandInfo.xml ditentukan dalam ServiceInfo.xml. Anda harus menggunakan nama yang tercantum dalam dokumen ini untuk file tersebut.

  • File .devicemetadata-ms tidak dapat menyertakan "{" atau "}" dalam nama. GUID untuk setiap nama file paket metadata harus unik. Saat membuat paket metadata layanan baru atau yang direvisi, Anda harus membuat GUID baru, meskipun perubahannya kecil.

  • Windows mengenali paket metadata layanan dengan ekstensi file .devicemetadata-ms.

Beberapa Struktur Paket Metadata Layanan Lokal

Paket metadata layanan mendukung beberapa file lokal dalam satu paket. Jika Anda mendukung lebih dari satu lokal untuk layanan Anda, Anda dapat memasukkan beberapa file lokal ke dalam satu paket metadata layanan.

Anda dapat menggunakan beberapa paket metadata layanan lokal jika anda ingin menampilkan nama yang dilokalkan untuk layanan Anda di Windows Pengelola Sambungan daftar jaringan atau untuk menampilkan logo lain di Windows Pengelola Sambungan untuk jaringan Anda. Windows akan menampilkan nama dan logo jaringan yang dilokalkan berdasarkan bahasa pilihan sistem, yang biasanya dikonfigurasi selama Penyetelan Windows. Bahkan jika bahasa pengguna saat ini berbeda dari bahasa pilihan sistem, ikon dan nama jaringan akan selalu muncul dalam bahasa pilihan sistem. Jika paket metadata layanan tidak menyertakan lokal, deskripsi netral bahasa dari akar paket metadata layanan ditampilkan. Untuk sebagian besar pengguna, bahasa mereka akan cocok dengan bahasa pilihan sistem.

Beberapa paket metadata layanan lokal harus memiliki struktur file berikut:

Diagram yang mengilustrasikan struktur file paket metadata layanan multi-lokal.

Beberapa pertimbangan untuk beberapa paket metadata lokal:

  • Buat folder nama lokal di setiap folder dan letakkan file XML atau file yang relevan di folder nama lokal.

  • Anda masih harus memiliki file XML tingkat atas dan file yang relevan, seperti file ikon, di tingkat atas setiap folder. Ini menyediakan mekanisme fallback ketika lokal tidak disertakan dalam paket metadata layanan Anda.

  • Pastikan bahwa semua file yang diperlukan dan bidang dalam file tersebut benar-benar terisi di dalam setiap folder khusus lokal yang Anda buat. Ini selain konten di tingkat atas setiap folder. Misalnya, elemen ServiceNumber di ServiceInfo.xml harus diisi dan diduplikasi di folder tingkat atas dan di setiap folder khusus lokal yang Anda buat. Gagal melakukan ini akan menyebabkan kesalahan.

  • Dokumen XML SoftwareInformation tidak mendukung beberapa lokal karena Anda tidak dapat menentukan file SoftwareInfo.xml yang berbeda per lokal.

Pengiriman dan pemeliharaan metadata layanan

Untuk informasi selengkapnya tentang cara mengirimkan paket metadata layanan ke Dasbor Windows Dev Center – Perangkat Keras, lihat Panduan pengembang untuk membuat metadata layanan.

Penting untuk selalu memperbarui paket metadata dalam hal bagaimana paket tersebut dijelaskan dan nilai IMSI dan ICCID atau Nama Penyedia CDMA atau SID mana yang cocok. Ini dapat memerlukan MNO atau MVNO untuk mengimplementasikan alur kerja baru yang merupakan bagian dari akuisisi SIM atau perangkat untuk melacak pesanan baru SIM dan MNO atau MVNO tempat ICCID atau IMSI tersebut disediakan.

Ini adalah praktik terbaik untuk menghindari seringnya membuat perubahan pada metadata layanan Anda dengan memesan rentang ICCID atau IMSI (atau NAMA CDMA SIM/Penyedia) untuk MNO dan MVNO terlebih dahulu, sehingga ketika SIM baru (atau perangkat CDMA) diperoleh, mereka sudah dipertangjawabkan dalam paket metadata layanan Anda.

Jika Anda perlu memperbarui pengidentifikasi layanan yang terdaftar di dasbor perangkat keras Windows Dev Center, lihat Pembaruan kepemilikan pengidentifikasi layanan.

Pembaruan metadata diterapkan secara diam-diam berdasarkan logika Windows internal (biasanya setiap delapan hari) ketika Windows meminta WMIS apakah memiliki pembaruan metadata yang diperbarui.

Aplikasi harus dirancang untuk menangani versi metadata sebelumnya yang dirujuknya, hingga metadata terbaru diterapkan ke sistem.

Merancang pengalaman pengguna aplikasi broadband seluler memberikan panduan tentang cara merancang pengalaman pengguna untuk mengatasi kasus kesalahan umum, seperti ketika perangkat hilang atau tidak dikenali.