Menambahkan Atribut ContentDistributor

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

Ketika pengguna mencoba memutar konten toko online atau menyalin konten ke CD atau perangkat, Pemutar Media Windows memanggil metode tertentu di objek COM Anda. Untuk melakukan ini, Pemutar memerlukan cara untuk membedakan konten Anda dari penyedia toko online lainnya. Dengan menambahkan nama kunci toko online Anda sebagai nilai untuk ContentDistributor (yang merupakan alias untuk atribut Windows Media Format SDK bernama WM/ContentDistributor) ke konten berbasis Windows Media Anda, Anda memastikan bahwa Pemutar dapat mengidentifikasi konten yang terkait dengan layanan Anda.

Menambahkan nilai untuk ContentDistributor juga memastikan bahwa Pemutar Media Windows akan membuat simpul di pustaka untuk konten yang Anda berikan. Lihat Integrasi Pustaka.

Anda dapat menentukan nilai ini dengan dua cara:

  • Gunakan model objek Pemutar Media Windows. Saat Anda melakukan ini, Pemutar Media Windows menambahkan nilai yang Anda tentukan ke database pustaka. Akhirnya, Pemutar juga akan menulis nilai atribut ke file media digital.
  • Gunakan Windows Media Format SDK untuk menambahkan atribut WM/ContentDistributor secara terprogram. Saat Anda melakukan ini, Pemutar Media Windows membaca nilai atribut dan menambahkannya ke database saat file media digital ditambahkan ke pustaka.

Saat membuat objek COM toko online Anda, nilai atribut file yang Anda tetapkan untuk ContentDistributor dan nilai yang ditetapkan ke kszContentDistributorID konstanta di YourProject.h harus sama persis. Ingat bahwa Anda menentukan nilai konstanta ini untuk objek COM saat Anda membuat proyek dengan menggunakan wizard proyek. Anda dapat mengubah nilai ini secara manual. Pastikan untuk menggunakan string yang secara unik mengidentifikasi layanan Anda.

Menggunakan Model Objek Pemutar Media Windows

Untuk menentukan nilai untuk ContentDistributor menggunakan model objek Pemutar Media Windows, gunakan metode Media.setItemInfo. Contoh kode berikut menentukan nilai "Proseware" untuk ContentDistributor untuk item media yang saat ini diputar:

// Retrieve the current media item.
var theMedia = Player.currentMedia;

//Test whether the media item was retrieved.
if(theMedia)
{
    // Set the ContentDistributor value.
    theMedia.setItemInfo("ContentDistributor", "Proseware");
}

Menggunakan Windows Media Format SDK

SDK Pemutar Media Windows menyertakan sampel file C++, bernama SetContentDistributor.cpp, yang menunjukkan cara menggunakan Windows Media Format 9 Series SDK untuk menambahkan atribut WM/ContentDistributor. Anda dapat menemukan file sampel ini di folder bernama Metadata tempat Anda menginstal SDK. Untuk menggunakan kode ini, Anda harus mengikuti langkah-langkah berikut:

  1. Instal Windows Media Format 9 Series SDK dan konfigurasikan runtime seperti yang dijelaskan dalam dokumentasi.
  2. Buat proyek C++ kosong baru di Visual Studio dan tambahkan file sampel bernama SetContentDistributor.cpp ke proyek.
  3. Tambahkan jalur ke folder Windows Media Format 9 Series SDK Lib ke daftar jalur file Anda. Dari menu Alat , pilih Opsi.
  4. Dalam kotak dialog Opsi , klik Proyek, lalu klik Direktori VC++.
  5. Dalam kotak daftar drop-down Perlihatkan Direktori untuk , klik File pustaka.
  6. Gunakan tombol untuk menambahkan jalur ke kotak daftar.
  7. Buka kotak dialog halaman properti untuk proyek Anda. Pilih Properti Konfigurasi, lalu Linker, lalu Input. Ketik "wmvcore.lib" di kotak teks Dependensi Tambahan .

Kode sampel membuat program baris perintah. Argumen yang Anda berikan saat menjalankan program menentukan jalur ke file media digital untuk dimodifikasi dan string untuk nilai atribut ContentDistributor . Kode ini menggunakan IWMHeaderInfo::SetAttribute untuk menambahkan atribut ke file yang Anda tentukan. Anda dapat menggunakan sampel ini apa adanya atau menggunakannya sebagai titik awal untuk program Anda sendiri.

Informasi Umum untuk Tipe 1 dan Tipe 2 Toko Online