媒體檔案的元數據屬性
本主題列出媒體檔案最常見的元數據屬性。
通用媒體屬性
Shell 屬性系統會針對所有殼層物件類型定義一組通用元數據屬性。 這些子集適用於媒體檔案。 下表列出媒體最常見的Shell屬性。 媒體檔案可能支援此處未列出的其他屬性。 此外，並非所有檔案格式都支援列出的每個屬性。 如需殼層屬性的完整清單，請參閱 Shell 屬性。
| PROPERTYKEY | 殼層名稱 | 描述 | 數據類型 |
|---|---|---|---|
| MFPKEY_Content_DLNA_Profile_ID | 沒有 | 數位生活網路聯盟 （DLNA） 配置檔識別碼。 | VT_LPWSTR |
| PKEY_Audio_ChannelCount | System.Audio.ChannelCount | 音訊通道數目。 | VT_UI4 |
| PKEY_Audio_EncodingBitrate | System.Audio.EncodingBitrate | 平均音訊比特率，以每秒位數為單位。 | VT_UI4 |
| PKEY_Audio_Format | System.Audio.Format | 以字串表示的音訊子類型 （MF_MT_SUBTYPE）。 | VT_LPWSTR |
| PKEY_Audio_IsVariableBitRate | System.Audio.IsVariableBitRate | 指出音訊數據流是否使用可變比特率編碼。 | VT_BOOL |
| PKEY_Audio_PeakValue | System.Audio.PeakValue | 音訊內容的尖峰音量層級。 | VT_UI4 |
| PKEY_Audio_SampleRate | System.Audio.SampleRate | 每秒樣本中的音訊取樣率。 相當於媒體類型中的 MF_MT_AUDIO_SAMPLES_PER_SECOND 屬性。 | VT_UI4 |
| PKEY_Audio_SampleSize | System.Audio.SampleSize | 每個音訊範例的位數。 相當於媒體類型中的 MF_MT_AUDIO_BITS_PER_SAMPLE 屬性。 | VT_UI4 |
| PKEY_Audio_StreamNumber | System.Audio.StreamNumber | 音訊數據流的標識碼。 | VT_UI4 |
| PKEY_Author | System.Author | 作者。 | VT_LPWSTR |
| PKEY_Comment | System.Comment | 附加至檔案的批注，通常是由使用者新增。 | VT_LPWSTR |
| PKEY_Copyright | System.Copyright | 著作權資訊。 | VT_LPWSTR |
| PKEY_DRM_IsProtected | System.DRM.IsProtected | 指出內容是否使用數位版權管理保護（DRM）。 | VT_BOOL |
| PKEY_Keywords | System.Keywords | 關鍵字。 | VT_LPWSTR |
| PKEY_Language | System.Language | 語言。 | VT_LPWSTR |
| PKEY_Media_AuthorUrl | System.Media.AuthorUrl | 作者網站的 URL。 | VT_LPWSTR |
| PKEY_Media_AverageLevel | System.Media.AverageLevel | 音訊內容的平均音量層級。 | VT_UI4 |
| PKEY_Media_ClassPrimaryID | System.Media.ClassPrimaryID | 識別媒體主要類別之 GUID 的字串表示。 如需有效值，請參閱 WM/MediaClassPrimaryID 屬性的檔。 | VT_LPWSTR |
| PKEY_Media_ClassSecondaryID | System.Media.ClassSecondaryID | 識別媒體次要類別之 GUID 的字串表示。 如需有效值，請參閱 WM/MediaClassSecondaryID 屬性的檔。 | VT_LPWSTR |
| PKEY_Media_CollectionGroupID | System.Media.CollectionGroupID | 識別集合群組之 GUID 的字串表示。 | VT_LPWSTR |
| PKEY_Media_CollectionID | System.Media.CollectionID | 識別集合之 GUID 的字串表示。 | VT_LPWSTR |
| PKEY_Media_ContentDistributor | System.Media.ContentDistributor | 內容的散發者。 | VT_LPWSTR |
| PKEY_Media_ContentID | System.Media.ContentID | 識別集合之 GUID 的字串表示。 | VT_LPWSTR |
| PKEY_Media_DateEncoded | System.Media.DateEncoded | 內容編碼的時間。 | VT_FILETIME |
| PKEY_Media_DateReleased | System.Media.DateReleased | 原始發行日期。 | VT_LPWSTR |
| PKEY_Media_Duration | System.Media.Duration | 持續時間，以 100 奈秒為單位。 相當於簡報描述元中的 MF_PD_DURATION 屬性。 | VT_UI8 |
| PKEY_Media_DVDID | System.Media.DVDID | 數字視訊光碟標識碼（DVDID）。 | VT_LPWSTR |
| PKEY_Media_EncodedBy | System.Media.EncodedBy | 編碼內容的人員或群組名稱。 | VT_LPWSTR |
| PKEY_Media_EncodingSettings | System.Media.EncodingSettings | 用來編碼內容的設定描述。 | VT_LPWSTR |
| PKEY_Media_MCDI | System.Media.MCDI | 音樂CD標識碼。 這個值用來識別CD。 | VT_LPWSTR |
| PKEY_Media_MetadataContentProvider | System.Media.MetadataContentProvider | 元數據內容提供者的名稱。 （例如，元數據可能由商務服務提供。 | VT_LPWSTR |
| PKEY_Media_Producer | System.Media.Producer | 內容產生者的名稱。 | VT_LPWSTR |
| PKEY_Media_PromotionUrl | System.Media.PromotionUrl | 提供內容相關促銷的網站 URL。 | VT_LPWSTR |
| PKEY_Media_ProviderRating | System.Media.ProviderRating | 元數據內容提供者所指派的內容評等。 | VT_LPWSTR |
| PKEY_Media_ProviderStyle | System.Media.ProviderStyle | 元數據內容提供者所指派的內容樣式或內容類型。 | VT_LPWSTR |
| PKEY_Media_Publisher | System.Media.Publisher | 發行人。 | VT_LPWSTR |
| PKEY_Media_SubTitle | System.Media.SubTitle | 字幕。 | VT_LPWSTR |
| PKEY_Media_UniqueFileIdentifier | System.Media.UniqueFileIdentifier | 可識別檔案的泛型字串。 | VT_LPWSTR |
| PKEY_Media_Writer | System.Media.Writer | 作家。 | VT_LPWSTR |
| PKEY_Media_Year | System.Media.Year | 發佈內容的年份。 | VT_UI4 |
| PKEY_Music_AlbumArtist | System.Music.AlbumArtist | 專輯的主要藝術家。 這個屬性可用來區分專輯的主要藝術家與在特定曲目上共同作業的藝術家。 | VT_LPWSTR |
| PKEY_Music_AlbumTitle | System.Music.AlbumTitle | 專輯標題。 | VT_LPWSTR |
| PKEY_Music_Artist | System.Music.Artist | 藝術家。 | VT_LPWSTR |
| PKEY_Music_BeatsPerMinute | System.Music.BeatsPerMinute | 每分鐘節拍次數。 | VT_LPWSTR |
| PKEY_Music_Composer | System.Music.Composer | 作曲家。 | VT_LPWSTR |
| PKEY_Music_Conductor | System.Music.Conductor | 導體。 | VT_LPWSTR |
| PKEY_Music_ContentGroupDescription | System.Music.ContentGroupDescription | 內容群組的描述（例如 Boxed set 或 series）。 | VT_LPWSTR |
| PKEY_Music_Genre | System.Music.Genre | 類型。 | VT_LPWSTR |
| PKEY_Music_InitialKey | System.Music.InitialKey | 音樂的初始按鍵。 | VT_LPWSTR |
| PKEY_Music_IsCompilation | System.Music.IsCompilation | 指出音樂檔案是否為編譯的一部分。 | VT_BOOL |
| PKEY_Music_Lyrics | System.Music.Lyrics | 歌詞。 | VT_LPWSTR |
| PKEY_Music_Mood | System.Music.Mood | 心情。 | VT_LPWSTR |
| PKEY_Music_PartOfSet | System.Music.PartOfSet | 檔案所屬集合中的元件編號和總數，並以斜線分隔。 | VT_LPWSTR |
| PKEY_Music_Period | System.Music.Period | 時期。 | VT_LPWSTR |
| PKEY_Music_TrackNumber | System.Music.TrackNumber | 追蹤編號。 | VT_UI4 |
| PKEY_ParentalRating | System.ParentalRating | 家長評等。 | VT_LPWSTR |
| PKEY_ParentalRatingReason | System.ParentalRatingReason | 指派的家長評等原因。 | VT_LPWSTR |
| PKEY_Rating | System.Rating | 用戶評等。 | VT_UI4 |
| PKEY_ThumbnailStream | System.ThumbnailStream | 縮圖影像。 | VT_STREAM |
| PKEY_Title | System.Title | 標題。 | VT_LPWSTR |
| PKEY_Video_Compression | System.Video.Compression | 視訊子類型 （MF_MT_SUBTYPE） 以字串表示。 | VT_LPWSTR |
| PKEY_Video_Director | System.Video.Director | 導演。 | VT_LPWSTR |
| PKEY_Video_EncodingBitrate | System.Video.EncodingBitrate | 平均視訊比特率，以每秒位數為單位。 | VT_UI4 |
| PKEY_Video_FourCC | System.Video.FourCC | 視訊編碼格式的 FOURCC。 只有在視訊子類型可以表示為 FOURCC 值時才適用。 | VT_UI4 |
| PKEY_Video_FrameHeight | System.Video.FrameHeight | 視訊畫面高度。 | VT_UI4 |
| PKEY_Video_FrameRate | System.Video.FrameRate | 視訊幀速率，以每秒畫面格表示× 1000。 | VT_UI4 |
| PKEY_Video_FrameWidth | System.Video.FrameWidth | 視訊畫面寬度。 | VT_UI4 |
| PKEY_Video_HorizontalAspectRatio | System.Video.HorizontalAspectRatio | 像素外觀比例的水準元件。 （相當於媒體類型中 MF_MT_PIXEL_ASPECT_RATIO 屬性的分子。 | VT_UI4 |
| PKEY_Video_IsStereo | System.Video.IsStereo | 指出視訊串流是否包含立體視訊內容。 | VT_BOOL |
| PKEY_Video_StreamNumber | System.Video.StreamNumber | 視訊數據流的標識碼。 | VT_UI4 |
| PKEY_Video_TotalBitrate | System.Video.TotalBitrate | 所有視訊和音訊串流的總數據速率，以每秒位數為單位。 （僅適用於至少有一個視訊數據流的檔案。 | VT_UI4 |
| PKEY_Video_VerticalAspectRatio | System.Video.VerticalAspectRatio | 像素外觀比例的垂直元件。 （相當於媒體類型中 MF_MT_PIXEL_ASPECT_RATIO 屬性的分母。 | VT_UI4 |
媒體共用屬性
若要讓媒體檔案與媒體共用功能相容，屬性處理程式應該公開下列元數據屬性。 這些屬性可讓媒體共用服務提供適當的選項，將內容轉碼為不同的格式或比特率。
- MFPKEY_Content_DLNA_Profile_ID
- PKEY_Audio_ChannelCount
- PKEY_Audio_EncodingBitrate
- PKEY_Audio_Format
- PKEY_Audio_SampleRate （選擇性）
- PKEY_Audio_SampleSize （選擇性）
- PKEY_DRM_IsProtected （DRM 內容所需）
- PKEY_Media_Duration
- PKEY_Video_Compression
- PKEY_Video_EncodingBitrate
- PKEY_Video_FOURCC
- PKEY_Video_FrameHeight
- PKEY_Video_FrameRate （選擇性）
- PKEY_Video_FrameWidth
- PKEY_Video_TotalBitrate
如果內容使用DRM保護，則需要 PKEY_DRM_IsProtected 屬性。 否則，這個屬性是選擇性的。
PKEY_Audio_SampleRate、PKEY_Audio_SampleSize和 PKEY_Video_FrameRate 屬性是選擇性的。 如果媒體共用服務可供使用，則會公開它們。
PKEY_Audio_* 群組中的屬性僅適用於具有音訊數據流的檔案，而 PKEY_Video_* 群組中的屬性只適用於具有視訊數據流的檔案。
Windows 媒體格式 SDK 對應
ASF 媒體來源會將下列屬性索引鍵對應至 ASF 標頭屬性。 在某些情況下，Shell 屬性和 Format SDK 屬性之間的數據類型不同。
| PROPERTYKEY | 格式化 SDK 屬性 |
|---|---|
| PKEY_Audio_IsVariableBitRate | IsVBR |
| PKEY_Audio_PeakValue | PeakValue |
| PKEY_Author | 作者 |
| PKEY_Comment | 描述 |
| PKEY_Copyright | 著作權 |
| PKEY_DRM_IsProtected | Is_Protected |
| PKEY_Keywords | WM/類別 |
| PKEY_Language | WM/語言 |
| PKEY_Media_AuthorUrl | WM/AuthorURL |
| PKEY_Media_AverageLevel | AverageLevel |
| 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/提供者 |
| PKEY_Media_Producer | WM/產生者 |
| 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/寫入器 |
| PKEY_Media_Year | WM/年 |
| PKEY_Music_AlbumArtist | WM/專輯藝術師 |
| PKEY_Music_AlbumTitle | WM/AlbumTitle |
| PKEY_Music_Artist | 作者 |
| PKEY_Music_BeatsPerMinute | WM/BeatsPerMinute |
| PKEY_Music_Composer | WM/Composer |
| PKEY_Music_Conductor | WM/導體 |
| PKEY_Music_ContentGroupDescription | WM/ContentGroupDescription |
| PKEY_Music_Genre | WM/內容類型 |
| PKEY_Music_InitialKey | WM/InitialKey |
| PKEY_Music_IsCompilation | WM/IsCompilation |
| PKEY_Music_Lyrics | WM/歌詞 |
| PKEY_Music_Mood | WM/Mood |
| PKEY_Music_PartOfSet | WM/PartOfSet |
| PKEY_Music_Period | WM/期間 |
| PKEY_Music_TrackNumber | WM/TrackNumber |
| PKEY_ParentalRating | WM/ParentalRating |
| PKEY_ParentalRatingReason | WM/ParentalRatingReason |
| PKEY_Rating | WM/SharedUserRating |
| PKEY_ThumbnailStream | WM/圖片 |
| PKEY_Title | 標題 |
| PKEY_Video_Director | WM/Director |
相關主題