Экспорт (0) Печать
Развернуть все
Эта тема еще не получила оценку - Оценить эту тему

Asset

Обновлено: Февраль 2014 г.

Ресурсом является виртуальная сущность, в которой содержатся метаданные о мультимедиа. В ресурсе может содержаться один или несколько файлов, в том числе видео, аудио, изображения, коллекции эскизов, текстовые каналы, файлы субтитров и проигрыватели расширенного мультимедийного содержимого. Сущность «Ресурс» определяет абстрактное понятие ресурса в системе Windows Azure Media Services.

К ресурсу в Службы Media Services применяются следующие характеристики.
Ресурс – это логический объект, который представляет один аудиовизуальный пакет.

В ресурсе содержится коллекция из одного или нескольких файлов мультимедиа.

Файлы ресурса находятся в одном контейнере хранилища больших двоичных объектов.

Ниже показано несколько примеров ресурса: фильм, телепередача, специальное издание; клип из фильма, телепередача, анимация, ISO-файл камеры, событие и т.п; трейлер к фильму или рекламный ролик, реклама, аудиофайл, радиопередача, подкаст, звуковой файл и т. д.

К ресурсу в Службы Media Services НЕ применяются следующие характеристики:
всего лишь контейнер хранилища;

папка для организации и хранения нескольких версий одного и того же пакета в;

папка для отправки пакетной обработки нескольких аудиовизуальных пакетов в программе Azure Media Encoder.

Например, в одном ресурсе нельзя сохранить фильм, трейлер к нему, рекламу и международную версию этого фильма.

ImportantВажно!
Осуществляя доступ к сущностям в Службы Media Services, в запросах HTTP необходимо указывать определенные поля заголовка и значения. Дополнительные сведения см. в разделе Настройка для разработки интерфейса API REST служб Media Services.

ImportantВажно!
После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

Свойства сущности ресурса

 

Свойство Тип Описание

ИД

Строка

Уникальный идентификатор, заданный Службы Media Services.

Состояние

Edm.Int32

Значение перечисления, описывающие состояние ресурса. Значениями значения являются:

  • Инициализировано = 0

  • Опубликовано = 1

    WarningПредупреждение
    Действие Publish было исключено. Начиная с последнего выпуска Службы Media Services, код, с помощью которого осуществляется проверка того, является ли ресурс в состоянии Published, следует удалить.

  • Удалено = 2

Дата создания

Edm.DateTime

Это значение задается Службы Media Services во время создания.

LastModified

Edm.DateTime

Обновление этого значения осуществляется с помощью Службы Media Services после внесения любых изменений свойств.

AlternateId

Edm.String

Необязательный параметр. Значение дополнительного ИД, которое отвечает ИД в другой системе управления содержимым.

Имя

Edm.String

Необязательный параметр. Укажите понятное имя для ресурса.

Параметры

Edm.Int32

Необязательный параметр. Значение перечисления, описывающее параметры шифрования, с помощью которых можно создать ресурс. Действительное значение является одним значением из списка, приведенного далее, а не сочетанием значений из этого списка.

  • Нет = 0 определяет отсутствие параметров создания ресурса.

  • StorageEncrypted = 1: определяет, что файлы ресурса необходимо зашифровать для передачи и сохранения во время создания ресурса.

  • CommonEncryptionProtected = 2: определяет, что файлы ресурса защищены с помощью общего метода шифрования (например, PlayReady).

Указатели

Набор сущностей указателя

Свойство навигации, доступ к которому можно получить, выбрав ссылку определенного ресурса с помощью значения ИД. В возвращенном наборе сущностей содержатся все сущности указателя, связанные с указанным ресурсом.

ContentKeys

Набор сущностей ContentKey

Свойство навигации, доступ к которому можно получить, выбрав ссылку определенного ресурса с помощью значения ИД. В возвращенном наборе сущностей содержатся все сущности ключа содержания, связанные с указанным ресурсом.

Файлы

Набор сущностей файла

Свойство навигации, доступ к которому можно получить, выбрав ссылку определенного ресурса с помощью значения ИД. В возвращенном наборе сущностей содержатся все сущности файла, связанные с указанным ресурсом.

ParentAssets

Набор сущностей ParentAsset

Свойство навигации, доступ к которому можно получить, выбрав ссылку определенного ресурса с помощью значения ИД. В возвращенном наборе сущностей содержатся все сущности родительского ресурса ParentAsset, связанные с указанным ресурсом.

Создание ресурса

Ресурсы можно создать с помощью запроса POST HTTP и указав значения свойства.

 

Метод URI-код запроса Версия HTTP

POST

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

HTTP/1.1

Пример запроса

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

Внесение ресурса в список

Ресурсы можно получить с помощью запроса GET HTTP.

 

Метод URI-код запроса Версия HTTP

GET

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

HTTP/1.1

 

Метод URI-код запроса Версия HTTP

GET

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

HTTP/1.1

Пример запроса

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


Обновление ресурса

Ресурсы можно обновить с помощью запроса MERGE HTTP, а также определенных свойств, которые необходимо изменить.

 

Метод URI-код запроса Версия HTTP

MERGE

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

HTTP/1.1

Пример запроса

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

Удаление ресурса

Ресурсы можно удалить, выбрав ссылку значения ИД ресурса. После удаления ресурса его указатели будут удалены с помощью Windows Azure Media Services. Если в ресурсе есть исходные указатели, они будут отозваны и также удалены. Все ссылки на сущность ContentKeys будут удалены и любая сущность ContentKeys, не связанная с другими ресурсами, будет удалена.

 

Метод URI-код запроса Версия HTTP

DELETE

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

HTTP/1.1

Пример запроса

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


Публикация ресурса

noteПримечание
Действие Publish было исключено. Начиная с последнего выпуска Службы Media Services, не нужно использовать действие Publish.

Если код использует действие Publish, обратите внимание на следующие рекомендации.

  1. Указатели, связанные с ресурсом, не будут удалены с помощью действия Publish. После вызова действия Publish, указатели необходимо удалить непосредственно в коде.

  2. С помощью действия Publish состояние Published для ресурса не устанавливается. Удалите код, с помощью которого осуществляется проверка того, находится ли ресурс в состоянии Published. В настоящее время состояние ресурса может быть определено как Initialized или Deleted.

Связывание ключей содержимого с ресурсами

Ссылаясь на ИД ресурса с помощью запроса HTTP POST, можно связать Сущность ContentKey с ресурсом. В текст запроса необходимо добавить Uri-код для сущности ContentKey. Связать можно только тот тип сущности ContentKey, который соответствует типу, указанному в свойстве CreationOptions ресурса. Например, если в ресурсе есть параметры, установленные на StorageEncrypted(1), для сущности ContentKey необходимо выбрать тип StorageEncryption(1).

 

Метод URI-код запроса Версия HTTP

POST

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

HTTP/1.1

Пример запроса

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

Удаление ссылок ContentKey

Ссылаясь на ИД ресурса и ИД сущности ContentKey в запросе HTTP DELETE, ссылки Сущность ContentKey можно удалить из ресурса. Сущность ContentKey будет удалена, если она не связана с любыми другими ресурсами.

 

Метод URI-код запроса Версия HTTP

DELETE

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

HTTP/1.1

Пример запроса

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

См. также


Дата сборки:

2014-04-03
Была ли вам полезна эта информация?
(1500 символов осталось)
Спасибо за ваш отзыв

Добавления сообщества

ДОБАВИТЬ
Показ:
© 2014 Microsoft. Все права защищены.