Pubblicare contenuti di Servizi multimediali di Azure mediante RESTPublish Azure Media Services content using REST

PanoramicaOverview

È possibile trasmettere in streaming un set MP4 a velocità in bit adattiva creando un localizzatore di streaming OnDemand e un URL di streaming.You can stream an adaptive bitrate MP4 set by creating an OnDemand streaming locator and building a streaming URL. Il codifica un asset articolo viene illustrato come effettuare la codifica in un set MP4 a velocità in bit adattiva.The encoding an asset article shows how to encode into an adaptive bitrate MP4 set. Se il contenuto viene crittografato, configurare criteri di distribuzione asset (come descritto in questo articolo) prima di creare un indicatore di posizione.If your content is encrypted, configure asset delivery policy (as described in this article) before creating a locator.

È inoltre possibile usare un localizzatore di streaming OnDemand per creare URL che puntano a file MP4 scaricabili in modo progressivo.You can also use an OnDemand streaming locator to build URLs that point to MP4 files that can be progressively downloaded.

In questo articolo viene illustrato come creare un OnDemand streaming localizzatore per pubblicare l'asset e creare un formato Smooth Streaming, MPEG DASH e HLS gli URL di streaming.This article shows how to create an OnDemand streaming locator in order to publish your asset and build a Smooth, MPEG DASH, and HLS streaming URLs. e come creare URL di download progressivo.It also shows hot to build progressive download URLs.

La sezione seguente mostra i tipi enum i cui valori vengono usati nelle chiamate REST.The following section shows the enum types whose values are used in the REST calls.

Nota

Quando si accede alle entità in Servizi multimediali, è necessario impostare valori e campi di intestazione specifici nelle richieste HTTP. Per altre informazioni, vedere Panoramica dell'API REST di Servizi multimediali.

Connettersi a Servizi multimedialiConnect to Media Services

Per informazioni su come connettersi all'API AMS, vedere Accedere all'API di Servizi multimediali di Azure con l'autenticazione di Azure AD.For information on how to connect to the AMS API, see Access the Azure Media Services API with Azure AD authentication.

Nota

Dopo avere stabilito la connessione a https://media.windows.net, si riceverà un reindirizzamento 301 che indica un altro URI di Servizi multimediali. Le chiamate successive dovranno essere effettuate al nuovo URI.

Creare un localizzatore di streaming OnDemandCreate an OnDemand streaming locator

Per creare il OnDemand localizzatore di streaming e ottenere l'URL, è necessario eseguire le operazioni seguenti:To create the OnDemand streaming locator and get URLs, you need to do the following:

  1. Se il contenuto viene crittografato, definire i criteri di accesso.If the content is encrypted, define an access policy.
  2. Creare un localizzatore di streaming OnDemand.Create an OnDemand streaming locator.
  3. Se si pianifica lo streaming, ottenere il file manifesto di streaming (.ism) nell'asset.If you plan to stream, get the streaming manifest file (.ism) in the asset.

    Se si pianifica il download progressivo, ottenere i nomi dei file MP4 nell'asset.If you plan to progressively download, get the names of MP4 files in the asset.

  4. Creare URL che puntano al file manifesto o ai file MP4.Build URLs to the manifest file or MP4 files.
  5. È possibile creare un localizzatore di streaming con un'entità AccessPolicy che include scrittura o eliminazione di autorizzazioni.You cannot create a streaming locator using an AccessPolicy that includes write or delete permissions.

Creare i criteri di accessoCreate an access policy

Nota

È previsto un limite di 1.000.000 di criteri per i diversi criteri AMS (ad esempio per i criteri Locator o ContentKeyAuthorizationPolicy). Se si utilizzano sempre gli stessi giorni o le autorizzazioni di accesso, ad esempio, i criteri per i localizzatori che devono rimanere sul posto per un lungo periodo (non-caricamento criteri), utilizzare lo stesso ID di criteri. Per altre informazioni, vedere questo articolo.

Richiesta:Request:

POST https://media.windows.net/api/AccessPolicies HTTP/1.1
Content-Type: application/json
DataServiceVersion: 1.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
Accept: application/json
Accept-Charset: UTF-8
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=amstest1&urn%3aSubscriptionId=zbbef702-e769-2233-9f16-bc4d3aa97387&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1424263184&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=NWE%2f986Hr5lZTzVGKtC%2ftzHm9n6U%2fxpTFULItxKUGC4%3d
x-ms-version: 2.17
x-ms-client-request-id: 6bcfd511-a561-448d-a022-a319a89ecffa
Host: media.windows.net
Content-Length: 68

{"Name":"access policy","DurationInMinutes":43200.0,"Permissions":1}

Risposta:Response:

HTTP/1.1 201 Created
Cache-Control: no-cache
Content-Length: 311
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8
Location: https:/media.windows.net/api/AccessPolicies('nb%3Apid%3AUUID%3A69c80d98-7830-407f-a9af-e25f4b0d3e5f')
Server: Microsoft-IIS/8.5
request-id: a877528a-bdb4-4414-9862-273f8e64f882
x-ms-request-id: a877528a-bdb4-4414-9862-273f8e64f882
x-ms-client-request-id: 6bcfd511-a561-448d-a022-a319a89ecffa
X-Content-Type-Options: nosniff
DataServiceVersion: 3.0;
X-Powered-By: ASP.NET
Strict-Transport-Security: max-age=31536000; includeSubDomains
Date: Wed, 18 Feb 2015 06:52:09 GMT

{"odata.metadata":"https://media.windows.net/api/$metadata#AccessPolicies/@Element","Id":"nb:pid:UUID:69c80d98-7830-407f-a9af-e25f4b0d3e5f","Created":"2015-02-18T06:52:09.8862191Z","LastModified":"2015-02-18T06:52:09.8862191Z","Name":"access policy","DurationInMinutes":43200.0,"Permissions":1}

Creare un localizzatore di streaming OnDemandCreate an OnDemand streaming locator

Creare il localizzatore per l'asset specificato e i relativi criteri.Create the locator for the specified asset and asset policy.

Richiesta:Request:

POST https://media.windows.net/api/Locators HTTP/1.1
Content-Type: application/json
DataServiceVersion: 1.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
Accept: application/json
Accept-Charset: UTF-8
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=amstest1&urn%3aSubscriptionId=zbbef702-e769-2233-9f16-bc4d3aa97387&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1424263184&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=NWE%2f986Hr5lZTzVGKtC%2ftzHm9n6U%2fxpTFULItxKUGC4%3d
x-ms-version: 2.17
x-ms-client-request-id: ac159492-9a0c-40c3-aacc-551b1b4c5f62
Host: media.windows.net
Content-Length: 181

{"AccessPolicyId":"nb:pid:UUID:1480030d-c481-430a-9687-535c6a5cb272","AssetId":"nb:cid:UUID:cc1e445d-1500-80bd-538e-f1e4b71b465e","StartTime":"2015-02-18T06:34:47.267872Z","Type":2}

Risposta:Response:

HTTP/1.1 201 Created
Cache-Control: no-cache
Content-Length: 637
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8
Location: https://media.windows.net/api/Locators('nb%3Alid%3AUUID%3Abe245661-2bbd-4fc6-b14f-9cf9a1492e5e')
Server: Microsoft-IIS/8.5
request-id: 5bd5864a-0afd-44c0-a67a-4044a2c9043b
x-ms-request-id: 5bd5864a-0afd-44c0-a67a-4044a2c9043b
x-ms-client-request-id: ac159492-9a0c-40c3-aacc-551b1b4c5f62
X-Content-Type-Options: nosniff
DataServiceVersion: 3.0;
X-Powered-By: ASP.NET
Strict-Transport-Security: max-age=31536000; includeSubDomains
Date: Wed, 18 Feb 2015 06:58:37 GMT

{"odata.metadata":"https://media.windows.net/api/$metadata#Locators/@Element","Id":"nb:lid:UUID:be245661-2bbd-4fc6-b14f-9cf9a1492e5e","ExpirationDateTime":"2015-03-20T06:34:47.267872+00:00","Type":2,"Path":"http://amstest1.streaming.mediaservices.windows.net/be245661-2bbd-4fc6-b14f-9cf9a1492e5e/","BaseUri":"http://amstest1.streaming.mediaservices.windows.net","ContentAccessComponent":"be245661-2bbd-4fc6-b14f-9cf9a1492e5e","AccessPolicyId":"nb:pid:UUID:1480030d-c481-430a-9687-535c6a5cb272","AssetId":"nb:cid:UUID:cc1e445d-1500-80bd-538e-f1e4b71b465e","StartTime":"2015-02-18T06:34:47.267872+00:00","Name":null}

Creare URL di streamingBuild streaming URLs

Usare il valore Path restituito dopo la creazione del localizzatore per creare gli URL Smooth, HLS e MPEG DASH.Use the Path value returned after the creation of the locator to build the Smooth, HLS, and MPEG DASH URLs.

Smooth Streaming: Path + nome file manifesto + "/manifest"Smooth Streaming: Path + manifest file name + "/manifest"

esempio:example:

http://amstest1.streaming.mediaservices.windows.net/3c5fe676-199c-4620-9b03-ba014900f214/BigBuckBunny.ism/manifest

HLS: Path + nome file manifesto + "/manifest(format=m3u8-aapl)"HLS: Path + manifest file name + "/manifest(format=m3u8-aapl)"

esempio:example:

http://amstest1.streaming.mediaservices.windows.net/3c5fe676-199c-4620-9b03-ba014900f214/BigBuckBunny.ism/manifest(format=m3u8-aapl)

DASH: Path + nome file manifesto + "/manifest(format=mpd-time-csf)"DASH: Path + manifest file name + "/manifest(format=mpd-time-csf)"

esempio:example:

http://amstest1.streaming.mediaservices.windows.net/3c5fe676-199c-4620-9b03-ba014900f214/BigBuckBunny.ism/manifest(format=mpd-time-csf)

Creare URL di download progressivoBuild progressive download URLs

Usare il valore Path restituito dopo la creazione del localizzatore per creare l'URL di download progressivo.Use the Path value returned after the creation of the locator to build the progressive download URL.

URL: Path + nome file mp4 assetURL: Path + asset file mp4 name

esempio:example:

http://amstest1.streaming.mediaservices.windows.net/3c5fe676-199c-4620-9b03-ba014900f214/BigBuckBunny_H264_650kbps_AAC_und_ch2_96kbps.mp4

Tipi enumEnum types

[Flags]
public enum AccessPermissions
{
    None = 0,
    Read = 1,
    Write = 2,
    Delete = 4,
    List = 8,
}

public enum LocatorType
{
    None = 0,
    Sas = 1,
    OnDemandOrigin = 2,
}

Percorsi di apprendimento di Servizi multimedialiMedia Services learning paths

Altre informazioni sui percorsi di apprendimento di Servizi multimediali di Azure:Read about the Azure Media Services learning paths:

Fornire commenti e suggerimentiProvide feedback

Usare il forum di suggerimenti degli utenti per fornire commenti e suggerimenti su come migliorare Servizi multimediali di Azure.Use the User Voice forum to provide feedback and make suggestions on how to improve Azure Media Services. È anche possibile passare direttamente a una delle categorie seguenti:You also can go directly to one of the following categories:

Vedere anche See also

Informazioni generali sull'API REST di Servizi multimedialiMedia Services operations REST API overview

Configurare i criteri di distribuzione dell'assetConfigure asset delivery policy