AssetFile

  • Artykuł

Jednostka AssetFile reprezentuje rzeczywisty plik wideo lub audio przechowywany w kontenerze obiektów blob. Plik zasobu jest zawsze skojarzony z elementem zawartości, a zasób może zawierać jeden lub wiele plików. Zadanie kodera usługi Media Services kończy się niepowodzeniem, jeśli obiekt pliku elementu zawartości nie jest skojarzony z plikiem cyfrowym w kontenerze obiektów blob.

Ten temat zawiera omówienie AssetFile jednostki, a także pokazuje, jak wykonywać różne operacje za pomocą interfejsu API REST usługi Media Services.

Ważne

Podczas uzyskiwania dostępu do jednostek w usłudze Media Services należy ustawić określone pola nagłówka i wartości w żądaniach HTTP.
Aby uzyskać więcej informacji, zobacz Setup for Media Services REST API Development (Konfigurowanie tworzenia interfejsu API REST usługi Media Services) i Connecting to Media Services with the Media Services REST API (Nawiązywanie połączenia z usługą Media Services za pomocą interfejsu API REST usługi Media Services).

Właściwości jednostki AssetFile

Właściwość Typ Opis
Id

Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia.		 Edm.String Unikatowy identyfikator.
Name

Wymagane.		 Edm.String Przyjazna nazwa elementu AssetFile. Wartość domyślna to nazwa pliku użyta podczas przekazywania pliku. Maksymalna długość to 260. Uwaga: Usługa Media Services używa wartości Name właściwości podczas tworzenia adresów URL zawartości przesyłania strumieniowego (na przykład http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters. Z tego powodu kodowanie procentowe jest niedozwolone. Wartość właściwości Name nie może zawierać żadnego z następujących znaków zarezerwowanych typu procent kodowania: !*'();:@&=+$,/?%#[]". Ponadto może istnieć tylko jeden "". dla rozszerzenia nazwy pliku.
ContentFileSize

Opcjonalny.		 Edm.Int64 Rozmiar elementu AssetFile (w bajtach) zawartości.
ParentAssetId

Wymagane. Nie można zaktualizować po utworzeniu jednostki.		 Edm.String Identyfikator zasobu, z którą jest skojarzony ten plik.
EncryptionVersion

Opcjonalny.		 Edm.String Bieżąca obsługiwana wersja dla zarówno storageEncryption, jak i CommonEncryption to "1.0"
EncryptionScheme

Opcjonalny.		 Edm.String Schemat szyfrowania używany dla tego pliku. Prawidłowe wartości to: "StorageEncryption" lub "CommonEncryption".
IsEncrypted

Opcjonalny.		 Edm.Boolean Ta wartość powinna być ustawiona na true wartość , jeśli ten plik jest przechowywany jako zaszyfrowany.
EncryptionKeyId

Opcjonalny.		 Edm.String Zaszyfrowany identyfikator klucza zawartości.
InitializationVector

Opcjonalny.		 Edm.String Wektor inicjowania używany do szyfrowania magazynu.
IsPrimary

Opcjonalny.		 Edm.Boolean Określa, czy ten plik jest plikiem podstawowym w zasobie z wieloma plikami.
LastModified

Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia.		 Edm.DateTime Ta wartość jest aktualizowana przez usługę Media Services po wprowadzeniu jakichkolwiek zmian właściwości. Reprezentuje liczbę milisekund od północy 1 stycznia 1970 r.
Created

Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia.		 Edm.DateTime Przedstawia liczbę milisekund od północy 1 stycznia 1970 r.
MimeType

Opcjonalny.		 Edm.String Usługa Media Services nie sprawdza przekazanych obiektów blob, dlatego należy ręcznie ustawić typ mime. Na przykład wartości "text/plain" lub "video/x-ms-avi" są prawidłowymi wartościami do użycia. Maksymalna długość to 4000.
ContentChecksum

Opcjonalny.		 Edm.String Liczba szesnastkowa reprezentująca wartość skrótu komunikatu MD5 (RFC 1321). Ta wartość jest ustawiana przez klienta lub bibliotekę klienta, aby służyć jako walidacja pomyślnego przekazania zawartości. Maksymalna długość to 4000.

Tworzenie elementu AssetFile

Funkcja CreateFileInfos służy do tworzenia nowej jednostki AssetFile. Aby uzyskać więcej informacji, zobacz Funkcje interfejsu API REST.

Wyświetlanie listy elementów zawartościPliki

Pliki AssetFile są pobierane przy użyciu żądania HTTP GET.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files> HTTP/1.1
Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1
Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Files HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa Media Services 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

Aktualizowanie elementu AssetFile

Pliki AssetFile są aktualizowane przy użyciu żądania HTTP MERGE.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
SCALANIA <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz Artykuł Usługa Media Services 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" }

Usuwanie elementu AssetFile

Pliki AssetFile są usuwane po usunięciu skojarzonego elementu zawartości. Aby zapoznać się z przykładem, zobacz Usuwanie elementu zawartości.

Zobacz też

ContentKey
Zasób
AccessPolicy
Zadanie
JobTemplate
Lokalizator
MediaProcessor
Zadanie
TaskTemplate
Limity przydziału i ograniczenia