Sdílet prostřednictvím

AssetFile

  • Článek

Entita AssetFile představuje skutečný videosoubor nebo zvukový soubor, který je uložený v kontejneru objektů blob. Soubor prostředku je vždy přidružený k prostředku a prostředek může obsahovat jeden nebo více souborů. Úloha kodéru Media Services selže, pokud objekt souboru prostředku není přidružený k digitálnímu souboru v kontejneru objektů blob.

Toto téma poskytuje přehled AssetFile entity a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.

Důležité

Při přístupu k entitě ve službě Media Services musíte v požadavcích HTTP nastavit konkrétní pole hlaviček a hodnoty.
Další informace najdete v tématu Nastavení pro vývoj rozhraní REST API služby Media Services a připojení ke službě Media Services pomocí rozhraní REST API služby Media Services.

Vlastnosti entity AssetFile

Vlastnost Typ Description
Id

Jen pro čtení. Nastavení službou Media Services při vytváření.		 Edm.String Jedinečný identifikátor.
Name

Povinná hodnota.		 Edm.String Popisný název souboru AssetFile. Výchozí hodnota je název souboru, který jste použili při nahrávání souboru. Maximální délka je 260. Poznámka: Služba Media Services používá hodnotu Name vlastnosti při vytváření adres URL streamovaného obsahu (například http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters.) Z tohoto důvodu není povolené kódování procent. Hodnota vlastnosti Name nemůže obsahovat žádný z následujících znaků vyhrazených pro kódování procent: !*'();:@&=+$,/?%#[]". Také může existovat pouze jeden '. pro příponu názvu souboru.
ContentFileSize

Nepovinný parametr.		 Edm.Int64 Velikost souboru AssetFile (v bajtech) obsahu.
ParentAssetId

Povinná hodnota. Po vytvoření entity nelze aktualizovat.		 Edm.String ID prostředku, ke kterému je tento soubor přidružený.
EncryptionVersion

Nepovinný parametr.		 Edm.String Aktuální podporovaná verze pro StorageEncryption i CommonEncryption je 1.0.
EncryptionScheme

Nepovinný parametr.		 Edm.String Schéma šifrování použité pro tento soubor. Platné hodnoty jsou: StorageEncryption nebo CommonEncryption.
IsEncrypted

Nepovinný parametr.		 Edm.Boolean Tato hodnota by měla být nastavena na true , pokud je tento soubor uložen zašifrovaný.
EncryptionKeyId

Nepovinný parametr.		 Edm.String Šifrované ID klíče obsahu.
InitializationVector

Nepovinný parametr.		 Edm.String Inicializační vektor použitý pro šifrování úložiště.
IsPrimary

Nepovinný parametr.		 Edm.Boolean Určuje, jestli je tento soubor primárním souborem ve vícesouborovém assetu.
LastModified

Jen pro čtení. Nastavení službou Media Services při vytváření.		 Edm.DateTime Tato hodnota je aktualizována službou Media Services po provedení jakýchkoli změn vlastností. Představuje počet milisekund od půlnoci 1. ledna 1970.
Created

Jen pro čtení. Nastavení službou Media Services při vytváření.		 Edm.DateTime Představuje počet milisekund od půlnoci 1. ledna 1970.
MimeType

Nepovinný parametr.		 Edm.String Služba Media Services nekontroluje žádný objekt blob, který jste nahráli, a proto musíte typ mime nastavit ručně. Například "text/plain" nebo "video/x-ms-wmv" jsou platné hodnoty, které se mají použít. Maximální délka je 4000.
ContentChecksum

Nepovinný parametr.		 Edm.String Šestnáctkové číslo představující hodnotu digestu zprávy MD5 (RFC 1321). Tato hodnota je nastavena klientem nebo klientskou knihovnou, aby sloužila jako ověření úspěšného nahrání obsahu. Maximální délka je 4000.

Vytvoření souboru AssetFile

Funkce CreateFileInfos slouží k vytvoření nové entity AssetFile. Další informace najdete v tématu Funkce rozhraní REST API.

Výpis souborů assetů

AssetFile se načítají pomocí požadavku HTTP GET.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files> HTTP/1.1
Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1
Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Files HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu Rest služby Media Services.

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

Aktualizace souboru AssetFile

AssetFiles se aktualizují pomocí požadavku HTTP merge.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
SLOUČIT <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1

Ukázkový požadavek

Nejnovější verzi najdete v x-ms-version:tématu Rest služby Media Services.

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" }

Odstranění souboru AssetFile

Soubory AssetFile se odstraní, když se odstraní jejich přidružený asset. Příklad najdete v tématu Odstranění prostředku.

Viz také

ContentKey
Prostředek
Zásady přístupu
Úloha
Pracovní pozice
Lokátor
MediaProcessor
Úkol
TaskTemplate
Kvóty a omezení