Partilhar via

AssetFile

  • Artigo

A AssetFile entidade representa um ficheiro de áudio ou vídeo real armazenado num contentor de blobs. Um ficheiro de recurso está sempre associado a um recurso e um recurso pode conter um ou muitos ficheiros. A tarefa Codificador dos Serviços de Multimédia falha se um objeto de ficheiro de recurso não estiver associado a um ficheiro digital num contentor de blobs.

Este tópico fornece uma descrição geral da AssetFile entidade e também demonstra como executar várias operações com a API REST dos Serviços de Multimédia.

Importante

Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).

Propriedades da Entidade AssetFile

Propriedade Tipo Description
Id

Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.		 Edm.String Identificador exclusivo.
Name

Obrigatório.		 Edm.String Nome amigável do AssetFile. O valor predefinido é o nome de ficheiro que utilizou durante o carregamento do ficheiro. O comprimento máximo é 260. Nota: Os Serviços de Multimédia utilizam o valor da Name propriedade ao criar URLs para o conteúdo de transmissão em fluxo (por exemplo, http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters.) Por este motivo, a codificação por percentagem não é permitida. O valor da propriedade Nome não pode ter nenhum dos seguintes carateres reservados por percentagem de codificação: !*'();:@&=+$,/?%#[]". Além disso, só pode haver um ".". para a extensão de nome de ficheiro.
ContentFileSize

Opcional.		 Edm.Int64 AssetFile tamanho (em bytes) do conteúdo.
ParentAssetId

Obrigatório. Não é possível atualizar após a criação da entidade.		 Edm.String ID do Recurso ao qual este ficheiro está associado.
EncryptionVersion

Opcional.		 Edm.String A versão suportada atual para StorageEncryption e CommonEncryption é "1.0"
EncryptionScheme

Opcional.		 Edm.String O esquema de encriptação utilizado para este ficheiro. Os valores válidos são: "StorageEncryption" ou "CommonEncryption".
IsEncrypted

Opcional.		 Edm.Boolean Este valor deve ser definido como true se este ficheiro estivesse armazenado encriptado.
EncryptionKeyId

Opcional.		 Edm.String ID de Chave de Conteúdo Encriptado.
InitializationVector

Opcional.		 Edm.String O vetor de inicialização utilizado para encriptação de armazenamento.
IsPrimary

Opcional.		 Edm.Boolean Determina se este ficheiro é o ficheiro principal num Recurso de múltiplos ficheiros.
LastModified

Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.		 Edm.DateTime Este valor é atualizado pelos Serviços de Multimédia depois de serem efetuadas alterações de propriedade. Representa o número de milissegundos desde a meia-noite de 1 de janeiro de 1970.
Created

Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.		 Edm.DateTime Representa o número de milissegundos desde a meia-noite de 1 de janeiro de 1970.
MimeType

Opcional.		 Edm.String Os Serviços de Multimédia não inspecionam nenhum blob que carregou, pelo que tem de definir manualmente o tipo de mime. Por exemplo, "text/plain" ou "video/x-ms-wmv" são valores válidos a utilizar. O comprimento máximo é 4000.
ContentChecksum

Opcional.		 Edm.String Um número hexadecimal que representa um valor de resumo de mensagens MD5 (RFC 1321). Este valor é definido pela biblioteca de cliente ou cliente para servir como uma validação do carregamento bem-sucedido do conteúdo. O comprimento máximo é 4000.

Criar um AssetFile

A função CreateFileInfos é utilizada para criar uma nova entidade AssetFile. Para obter mais informações, veja Funções da API REST.

Listar AssetFiles

Os AssetFiles são obtidos com um pedido GET HTTP.

Método URI do pedido Versão HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files> HTTP/1.1
Método URI do pedido Versão HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1
Método URI do pedido Versão HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Files HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

GET https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:d0214595-fff0-164e-9c67-d576eba09605') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net

Atualizar um AssetFile

Os AssetFiles são atualizados com o pedido HTTP MERGE.

Método URI do pedido Versão HTTP
INTERCALAR <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

MERGE https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:2710e174-3165-a34c-96ad-618714b0d504') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Content-Length: 27  
Expect: 100-continue  
  
{"MimeType" : "video/mp4" }

Eliminar um AssetFile

Os AssetFiles são eliminados quando o recurso associado foi eliminado. Por exemplo, veja Eliminar um Recurso.

Consulte também

ContentKey
Recurso
AccessPolicy
Tarefa
JobTemplate
Localizador
MediaProcessor
Tarefa
TaskTemplate
Quotas e Limitações