Delen via

Asset

  • Artikel

De Asset entiteit bevat digitale bestanden (waaronder video, audio, afbeeldingen, miniatuurverzamelingen, tekstsporen en gesloten onderschrift bestanden) en de metagegevens over deze bestanden. Nadat de digitale bestanden zijn geüpload naar een asset, kunnen ze worden gebruikt in de Media Services-coderings- en streamingwerkstromen.

Wanneer u een asset coderen, wordt er een uitvoerasset geproduceerd na voltooiing van de coderingstaak. Onder de hierboven genoemde bestanden bevat de uitvoerasset XML-metagegevensbestanden die de invoerasset en uitvoerasset beschrijven. Zie de artikelen Invoermetagegevens en Uitvoermetagegevens voor meer informatie.

De volgende kenmerken zijn van toepassing op een asset in Media Services:

  • Een asset is een logische eenheid die één audiovisuele presentatie vertegenwoordigt.

  • Een asset bevat een verzameling van één tot veel mediabestanden.

  • De bestanden van een asset bevinden zich in één blobopslagcontainer.

Enkele voorbeelden van een Asset zijn: een volledige film, tv-programma, specifieke bewerking; een clip uit een film, tv-programma, animatie, ISO-bestand van de camera of gebeurtenis; een filmtrailer of promotievideo; een advertentie; een audiobestand, radioprogramma, podcast of geluidsbestand.

De volgende kenmerken zijn NIET van toepassing op een asset in Media Services:

  • Gewoon een opslagcontainer

  • Een map voor het organiseren en opslaan van meerdere versies van dezelfde presentatie in

  • Een map voor het verzenden van batchverwerking van meerdere audiovisuele presentaties naar Azure Media Encoder

U mag bijvoorbeeld een film, de trailer, een advertentie en een internationale bewerkingsversie van dezelfde film niet opslaan in één asset.

Dit onderwerp geeft een overzicht van de Asset entiteit en laat ook zien hoe u verschillende bewerkingen uitvoert met de Media Services REST API.

Belangrijk

Bij het openen van entiteiten in Media Services moet u specifieke headervelden en -waarden instellen in uw HTTP-aanvragen.
Zie Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Verbinding maken met Media Services met de Media Services REST API) voor meer informatie.

Eigenschappen van activatiteit

Eigenschap Type Beschrijving
Id

Alleen-lezen. Ingesteld door Media Services tijdens het maken.		 Tekenreeks Unieke id.
State

Alleen-lezen. Ingesteld door Media Services.		 Edm.Int32 Een opsommingswaarde die de status van de asset beschrijft. Waardewaarden zijn:

- Geïnitialiseerd = 0
- Gepubliceerd = 1 Waarschuwing: de Publish actie is afgeschaft. Verwijder de code die controleert of een asset de Published status heeft.
- Verwijderd = 2

Een asset heeft altijd de status Geïnitialiseerd totdat deze wordt verwijderd.
Created

Alleen-lezen. Ingesteld door Media Services tijdens het maken.		 Edm.DateTime Deze waarde wordt ingesteld door Media Services tijdens het maken.
LastModified

Alleen-lezen. Ingesteld door Media Services.		 Edm.DateTime Deze waarde wordt bijgewerkt door Media Services nadat eventuele eigenschapswijzigingen zijn aangebracht.
AlternateId

Optioneel.		 Edm.String Een alternatieve id-waarde die overeenkomt met een id in een ander inhoudsbeheersysteem. De maximale lengte is 4000.
Name

Optioneel.		 Edm.String Beschrijvende naam voor uw asset. De maximale lengte is 512.
Options

Vereist. Kan niet worden bijgewerkt nadat de entiteit is gemaakt.		 Edm.Int32 Een opsommingswaarde die de versleutelingsopties beschrijft waarmee een asset kan worden gemaakt. Een geldige waarde is één waarde uit de onderstaande lijst, niet een combinatie van waarden uit deze lijst:

- Geen = 0: hiermee geeft u geen opties voor het maken van assets op.
- StorageEncrypted = 1: hiermee geeft u op dat de bestanden van een asset moeten worden versleuteld voor uploaden en opslaan bij het maken van de asset.
- CommonEncryptionProtected = 2: hiermee geeft u op dat de bestanden van een asset worden beveiligd met behulp van een algemene versleutelingsmethode (zoals PlayReady).
- EnvelopeEncryptionProtected = 4
Uri

Alleen-lezen. Ingesteld door Media Services.		 Edm.String De URI van de blobopslagcontainer van de opgegeven asset.
Locators

Alleen-lezen. Ingesteld door Media Services.		 Entiteitsset Locator De geretourneerde entiteitsset bevat alle Locator-entiteiten die zijn gekoppeld aan de opgegeven asset.
ContentKeys

Optioneel.		 ContentKey-entiteitsset De geretourneerde entiteitenet bevat alle ContentKey-entiteiten die zijn gekoppeld aan de opgegeven asset.
Files

Alleen-lezen. Ingesteld door Media Services.		 Bestandsentiteitsset De geretourneerde entiteitsset bevat alle bestandsentiteiten die zijn gekoppeld aan de opgegeven asset.
ParentAssets

Optioneel.		 Entiteitsset bovenliggende activa De geretourneerde entiteitsset bevat alle bovenliggende activatiteiten die zijn gekoppeld aan de opgegeven asset.
StorageAccountName

Optioneel. Kan niet worden bijgewerkt nadat de entiteit is gemaakt.		 Edm.String Naam van het opslagaccount dat de blobcontainer van de asset bevat.

Als dit niet is opgegeven tijdens het maken, stelt Media Services de standaardnaam van het opslagaccount in.
StorageAccount

Alleen-lezen. Ingesteld door Media Services.		 Entiteitenset StorageAccount De geretourneerde entiteitsset bevat alle StorageAccount-entiteiten die zijn gekoppeld aan de opgegeven asset.
DeliveryPolicies Entiteitenset AssetDeliveryPolicy De geretourneerde entiteitsset bevat leveringsbeleid dat is gekoppeld aan de asset.
FormatOption Edm.Int32 Hiermee geeft u verschillende indelingsopties op waarmee een asset kan worden gemaakt. Toegestane waarden zijn: 0 (standaard): hiermee geeft u geen optie voor assetindeling op; 1 : geeft aan dat de indeling van een asset AdaptiveStreaming is.

Een Asset maken

Assets kunnen worden gemaakt met behulp van een POST HTTP-aanvraag en het opgeven van eigenschapswaarden.

Methode Aanvraag-URI HTTP-versie
POST <https:// accountnaam.restv2>.<location.media.azure.net/api/Assets> HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de nieuwste x-ms-version:versie.

POST https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization:  Bearer <token value>  
Host: media.windows.net  
Content-Length: 27  
Expect: 100-continue  
  
{ "Name" : "NewJSONAsset" }

Een asset weergeven

Assets kunnen worden opgehaald met behulp van een GET HTTP-aanvraag.

Methode Aanvraag-URI HTTP-versie
GET <https:// accountnaam.restv2>.<location.media.azure.net/api/Assets> HTTP/1.1
Methode Aanvraag-URI HTTP-versie
GET <https:// accountnaam.restv2>.<location.media.azure.net/api/Assets>('assetid') HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de nieuwste x-ms-version:versie.

GET https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

Een asset bijwerken

Assets kunnen worden bijgewerkt met behulp van een HTTP-aanvraag samenvoegen en de specifieke eigenschappen die u wilt wijzigen.

Methode Aanvraag-URI HTTP-versie
SAMENVOEGEN <https:// accountnaam.restv2>.<location.media.azure.net/api/Assets>('assetid') HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de nieuwste x-ms-version:versie.

MERGE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 21  
Expect: 100-continue  
  
{"Name" : "NewName" }

Een asset verwijderen

Assets kunnen worden verwijderd door te verwijzen naar de waarde van de asset-id. Wanneer een asset wordt verwijderd, worden alle locators verwijderd door Microsoft Azure Media Services. Als de asset oorsprongslocators had, worden deze locators ook ingetrokken en verwijderd. Alle koppelingen naar ContentKeys worden verwijderd en ContentKeys die niet aan andere assets zijn gekoppeld, worden verwijderd.

Methode Aanvraag-URI HTTP-versie
DELETE <https:// accountnaam.restv2>.<location.media.azure.net/api/Assets>('assetid') HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de nieuwste x-ms-version:versie.

DELETE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

Een asset publiceren

Notitie

De Publish actie is afgeschaft. Vanaf de nieuwste Media Services-release Publish mag niet worden gebruikt.

Als uw code gebruikmaakt Publishvan , moet u rekening houden met de volgende overwegingen:

  1. De Publish actie verwijdert geen locators die aan de asset zijn gekoppeld. U moet de locators in code expliciet verwijderen na het aanroepen Publishvan .
  2. De Publish actie stelt de assetstatus niet in op Published. Verwijder de code die controleert of een asset de Published status heeft. Op dit moment kan een asset alleen de Initialized status of Deleted hebben.

Inhoudssleutels koppelen aan assets

U kunt een ContentKey koppelen aan een asset door te verwijzen naar de asset-id met een HTTP POST-aanvraag. De URI van de ContentKey moet worden opgenomen in de hoofdtekst van de aanvraag. U kunt alleen een Type ContentKey koppelen dat overeenkomt met het type dat is opgegeven in de CreationOptions van de asset. Als voor de asset bijvoorbeeld opties zijn ingesteld op StorageEncrypted(1), moet de ContentKey van het type StorageEncryption(1) zijn.

Methode Aanvraag-URI HTTP-versie
POST <https:// accountnaam.restv2>.<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de nieuwste x-ms-version:versie.

POST https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 121  
Expect: 100-continue  
  
{ "uri": "https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}

U kunt ContentKey-koppelingen uit een asset verwijderen door te verwijzen naar de asset-id en de ContentKey-id in een HTTP DELETE-aanvraag. Als de ContentKey niet is gekoppeld aan andere assets, wordt deze verwijderd.

Methode Aanvraag-URI HTTP-versie
DELETE <https:// accountnaam.restv2>.<location.media.azure.net/api/Assets>('Asset Id')/$links/ContentKeys('ContentKey Id') HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de nieuwste x-ms-version:versie.

DELETE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

Zie ook

AccessPolicy
ContentKey
AssetFile
Taak
JobTemplate
Locator
MediaProcessor
Taak
TaskTemplate
Assets opnemen met de Media Services REST API
Quota en beperkingen