Condividi tramite

Sviluppare con le API di Servizi multimediali v3

  • Articolo

logo di Servizi multimediali v3

Avvertimento

Servizi multimediali di Azure verrà ritirato il 30 giugno 2024. Per altre informazioni, vedere la Guida al ritiro di AMS .

Gli sviluppatori possono usare librerie client per (.NET, Python, Node.js, Java e Go) che consentono di interagire con l'API REST per creare, gestire e gestire facilmente flussi di lavoro multimediali personalizzati.

Questo articolo illustra le regole applicabili alle entità e alle API durante lo sviluppo con Servizi multimediali v3.

Avvertimento

Non è consigliabile tentare di eseguire il wrapping dell'API REST per Servizi multimediali direttamente nel codice della libreria, perché in questo modo, a scopo di produzione, è necessario implementare la logica di ripetizione dei tentativi di Gestione risorse di Azure completa e comprendere come gestire le operazioni a esecuzione prolungata nelle API di Gestione risorse di Azure. Questa operazione viene gestita dagli SDK client per diversi linguaggi, .NET, Java, TypeScript, Python e così via, riducendo automaticamente le probabilità di problemi con la logica di ripetizione dei tentativi o le chiamate API non riuscite. Gli SDK client gestiscono tutto questo già.

Accesso all'API di Servizi multimediali di Azure

Per poter accedere alle risorse di Servizi multimediali e all'API servizi multimediali, è necessario prima essere autenticati. Servizi multimediali supporta 'autenticazione basata su Azure Active Directory (Azure AD). Due opzioni di autenticazione comuni sono:

  • 'autenticazione dell'entità servizio: usato per autenticare un servizio, ad esempio app Web, app per le funzioni, app per la logica, API e microservizi. Le applicazioni che usano in genere questo metodo di autenticazione sono app che eseguono servizi daemon, servizi di livello intermedio o processi pianificati. Ad esempio, per le app Web deve essere sempre presente un livello intermedio che si connette a Servizi multimediali con un'entità servizio.
  • autenticazione utente: usato per autenticare una persona che usa l'app per interagire con le risorse di Servizi multimediali. L'app interattiva deve prima richiedere all'utente le credenziali dell'utente. Un esempio è un'app console di gestione usata dagli utenti autorizzati per monitorare i processi di codifica o lo streaming live.

L'API servizi multimediali richiede che l'utente o l'app che effettua le richieste dell'API REST abbiano accesso alla risorsa dell'account di Servizi multimediali e usino un collaboratore o ruolo proprietario. È possibile accedere all'API con il ruolo di lettore di, ma saranno disponibili solo operazioni get o List. Per altre informazioni, vedere controllo degli accessi in base al ruolo di Azure per gli account di Servizi multimediali.

Anziché creare un'entità servizio, prendere in considerazione l'uso di identità gestite per le risorse di Azure per accedere all'API di Servizi multimediali tramite Azure Resource Manager. Per altre informazioni sulle identità gestite per le risorse di Azure, vedere Informazioni sulle identità gestite per le risorse di Azure.

Entità servizio di Azure AD

L'app Azure AD e l'entità servizio devono trovarsi nello stesso tenant. Dopo aver creato l'app, concedere all'app collaboratore o ruolo Proprietario all'account di Servizi multimediali.

Se non si è certi di avere le autorizzazioni per creare un'app Azure AD, vedere Autorizzazioni necessarie.

Nella figura seguente i numeri rappresentano il flusso delle richieste in ordine cronologico:

'autenticazione dell'app di livello intermedio con AAD da un'API Web

  1. Un'app di livello intermedio richiede un token di accesso di Azure AD con i parametri seguenti:

    • Endpoint del tenant di Azure AD.
    • URI della risorsa di Servizi multimediali.
    • URI della risorsa per Servizi multimediali REST.
    • Valori dell'app Azure AD: ID client e segreto client.

    Per ottenere tutti i valori necessari, vedere Access Azure Media Services API.

  2. Il token di accesso di Azure AD viene inviato al livello intermedio.

  3. Il livello intermedio invia una richiesta all'API REST di Azure Media con il token di Azure AD.

  4. Il livello intermedio recupera i dati da Servizi multimediali.

Campioni

Vedere gli esempi seguenti che illustrano come connettersi con l'entità servizio di Azure AD:

Convenzioni di denominazione

I nomi delle risorse di Servizi multimediali di Azure v3 (ad esempio, Asset, processi, trasformazioni) sono soggetti a vincoli di denominazione di Azure Resource Manager. In conformità con Azure Resource Manager, i nomi delle risorse sono sempre univoci. È quindi possibile usare qualsiasi stringa di identificatore univoco (ad esempio GUID) per i nomi delle risorse.

I nomi delle risorse di Servizi multimediali non possono includere: '<', '>', '%', '&', ':', '\', '?', '/', '*', '+', '.', il carattere virgolette singole o qualsiasi carattere di controllo. Sono consentiti tutti gli altri caratteri. La lunghezza massima di un nome di risorsa è di 260 caratteri.

Per altre informazioni sulla denominazione di Azure Resource Manager, vedere requisiti di denominazione e convenzioni di denominazione .

Nomi di file/BLOB all'interno di un asset

I nomi di file/BLOB all'interno di un asset devono rispettare sia i requisiti dei nomi BLOB che i requisiti dei nomi NTFS . Il motivo di questi requisiti è che i file possono essere copiati dall'archivio BLOB a un disco NTFS locale per l'elaborazione.

Operazioni a esecuzione prolungata

Le operazioni contrassegnate con x-ms-long-running-operation nei file swagger di Servizi multimediali di Azure sono operazioni a esecuzione prolungata.

Per informazioni dettagliate su come tenere traccia delle operazioni asincrone di Azure, vedere operazioni asincrone.

Servizi multimediali dispone delle operazioni seguenti a esecuzione prolungata:

Al termine dell'invio di un'operazione lunga, si riceve un '201 Created' e si deve eseguire il polling per il completamento dell'operazione usando l'ID operazione restituito.

L'articolo tenere traccia delle operazioni asincrone di Azure illustra in dettaglio come tenere traccia dello stato delle operazioni asincrone di Azure tramite i valori restituiti nella risposta.

Per un determinato evento live o per uno dei relativi output live associati è supportata una sola operazione a esecuzione prolungata. Una volta avviata, è necessario completare un'operazione a esecuzione prolungata prima di avviare un'operazione a esecuzione prolungata successiva sullo stesso LiveEvent o sugli output live associati. Per gli eventi live con più output live, è necessario attendere il completamento di un'operazione a esecuzione prolungata su un output live prima di attivare un'operazione a esecuzione prolungata su un altro output live.

SDK

Nota

Gli SDK di Servizi multimediali di Azure v3 non sono garantiti come thread-safe. Quando si sviluppa un'app multithread, è necessario aggiungere la logica di sincronizzazione dei thread personalizzata per proteggere il client o usare un nuovo oggetto AzureMediaServicesClient per ogni thread. È anche consigliabile prestare attenzione ai problemi di multithreading introdotti da oggetti facoltativi forniti dal codice al client , ad esempio un'istanza HttpClient in .NET.

SDK Riferimento
.NET SDK di riferimento .NET
Java SDK di riferimento Java
Python SDK di riferimento Python
Node.js SDK Node.js ref
Go SDK Go ref

Vedere anche

Esplora servizi multimediali di Azure

Azure Media Services Explorer (AMSE) è uno strumento disponibile per i clienti Windows che vogliono ottenere informazioni su Servizi multimediali. AMSE è un'applicazione Winforms/C# che esegue il caricamento, il download, la codifica, lo streaming di contenuti VOD e live con Servizi multimediali. Lo strumento AMSE è destinato ai client che vogliono testare Servizi multimediali senza scrivere codice. Il codice AMSE viene fornito come risorsa per i clienti che vogliono sviluppare con Servizi multimediali.

AMSE è un progetto open source, il supporto viene fornito dalla community (i problemi possono essere segnalati a https://github.com/Azure/Azure-Media-Services-Explorer/issues). Questo progetto ha adottato la codice di comportamento Microsoft Open Source. Per altre informazioni, vedere domande frequenti sul codice di comportamento o contattare opencode@microsoft.com con eventuali altre domande o commenti.

Filtro, ordinamento, paging delle entità di Servizi multimediali

Vedere Filtro, ordinamento, paging delle entità di Servizi multimediali di Azure.

Ottenere assistenza e supporto tecnico

È possibile contattare Servizi multimediali con domande o seguire gli aggiornamenti in uno dei metodi seguenti: