Metode External.changeView

[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 changeView mengubah tampilan di Pemutar Media Windows.

Sintaks

External.changeView(
  LibraryLocationType,
  LibraryLocationID,
  Filter,
  ViewParams
)

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. Lihat Keterangan.

Filter [in]

String yang berisi filter untuk tampilan baru. Tampilan akan difilter seolah-olah pengguna telah memasukkan teks ini dalam kontrol roda kata Pemutar. String ini bisa kosong.

ViewParams [in]

String yang berisi parameter yang Pemutar Media Windows sediakan untuk halaman penemuan baru yang ditampilkan dengan tampilan baru. Parameter ini tidak ditafsirkan oleh Pemutar Media Windows. Mereka dibuat oleh toko online dan hanya memiliki arti untuk toko online.

Menampilkan nilai

Metode ini tidak mengembalikan nilai.

Keterangan

Dalam beberapa kasus, masuk akal untuk mengatur parameter LibraryLocationID ke string kosong. Misalnya, jika Anda mengatur parameter LibraryLocationType ke AllCPAlbumIDs, tampilan baru akan mewakili semua album. Tidak ada album individu yang akan menjadi fokus tampilan baru, jadi tidak perlu menyediakan ID album di parameter LibraryLocationID .

Parameter ViewParams menyediakan cara bagi halaman penemuan untuk berkomunikasi dengan halaman penemuan lain. Saat skrip di halaman penemuan memanggil changeView, Pemutar Media Windows menyesuaikan antarmuka penggunanya. Penyesuaian itu menyebabkan Pemutar memanggil metode IWMPContentPartner::GetTemplate plug-in untuk mendapatkan URL halaman penemuan baru. String yang diteruskan halaman penemuan asli dalam parameter ViewParams tidak diteruskan ke GetTemplate. Namun, halaman penemuan baru dapat mengambil string ViewParams dengan memanggil External.viewParameters.

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows 11.
DLL	Wmp.dll

Lihat juga

Objek Eksternal untuk Toko Online Tipe 1

External.changeViewOnlineList

External.libraryLocationID

External.libraryLocationType

External.viewParameters