Share via

Membeli Konten Media

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

Saat Pemutar Media Windows menampilkan konten musik dalam tampilan pohon pustaka, antarmuka pengguna menyertakan elemen yang dapat diklik pengguna untuk membeli konten. Misalnya, pengguna dapat mengklik tombol untuk membeli lagu individual atau membeli seluruh album.

Jika toko online aktif adalah toko Tipe 1, Pemutar Media Windows memiliki akses untuk melacak, album, dan mencantumkan harga di katalog toko online. Harga dalam katalog tersebut adalah string yang memiliki format yang hanya dipahami oleh toko online. Pemutar Media Windows tidak menafsirkan string harga; itu hanya menampilkannya di elemen antarmuka pengguna seperti tombol Beli.

Ketika Pemutar Media Windows menyiapkan pembelian untuk sekumpulan item media, ia meneruskan ID dan harga item media ke plug-in mitra konten dengan memanggil IWMPContentPartner::CanBuySilent. Pada saat itu, plug-in dapat memeriksa harga yang disediakan oleh Pemutar. Ini adalah harga yang diharapkan pengguna untuk membayar; yaitu, harga yang ditampilkan Pemutar kepada pengguna. Berdasarkan ID media dan harga yang disediakan oleh Pemutar, plug-in menghitung harga total, yang dikembalikan ke Pemutar dalam parameter bstrTotalPrice . Harga yang diteruskan Pemutar ke CanBuySilent memberikan plug-in dengan informasi, tetapi mereka tidak mewajibkan plug-in untuk mengembalikan harga total tertentu. Plug-in dapat menghitung harga total sesuai keinginan.

Selain menghitung total harga pembelian, CanBuySilent menentukan apakah pembelian dapat dilanjutkan secara diam-diam; yaitu, tanpa menampilkan kotak dialog. Jika CanBuySilent mengembalikan True, Pemutar Media Windows cukup mengubah teks pada tombol Beli untuk meminta pengguna mengonfirmasi pembelian. Jika CanBuySilent mengembalikan False, Pemutar Media Windows menampilkan kotak dialog yang meminta pengguna untuk mengonfirmasi pembelian. Kotak dialog memberi pengguna informasi yang meringkas pembelian seperti jumlah album, jumlah trek individual, dan harga total (seperti yang dikembalikan oleh plug-in).

Setelah pengguna mengonfirmasi pembelian, Pemutar memanggil IWMPContentPartner::Buy. Panggilan metode ini menyediakan plug-in dengan daftar kontainer konten yang sama dengan CanBuySilent. Saat memanggil Beli, Pemutar Media Windows juga menyediakan cookie (hanya nilai DWORD, unik untuk sesi) yang dapat digunakan plug-in untuk mengidentifikasi transaksi. Ketika transaksi selesai, plug-in harus memanggil IWMPContentPartnerCallback::BuyComplete, melewati nilai cookie asli untuk parameter dwBuyCookie , untuk memberi tahu Pemutar bahwa transaksi selesai.

Panduan Pemrograman untuk Toko Online Tipe 1