Bagikan melalui

Kunci dan Entri Registri untuk Toko Online Tipe 1

  • Artikel

[Fitur yang terkait dengan halaman ini, Pemutar Media Windows SDK, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer. MediaPlayer telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer alih-alih Pemutar Media Windows SDK, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Untuk membuat toko online tipe 1 tersedia di Pemutar Media Windows, penyedia toko online harus membuat subkunci dan entri registri berikut di komputer pengguna.

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MediaPlayer\Subscriptions\keyName]
"Capabilities"=dword:flags
"SubscriptionObjectGUID"=clsid
"FriendlyName"=friendlyName

[HKEY_CLASSES_ROOT\AppID\appid]
@=pluginName
"DllSurrogate"=""

[HKEY_CLASSES_ROOT\CLSID\clsid]
@=className
"AppID"="appid"

[HKEY_CLASSES_ROOT\CLSID\clsid\InprocServer32]
@=moduleName
"ThreadingModel"="threading"

Catatan

Mengatur nilai DllSurrogate ke string kosong menunjukkan bahwa runtime COM akan memuat plug-in toko online ke pengganti DLL default, dllhost.exe.

Dalam sintaks registri sebelumnya, simbol dalam miring adalah tempat penampung untuk nama dan pengidentifikasi unik global (GUID) yang khusus untuk toko online. Tabel berikut ini menjelaskan tempat penampung tersebut.

Tempat penampung Deskripsi
keyName String yang disepakati antara Microsoft dan toko online. String ini secara unik mengidentifikasi toko online. Contoh: "Proseware"
Bendera Bitwise ATAU dari satu atau beberapa bendera kemampuan plug-in Bendera ini menentukan apakah Pemutar Media Windows harus memanggil metode IWMPContentPartner tertentu. Untuk informasi tentang bendera yang didukung, lihat tabel bendera kemampuan plug-in yang mengikuti tabel ini. Contoh: 00000058
Clsid GUID yang merupakan pengidentifikasi kelas (CLSID) untuk kelas yang mengimplementasikan IWMPContentPartner di plug-in toko online. GUID ini harus dalam format registri, lengkap dengan kurung kurawal. Format: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx}
nama ramah Nama yang mudah diingat untuk toko online. Contoh: "Proseware Music Service"
appid GUID yang merupakan pengidentifikasi aplikasi (AppID) untuk plug-in toko online. GUID ini harus dalam format registri, lengkap dengan kurung kurawal. Format: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx}
pluginName Nama untuk plug-in toko online. Contoh: "Plug-in Mitra Konten Proseware"
className Nama kelas yang mengimplementasikan IWMPContentpartner di plug-in toko online. Contoh: "CProsewarePartner"
moduleName Jalur yang sepenuhnya memenuhi syarat ke DLL yang mengimplementasikan plug-in toko online. Contoh: "C:\Program Files\Proseware\ProsewarePartner.dll"
Threading Jenis apartemen tempat plug-in berjalan. "ThreadingModel"="Apartment" menunjukkan bahwa plug-in berjalan di apartemen berulir tunggal (STA). "ThreadingModel"="Free" menunjukkan bahwa plug-in berjalan di apartemen multithreaded (MTA).

Tabel berikut ini menjelaskan bendera kapabilitas plug-in.

Bendera Nilai Deskripsi
SUBSCRIPTION_CAP_BACKGROUNDPROCESSING 0x8 Pemutar Media Windows harus memanggil IWMPContentPartner::Notify untuk menginformasikan plug-in kapan harus memulai dan menghentikan pemrosesan latar belakang.
SUBSCRIPTION_CAP_DEVICEAVAILABLE 0x10 Pemutar Media Windows harus memanggil IWMPContentPartner::UpdateDevice.
SUBSCRIPTION_CAP_IS_CONTENTPARTNER 0x40 Menginformasikan Pemutar Media Windows bahwa plug-in mengimplementasikan antarmuka IWMPContentPartner. Semua plug-in toko online tipe 1 harus mengatur bendera ini.
SUBSCRIPTION_CAP_ALTLOGIN 0x80 Menginformasikan Pemutar Media Windows bahwa plug-in mendukung login alternatif. Jika plug-in mendukung login alternatif, Pemutar Media Windows mengambil URL masuk alternatif dan caption dengan memanggil IWMPContentPartner::GetItemInfo.

Entri Registri untuk Pengembangan dan Pengujian

Saat Anda mulai mengembangkan toko online, Microsoft memberi Anda dua kunci: kunci pengujian dan kunci produksi. Selama fase pengembangan dan pengujian, toko online Anda akan muncul di Pemutar Media Windows hanya jika kunci pengujian atau kunci produksi Anda berada di registri di komputer pengguna. Untuk informasi selengkapnya tentang kunci pengujian dan produksi, lihat Kunci Pengujian dan Produksi untuk Toko Online Tipe 1.

Tempatkan kunci pengujian atau produksi Anda di lokasi berikut di registri.

[HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Services]
"TestParameter" = "key1;key2;...;keyN"

Perhatikan bahwa nilai entri registri TestParameter dapat menentukan beberapa kunci pengujian atau produksi. Misalnya, Proseware memiliki kunci pengujian "1234" dan Contoso memiliki kunci uji "2345". Entri registri berikut menentukan bahwa penyimpanan pengujian untuk Proseware dan Contoso akan muncul di Pemutar Media Windows.

[HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Services]
"TestParameter" = "1234;2345"

Entri Registri ActiveService

Ketika pengguna mengaktifkan toko online, Pemutar Media Windows menulis informasi di registri yang mengidentifikasi toko online aktif. Pemutar Media Windows menempatkan informasi di lokasi berikut di registri di komputer pengguna.

[HKEY_CURRENT_USER\Software\Microsoft\MediaPlayer\Subscriptions]
"ActiveService"=serviceInfo

Dalam sintaks registri sebelumnya, serviceInfo adalah tempat penampung untuk string yang berisi informasi deskriptif tentang penyimpanan online aktif.

Referensi untuk Toko Online Tipe 1