Propriedades de metadados para Arquivos de mídia
Este tópico lista as propriedades de metadados mais comuns para arquivos de mídia.
- Propriedades comuns de mídia
- Propriedades de Compartilhamento de Mídia
- Mapeamentos do SDK de Formato de Mídia do Windows
- Tópicos relacionados
Propriedades comuns de mídia
O sistema de propriedades Shell define um conjunto de propriedades comuns de metadados para todos os tipos de objetos de shell. Um subconjunto deles é aplicável a arquivos de mídia. A tabela a seguir lista as propriedades mais comuns do Shell para mídia. Os arquivos de mídia podem dar suporte a propriedades adicionais não listadas aqui. Além disso, nem todos os formatos de arquivo dão suporte a todas as propriedades listadas. Para obter uma lista completa das propriedades do Shell, consulte Propriedades do Shell.
| PROPERTYKEY | Nome do shell | Descrição | Tipo de Dados |
|---|---|---|---|
| MFPKEY_Content_DLNA_Profile_ID | Nenhum | Identificador de perfil da DLNA (Digital Living Network Alliance). | VT_LPWSTR |
| PKEY_Audio_ChannelCount | System.Audio.ChannelCount | Número de canais de áudio. | VT_UI4 |
| PKEY_Audio_EncodingBitrate | System.Audio.EncodingBitrate | Taxa média de bits de áudio, em bits por segundo. | VT_UI4 |
| PKEY_Audio_Format | System.Audio.Format | Subtipo de áudio (MF_MT_SUBTYPE) expresso como uma cadeia de caracteres. | VT_LPWSTR |
| PKEY_Audio_IsVariableBitRate | System.Audio.IsVariableBitRate | Indica se o fluxo de áudio usa a codificação de taxa de bits variável. | VT_BOOL |
| PKEY_Audio_PeakValue | System.Audio.PeakValue | Nível de volume de pico de conteúdo de áudio. | VT_UI4 |
| PKEY_Audio_SampleRate | System.Audio.SampleRate | Taxa de exemplo de áudio em exemplos por segundo. Equivalente ao atributo MF_MT_AUDIO_SAMPLES_PER_SECOND no tipo de mídia. | VT_UI4 |
| PKEY_Audio_SampleSize | System.Audio.SampleSize | Número de bits por exemplo de áudio. Equivalente ao atributo MF_MT_AUDIO_BITS_PER_SAMPLE no tipo de mídia. | VT_UI4 |
| PKEY_Audio_StreamNumber | System.Audio.StreamNumber | Identificador do fluxo de áudio. | VT_UI4 |
| PKEY_Author | System.Author | Autor. | VT_LPWSTR |
| PKEY_Comment | System.Comment | Um comentário anexado a um arquivo, normalmente adicionado por um usuário. | VT_LPWSTR |
| PKEY_Copyright | System.Copyright | Informações sobre direitos autorais. | VT_LPWSTR |
| PKEY_DRM_IsProtected | System.DRM.IsProtected | Indica se o conteúdo é protegido usando o DRM (gerenciamento de direitos digitais). | VT_BOOL |
| PKEY_Keywords | System.Keywords | Palavras-chave. | VT_LPWSTR |
| PKEY_Language | System.Language | Idioma. | VT_LPWSTR |
| PKEY_Media_AuthorUrl | System.Media.AuthorUrl | URL do site do autor. | VT_LPWSTR |
| PKEY_Media_AverageLevel | System.Media.AverageLevel | Nível médio de volume de conteúdo de áudio. | VT_UI4 |
| PKEY_Media_ClassPrimaryID | System.Media.ClassPrimaryID | A representação de cadeia de caracteres de um GUID que identifica a classe primária de mídia. Para obter valores válidos, consulte a documentação do atributo WM/MediaClassPrimaryID . | VT_LPWSTR |
| PKEY_Media_ClassSecondaryID | System.Media.ClassSecondaryID | A representação de cadeia de caracteres de um GUID que identifica a classe secundária de mídia. Para obter valores válidos, consulte a documentação do atributo WM/MediaClassSecondaryID . | VT_LPWSTR |
| PKEY_Media_CollectionGroupID | System.Media.CollectionGroupID | A representação de cadeia de caracteres de um GUID que identifica o grupo de coleção. | VT_LPWSTR |
| PKEY_Media_CollectionID | System.Media.CollectionID | A representação de cadeia de caracteres de um GUID que identifica a coleção. | VT_LPWSTR |
| PKEY_Media_ContentDistributor | System.Media.ContentDistributor | Distribuidor do conteúdo. | VT_LPWSTR |
| PKEY_Media_ContentID | System.Media.ContentID | A representação de cadeia de caracteres de um GUID que identifica a coleção. | VT_LPWSTR |
| PKEY_Media_DateEncoded | System.Media.DateEncoded | Hora em que o conteúdo foi codificado. | VT_FILETIME |
| PKEY_Media_DateReleased | System.Media.DateReleased | Data de lançamento original. | VT_LPWSTR |
| PKEY_Media_Duration | System.Media.Duration | Duração, em unidades de 100 nanossegundos. Equivalente ao atributo MF_PD_DURATION no descritor de apresentação. | VT_UI8 |
| PKEY_Media_DVDID | System.Media.DVDID | DVDID (identificador de disco de vídeo digital). | VT_LPWSTR |
| PKEY_Media_EncodedBy | System.Media.EncodedBy | Nome da pessoa ou grupo que codificou o conteúdo. | VT_LPWSTR |
| PKEY_Media_EncodingSettings | System.Media.EncodingSettings | Descrição das configurações usadas para codificar o conteúdo. | VT_LPWSTR |
| PKEY_Media_MCDI | System.Media.MCDI | Identificador de CD de música. Esse valor é usado para identificar um CD. | VT_LPWSTR |
| PKEY_Media_MetadataContentProvider | System.Media.MetadataContentProvider | Nome do provedor de conteúdo de metadados. (Por exemplo, os metadados podem ser fornecidos por um serviço comercial.) | VT_LPWSTR |
| PKEY_Media_Producer | System.Media.Producer | Nome do produtor do conteúdo. | VT_LPWSTR |
| PKEY_Media_PromotionUrl | System.Media.PromotionUrl | URL de um site que oferece uma promoção relacionada ao conteúdo. | VT_LPWSTR |
| PKEY_Media_ProviderRating | System.Media.ProviderRating | Classificação do conteúdo conforme atribuído pelo provedor de conteúdo de metadados. | VT_LPWSTR |
| PKEY_Media_ProviderStyle | System.Media.ProviderStyle | Estilo ou gênero do conteúdo conforme atribuído pelo provedor de conteúdo de metadados. | VT_LPWSTR |
| PKEY_Media_Publisher | System.Media.Publisher | Editor. | VT_LPWSTR |
| PKEY_Media_SubTitle | System.Media.SubTitle | Legenda. | VT_LPWSTR |
| PKEY_Media_UniqueFileIdentifier | System.Media.UniqueFileIdentifier | Uma cadeia de caracteres genérica que pode ser para identificar o arquivo. | VT_LPWSTR |
| PKEY_Media_Writer | System.Media.Writer | Escritor. | VT_LPWSTR |
| PKEY_Media_Year | System.Media.Year | Ano em que o conteúdo foi publicado. | VT_UI4 |
| PKEY_Music_AlbumArtist | System.Music.AlbumArtist | Artista principal do álbum. Esse atributo pode ser usado para distinguir o artista principal de um álbum de um artista que colaborou em uma faixa específica. | VT_LPWSTR |
| PKEY_Music_AlbumTitle | System.Music.AlbumTitle | Título do álbum. | VT_LPWSTR |
| PKEY_Music_Artist | System.Music.Artist | Artista. | VT_LPWSTR |
| PKEY_Music_BeatsPerMinute | System.Music.BeatsPerMinute | Bate por minuto. | VT_LPWSTR |
| PKEY_Music_Composer | System.Music.Composer | Compositor. | VT_LPWSTR |
| PKEY_Music_Conductor | System.Music.Conductor | Condutor. | VT_LPWSTR |
| PKEY_Music_ContentGroupDescription | System.Music.ContentGroupDescription | Descrição do grupo de conteúdo (por exemplo, conjunto ou série em caixa). | VT_LPWSTR |
| PKEY_Music_Genre | System.Music.Genre | Gênero. | VT_LPWSTR |
| PKEY_Music_InitialKey | System.Music.InitialKey | A chave inicial da música. | VT_LPWSTR |
| PKEY_Music_IsCompilation | System.Music.IsCompilation | Indica se o arquivo de música faz parte de uma compilação. | VT_BOOL |
| PKEY_Music_Lyrics | System.Music.Lyrics | Letras. | VT_LPWSTR |
| PKEY_Music_Mood | System.Music.Mood | Humor. | VT_LPWSTR |
| PKEY_Music_PartOfSet | System.Music.PartOfSet | O número da parte e o número total de partes no conjunto ao qual o arquivo pertence, separados por uma barra. | VT_LPWSTR |
| PKEY_Music_Period | System.Music.Period | Ponto final. | VT_LPWSTR |
| PKEY_Music_TrackNumber | System.Music.TrackNumber | Rastrear número. | VT_UI4 |
| PKEY_ParentalRating | System.ParentalRating | Classificação dos pais. | VT_LPWSTR |
| PKEY_ParentalRatingReason | System.ParentalRatingReason | Motivos para a classificação dos pais atribuída. | VT_LPWSTR |
| PKEY_Rating | System.Rating | Classificação do usuário. | VT_UI4 |
| PKEY_ThumbnailStream | System.ThumbnailStream | Imagem em miniatura. | VT_STREAM |
| PKEY_Title | System.Title | Título. | VT_LPWSTR |
| PKEY_Video_Compression | System.Video.Compression | Subtipo de vídeo (MF_MT_SUBTYPE) expresso como uma cadeia de caracteres. | VT_LPWSTR |
| PKEY_Video_Director | System.Video.Director | Diretor. | VT_LPWSTR |
| PKEY_Video_EncodingBitrate | System.Video.EncodingBitrate | Taxa média de bits de vídeo, em bits por segundo. | VT_UI4 |
| PKEY_Video_FourCC | System.Video.FourCC | O FOURCC do formato de codificação de vídeo. Aplica-se somente se o subtipo de vídeo puder ser expresso como um valor FOURCC . | VT_UI4 |
| PKEY_Video_FrameHeight | System.Video.FrameHeight | Altura do quadro de vídeo. | VT_UI4 |
| PKEY_Video_FrameRate | System.Video.FrameRate | Taxa de quadros de vídeo, expressa como quadros por segundo × 1000. | VT_UI4 |
| PKEY_Video_FrameWidth | System.Video.FrameWidth | Largura do quadro de vídeo. | VT_UI4 |
| PKEY_Video_HorizontalAspectRatio | System.Video.HorizontalAspectRatio | O componente horizontal da taxa de proporção de pixel. (Equivalente ao numerador do atributo MF_MT_PIXEL_ASPECT_RATIO no tipo de mídia.) | VT_UI4 |
| PKEY_Video_IsStereo | System.Video.IsStereo | Indica se o fluxo de vídeo contém conteúdo de vídeo estéreo. | VT_BOOL |
| PKEY_Video_StreamNumber | System.Video.StreamNumber | Identificador do fluxo de vídeo. | VT_UI4 |
| PKEY_Video_TotalBitrate | System.Video.TotalBitrate | Taxa total de dados para todos os fluxos de áudio e vídeo, em bits por segundo. (Aplica-se somente a arquivos com pelo menos um fluxo de vídeo.) | VT_UI4 |
| PKEY_Video_VerticalAspectRatio | System.Video.VerticalAspectRatio | O componente vertical da taxa de proporção de pixel. (Equivalente ao denominador do atributo MF_MT_PIXEL_ASPECT_RATIO no tipo de mídia.) | VT_UI4 |
Propriedades de compartilhamento de mídia
Para tornar um arquivo de mídia compatível com o recurso de Compartilhamento de Mídia, o manipulador de propriedades deve expor as propriedades de metadados a seguir. Essas propriedades permitem que o serviço de Compartilhamento de Mídia ofereça as opções adequadas para transcodificar o conteúdo em diferentes formatos ou taxas de bits.
- MFPKEY_Content_DLNA_Profile_ID
- PKEY_Audio_ChannelCount
- PKEY_Audio_EncodingBitrate
- PKEY_Audio_Format
- PKEY_Audio_SampleRate (opcional)
- PKEY_Audio_SampleSize (opcional)
- PKEY_DRM_IsProtected (necessário para conteúdo DRM)
- PKEY_Media_Duration
- PKEY_Video_Compression
- PKEY_Video_EncodingBitrate
- PKEY_Video_FOURCC
- PKEY_Video_FrameHeight
- PKEY_Video_FrameRate (opcional)
- PKEY_Video_FrameWidth
- PKEY_Video_TotalBitrate
A propriedade PKEY_DRM_IsProtected será necessária se o conteúdo estiver protegido usando DRM. Caso contrário, essa propriedade é opcional.
As propriedades PKEY_Audio_SampleRate, PKEY_Audio_SampleSize e PKEY_Video_FrameRate são opcionais. O serviço de Compartilhamento de Mídia os exporá se estiverem disponíveis.
As propriedades no grupo PKEY_Audio_* se aplicam somente a arquivos com um fluxo de áudio, e as propriedades no grupo PKEY_Video_* se aplicam somente a arquivos com um fluxo de vídeo.
Mapeamentos do SDK de Formato de Mídia do Windows
A fonte de mídia ASF mapeia as chaves de propriedade a seguir para atributos de cabeçalho ASF. Em alguns casos, os tipos de dados diferem entre a propriedade Shell e o atributo Format SDK.
| PROPERTYKEY | Formatar atributo do SDK |
|---|---|
| PKEY_Audio_IsVariableBitRate | IsVBR |
| PKEY_Audio_PeakValue | PeakValue |
| PKEY_Author | Autor |
| PKEY_Comment | Descrição |
| PKEY_Copyright | Direitos autorais |
| PKEY_DRM_IsProtected | Is_Protected |
| PKEY_Keywords | WM/Categoria |
| PKEY_Language | WM/Idioma |
| 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/Provedor |
| PKEY_Media_Producer | WM/Produtor |
| 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/Gravador |
| PKEY_Media_Year | WM/Ano |
| PKEY_Music_AlbumArtist | WM/AlbumArtist |
| PKEY_Music_AlbumTitle | WM/AlbumTitle |
| PKEY_Music_Artist | Autor |
| PKEY_Music_BeatsPerMinute | WM/BeatsPerMinute |
| PKEY_Music_Composer | WM/Composer |
| PKEY_Music_Conductor | WM/Condutor |
| PKEY_Music_ContentGroupDescription | WM/ContentGroupDescription |
| PKEY_Music_Genre | WM/Gênero |
| PKEY_Music_InitialKey | WM/InitialKey |
| PKEY_Music_IsCompilation | WM/IsCompilation |
| PKEY_Music_Lyrics | WM/Letras |
| PKEY_Music_Mood | WM/Mood |
| PKEY_Music_PartOfSet | WM/PartOfSet |
| PKEY_Music_Period | WM/Período |
| PKEY_Music_TrackNumber | WM/TrackNumber |
| PKEY_ParentalRating | WM/ParentalRating |
| PKEY_ParentalRatingReason | WM/ParentalRatingReason |
| PKEY_Rating | WM/SharedUserRating |
| PKEY_ThumbnailStream | WM/Imagem |
| PKEY_Title | Título |
| PKEY_Video_Director | WM/Director |
Tópicos relacionados