媒体文件的元数据属性
本主题列出了媒体文件的最常见元数据属性。
通用媒体属性
Shell 属性系统为所有类型的 shell 对象定义一组通用元数据属性。 其中一部分适用于媒体文件。 下表列出了媒体的最常见 Shell 属性。 媒体文件可能支持此处未列出的其他属性。 此外，并非所有文件格式都支持列出的每个属性。 有关 Shell 属性的完整列表，请参阅 Shell 属性。
| PROPERTYKEY | Shell 名称 | 描述 | 数据类型 |
|---|---|---|---|
| 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 | 内容组的说明（例如装箱集或系列）。 | 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/Year |
| PKEY_Music_AlbumArtist | WM/AlbumArtist |
| 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 |
相关主题