Observação: esta documentação se aplica somente ao uso da entrega de arquivos em massa.
Para analisar os requisitos de ativos de arte, consulte Requisitos de arte. Para entregar com sucesso os ativos de arte ao Prime Video, os arquivos de arte (.jpg, .png) devem ser enviados para o Aspera ou S3, e as referências devem ser incluídas no Media Entertainment Core (MEC) ou no Media Manifest Core (MMC).
Referências de propósito
As referências de propósito são usadas no MEC e no MMC para identificar o tipo de imagem que está sendo entregue. A finalidade da imagem é suportada de forma diferente de acordo com o tipo de nível do título (como episódio, filme ou temporada). Consulte a tabela a seguir para obter orientações de uso da finalidade.
Arte da capa |
16:9 |
Filmes e temporadas |
capa |
Arte da caixa |
4:3 |
Temporadas |
boxart |
Arte da caixa |
3:4 |
Filmes |
boxart |
Arte do pôster |
2:3 |
Filmes e temporadas |
cartaz |
Arte do herói (plano de fundo) |
16:9 |
Filmes e temporadas |
herói |
Arte do título |
Flexível |
Filmes e temporadas |
título |
Arte episódica |
16:9 |
Episódios |
capa |
Trailer e arte bônus |
16:9 |
Trailers e bônus |
capa |
Requisito global de arte (sem região)
Esse é o requisito de entrega padrão. A entrega global de obras de arte inclui o idioma local, mas não inclui a região. Com obras de arte globais, os clientes podem ter uma experiência personalizada orientada por sua preferência de idioma de interface do usuário. Por exemplo, um cliente morando no Canadá com o espanhol definido como idioma da interface do usuário veria uma arte em espanhol, porque ela foi entregue em espanhol no idioma local e sem um valor de região.
Exceção de arte específica da região
Essa é uma exceção de entrega destinada apenas a casos de uso específicos. A entrega de obras de arte específicas da região inclui o idioma, o local e a região. Embora a entrega específica por região seja suportada, também exigimos pelo menos uma entrega global de arte por tipo de imagem (arte da caixa, arte da capa e arte do pôster) para temporadas e filmes. Os casos de uso aceitos são:
- Versões de conformidade, como omitir cigarros na Índia.
- Marca original específica da região (quando permitida).
Todos os outros casos de uso, incluindo, mas não se limitando a textos estranhos específicos da região, apelos à ação ou textos explicativos de marketing, não são aceitos.
Comportamento de idioma, localidade e região
- Idioma local: esse campo é obrigatório para todas as referências de obras de arte. Ele identifica o idioma da obra de arte que está sendo entregue. Por exemplo, a obra de arte entregue com pt-BR significa que a obra de arte foi localizada no idioma português brasileiro.
- Região: esse campo é opcional e identifica um território específico no qual a obra de arte específica da região será exibida em vez da obra de arte global. Se o campo Região for fornecido, ele bloqueará a arte global nessa região. Se nenhum campo de região for fornecido, a arte estará qualificada para ser usada na vitrine de todo o mundo.
Requisitos de idioma da direita para a esquerda
Como o árabe e o hebraico são lidos da direita para a esquerda, os clientes com o idioma da interface do usuário definido como árabe ou hebraico verão a sobreposição de metadados/texto no lado direito da página de exibição em vez do esquerdo. Se você estiver entregando ilustrações de heróis da direita para a esquerda (RTL) em hebraico ou árabe, use He-il e ar-AE como o código padrão para todas as entregas em árabe, pois o código do idioma ar-001 está obsoleto. Embora ar-AE seja o código preferido para o árabe, os códigos alternativos de idioma e localidade mostrados na tabela a seguir também são aceitos. Todos os outros códigos de idioma serão considerados da esquerda para a direita (LTR).
hebraico |
He-il |
árabe |
Ar-dz |
AR-EG |
|
Ar-ma |
|
Ar-ae (preferencial) |
|
AR-kW |
|
Ar-sy |
|
AR-LB |
|
Ar-TN |
|
Ar-ly |
|
Ar-sim |
|
Ar-QA |
|
AR-iQ |
|
Ar-sa |
|
ar-BH |
|
Ar-jo |
|
Ar-om |
|
Ar-TD |
|
Ar-DJ |
|
Ar-kz |
|
Ar-MR |
|
AR-PS |
|
Ar-SS |
|
Ar-er |
|
Ar-então |
|
Ar-il |
|
Ar-eh |
|
Ar-SD |
|
AR-km |
Referências do MMC
O MMC é o método preferido para enviar referências de obras de arte. É mais simples referenciar obras de arte localizadas no MMC e, diferentemente do MEC, ele não depende dos metadados do título. O MMC pode ser usado para ingerir o idioma original e arquivos de arte localizados se você fornecer valores de finalidade, idioma e região.
A tabela a seguir lista os campos relevantes para a arte no manifesto de ativos do MMC.
Campo |
Definição e notas |
Valores aceitos |
Uso |
Inventário |
Identifica todos os ativos individuais que estão sendo entregues como parte do pacote (como arquivos de mezanino, texto cronometrado, áudio etc.) junto com metadados específicos do ativo. |
Obrigatório |
|
Imagem |
Manifesto: imagem |
||
@ImageID |
ID usado para referenciar a imagem em todo o MMC. |
Necessário para entrega de imagens |
|
Propósito |
Identifica o tipo de arte que está sendo entregue e determina o posicionamento. |
boxart, capa, herói, cartaz, título |
Obrigatório |
Idioma |
Identifica o idioma da obra de arte que está sendo entregue. |
Obrigatório |
|
Largura |
Largura, em pixels, da imagem que está sendo entregue. |
Cadeia de caracteres (por exemplo, 1920) |
Opcional |
Altura |
Altura, em pixels, da imagem que está sendo entregue. |
Cadeia de caracteres (por exemplo, 1080) |
Opcional |
Intenção do ativo |
Identifica obras de arte específicas de uma região e que não devem ser exibidas em outros lugares, como versões de conformidade. Se não for incluída, a arte será considerada elegível para exibição em todas as regiões. |
Opcional |
|
Tipo |
Identifica obras de arte específicas de uma região e que não devem ser exibidas em outros lugares, como versões de conformidade. Se não for incluída, a arte será considerada elegível para exibição em todas as regiões. |
Região |
Opcional |
Subtipo |
Identifica obras de arte específicas de uma região e que não devem ser exibidas em outros lugares, como versões de conformidade. Se não for incluída, a arte será considerada elegível para exibição em todas as regiões. |
Códigos de país |
|
Grupos de imagens |
Uma lista de grupos de imagens. Seleção de imagens associadas a um título ou série. |
Obrigatório |
|
Grupo de imagens |
Um único grupo de imagens. Seleção de imagens associadas a um título ou série. |
||
@PictureGroupID |
O ID do grupo de imagens que se refere ao ID do conteúdo principal (filme, episódio ou série). md:picturegroupid: [scheme]: [SSID]. |
Necessário para entrega de imagens |
|
Foto |
Descreve uma imagem individual, incluindo como ela se relaciona com outras imagens quando sequenciada em uma Galeria. |
Obrigatório |
|
ID da imagem |
Exigido pelo XSD. Não usado pelo Prime Video. |
O valor é ignorado; pode estar em branco |
Não usado, mas obrigatório |
ID da imagem |
ID usado para referenciar a imagem em todo o MMC. |
Necessário para entrega de imagens |
|
Experiências |
A seção Experiência do MMC agrupa apresentações e/ou sequências reproduzíveis junto com grupos de imagens para definir a experiência do cliente. |
Obrigatório |
|
Experiência |
O elemento Experiência que define quais títulos e galerias se aplicam. |
||
@ExperienceID |
ID usada para referenciar a Experiência em todo o MMC. |
Obrigatório |
|
ID do conteúdo |
Não usado pelo Prime Video. A correspondência é baseada no UniqueID. |
Não usado |
|
Grupo de imagem ID |
Referências a PictureGroups. |
||
Mapas de experiência da Alid |
Relaciona os ALIDs às experiências associadas a esse conteúdo. |
Obrigatório |
|
Mapa da experiência de Alid |
As experiências podem ser localizadas, portanto, um único ALID só pode ser mapeado para uma experiência. |
Obrigatório |
|
ALID |
Um Logical Asset ID (ALID) usado para identificar um conjunto de conteúdo (como um Logical Asset) associado aos avails em um envio do EMA Avails. |
Obrigatório |
|
ID da experiência |
Obrigatório |
||
Apresentações |
É necessária uma instância de apresentação para cada conjunto de faixas conformadas. Não é necessário apenas para entrega parcial do MMC, incluindo referências de obras de arte. |
Exigido pela AudioVisual |
Para obter uma lista completa de todos os campos compatíveis com o MMC, consulte o manifesto de ativos do MMC.
Entrega parcial de imagens do MMC
Os arquivos de arte podem ser referenciados independentemente de outros ativos ou como parte do pacote completo de ativos MMC.
- Os MMCs parciais devem conter apenas objetos de inventário para ativos incluídos no pacote atualizado. Você não precisa declarar o inventário de ativos que foram entregues anteriormente ao Prime Video.
- Declare apresentações somente quando elas contiverem ativos presentes no inventário do MMC e no pacote.
Ao fazer referência apenas a ativos de arte, você deve excluir apresentações do MMC.
- O ALID é o único ID que deve corresponder entre um pacote inicial e um pacote atualizado que contém novos ativos.
Veja a seguir um exemplo de um MMC parcial para um título de filme que faz referência somente a ativos de arte:
<? versão xml ="1.0" encoding="UTF-8"? > |
<manifest:MediaManifest xmlns:manifest="http://www.movielabs.com/schema/manifest/v1.5/manifest” xmlns:md="http://www.movielabs.com/schema/md/v2.4/md” xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance” xsi:schemaLocation="http://www.movielabs.com/schema/manifest/v1.5/manifest manifest-v1.5.xsd"> |
<manifest:Compatibility> |
<manifest:SpecVersion>1.5</manifest:SpecVersion> |
<manifest:Profile>MMC-1</manifest:Profile> |
</manifest:Compatibility> |
<manifest:Inventory> |
<! -- Arte de capa de filme em inglês sem região a ser exibida globalmente --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:cover.art.en"> |
<md:Purpose>capa</md:Purpose> |
<md:Width>1920</md:Width> |
<md:Height>1080</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>pt-BR</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>cover_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<! -- Arte de caixa de cinema em inglês sem região a ser exibida globalmente -> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:box.art.en"> |
<md:Purpose>arte de boxe</md:Purpose> |
<md:Width>1200</md:Width> |
<md:Height>1600</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>pt-BR</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>box_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<! -- Arte de herói cinematográfico em inglês sem região a ser exibida globalmente --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:hero.art.en"> |
<md:Purpose>herói</md:Purpose> |
<md:Width>1920</md:Width> |
<md:Height>1080</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>pt-BR</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>hero_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<! -- Arte de título de filme em inglês sem região a ser exibida globalmente --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:title.art.en"> |
<md:Purpose>título</md:Purpose> |
<md:Width>3450</md:Width> |
<md:Height>560</md:Height> |
<md:Encoding>png</md:Encoding> |
<md:Language>pt-BR</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>title_art.png</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<! -- Arte de caixa de cinema em inglês com região, a ser exibida somente nos EUA e na Califórnia --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:box.art.en"> |
<md:Purpose>arte de boxe</md:Purpose> |
<md:Width>1200</md:Width> |
<md:Height>1600</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>pt-BR</md:Language> |
<md:AssetIntent> |
<md:Type>Região</md:Type> |
<md:SubType>EUA</md:SubType> |
</md:AssetIntent> |
<md:AssetIntent> |
<md:Type>Região</md:Type> |
<md:SubType>CA</md:SubType> |
</md:AssetIntent> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>box_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
</manifest:Inventory> |
<manifest:PictureGroups> |
<manifest:PictureGroup PictureGroupID="md:picturegroup:org:partneralias:title_SKU:picturegroup"> |
<manifest:Picture> |
<! -- O PictureID é exigido pelo XSD, mas não é necessário pela Amazon --> |
<manifest:PictureID> |
<manifest:ImageID>md: ID da imagem: org: partner Alias:title_sku:cover.art.en</manifest:ImageID> |
<manifest:ImageID>md: ID da imagem: org: partner Alias:title_sku:box.art.en</manifest:ImageID> |
<manifest:ImageID>MD: ID da imagem: org: partner Alias:title_sku:hero.art.en</manifest:ImageID> |
<manifest:ImageID>md: ID da imagem: org: partner Alias:title_sku:title.art.en</manifest:ImageID> |
<manifest:ImageID>MD: ID da imagem: org: partner Alias:title_sku:box.art.en.ca.us</manifest:ImageID> |
</manifest:Picture> |
</manifest:PictureGroup> |
</manifest:PictureGroups> |
<! -- Experiência raiz --> |
<manifest:Experiences> |
<manifest:Experience ExperienceID="md:picturegroup:org:partneralias:title_SKU:picturegroup:experience” version="1.0"> |
<manifest:ContentID>md:cid:org:partnerAlias:title_sku</manifest:ContentID> |
<manifest:PictureGroupID>md:picturegup:org:partnerAlias:title_sku:picturegroup</manifest:PictureGroupID> |
</manifest:Experience> |
</manifest:Experiences> |
<manifest:ALIDExperienceMaps> |
<manifest:ALIDExperienceMap> |
<manifest:ALID>md:alid:org:partnerAlias:title_sku</manifest:ALID> |
<manifest:ExperienceID>md:picturegup:org:partnerAlias:title_sku:picturegroup:experience</manifest:ExperienceID> |
</manifest:ALIDExperienceMap> |
</manifest:ALIDExperienceMaps> |
</manifest:MediaManifest> |
Referências do MEC
Embora o MEC seja usado principalmente para fornecer metadados de títulos (sinopse, atores, classificações e assim por diante), ele também pode ser usado para comunicar referências de obras de arte.
Quando você utiliza o MEC para entrega de obras de arte, um campo ArtReference na seção LocalizedInfo deve estar presente. Isso permite que você faça referência a várias peças de arte para um único título e comunique elementos de metadados sobre a obra de arte, como resolução, propósito e idioma.
O idioma, o nome do arquivo e a finalidade devem ser incluídos em cada seção LocalizedInfo. A localidade do idioma da sua arte deve estar alinhada aos metadados do título localizados fornecidos em uma determinada seção LocalizedInfo.
Quando você envia um MEC completo que contém metadados do título e referências da obra de arte, as referências da obra de arte serão marcadas com o idioma inserido para o bloco LocalizedInfo correspondente. Certifique-se de que a arte que está sendo entregue corresponda ao idioma enviado. Se você precisar enviar uma ilustração em um idioma que não corresponda ao idioma de metadados principal fornecido, insira um segundo bloco LocalizedInfo e inclua os campos de metadados obrigatórios (TitleDisplayUnlimited e Summary400) com as referências correspondentes da arte artReference. Para ver um exemplo desse caso de uso, consulte os arquivos de amostra .xml na seção de exemplos do MMC e do MEC, mais adiante neste tópico.
A tabela a seguir lista os campos relevantes para a arte nos metadados de títulos do MEC.
Informações localizadas |
Inclui elementos que podem ser localizados. |
Obrigatório |
|
@Language |
Identifica o idioma da obra de arte que está sendo entregue. |
Obrigatório |
|
@Region |
Identifica obras de arte específicas de uma região e que não devem ser exibidas em outros lugares, como versões de conformidade. Se não for incluída, a arte será considerada elegível para exibição em todas as regiões. |
Códigos de país |
Opcional |
Referência de arte |
É necessária pelo menos uma ArtReference por título ao fazer referência à obra de arte. |
Obrigatório |
|
@Resolution |
Resolução da obra de arte que está sendo entregue. |
Cadeia de caracteres no formato ColxRow |
Opcional |
@Purpose |
Identifica o tipo de arte que está sendo entregue e determina o posicionamento. |
boxart, capa, herói, cartaz, título |
Obrigatório |
Entrega parcial de imagens MEC
O MEC pode ser usado para fornecer ilustrações independentes dos metadados do título, com um md:Profile adicional que relaxa as validações de análise.
Veja a seguir um exemplo de um MEC parcial para um título de filme que faz referência somente a ativos de arte.
<? versão xml ="1.0" encoding="UTF-8"? > |
<mdmec:CoreMetadata xmlns:mdmec=” http://www.movielabs.com/schema/mdmec/v2.9 “xmlns:md=” http://www.movielabs.com/schema/md/v2.9/md “xmlns:xsi=” http://www.w3.org/2001/XMLSchema-instance “xsi:schemaLocation=” http://www.movielabs.com/schema/mdmec/v2.9.. /mdmec-v2.9.xsd “> |
<mdmec:Compatibility> |
<md:SpecVersion>2.9</md:SpecVersion> |
<! -- O perfil CM-IMAGE-1 indica que esse arquivo está em conformidade com o perfil somente de imagem. A Amazon não analisará nenhum metadado do título do arquivo quando esse perfil for fornecido --> |
<md:Profile>CM-IMAGE-1</md:Profile> |
</mdmec:Compatibility> |
<mdmec:Basic ContentID="md:cid:org:partneralias:titlesku"> |
<! -- Obra de arte em inglês com região, a ser exibida somente nos EUA -> |
<md:LocalizedInfo language="en-US"> |
<md:ArtReference purpose="boxart">box_art_US.jpg</md:ArtReference> |
<md:ArtReference purpose="cover">cover_art_US.jpg</md:ArtReference> |
<md:ArtReference purpose="hero">hero_art_US.jpg</md:ArtReference> |
<md:ArtReference purpose="poster">poster_art_US.jpg</md:ArtReference> |
<md:Region> |
<md:country>EUA</md:country> |
</md:Region> |
</md:LocalizedInfo> |
<! -- Obra de arte inglesa sem região destinada a ser usada global--> |
<md:LocalizedInfo language="en-US"> |
<md:ArtReference purpose="boxart">box_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="cover">cover_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="hero">hero_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="poster">poster_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="title">title_art_en_global.png</md:ArtReference> |
</md:LocalizedInfo> |
<! -- Obra de arte sem região em português do Brasil destinada a ser usada global--> |
<md:LocalizedInfo language="pt-BR"> |
<md:ArtReference purpose="boxart">box_art_pt_br.jpg</md:ArtReference> |
<md:ArtReference purpose="cover">cover_art_pt_br.jpg</md:ArtReference> |
<md:ArtReference purpose="poster">poster_art_pt_br.jpg</md:ArtReference> |
<md:ArtReference purpose="title">title_art_pt_br_global.png</md:ArtReference> |
</md:LocalizedInfo> |
<! -- A especificação MEC exige ReleaseYear e WorkType. Ao entregar com o CM-IMAGE-1, a Amazon ignorará esses valores. --> |
<md:ReleaseYear>2018</md:ReleaseYear> |
<md:WorkType>filme</md:WorkType> |
<md:AltIdentifier> |
<md:Namespace>ORGANIZAÇÃO</md:Namespace> |
<md:Identifier>titlesku</md:Identifier> |
</md:AltIdentifier> |
<md:AssociatedOrg organizationID="partneralias” role="licensor” /> |
</mdmec:Basic> |
Entregas de obras de arte clássicas via MMC
Agora, o Prime Video pode oferecer suporte à entrega e/ou substituição de ilustrações de títulos que foram entregues anteriormente aos Classic Marketplaces (EUA, DE, JP e GB), aproveitando a especificação atual do MMC, conforme explicado nas referências do MMC acima. Observe que as referências de arte do MEC não são suportadas para esse caso de uso específico (Títulos Clássicos).
Tipos de arte compatíveis (todos)
Objetivo no MMC |
Tipo |
Filmes |
Nível de Séries |
Nível da Temporada |
Nível do episódio |
Trailer e bônus |
arte de boxe |
Arte da caixa |
X |
X |
|||
capa |
Arte da capa |
X |
X |
|||
cartaz |
Arte do pôster |
X |
X |
|||
herói |
Arte de herói |
X |
X |
|||
título |
Arte do título |
X |
X |
|||
capa |
Arte episódica |
X |
||||
capa |
Trailer e arte bônus |
X |
Especificações de entrega
Certifique-se de usar o mesmo alias de parceiro e SKU usados quando o livro clássico foi criado inicialmente. As especificações são idênticas às especificações globais da MMC; todos os tipos de arte, idiomas, localidades e regiões são suportados.
Perguntas frequentes sobre entrega de obras de arte clássicas
Erros do esquema MEC
Mensagem de erro |
Causa |
Mais de uma instância de LocalizedInfo é fornecida para o mesmo idioma. |
Existem blocos LocalizedInfo duplicados (por tipo e região). |
Se fornecer valores de região, um elemento LocalizedInfo para esse idioma deve ser aplicado a todos os territórios (sem substituição de região). |
Não há bloqueio sem região. |