Exporter (0) Imprimer
Développer tout

Asset

Mis à jour: février 2014

L'entité Asset contient des fichiers numériques (notamment des fichiers vidéo et audio, des images, des collections de miniatures, des pistes textuelles et des légendes) ainsi que les métadonnées concernant ces fichiers. Une fois les fichiers numériques téléchargés vers un élément, ils peuvent être utilisés dans les flux de travail d'encodage et de diffusion en continu de Media Services.

Les caractéristiques suivantes s’appliquent à un élément multimédia dans Services de média :
Un élément multimédia est une unité logique qui représente une présentation audiovisuelle.

Il inclut une collection d’un ou plusieurs fichiers multimédias.

Les fichiers d’un élément multimédia sont placés dans un seul conteneur de stockage d’objets blob.

Les éléments multimédias peuvent être : un film, un programme télévisé, une édition spécifique ; un clip extrait d’un film, un programme télévisé, une animation, un fichier ISO de caméra ou un événement ; une bande-annonce ou une vidéo promotionnelle ; une publicité ; un fichier audio, une émission de radio, un podcast ou un fichier sonore.

Les caractéristiques suivantes NE s’appliquent PAS à un élément multimédia dans Services de média :
Simple conteneur de stockage.

Un dossier dans lequel organiser et stocker plusieurs versions de la même présentation.

Un dossier pour envoyer un traitement par lots de plusieurs présentations audiovisuelles à Azure Media Encoder.

Par exemple, vous ne devez pas stocker de film, sa bande-annonce, une publicité et une version d’édition internationale du même film dans un seul élément multimédia.

Cette rubrique fournit un aperçu de l'entité Asset et illustre la façon d'exécuter diverses opérations avec l'API REST de Media Services.

ImportantImportant
Lorsque vous utilisez l'API REST de Media Services, prenez en compte les éléments suivants :

Propriétés de l’entité Asset

 

Propriété Type Description

Id

Lecture seule. Définie par Services de média lors de la création.

Chaîne

Identificateur unique

State

Lecture seule. Définie par Services de média.

Edm.Int32

Valeur d’énumération qui décrit l’état de l’élément multimédia. Les valeurs suivantes sont valides :

  • Initialisation = 0

  • Publication = 1

    WarningAvertissement
    L’action Publish est devenue obsolète. Supprimez le code qui vérifie si un élément multimédia se trouve dans l’état Published.

  • Suppression = 2

Un élément multimédia est toujours associé à l'état Initialisé jusqu'à sa suppression.

Crated

Lecture seule. Définie par Services de média lors de la création.

Edm.DateTime

Cette valeur est définie par Services de média lors de la création.

LastModified

Lecture seule. Définie par Services de média.

Edm.DateTime

Cette valeur est mise à jour par Services de média suite à la modification d’une propriété.

AlternateId

Facultatif.

Edm.String

Autre valeur d’ID qui correspond à un ID dans un autre système de gestion de contenu. La longueur maximale est de 4 000.

Name

Facultatif.

Edm.String

Nom convivial de votre élément multimédia. La longueur maximale est de 4 000.

Options

Obligatoire. Mise à jour impossible après la création de l'entité.

Edm.Int32

Valeur d’énumération qui décrit les options de chiffrement avec lesquelles un élément multimédia peut être créé. Une valeur valide est une de celle figurant dans la liste ci-dessous (et non une combinaison de celles-ci) :

  • Aucun = 0 : ne spécifie aucune option de création d’éléments multimédias.

  • StorageEncrypted = 1 : spécifie que les fichiers d’un élément multimédia doivent être chiffrés pour le chargement et le stockage lors de la création de l’élément multimédia.

  • CommonEncryptionProtected = 2 : spécifie que les fichiers d’un élément multimédia sont protégés à l’aide d’une méthode de chiffrement commun (telle que PlayReady)

  • EnvelopeEncryptionProtected = 4

Uri

Lecture seule. Définie par Services de média.

Edm.String

URI du conteneur de stockage d'objets blob de l'élément multimédia spécifié.

Locators

Lecture seule. Définie par Services de média.

Ensemble d’entités Locator

L’ensemble d’entités renvoyé contient les entités Locator liées à l’élément multimédia spécifié.

ContentKeys

Facultatif.

Ensemble d’entités ContentKey

L’ensemble d’entités renvoyé contient les entités ContentKey liées à l’élément multimédia spécifié.

Files

Lecture seule. Définie par Services de média.

Ensemble d’entités File

L’ensemble d’entités renvoyé contient les entités File liées à l’élément multimédia spécifié.

ParentAssets

Facultatif.

Ensemble d’entités Asset parent

L’ensemble d’entités renvoyé contient les entités Asset parent liées à l’élément multimédia spécifié.

StorageAccountName

Facultatif. Mise à jour impossible après la création de l'entité.

Edm.String

Nom du compte de stockage dans lequel se trouve le conteneur d'objets blob de l'élément multimédia.

Si aucun compte n'est précisé lors de la création, Services de média définit le nom du compte de stockage par défaut.

StorageAccount

Lecture seule. Définie par Services de média.

Ensemble d’entités StorageAccount

L’ensemble d’entités renvoyé contient les entités StorageAccount liées à l’élément multimédia spécifié.

Création d’un élément multimédia

Les éléments multimédias peuvent être créés à l’aide d’une requête HTTP POST et en spécifiant la valeur des propriétés.

 

Méthode URI de requête Version HTTP

POST

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

HTTP/1.1

Exemple de requête

ImportantImportant
Après vous être connecté au https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Services de média. Vous devez apporter appels suivants au nouvel 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.6
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" }

Liste des Assets

Les Assets peuvent être récupérés à l’aide d’une requête HTTP GET.

 

Méthode URI de requête Version HTTP

GET

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

HTTP/1.1

 

Méthode URI de requête Version HTTP

GET

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

HTTP/1.1

Exemple de requête

ImportantImportant
Après vous être connecté au https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Services de média. Vous devez apporter appels suivants au nouvel 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.6
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


Mise à jour d’un Asset

Les Assets peuvent être mis à jour à l’aide d’une requête HTTP MERGE et des propriétés spécifiques que vous voulez modifier.

 

Méthode URI de requête Version HTTP

MERGE

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

HTTP/1.1

Exemple de requête

ImportantImportant
Après vous être connecté au https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Services de média. Vous devez apporter appels suivants au nouvel 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.6
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" }

Suppression d’un élément multimédia

Les Assets peuvent être supprimés via la référence de la valeur d’ID de l’élément multimédia. Lorsqu’un élément multimédia est supprimé, tous ses localisateurs sont supprimés par Microsoft Azure Media Services. Si l’élément multimédia incluait des localisateurs d’origine, ceux-ci seront également révoqués et supprimés. Tous les liens vers les ContentKeys seront supprimés. Les ContentKeys non liées à d’autres éléments multimédias seront supprimées.

 

Méthode URI de requête Version HTTP

DELETE

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

HTTP/1.1

Exemple de requête

ImportantImportant
Après vous être connecté au https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Services de média. Vous devez apporter appels suivants au nouvel 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.6
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


Publication d’un Asset

noteRemarque
L’action Publish est devenue obsolète. Depuis la dernière version de Services de média, l’action Publish ne doit pas être utilisée.

Si votre code utilise l’action Publish, prenez en compte ce qui suit :

  1. L’action Publish ne supprime pas les localisateurs associés à l’élément multimédia. Vous devez supprimer de manière explicite les localisateurs dans le code après avoir appelé Publish.

  2. L’action Publish ne définit pas l’état de l’élément multimédia sur Published. Supprimez le code qui vérifie si un élément multimédia se trouve dans l’état Published. Actuellement, un élément multimédia peut uniquement avoir l’état Initialized ou Deleted.

Association de clés de contenu aux éléments multimédias

Vous pouvez lier une ContentKey à un élément multimédia en faisant référence à l’ID d’élément multimédia avec une requête HTTP POST. L’URI de la ContentKey doit être inclus dans le corps de la requête. Vous pouvez uniquement lier un type de ContentKey correspondant au type spécifié dans les CreationOptions de l’élément multimédia. Par exemple, si les options de l’élément multimédia sont définies sur StorageEncrypted(1), la ContentKey doit être de type StorageEncryption(1).

 

Méthode URI de requête Version HTTP

POST

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

HTTP/1.1

Exemple de requête

ImportantImportant
Après vous être connecté au https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Services de média. Vous devez apporter appels suivants au nouvel 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.6
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')"}

Suppression des liens ContentKey

Vous pouvez supprimer les liens ContentKey d’un élément multimédia en faisant référence à l’ID d’élément multimédia dans une requête HTTP DELETE. Si la ContentKey n’est pas associée à un autre élément multimédia, elle sera supprimée.

 

Méthode URI de requête Version HTTP

DELETE

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

HTTP/1.1

Exemple de requête

ImportantImportant
Après vous être connecté au https://media.windows.net, vous recevrez une redirection 301 spécifiant un autre URI de Services de média. Vous devez apporter appels suivants au nouvel 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.6
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

Voir aussi


Date de génération :

2014-06-20

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft