Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Asset

Un élément multimédia est une entité virtuelle qui contient des métadonnées sur un média. Il inclut un ou plusieurs fichiers, notamment des fichiers vidéo et audio, des images, des collections de miniatures, des pistes textuelles, des légendes et des lecteurs multimédias enrichis. L’entité Asset définit la notion abstraite d’un élément multimédia dans le système Service de média de Windows Azure.

Les caractéristiques suivantes s’appliquent à un élément multimédia dans Service 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 complet, une émission TV, une édition spécifique ; un clip extrait d’un film, une émission TV, une animation, un fichier ISO de caméra, un événement, etc. ; une bande-annonce ou vidéo promotionnelle, une publicité, un fichier audio, une émission de radio, un podcast, un fichier sonore, etc.

Les caractéristiques suivantes NE s’appliquent PAS à un élément multimédia dans Service 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.

Important
Dans le cadre de l’accès aux entités dans Service de média, vous devez définir des champs et valeurs d’en-tête spécifiques dans vos requêtes HTTP. Pour plus d'informations, voir Setup for Media Services REST API Development.

Propriétés de l’entité Asset
Création d’un élément multimédia
Liste des Assets
Mise à jour d’un Asset
Suppression d’un élément multimédia
Publication d’un Asset
Association de clés de contenu aux éléments multimédias
Suppression des liens ContentKey

Important
Après vous être connecté au https://media.windows.net/API, vous recevrez une redirection 301 spécifiant un autre URI de Service de média. Vous devez apporter appels suivants au nouvel URI.

Propriétés de l’entité Asset

Propriété

Type

Description

Chaîne

Identificateur unique défini par Service de média.

State

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

Avertissement
L’action Publish est devenue obsolète. Depuis la dernière version de Service de média, vous devez supprimer le code qui vérifie si un élément se trouve dans l’état Published.

Suppression = 2

Created

Edm.DateTime

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

LastModified

Edm.DateTime

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

AlternateId

Edm.String

Facultatif. Autre valeur d’ID qui correspond à un ID dans un autre système de gestion de contenu.

Désignation

Edm.String

Facultatif. Nom convivial de votre élément multimédia.

Options

Edm.Int32

Facultatif. 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)

Locators

Ensemble d’entités Locator

Propriété de navigation accessible via la référence d’un élément multimédia spécifique selon la valeur d’ID. L’ensemble d’entités renvoyé contient les entités Locator liées à l’élément multimédia spécifié.

ContentKeys

Ensemble d’entités ContentKey

Propriété de navigation accessible via la référence d’un élément multimédia spécifique selon la valeur d’ID. L’ensemble d’entités renvoyé contient les entités ContentKey liées à l’élément multimédia spécifié.

Files

Ensemble d’entités File

Propriété de navigation accessible via la référence d’un élément multimédia spécifique selon la valeur d’ID. L’ensemble d’entités renvoyé contient les entités File liées à l’élément multimédia spécifié.

ParentAssets

Ensemble d’entités ParentAsset

Propriété de navigation accessible via la référence d’un élément multimédia spécifique selon la valeur d’ID. L’ensemble d’entités renvoyé contient les entités ParentAsset 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

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.0
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

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.0
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

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.0
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 Service de média de Windows Azure. 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

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.0
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

Remarque
L’action Publish est devenue obsolète. Depuis la dernière version de Service 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 : 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. 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.

Remarque

L’action Publish est devenue obsolète. Depuis la dernière version de Service 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 :

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.
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

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.0
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

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.0
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

Concepts

AccessPolicies
ContentKey
AssetFiles
Jobs
JobTemplates
Locator
MediaProcessors
Task
TaskTemplates

Autres ressources

Ingest Assets with the Media Services REST API
Media Services Considerations

Date de génération :

2013-04-11

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Ajouts de la communauté

AJOUTER