Share via

媒体文件的元数据属性

  • 项目

本主题列出了媒体文件的最常见元数据属性。

常用媒体属性

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/控制器

 

媒体元数据

Shell 元数据提供程序