Metode External.changeViewOnlineList

[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.]

Catatan

Topik ini menjelaskan fungsionalitas yang dirancang untuk digunakan oleh toko online. Penggunaan fungsionalitas ini di luar konteks toko online tidak didukung.

Metode changeViewOnlineList mengubah tampilan di Pemutar Media Windows untuk menampilkan daftar yang dihasilkan secara dinamis oleh toko online.

Sintaks

External.changeViewOnlineList(
  LibraryLocationType,
  LibraryLocationID,
  Params,
  FriendlyName,
  ListType,
  ViewMode
)

Parameter

LibraryLocationType [in]

Konstanta lokasi pustaka yang menentukan jenis tampilan baru. Misalnya, CPGenreID konstanta menentukan bahwa tampilan baru akan menampilkan genre tertentu.

LibraryLocationID [in]

String yang berisi ID item tertentu untuk ditampilkan dalam tampilan baru. Misalnya, jika LibraryLocationType adalah CPGenreID, maka parameter ini menentukan ID genre yang akan ditampilkan dalam tampilan baru. String ini bisa kosong.

Params [in]

String yang berisi parameter yang Pemutar Media Windows teruskan ke plug-in toko online dengan memanggil IWMPContentPartner::GetTemplate. Parameter ini tidak ditafsirkan oleh Pemutar Media Windows. Mereka dibuat oleh toko online dan hanya memiliki arti untuk toko online. String ini bisa kosong

FriendlyName [in]

String yang berisi nama yang mudah diingat, yang akan ditampilkan oleh Pemutar Media Windows, untuk daftar dinamis.

ListType [in]

Konstanta lokasi pustaka yang menentukan jenis item dalam daftar yang dihasilkan secara dinamis. Misalnya, jika nilai parameter ini adalah CPTrackID, maka daftar dinamis akan berisi trek.

ViewMode [in]

String yang menentukan mode yang akan digunakan Pemutar Media Windows untuk menampilkan daftar dinamis. Pemanggil harus mengatur parameter ini ke salah satu nilai berikut, yang ditentukan dalam contentpartner.h:

ViewModeReport

ViewModeDetails

ViewModeIcon

ViewModeTile

ViewModeOrderedList

Mengembalikan nilai

Metode ini tidak mengembalikan nilai.

Keterangan

Ketika skrip pada halaman penemuan memanggil changeViewOnlineList, Pemutar Media Windows meneruskan beberapa parameter bersama dengan metode IWMPContentPartner::GetListContents dan IWMPContentPartner::GetTemplate, yang diimplementasikan oleh plug-in toko online. Tabel berikut menunjukkan korespondensi antara parameter dari tiga metode.

parameter changeViewOnlineList	Parameter GetListContents	Parameter GetTemplate
LocationType	lokasi	lokasi
LocationID	pContext	pContext
Param	bstrParams	bstrViewParams
ListType	bstrListType	tidak berlaku

Karena ketiga metode yang ditunjukkan dalam tabel sebelumnya diimplementasikan oleh toko online, Anda memiliki beberapa fleksibilitas dalam cara Anda menggunakan parameter. Idenya adalah Bahwa Anda memberikan informasi yang cukup untuk GetListContents untuk menentukan daftar mana yang harus diambil dan untuk GetTemplate untuk menentukan halaman penemuan mana yang harus ditampilkan berikutnya. Contoh berikut menggambarkan dua kemungkinan.

Contoh 1: Daftar dinamis yang ada di katalog toko online

Misalkan Anda ingin plug-in mendapatkan konten daftar dinamis yang memiliki ID 6 di katalog toko online. Asumsikan bahwa daftar 6 adalah daftar trek. Anda dapat memberikan plug-in dengan informasi yang cukup dengan melakukan panggilan berikut.

external.changeViewOnlineList(
   "CPListID", 6, "", 
   "Songs for Today", "CPTrackID", "ViewModeDetails");

Perhatikan bahwa parameter Params kosong; plug-in memiliki informasi yang cukup di parameter lain.

Contoh 2: Daftar dinamis yang tidak ada di katalog toko online

Misalkan Anda ingin plug-in mendapatkan konten daftar dinamis yang tidak ada di katalog toko online. Mungkin Anda telah memutuskan untuk memiliki daftar dinamis yang mencakup lagu yang dipilih oleh artis tertentu. Asumsikan artis memiliki ID 2 di katalog toko online. Anda dapat melakukan panggilan berikut.

external.changeViewOnlineList(
   "CPArtistID", 2, "songs picked by Sally", 
   "Sally Picks", "CPTrackID", "ViewModeDetails");

Perhatikan bahwa parameter LocationType dan LocationID tidak menentukan daftar. Sebagai gantinya, parameter Params menentukan daftar. Parameter LocationType dan LocationID diteruskan ke IWMPContentPartner::GetListContents, tetapi dalam hal ini, GetListContents dapat mengabaikannya. Parameter LocationType dan LocationID juga diteruskan ke IWMPContentPartner::GetTemplate, yang dapat menggunakannya untuk menentukan halaman penemuan mana yang harus ditampilkan dengan daftar dinamis.

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows 11
DLL	Wmp.dll

Lihat juga

Objek Eksternal untuk Toko Online Tipe 1

IWMPContentPartner::GetListContents

IWMPContentPartnerCallback::AddListContents

IWMPContentPartner::GetTemplate

Lokasi dan Item Terpilih