Properti Metadata untuk File Media
Topik ini mencantumkan properti metadata yang paling umum untuk file media.
Properti Media Umum
Sistem properti Shell mendefinisikan sekumpulan properti metadata umum untuk semua jenis objek shell. Subset ini berlaku untuk file media. Tabel berikut ini mencantumkan properti Shell yang paling umum untuk media. File media mungkin mendukung properti tambahan yang tidak tercantum di sini. Selain itu, tidak setiap format file mendukung setiap properti yang tercantum. Untuk daftar lengkap properti Shell, lihat Properti Shell.
| PROPERTYKEY | Nama Shell | Deskripsi | Jenis Data |
|---|---|---|---|
| MFPKEY_Content_DLNA_Profile_ID | Tidak ada | Pengidentifikasi profil Digital Living Network Alliance (DLNA). | VT_LPWSTR |
| PKEY_Audio_ChannelCount | System.Audio.ChannelCount | Jumlah saluran audio. | VT_UI4 |
| PKEY_Audio_EncodingBitrate | System.Audio.EncodingBitrate | Laju bit audio rata-rata, dalam bit per detik. | VT_UI4 |
| PKEY_Audio_Format | System.Audio.Format | Subjenis audio (MF_MT_SUBTYPE) dinyatakan sebagai string. | VT_LPWSTR |
| PKEY_Audio_IsVariableBitRate | System.Audio.IsVariableBitRate | Menunjukkan apakah aliran audio menggunakan pengodean laju bit variabel. | VT_BOOL |
| PKEY_Audio_PeakValue | System.Audio.PeakValue | Tingkat volume puncak konten audio. | VT_UI4 |
| PKEY_Audio_SampleRate | System.Audio.SampleRate | Laju sampel audio dalam sampel per detik. Setara dengan atribut MF_MT_AUDIO_SAMPLES_PER_SECOND dalam jenis media. | VT_UI4 |
| PKEY_Audio_SampleSize | System.Audio.SampleSize | Jumlah bit per sampel audio. Setara dengan atribut MF_MT_AUDIO_BITS_PER_SAMPLE dalam jenis media. | VT_UI4 |
| PKEY_Audio_StreamNumber | System.Audio.StreamNumber | Pengidentifikasi aliran audio. | VT_UI4 |
| PKEY_Author | System.Author | Penulis. | VT_LPWSTR |
| PKEY_Comment | System.Comment | Komentar yang dilampirkan ke file, biasanya ditambahkan oleh pengguna. | VT_LPWSTR |
| PKEY_Copyright | System.Copyright | Informasi hak cipta. | VT_LPWSTR |
| PKEY_DRM_IsProtected | System.DRM.IsProtected | Menunjukkan apakah konten dilindungi menggunakan manajemen hak digital (DRM). | VT_BOOL |
| PKEY_Keywords | System.Keywords | Kata kunci. | VT_LPWSTR |
| PKEY_Language | System.Language | Bahasa. | VT_LPWSTR |
| PKEY_Media_AuthorUrl | System.Media.AuthorUrl | URL situs web penulis. | VT_LPWSTR |
| PKEY_Media_AverageLevel | System.Media.AverageLevel | Tingkat volume rata-rata konten audio. | VT_UI4 |
| PKEY_Media_ClassPrimaryID | System.Media.ClassPrimaryID | Representasi string GUID yang mengidentifikasi kelas utama media. Untuk nilai yang valid, lihat dokumentasi untuk atribut WM/MediaClassPrimaryID . | VT_LPWSTR |
| PKEY_Media_ClassSecondaryID | System.Media.ClassSecondaryID | Representasi string GUID yang mengidentifikasi kelas media sekunder. Untuk nilai yang valid, lihat dokumentasi untuk atribut WM/MediaClassSecondaryID . | VT_LPWSTR |
| PKEY_Media_CollectionGroupID | System.Media.CollectionGroupID | Representasi string GUID yang mengidentifikasi grup koleksi. | VT_LPWSTR |
| PKEY_Media_CollectionID | System.Media.CollectionID | Representasi string GUID yang mengidentifikasi koleksi. | VT_LPWSTR |
| PKEY_Media_ContentDistributor | System.Media.ContentDistributor | Distributor konten. | VT_LPWSTR |
| PKEY_Media_ContentID | System.Media.ContentID | Representasi string GUID yang mengidentifikasi koleksi. | VT_LPWSTR |
| PKEY_Media_DateEncoded | System.Media.DateEncoded | Waktu ketika konten dikodekan. | VT_FILETIME |
| PKEY_Media_DateReleased | System.Media.DateReleased | Tanggal rilis asli. | VT_LPWSTR |
| PKEY_Media_Duration | System.Media.Duration | Durasi, dalam unit 100 nanodetik. Setara dengan atribut MF_PD_DURATION dalam deskriptor presentasi. | VT_UI8 |
| PKEY_Media_DVDID | System.Media.DVDID | Pengidentifikasi cakram video digital (DVDID). | VT_LPWSTR |
| PKEY_Media_EncodedBy | System.Media.EncodedBy | Nama orang atau grup yang mengodekan konten. | VT_LPWSTR |
| PKEY_Media_EncodingSettings | System.Media.EncodingSettings | Deskripsi pengaturan yang digunakan untuk mengodekan konten. | VT_LPWSTR |
| PKEY_Media_MCDI | System.Media.MCDI | Pengidentifikasi CD Musik. Nilai ini digunakan untuk mengidentifikasi CD. | VT_LPWSTR |
| PKEY_Media_MetadataContentProvider | System.Media.MetadataContentProvider | Nama penyedia konten metadata. (Misalnya, metadata mungkin disediakan oleh layanan komersial.) | VT_LPWSTR |
| PKEY_Media_Producer | System.Media.Producer | Nama produser konten. | VT_LPWSTR |
| PKEY_Media_PromotionUrl | System.Media.PromotionUrl | URL situs web yang menawarkan promosi yang terkait dengan konten. | VT_LPWSTR |
| PKEY_Media_ProviderRating | System.Media.ProviderRating | Peringkat konten sebagaimana ditetapkan oleh penyedia konten metadata. | VT_LPWSTR |
| PKEY_Media_ProviderStyle | System.Media.ProviderStyle | Gaya atau genre konten seperti yang ditetapkan oleh penyedia konten metadata. | VT_LPWSTR |
| PKEY_Media_Publisher | System.Media.Publisher | Penerbit. | VT_LPWSTR |
| PKEY_Media_SubTitle | System.Media.SubTitle | Subjudul. | VT_LPWSTR |
| PKEY_Media_UniqueFileIdentifier | System.Media.UniqueFileidentifier | String generik yang dapat mengidentifikasi file. | VT_LPWSTR |
| PKEY_Media_Writer | System.Media.Writer | Penulis. | VT_LPWSTR |
| PKEY_Media_Year | System.Media.Year | Tahun konten diterbitkan. | VT_UI4 |
| PKEY_Music_AlbumArtist | System.Music.AlbumArtist | Artis utama untuk album. Atribut ini dapat digunakan untuk membedakan artis utama untuk album dari artis yang berkolaborasi di trek tertentu. | VT_LPWSTR |
| PKEY_Music_AlbumTitle | System.Music.AlbumTitle | Judul album. | VT_LPWSTR |
| PKEY_Music_Artist | System.Music.Artist | Artis. | VT_LPWSTR |
| PKEY_Music_BeatsPerMinute | System.Music.BeatsPerMinute | Ketukan per menit. | VT_LPWSTR |
| PKEY_Music_Composer | System.Music.Composer | Komposer. | VT_LPWSTR |
| PKEY_Music_Conductor | System.Music.Conductor | Konduktor. | VT_LPWSTR |
| PKEY_Music_ContentGroupDescription | System.Music.ContentGroupDescription | Deskripsi grup konten (misalnya, set atau seri berkotak). | VT_LPWSTR |
| PKEY_Music_Genre | System.Music.Genre | Genre. | VT_LPWSTR |
| PKEY_Music_InitialKey | System.Music.InitialKey | Kunci awal musik. | VT_LPWSTR |
| PKEY_Music_IsCompilation | System.Music.IsCompilation | Menunjukkan apakah file musik adalah bagian dari kompilasi. | VT_BOOL |
| PKEY_Music_Lyrics | System.Music.Lyrics | Lirik. | VT_LPWSTR |
| PKEY_Music_Mood | System.Music.Mood | Suasana hati. | VT_LPWSTR |
| PKEY_Music_PartOfSet | System.Music.PartOfSet | Nomor bagian dan jumlah total bagian dalam set tempat file berada, dipisahkan oleh garis miring. | VT_LPWSTR |
| PKEY_Music_Period | System.Music.Period | Titik. | VT_LPWSTR |
| PKEY_Music_TrackNumber | System.Music.TrackNumber | Lacak nomor. | VT_UI4 |
| PKEY_ParentalRating | System.ParentalRating | Peringkat orang tua. | VT_LPWSTR |
| PKEY_ParentalRatingReason | System.ParentalRatingReason | Alasan peringkat orang tua yang ditetapkan. | VT_LPWSTR |
| PKEY_Rating | System.Rating | Peringkat pengguna. | VT_UI4 |
| PKEY_ThumbnailStream | System.ThumbnailStream | Gambar mini. | VT_STREAM |
| PKEY_Title | System.Title | Judul. | VT_LPWSTR |
| PKEY_Video_Compression | System.Video.Compression | Subjenis video (MF_MT_SUBTYPE) dinyatakan sebagai string. | VT_LPWSTR |
| PKEY_Video_Director | System.Video.Director | Direktur. | VT_LPWSTR |
| PKEY_Video_EncodingBitrate | System.Video.EncodingBitrate | Laju bit video rata-rata, dalam bit per detik. | VT_UI4 |
| PKEY_Video_FourCC | System.Video.FourCC | FOURCC dari format pengodean video. Hanya berlaku jika subjenis video dapat dinyatakan sebagai nilai FOURCC . | VT_UI4 |
| PKEY_Video_FrameHeight | System.Video.FrameHeight | Tinggi bingkai video. | VT_UI4 |
| PKEY_Video_FrameRate | System.Video.FrameRate | Kecepatan bingkai video, dinyatakan sebagai bingkai per detik × 1000. | VT_UI4 |
| PKEY_Video_FrameWidth | System.Video.FrameWidth | Lebar bingkai video. | VT_UI4 |
| PKEY_Video_HorizontalAspectRatio | System.Video.HorizontalAspectRatio | Komponen horizontal dari rasio aspek piksel. (Setara dengan pembilang atribut MF_MT_PIXEL_ASPECT_RATIO dalam jenis media.) | VT_UI4 |
| PKEY_Video_IsStereo | System.Video.IsStereo | Menunjukkan apakah aliran video berisi konten video stereo. | VT_BOOL |
| PKEY_Video_StreamNumber | System.Video.StreamNumber | Pengidentifikasi aliran video. | VT_UI4 |
| PKEY_Video_TotalBitrate | System.Video.TotalBitrate | Total laju data untuk semua aliran video dan audio, dalam bit per detik. (Hanya berlaku untuk file dengan setidaknya satu aliran video.) | VT_UI4 |
| PKEY_Video_VerticalAspectRatio | System.Video.VerticalAspectRatio | Komponen vertikal rasio aspek piksel. (Setara dengan penyebut atribut MF_MT_PIXEL_ASPECT_RATIO dalam jenis media.) | VT_UI4 |
Properti Berbagi Media
Untuk membuat file media kompatibel dengan fitur Berbagi Media, penangan properti harus mengekspos properti metadata berikut. Properti ini memungkinkan layanan Berbagi Media untuk menawarkan opsi yang tepat untuk mentranskodekan konten ke dalam format atau laju bit yang berbeda.
- MFPKEY_Content_DLNA_Profile_ID
- PKEY_Audio_ChannelCount
- PKEY_Audio_EncodingBitrate
- PKEY_Audio_Format
- PKEY_Audio_SampleRate (opsional)
- PKEY_Audio_SampleSize (opsional)
- PKEY_DRM_IsProtected (diperlukan untuk konten DRM)
- PKEY_Media_Duration
- PKEY_Video_Compression
- PKEY_Video_EncodingBitrate
- PKEY_Video_FOURCC
- PKEY_Video_FrameHeight
- PKEY_Video_FrameRate (opsional)
- PKEY_Video_FrameWidth
- PKEY_Video_TotalBitrate
Properti PKEY_DRM_IsProtected diperlukan jika konten dilindungi menggunakan DRM. Jika tidak, properti ini bersifat opsional.
Properti PKEY_Audio_SampleRate, PKEY_Audio_SampleSize, dan PKEY_Video_FrameRate bersifat opsional. Layanan Berbagi Media akan mengeksposnya jika tersedia.
Properti dalam grup PKEY_Audio_* hanya berlaku untuk file dengan aliran audio, dan properti di grup PKEY_Video_* hanya berlaku untuk file dengan aliran video.
Pemetaan SDK Format Media Windows
Sumber media ASF memetakan kunci properti berikut ke atribut header ASF. Dalam beberapa kasus, jenis data berbeda antara properti Shell dan atribut Format SDK.
| PROPERTYKEY | Format Atribut SDK |
|---|---|
| PKEY_Audio_IsVariableBitRate | IsVBR |
| PKEY_Audio_PeakValue | Nilai Puncak |
| PKEY_Author | Penulis |
| PKEY_Comment | Deskripsi |
| PKEY_Copyright | Hak cipta |
| PKEY_DRM_IsProtected | Is_Protected |
| PKEY_Keywords | WM/Category |
| PKEY_Language | WM/Bahasa |
| PKEY_Media_AuthorUrl | WM/AuthorURL |
| PKEY_Media_AverageLevel | Rata-rataLevel |
| PKEY_Media_ClassPrimaryID | WM/MediaClassPrimaryID |
| PKEY_Media_ClassSecondaryID | WM/MediaClassSecondaryID |
| PKEY_Media_CollectionGroupID | WM/WMCollectionGroupID |
| PKEY_Media_CollectionID | WM/WMCollectionID |
| PKEY_Media_ContentDistributor | WM/ContentDistributor |
| PKEY_Media_ContentID | WM/WMContentID |
| PKEY_Media_DateEncoded | WM/EncodingTime |
| PKEY_Media_DateReleased | WM/OriginalReleaseTime |
| PKEY_Media_DVDID | WM/DVDID |
| PKEY_Media_EncodedBy | WM/EncodedBy |
| PKEY_Media_EncodingSettings | WM/EncodingSettings |
| PKEY_Media_MCDI | WM/MCDI |
| PKEY_Media_MetadataContentProvider | WM/Penyedia |
| PKEY_Media_Producer | WM/Produser |
| PKEY_Media_PromotionUrl | WM/PromotionURL |
| PKEY_Media_ProviderRating | WM/ProviderRating |
| PKEY_Media_ProviderStyle | WM/ProviderStyle |
| PKEY_Media_Publisher | WM/Publisher |
| PKEY_Media_SubTitle | WM/SubTitleDescription |
| PKEY_Media_UniqueFileIdentifier | WM/UniqueFileidentifier |
| PKEY_Media_Writer | WM/Writer |
| PKEY_Media_Year | WM/Tahun |
| PKEY_Music_AlbumArtist | WM/AlbumArtist |
| PKEY_Music_AlbumTitle | WM/AlbumTitle |
| PKEY_Music_Artist | Penulis |
| PKEY_Music_BeatsPerMinute | WM/BeatsPerMinute |
| PKEY_Music_Composer | WM/Composer |
| PKEY_Music_Conductor | WM/Konduktor |
| PKEY_Music_ContentGroupDescription | WM/ContentGroupDescription |
| PKEY_Music_Genre | WM/Genre |
| PKEY_Music_InitialKey | WM/InitialKey |
| PKEY_Music_IsCompilation | WM/IsCompilation |
| PKEY_Music_Lyrics | WM/Lirik |
| PKEY_Music_Mood | WM/Mood |
| PKEY_Music_PartOfSet | WM/PartOfSet |
| PKEY_Music_Period | WM/Periode |
| PKEY_Music_TrackNumber | WM/TrackNumber |
| PKEY_ParentalRating | WM/ParentalRating |
| PKEY_ParentalRatingReason | WM/ParentalRatingReason |
| PKEY_Rating | WM/SharedUserRating |
| PKEY_ThumbnailStream | WM/Gambar |
| PKEY_Title | Judul |
| PKEY_Video_Director | WM/Direktur |
Topik terkait
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk