Metode Media.getItemInfo

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

Metode getItemInfo mengambil nilai atribut yang ditentukan untuk item media saat ini.

Sintaks

strRetVal = Media.getItemInfo(
  name
)

Parameter

name [in]

String yang berisi nama atribut . Untuk informasi tentang atribut yang didukung oleh Pemutar Media Windows, lihat Referensi Atribut Pemutar Media Windows.

Mengembalikan nilai

Metode ini mengembalikan String yang mewakili nilai atribut yang ditentukan. Untuk atribut yang nilai yang mendasarnya adalah Boolean, ia mengembalikan string "true" atau "false".

Keterangan

Metode ini mengambil metadata untuk item media digital individual atau item media yang merupakan bagian dari daftar putar.

Properti attributeCount berisi jumlah nama atribut yang tersedia untuk objek Media tertentu. Nomor indeks kemudian dapat digunakan dengan metode getAttributeName untuk menentukan nama setiap atribut yang tersedia. Nama atribut individual dapat diteruskan ke getItemInfo.

Untuk mengambil atribut dengan beberapa nilai dan atribut dengan nilai kompleks, gunakan metode getItemInfoByType .

Untuk menggunakan metode ini, diperlukan akses baca ke pustaka. Untuk informasi selengkapnya, lihat Akses Pustaka.

Untuk berbagi pustaka media Windows melalui UPnP, Pemutar Media Windows membuat layanan direktori konten (CDS) yang diekspos melalui UPnP. Perangkat lain kemudian dapat menavigasi dan menelusuri pustaka.

Di Windows 7, aplikasi dapat menggunakan atribut Pemutar Media Windows TrackingID dan MediaType untuk membuat ID objek setiap item di CDS. Perhatikan bahwa konstruksi ini mungkin berubah dalam versi Windows yang akan datang. Aplikasi meneruskan masing-masing string atribut ini dalam parameter nama dalam panggilan ke getItemInfo. getItemInfo mengembalikan nilai untuk setiap atribut dalam nilai yang dikembalikan. Aplikasi kemudian menggunakan sintaks berikut untuk membuat setiap ID objek:

TrackingID.0. MediaTypeID

Sintaks ini memiliki arti berikut:

• TrackingID adalah string yang disimpan dalam atribut Pemutar Media Windows TrackingID item media.

• MediaTypeID bergantung pada nilai atribut MediaType , seperti yang ditunjukkan dalam tabel berikut:

  Atribut MediaType	MediaTypeID
  Item Audio	4
  Item Foto	B
  Item Video	8

Pemutar Media Windows 10 Mobile: Atribut untuk item media hanya tersedia selama pemutaran kecuali diambil dari item melalui koleksi media.

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows versi 7.0 atau yang lebih baru.
DLL	Wmp.dll

Lihat juga

Objek Media

Media.attributeCount

Media.getAttributeName

Media.getItemInfoByType

Media.setItemInfo

Membaca Nilai Atribut

Settings.mediaAccessRights

Settings.requestMediaAccessRights