Exportar (0) Imprimir
Expandir Tudo

Ativo

Atualizado: fevereiro de 2015

A entidade Asset contém arquivos digitais (incluindo vídeo, áudio, imagens, coleções de miniaturas, faixas de texto e arquivos de legenda codificada) e os metadados para esses arquivos. Quando os arquivos digitais são carregados em um ativo, podem ser usados na codificação e streaming de fluxos de trabalho do Media Services.

Quando você codifica um ativo, é produzido um ativo de saída ao finalizar o trabalho de codificação. Entre os arquivos mencionados acima, o ativo de saída contém arquivos de metadados XML que descrevem o ativo de entrada e de saída. Para obter mais informações, consulte os tópicos Metadados de entrada e Metadados de saída.

As seguintes características se aplicam a um ativo no Serviços de Mídia:
Um ativo é uma unidade lógica que representa uma apresentação audiovisual única.

Um ativo contém uma coleção de um a vários arquivos de mídia.

Os arquivos de um ativo estão localizados em um único contêiner de armazenamento blob.

Alguns exemplos de ativos são: um filme completo, programa de TV, edição específica, um clipe de um filme, programa de TV, animação, arquivo ISO de câmera ou um evento; um trailer de filme ou vídeo promocional; um anúncio; um arquivo de áudio, programa de rádio, podcast ou arquivo de som.

As seguintes características NÃO se aplicam a um ativo no Serviços de Mídia:
Um simples contêiner de armazenamento

Uma pasta para organizar e armazenar múltiplas versões da mesma apresentação

Uma pasta para enviar um processamento em massa de várias apresentações audiovisuais para o Azure Media Encoder

Por exemplo, você não deve armazenar um filme, o seu trailer, um anúncio e uma versão de edição internacional do mesmo filme em um único ativo.

Este tópico oferece uma visão geral da entidade Asset e também demonstra como executar várias operações com a API REST dos Serviços de Mídia.

ImportantImportante
Ao trabalhar com a API REST dos Serviços de Mídia, aplicam-se as seguintes considerações:

  • Ao acessar entidades nos Serviços de Mídia, você deve configurar valores e campos de cabeçalho específicos nas suas solicitações HTTP. Para obter mais informações, consulte Setup for Media Services REST API Development.

  • Depois de se conectar com êxito em https://media.windows.net, você receberá um redirecionamento 301 que especifica outro URI dos Serviços de Mídia. Você deve fazer chamadas subsequentes para o novo URI.

    Para obter mais informações, consulte Connecting to Media Services with the Media Services REST API.

 

Propriedade Tipo Descrição

Id

Somente leitura. Configurada pelos Serviços de Mídia no momento da criação.

Cadeia de caracteres

Identificador exclusivo.

State

Somente leitura. Configurada pelos Serviços de Mídia.

Edm.Int32

Um valor de enumeração que descreve o estado do ativo. Os valores do valor são:

  • Inicializado = 0

  • Publicado = 1

    WarningAviso
    A ação Publish foi substituída. Remova o código que verifica se o ativo está no estado Published.

  • Excluído = 2

Um ativo está sempre no estado Inicializado até que seja excluído.

Created

Somente leitura. Configurada pelos Serviços de Mídia no momento da criação.

Edm.DateTime

Esse valor é configurado pelos Serviços de Mídia no momento da criação.

LastModified

Somente leitura. Configurada pelos Serviços de Mídia.

Edm.DateTime

Esse valor é atualizado pelos Serviços de Mídia após alterações na propriedade.

AlternateId

Opcional.

Edm.String

Um valor de ID alternativo que corresponde a uma ID em outro sistema de gerenciamento de conteúdo. O comprimento máximo é 4000.

Name

Opcional.

Edm.String

Nome amigável para o ativo. O comprimento máximo é 4000.

Options

Obrigatória. Não pode ser atualizada após a criação da entidade.

Edm.Int32

Um valor de enumeração que descreve as opções de criptografia com as quais um ativo pode ser criado. Um valor da lista abaixo é um valor válido, uma combinação de valores dessa lista, não:

  • Nenhum = 0: Não especifica opções de criação de ativo.

  • StorageEncrypted = 1: Especifica que os arquivos de um ativo devem ser criptografados para carregamento e armazenamento ao criar o ativo.

  • CommonEncryptionProtected = 2: Especifica que os arquivos de um ativo são protegidos usando um método de criptografia comum (como o PlayReady).

  • EnvelopeEncryptionProtected = 4

Uri

Somente leitura. Configurada pelos Serviços de Mídia.

Edm.String

O URI do contêiner de armazenamento de blob do ativo especificado.

Locators

Somente leitura. Configurada pelos Serviços de Mídia.

Conjunto de entidades do localizador

O conjunto de entidades retornado contém todas as entidades do localizador que estão vinculadas ao ativo especificado.

ContentKeys

Opcional.

Conjunto de entidades de ContentKey

O conjunto de entidades retornado contém todas as entidades de ContentKey que estão vinculadas ao ativo especificado.

Files

Somente leitura. Configurada pelos Serviços de Mídia.

Conjunto de entidades de arquivo

O conjunto de entidades retornado contém todas as entidades de arquivo que estão vinculadas ao ativo especificado.

ParentAssets

Opcional.

Conjunto de entidades dos ativos pais

O conjunto de entidade retornado contém todas as entidades de ativo pai que estão conectadas ao ativo especificado.

StorageAccountName

Opcional. Não pode ser atualizada após a criação da entidade.

Edm.String

Nome da conta de armazenamento que contém o contêiner de blob do ativo.

Se não especificado no momento da criação, o Serviços de Mídia define o nome de conta de armazenamento padrão.

StorageAccount

Somente leitura. Configurada pelos Serviços de Mídia.

Conjunto de entidades de StorageAccount

O conjunto de entidade retornado contém todas as entidades StorageAccount que estão conectadas ao ativo especificado.

DeliveryPolicies

Conjunto de entidades de AssetDeliveryPolicy

O conjunto de entidades retornado contém políticas de entrega associadas ao ativo.

Os ativos podem ser criados usando uma solicitação HTTP POST e especificando os valores da propriedade.

 

Método URI de solicitação Versão de HTTP

POST

https://media.windows.net/API/Assets

HTTP/1.1

ImportantImportante
Depois de se conectar com êxito em https://media.windows.net, você receberá um redirecionamento 301 que especifica outro URI dos Serviços de Mídia. Você deve fazer chamadas subsequentes para o novo URI.

POST https://media.windows.net/API/Assets HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 27
Expect: 100-continue

{ "Name" : "NewJSONAsset" }

Os ativos podem ser recuperados usando uma solicitação HTTP GET.

 

Método URI de solicitação Versão de HTTP

GET

https://media.windows.net/API/Assets

HTTP/1.1

 

Método URI de solicitação Versão de HTTP

GET

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

ImportantImportante
Depois de se conectar com êxito em https://media.windows.net, você receberá um redirecionamento 301 que especifica outro URI dos Serviços de Mídia. Você deve fazer chamadas subsequentes para o novo URI.

GET https://media.windows.net/API/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0


Os ativos pode ser atualizados usando uma solicitação HTTP MERGE e as propriedades específicas que você deseja alterar.

 

Método URI de solicitação Versão de HTTP

MERGE

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

ImportantImportante
Depois de se conectar com êxito em https://media.windows.net, você receberá um redirecionamento 301 que especifica outro URI dos Serviços de Mídia. Você deve fazer chamadas subsequentes para o novo URI.

MERGE https://media.windows.net/API/Assets('nb:cid:UUID:80782407-3f87-4e60-a43e-5e4454232f60') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337083279&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=DMLQXWah4jO0icpfwyws5k%2b1aCDfz9KDGIGao20xk6g%3d
Host: media.windows.net
Content-Length: 21
Expect: 100-continue

{"Name" : "NewName" }

Os ativos podem ser excluídos referenciando o valor da ID do ativo. Quando um ativo é excluído, todos os seus localizadores são excluídos pelo Serviços de Mídia do Microsoft Azure. Se o ativo tiver localizadores de origem, esses serão revogados e excluídos também. Todos os links para ContentKeys serão excluídos e quaisquer ContentKeys não vinculados a outros ativos serão excluídos.

 

Método URI de solicitação Versão de HTTP

DELETE

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

ImportantImportante
Depois de se conectar com êxito em https://media.windows.net, você receberá um redirecionamento 301 que especifica outro URI dos Serviços de Mídia. Você deve fazer chamadas subsequentes para o novo URI.

DELETE https://media.windows.net/API/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0


noteObservação
A ação Publish foi substituída. A partir da versão mais recente do Serviços de Mídia, Publish não deve ser usado.

Se o seu código usa Publish, esteja atento às seguintes considerações:

  1. A ação Publish não exclui localizadores associados ao ativo. Você deve excluir explicitamente os localizadores do código depois de chamar Publish.

  2. A ação Publish não define o estado do ativo como Published. Remova o código que verifica se o ativo está no estado Published. Atualmente, um ativo pode ter apenas o estado Initialized ou Deleted.

Você pode vincular um ContentKey a um ativo referenciando a ID do ativo com uma solicitação HTTP POST. O URI do ContentKey deve estar incluído no corpo da solicitação. Só é possível vincular um tipo de ContentKey que corresponda ao tipo especificado em CreationOptions do ativo. Por exemplo, se um ativo tiver as opções definidas como StorageEncrypted(1), o ContentKey deverá ser do tipo StorageEncryption(1).

 

Método URI de solicitação Versão de HTTP

POST

https://media.windows.net/API/Assets(‘Asset Id')/$links/ContentKeys

HTTP/1.1

ImportantImportante
Depois de se conectar com êxito em https://media.windows.net, você receberá um redirecionamento 301 que especifica outro URI dos Serviços de Mídia. Você deve fazer chamadas subsequentes para o novo URI.

POST https://media.windows.net/API/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=vodbvttest01&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&Audience=urn%3aNimbus&ExpiresOn=1352143039&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=sx%2bpdQNrEi8FoEVnwnIK1sXe3GWxXELEFbwKNMQ7BNM%3d
Host: media.windows.net
Content-Length: 121
Expect: 100-continue

{ "uri": "https://media.windows.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}

É possível remover links ContentKey de um ativo referenciando a ID do ativo e a ID do ContentKey em uma solicitação HTTP DELETE. Se o ContentKey não estiver vinculado a nenhum outro ativo, ele será excluído.

 

Método URI de solicitação Versão de HTTP

DELETE

https://media.windows.net/API/Assets(‘Asset Id')/$links/ContentKeys('ContentKey Id')

HTTP/1.1

ImportantImportante
Depois de se conectar com êxito em https://media.windows.net, você receberá um redirecionamento 301 que especifica outro URI dos Serviços de Mídia. Você deve fazer chamadas subsequentes para o novo URI.

DELETE https://media.windows.net/API/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys('nb:kid:UUID:5db89211-c9d9-404b-a6bc-3e6b91c7a214') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=vodbvttest01&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&Audience=urn%3aNimbus&ExpiresOn=1352143039&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=sx%2bpdQNrEi8FoEVnwnIK1sXe3GWxXELEFbwKNMQ7BNM%3d
Host: media.windows.net
Content-Length: 0

Consulte também

A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2015 Microsoft