媒体文件的元数据属性
本主题列出了媒体文件的最常见元数据属性。
常用媒体属性
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 | 像素纵横比的水平分量。 (等效于媒体 type.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 | 像素纵横比的垂直分量。 (等效于媒体 type. ) 中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 (可选)
- DRM 内容) 所需的PKEY_DRM_IsProtected (
- 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/Category |
| 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/发布服务器 |
| PKEY_Media_SubTitle | WM/SubTitleDescription |
| PKEY_Media_UniqueFileIdentifier | WM/UniqueFileIdentifier |
| PKEY_Media_Writer | WM/编写器 |
| PKEY_Media_Year | WM/年 |
| 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/控制器 |
相关主题