Terminologia e modifiche alle entità tra Servizi multimediali V2 e V3

logo della guida alla migrazione


passaggi di migrazione 2

Importante

Non è più necessario eseguire la migrazione da Servizio multimediale di Azure v2 a v3 come deprecazione dell'API V2 allineata al ritiro di Servizi multimediali di Azure. Per altre informazioni, vedere la guida al ritiro di Servizi multimediali di Azure .

Questo articolo descrive le differenze di terminologia tra Servizi multimediali di Azure v2 e v3.

Modifiche della terminologia

  • Un localizzatore è ora chiamato localizzatore di streaming.
  • Un canale è ora denominato evento live.
  • Un programma è ora denominato Output live.
  • Un'attività è ora denominata JobOutput, che fa parte di un processo.

Modifiche alle entità

Entità V2 Entità V3 Indicazioni Accessibile a V3 Aggiornato da V3
AccessPolicy L'entità AccessPolicies non esiste in V3. No No
Asset Asset
AssetDeliveryPolicy StreamingPolicy No
AssetFile L'entità AssetFiles non esiste in V3. Anche se i file (BLOB di archiviazione) caricati sono ancora considerati file.

Usare invece le API di archiviazione di Azure per enumerare i BLOB in un contenitore. Esistono due modi per applicare una trasformazione ai file con un processo:

File già caricati nell'archiviazione: l'URI include l'ID asset per i processi da eseguire sugli asset all'interno di un account di archiviazione.

File da caricare durante il processo di trasformazione e processo: l'asset viene creato nell'archiviazione, viene restituito un URL di firma di accesso condiviso, i file vengono caricati nell'archiviazione e quindi la trasformazione viene applicata ai file.
No No
Channel LiveEvent Eventi live sostituisci canali dall'API v2. Eseguono la maggior parte delle funzionalità e dispongono di nuove funzionalità come trascrizioni live, modalità stand-by e supporto per l'inserimento RTMPS.

Vedere l'evento live nello scenario di live streaming basato su
No No
ContentKey ContentKeys non è più un'entità, è ora una proprietà di un localizzatore di streaming.

In v3, i dati della chiave di contenuto sono associati a (per la crittografia di output) o l'asset stesso (per la crittografia dell'archiviazione StreamingLocator lato client).
No
ContentKeyAuthorizationPolicy ContentKeyPolicy No
ContentKeyAuthorizationPolicyOption ContentKeyPolicyOptions sono inclusi in ContentKeyPolicy. No
IngestManifest L'entità IngestManifests non esiste in V3. Il caricamento di file in V3 comporta l'API di archiviazione di Azure. Gli asset vengono prima creati e quindi i file vengono caricati nel contenitore di archiviazione associato. Esistono invece molti modi per ottenere dati in un contenitore di archiviazione di Azure che può essere usato. JobInputHttp fornisce anche un modo per scaricare un input del processo da un url specificato, se desiderato. No No
IngestManifestAsset Esistono invece molti modi per ottenere dati in un contenitore di archiviazione di Azure che può essere usato. JobInputHttp fornisce anche un modo per scaricare un input del processo da un url specificato, se desiderato. No No
IngestManifestFile Esistono invece molti modi per ottenere dati in un contenitore di archiviazione di Azure che può essere usato. JobInputHttp fornisce anche un modo per scaricare un input del processo da un url specificato, se desiderato. No No
Job Job Creare un oggetto Transform prima di creare un Joboggetto . No No
JobTemplate Transform Usare invece un oggetto Transform . Una trasformazione è un'entità separata da un processo ed è riutilizzabile. No No
Locator StreamingLocator No
MediaProcessor Invece di cercare l'oggetto MediaProcessor da usare per nome, usare il set di impostazioni desiderato durante la definizione di una trasformazione. Il set di impostazioni utilizzato determina il processore multimediale usato dal sistema del processo. Vedere gli argomenti di codifica nella codifica basata su scenari. No NA (readonly in V2)
NotificationEndPoint Le notifiche in v3 vengono gestite tramite Griglia di eventi di Azure. L'oggetto NotificationEndpoint viene sostituito dalla registrazione della sottoscrizione griglia di eventi che incapsula anche la configurazione per i tipi di notifiche da ricevere (che in v2 è stata gestita dall'oggetto JobNotificationSubscription Job, TaskNotificationSubscription dall'oggetto Task e dalla telemetria ComponentMonitoringSetting). I dati di telemetria v2 sono stati suddivisi tra Griglia di eventi di Azure e Monitoraggio di Azure per adattarsi ai miglioramenti dell'ecosistema di Azure più grande. No No
Program LiveOutput Gli output live sostituiscono ora programmi nell'API v3. No No
StreamingEndpoint StreamingEndpoint Gli endpoint di streaming rimangono principalmente gli stessi. Vengono usati per la creazione dinamica di pacchetti, crittografia e distribuzione di contenuti HLS e DASH sia per lo streaming live che su richiesta direttamente dall'origine o tramite la rete CDN. Le nuove funzionalità includono il supporto per migliorare l'integrazione e il grafico di Monitoraggio di Azure.
Task JobOutput Sostituito da JobOutput (che non è più un'entità separata nell'API). Vedere gli argomenti di codifica nella codifica basata su scenari. No No
TaskTemplate TransformOutput Sostituito da TransformOutput (che non è più un'entità separata nell'API). Vedere gli argomenti di codifica nella codifica basata su scenari. No No
Inputs Inputs Gli input e gli output sono ora a livello di processo. Vedere gli argomenti di codifica nella codifica basata su scenari No No
Outputs Outputs Gli input e gli output sono ora a livello di processo. Nella versione 3 il formato dei metadati è cambiato da XML a JSON. Gli output live iniziano al momento della creazione e terminano quando vengono eliminati. Vedere gli argomenti di codifica nella codifica basata su scenari No No
Altre modifiche V2 V3
Archiviazione
Archiviazione Gli SDK V3 sono ora separati da Storage SDK, che offre un maggiore controllo sulla versione di Storage SDK che si vuole usare ed evita problemi di controllo delle versioni.
Codifica
Velocità di bit di codifica velocità in bit misurata in kbps, ad esempio 128 (kbps) bit al secondo, ad esempio 128000 (bit al secondo)
Codifica DRM FairPlay In Servizi multimediali V2 è possibile specificare il vettore di inizializzazione (IV). In Servizi multimediali V3 non è possibile specificare FairPlay IV.
Codificatore Premium Codificatore Premium e indicizzatore legacy Il codificatore Premium e i processori di analisi multimediale legacy (Anteprima di Azure Media Services Indexer 2, Face Redactor e così via) non sono accessibili tramite V3. È stato aggiunto il supporto per il mapping dei canali audio al codificatore Standard. Vedere Audio nella documentazione di Swagger di codifica di Servizi multimediali.
Vedere gli argomenti di codifica nella codifica basata su scenari
Trasformazioni e processi
HTTPS per l'elaborazione basata su processi Per l'elaborazione di processi basati su file, è possibile usare un URL HTTPS come input. Non è necessario che il contenuto sia già archiviato in Azure né sia necessario creare asset.
Modelli di Resource Manager per i processi I modelli arm non esistevano nella versione 2. Una trasformazione può essere usata per creare configurazioni riutilizzabili, per creare modelli di Resource Manager di Azure e isolare le impostazioni di elaborazione tra più clienti o tenant.
Eventi live
Endpoint di streaming Un endpoint di streaming rappresenta un servizio di streaming in grado di distribuire contenuti direttamente a un'applicazione lettore client o a una rete per la distribuzione di contenuti (CDN) per un'ulteriore distribuzione. Gli endpoint di streaming rimangono principalmente gli stessi. Vengono usati per la creazione dinamica di pacchetti, la crittografia e la distribuzione di contenuti HLS e DASH sia per lo streaming live che su richiesta direttamente dall'origine o tramite la rete CDN. Le nuove funzionalità includono il supporto per una migliore integrazione e creazione di grafici in Monitoraggio di Azure.
Canali di eventi live I canali sono responsabili dell'elaborazione di contenuti in streaming live. Un'entità Channel, o canale, fornisce un endpoint di input (URL di inserimento) che può essere a sua volta fornito al transcodificatore live. Il canale riceve flussi di input live dal transcoder live e lo rende disponibile per lo streaming tramite uno o più endpoint di streaming. I canali forniscono anche un endpoint di anteprima(URL di anteprima) che consente di visualizzare in anteprima e convalidare il flusso prima dell'ulteriore elaborazione e del recapito. Gli eventi live sostituiscono canali dall'API v2. Eseguono la maggior parte delle funzionalità e hanno altre nuove funzionalità, ad esempio trascrizioni in tempo reale, modalità stand-by e supporto per l'inserimento RTMPS.
Programmi di eventi live Il programma consente di controllare la pubblicazione e l'archiviazione di segmenti in un flusso live. I programmi sono gestiti dai canali. La relazione tra queste due entità è simile a quella che intercorre tra di essi nei media tradizionali, in cui un canale è costituito da un flusso costante di contenuti, mentre un programma ha come ambito una serie di eventi programmati sul canale. È possibile specificare il numero di ore per cui si desidera mantenere il contenuto registrato per il programma impostando la ArchiveWindowLength proprietà . Il valore impostato può essere compreso tra 5 minuti e 25 ore. Gli output live sostituiscono ora i programmi nell'API v3.
Lunghezza dell'evento live È possibile trasmettere gli eventi live 24/7 quando si usa Servizi multimediali per la transcodifica di un feed di contributi a velocità in bit singola in un flusso di output con più velocità in bit.
Latenza degli eventi live Nuovo supporto per lo streaming live a bassa latenza sugli eventi live.
Anteprima eventi live L'anteprima degli eventi live supporta la creazione dinamica dei pacchetti e la crittografia dinamica. Questo consente la protezione del contenuto nell'anteprima, nonché la creazione di pacchetti DASH e HLS.
Evento live RTMPS Miglioramento del supporto RTMPS con maggiore stabilità e maggiore supporto del codificatore di origine.
Inserimento sicuro RTMPS per eventi live Quando si crea un evento live, si ottengono 4 URL di inserimento. Gli URL di inserimento 4 sono quasi identici, hanno lo stesso token AppIddi streaming, ma solo la parte del numero di porta è diversa. Due URL sono primari e due sono di backup per RTMPS.
Trascrizione di eventi live Servizi multimediali di Azure offre video, audio e testo in protocolli diversi. Quando si pubblica il flusso live usando MPEG-DASH o HLS/CMAF, quindi insieme a video e audio, il servizio fornisce il testo trascritto in IMSC1.1 compatibile con TTML.
Modalità standby degli eventi live Non era disponibile la modalità standby per la versione 2. La modalità stand-by è una nuova funzionalità v3 che consente di gestire pool di eventi live ad accesso frequente. I clienti possono ora avviare un evento live in modalità stand-by a costi inferiori prima di passare allo stato di esecuzione. In questo modo si migliorano i tempi di avvio del canale e si riducono i costi dei pool di accesso frequente per le start up più veloci.
Fatturazione degli eventi live La fatturazione degli eventi live si basa sui contatori del canale live.
Output live I programmi devono essere avviati dopo la creazione. Gli output live iniziano al momento della creazione e terminano quando vengono eliminati.

Guida e supporto tecnico

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