Exportar (0) Imprimir
Expandir Tudo
Este tópico ainda não foi avaliado como - Avalie este tópico

Conectar ao Media Services usando a API REST do Media Services

Atualizado: fevereiro de 2012

Duas coisas são necessárias ao acessar o Serviços de Mídia do Windows Azure: Um token de acesso fornecido pelo Windows Azure Access Control Services (ACS) e o URI do próprio Serviços de Mídia. Você pode usar os meios que desejar ao criar essas solicitações desde que especifique os valores de cabeçalho corretos e os passe corretamente para o token de acesso ao chamá-los no Serviços de Mídia.

ImportantImportante
Depois de se conectar com êxito em https://media.windows.net, você receberá um redirecionamento 301 que especifica outro URI dos Serviços de Mídia. Você deve fazer chamadas subsequentes para o novo URI.

Obtendo um token de acesso

Para acessar o Serviços de Mídia diretamente por meio de uma API REST, recupere um token de acesso do ACS e use-o durante todas as solicitações HTTP que fizer ao serviço. Este token é similar aos outros tokens fornecidos pelo ACS, com base nas declarações de acesso fornecidas no cabeçalho de uma solicitação HTTP e usando o protocolo OAuth v2. Não é necessário qualquer outro pré-requisito antes de conectar diretamente ao Serviços de Mídia.

O seguinte exemplo mostra o cabeçalho e o corpo de solicitação HTTP usados para recuperar um token:

POST https://wamsprodglobal001acs.accesscontrol.windows.net/v2/OAuth2-13 HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: wamsprodglobal001acs.accesscontrol.windows.net
Content-Length: 120
Expect: 100-continue
Connection: Keep-Alive

grant_type=client_credentials&client_id=client id value&client_secret=URL-encoded client secret value&scope=urn%3aWindowsAzureMediaServices

ImportantImportante
O client_id e o client_secret são fornecidos pelo Media Services quando você configura a sua conta. Eles correspondem aos valores AccountName e AccountKey, respectivamente. Para obter mais informações, consulte as Instruções de configuração de conta do Media Services. Além disso, o AccountKey para a conta do Serviços de Mídia deve estar codificado em URL ao usá-lo como o valor client_secret na solicitação de token de acesso.

O seguinte exemplo mostra a resposta HTTP que contém o token de acesso no corpo de resposta.

HTTP/1.1 200 OK
Cache-Control: public, no-store, max-age=0
Content-Type: application/json; charset=utf-8
Expires: Fri, 13 Jan 2012 22:40:07 GMT
Last-Modified: Fri, 13 Jan 2012 22:40:07 GMT
Vary: *
Server: Microsoft-IIS/7.5
Set-Cookie: ASP.NET_SessionId=w3mtu2rnxucaz5tvj0iyfm0t; path=/; HttpOnly
X-AspNetMvc-Version: 2.0
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
X-Content-Type-Options: nosniff
Date: Fri, 13 Jan 2012 22:40:07 GMT
Content-Length: 580

{"access_token":"http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=client_id&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1326498007&Issuer=https%3a%2f%2f wamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=hV1WF7sTe%2ffoHqzK%2ftmnwQY22NRPaDytcOOpC9Nv4DA%3d","token_type":"http://schemas.xmlsoap.org/ws/2009/11/swt-token-profile-1.0","expires_in":"3599","scope":"urn:WindowsAzureMediaServices"}

ImportantImportante
Monitore o valor "expires_in" do token de acesso e atualize as chamadas de API REST com novos tokens, conforme necessário.

Conectando ao URI do Media Services

O URI raiz para o Media Services é https://media.windows.net/API/. Primeiro, você deve conectar a este URI e se obtiver uma resposta 301 redirecionar de volta, deverá realizar as chamadas subsequentes ao novo URI. Além disso, não use nenhuma lógica de redirecionamento/acompanhamento automático nas solicitações. Os verbos e os corpos de solicitação HTTP não serão redirecionados para o novo URI.

O URI raiz para carregar e baixar arquivos do ativo é https://suacontadearmazenamento.blob.core.windows.net/, em que o nome da conta de armazenamento é o mesmo que você usou durante a configuração da conta do Serviços de Mídia.

O exemplo de código a seguir mostra como criar um ativo no Serviços de Mídia. Observe que o real mecanismo de autorização que é passado no cabeçalho de solicitação é um token portador OAuth v2.

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=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=1335602357&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=XQs5T%2fEfdO39%2f0Z9%2fBBkA12%2bbUUEY21YyefWXuRYZlY%3d
Host: media.windows.net
Content-Length: 27
Expect: 100-continue

{ "Name" : "NewJSONAsset" }
TipDica
Para tornar as entidades do Serviços de Mídia mais detectáveis, a operação $metadata pode ser usada. Ela permite que você recupere todos os tipos válidos de entidade, propriedade de entidade, associações, funções, ações e assim por diante. O seguinte exemplo mostra como construir o URI: https://media.windows.net/API/$metadata.

Você deve anexar "?api-version=2.0" ao final do URI se desejar visualizar os metadados no navegador ou não incluir o cabeçalho x-ms-version na solicitação.

Consulte também


Data da compilação:

2014-04-03
Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários

Contribuições da comunidade

Mostrar:
© 2014 Microsoft. Todos os direitos reservados.