Risolvere i problemi relativi a Servizi multimediali
Avviso
Servizi multimediali di Azure verrà ritirato il 30 giugno 2024. Per altre informazioni, vedere la Guida al ritiro di AMS.
Individuare le cause e le soluzioni per i problemi relativi a Servizi multimediali.
Nota
Molti problemi possono essere risolti eseguendo la migrazione all'API di Servizi multimediali v3 o leggendo la guida alle procedure consigliate per lo streaming live.
Problemi relativi all'account
| Causa | Soluzione |
|---|---|
| È possibile provare a usare le funzionalità dell'API v3 con un account v2 o un'implementazione dell'API v2. | Aggiornare il codice per usare l'API v3. Per assistenza più dettagliata, vedere la Guida alla migrazione. |
Problemi comuni di riproduzione video
- L'inizio della riproduzione dei video richiede molto tempo.
- I video sono sfocati quando iniziano a riprodurre.
- La qualità video è bassa.
- Il video non viene riprodotto affatto o mostra una schermata nera.
| Causa | Soluzione |
|---|---|
| È possibile che si stia tentando di raggiungere un gruppo di destinatari di grandi dimensioni senza usare una rete CDN che causa problemi di latenza. | Aggiungere una rete CDN al localizzatore di streaming. Per altre informazioni sull'uso di una rete CDN, vedere Trasmettere contenuto con l'integrazione della rete CDN. |
| È possibile che non sia stata implementata la creazione dinamica dei pacchetti. | Per altre informazioni sull'implementazione della creazione dinamica dei pacchetti, vedere Creazione dinamica dei pacchetti in Servizi multimediali v3. |
| Si potrebbe avere ciò che è noto come "vicini rumorosi", il che significa che si stanno condividendo le risorse di calcolo con altri clienti. | Per evitare l'aggiornamento di "vicini rumorosi" da un endpoint di streaming standard a un endpoint di streaming Premium con unità di streaming dedicate. |
| È possibile usare un browser precedente per visualizzare i video. | Aggiornare il browser. |
| È possibile usare un lettore e filtri di terze parti. | Aggiungere audio-only=false all'URL di streaming come indicato di seguito https://streamingtest.streaming.media.azure.net/00000000-0000-0000-0000-000000000000/sample.ism/manifest(format-m3u8-aapl,audio-only=false) |
Non è possibile riprodurre un file MP4 dall'asset
| Causa | Soluzione |
|---|---|
| Servizi multimediali di Azure è progettato per usare un file manifesto anziché riprodurre direttamente flussi MP4 di dimensioni intere. Il file manifesto indica al lettore quali frammenti multimediali codificati riprodurre e in quale ordine. | Usare uno dei codificatori multimediali forniti per creare frammenti multimediali e file manifesto. Per altre informazioni sulla codifica, vedere Codifica compatibile con il contenuto e Codifica con una codifica a velocità in bit generata automaticamente . |
| Il nome del file contiene caratteri riservati. | Rimuovere i caratteri riservati dal nome del file. |
Caratteri riservati
- Servizi multimediali usa il valore del nome del file di asset durante la compilazione di URL per lo streaming del contenuto. Per questo motivo, la codifica percentuale non è consentita. Il valore della proprietà name non può contenere uno dei caratteri riservati per la codifica percentuale seguenti: !*'();:@&=+$,/?%#[]". L'estensione del nome di file, inoltre, può essere preceduta da un solo punto (.).
- La lunghezza del nome non deve essere superare i 260 caratteri.
Il contenuto crittografato non verrà riprodotto in modalità offline.
| Causa | Soluzione |
|---|---|
| Il lettore usato per riprodurre i video crittografati AES scaricati in modalità offline nei dispositivi iOS gestisce la modalità di riproduzione dei video. La causa non è con Servizi multimediali. | Esaminare la documentazione per il lettore video offline scelto. |
L'audio non è sincronizzato.
| Causa | Soluzione |
|---|---|
| I pacchetti video vengono recapitati in ritardo. | Soluzioni possibili: 1. È possibile che sia stato implementato un criterio di controllo delle versioni di archiviazione attivato automaticamente che causa la memorizzazione nel buffer e la disconnessione. Rimuovere i criteri e disattivare il controllo delle versioni di archiviazione automatica. 2. Abilitare una rete CDN. 3. Usare un endpoint di streaming Premium con unità riservate sufficienti. |
La richiesta del lettore per il file VTT ha causato errori CORS.
| Causa | Soluzione |
|---|---|
| Configurazione delle regole CORS | Configurare le regole CORS per l'account di archiviazione o la rete CDN. |
Yuu può anche ottenere l'URL di download del file VTT dall'asset.
Un endpoint di streaming non verrà avviato.
| Causa | Soluzione |
|---|---|
| È possibile che sia stato creato un criterio personalizzato che abilita solo HTTPS. Questo non è attualmente supportato da Servizi multimediali. | Possibili soluzioni alternative: 1. Nella portale di Azure disabilitare i criteri personalizzati. 2. Creare un endpoint di streaming con una rete CDN abilitata e disabilitare HTTP per l'endpoint della rete CDN. Or 1. Non abilitare la rete CDN per l'endpoint di streaming con il portale o l'API. 2. Passare invece alla pagina della rete CDN di Azure nella portale di Azure o usare l'API della rete CDN di Azure per creare un endpoint che punti all'endpoint di Servizi multimediali, impostando l'origine per l'endpoint della rete CDN sul nome host per l'endpoint di streaming. |
| È possibile che sia stato arrestato un endpoint di streaming con una rete CDN. | Vedere Endpoint di streaming non interrotto |
Un endpoint di streaming con una rete CDN non verrà arrestato.
| Causa | Soluzione |
|---|---|
| Quando si abilita la rete CDN per qualsiasi endpoint di streaming, l'endpoint della rete CDN non verrà creato fino a quando non si avvia l'endpoint di streaming. Questo è il motivo per cui durante il processo di avvio la piattaforma creerà gli endpoint della rete CDN e li collega all'endpoint di streaming ,inclusa la configurazione del nome host personalizzato. Durante il processo di arresto per l'endpoint di streaming, la piattaforma deve eliminare l'endpoint della rete CDN. Pertanto, se l'endpoint di streaming è in stato di arresto, l'endpoint della rete CDN non esisterà né punterà all'endpoint di streaming. In alcuni scenari, tuttavia, quando AMS chiama la rete CDN per eliminare gli endpoint della rete CDN, non riesce a eliminare gli endpoint a causa di cache nella rete CDN. Ciò comporta un problema di conflitto con il nome host se l'endpoint della rete CDN è ancora presente e attiva il problema dell'endpoint di arresto dello streaming. |
Eliminare manualmente il profilo della rete CDN e quindi eliminare l'endpoint di streaming e impostarne uno nuovo. |
Gli endpoint di streaming non vengono visualizzati dopo lo spostamento dell'account in una sottoscrizione diversa.
| Causa | Soluzione |
|---|---|
| Ci vuole del tempo per spostare gli endpoint di streaming nella nuova sottoscrizione. | Attendere 2 ore e verificare che gli endpoint di streaming siano visualizzati nella nuova sottoscrizione. |
Il codificatore locale non invia dati all'evento live.
| Causa | Soluzione |
|---|---|
| È possibile usare un codificatore che non è stato testato con Servizi multimediali. | Vedere Codificatori di streaming live locali verificati. |
| Il codificatore locale potrebbe non essere configurato correttamente. | Verificare di aver configurato correttamente il codificatore locale. |
La codifica sembra impiegare molto tempo.
La maggior parte dei problemi di durata della codifica può essere risolta configurando le impostazioni del codificatore per controllare l'equilibrio tra velocità e qualità. Per la codifica più veloce, impostarla sulla modalità velocità .
| Causa | Soluzione |
|---|---|
| Il file mezzanino può essere molto grande. Le dimensioni del file sono uguali al bitrate moltiplicato per durata. | Nessuno |
| Esistono un numero elevato di livelli di output. | Ridurre il numero di livelli di output. |
| I livelli di output hanno una risoluzione elevata. | Ridurre la risoluzione del livello di output al bitrate che si intende trasmettere i supporti. |
| Il file mezzanino può essere complesso, soprattutto se si codifica un file di risoluzione 4k. | Nessuno |
Errori di trasformazione
| Causa | Soluzione |
|---|---|
| Potrebbe essere stata superata la quota per le trasformazioni per ogni account che è 100. | Eliminare trasformazioni inutilizzate. |
Non è possibile caricare supporti
Non è possibile caricare supporti in un account di archiviazione.
| Causa | Soluzione |
|---|---|
| Si sta tentando di usare HTTP. | Usa HTTPS. Il protocollo HTTP non è più supportato per il caricamento del contenuto. |
| Non è in attesa sufficiente per la distribuzione dell'account di archiviazione. | Se è stato creato l'account di archiviazione a livello di codice, aggiungere codice per verificare che l'account di archiviazione venga distribuito prima di tentare di caricare supporti. |
Problemi CORS
| Causa | Soluzione |
|---|---|
| Se si sta tentando di usare le richieste di pre-volo contenenti intestazioni traceparent, si riceveranno errori CORS. In questo momento, Servizi multimediali non supporta le richieste preliminari. | Siamo consapevoli che le richieste preliminari sono di valore ai nostri clienti. Non usare le richieste preliminari fino a quando la funzionalità non è disponibile. |
Problemi di connessione dell'account di archiviazione
Stato disconnesso
Lo stato "Disconnesso" per un account Servizi multimediali indica che l'account non ha più accesso a uno o più degli account di archiviazione collegati a causa di una modifica alle chiavi di accesso alle risorse di archiviazione. Sono necessarie chiavi di accesso alle risorse di archiviazione aggiornate in Servizi multimediali per eseguire molte attività nell'account.
Di seguito sono riportati gli scenari principali che potrebbero comportare il mancato accesso, da parte di un account di Servizi multimediali, agli account di archiviazione collegati.
| Causa | Soluzione |
|---|---|
| L'account di Servizi multimediali o gli account di archiviazione collegati sono stati migrati per separare le sottoscrizioni. | Eseguire la migrazione degli account di archiviazione o dell'account di Servizi multimediali in modo che siano tutti nella stessa sottoscrizione o usare l'identità gestita per l'autenticazione dell'account di archiviazione se l'account di archiviazione si trova nello stesso tenant. |
| L'account di Servizi multimediali usa un account di archiviazione associato in un'altra sottoscrizione perché si tratta di un account Servizi multimediali iniziale in cui l'account di archiviazione era già precedentemente supportato. Tutti gli account di Servizi multimediali iniziali sono stati convertiti in account basati su Azure Resources Manager moderni e avranno uno stato Disconnesso. | Eseguire la migrazione dell'account di archiviazione o dell'account di Servizi multimediali in modo che siano tutti nella stessa sottoscrizione o usino l'identità gestita per l'autenticazione dell'account di archiviazione se l'account di archiviazione si trova nello stesso tenant. |
L'account di Servizi multimediali non può accedere all'account di archiviazione
| Causa | Soluzione |
|---|---|
| L'identità gestita di Servizi multimediali non è stata assegnata al ruolo Collaboratore dati BLOB di archiviazione. | Per controllare questo problema nel portale di Azure, individuare prima di tutto quale identità è impostata per l'account di archiviazione selezionando "Account di archiviazione" dal menu dell'account Servizi multimediali, questo deve essere "Assegnato dal sistema" o il nome di un'identità gestita assegnata dall'utente. Passare quindi all'account di archiviazione nel portale, selezionare "Controllo di accesso (IAM)" dal menu, selezionare "Assegnazioni di ruolo" dalla barra degli strumenti, quindi aggiungere l'assegnazione di ruolo. Quando si aggiunge l'assegnazione di ruolo, il ruolo deve essere impostato su "Collaboratore dati BLOB di archiviazione" e i membri devono essere impostati sull'identità gestita usata dall'account servizi multimediali per accedere all'account di archiviazione. Dopo aver aggiunto l'assegnazione di ruolo, la modifica potrebbe richiedere alcuni minuti. |
Azure Media Indexer 2 non viene restituito nell'elenco dei processori multimediali.
| Causa | Soluzione |
|---|---|
| Azure Media Indexer 2 è stato deprecato il 1° gennaio 2020. | Eseguire la migrazione all'API Servizi multimediali v3. |
Un errore di rete ha causato il download del video in modo non riuscita.
| Causa | Soluzione |
|---|---|
| Questo errore è in genere il risultato dei problemi di connessione di rete sul lato client e non con Servizi multimediali. | Contattare l'amministratore di rete o usare il debug del browser Fiddler o F12 per visualizzare l'errore sottostante. |
Download di problemi
Potrebbe essere stato ricevuto l'errore seguente:
"Durante il tentativo di scaricare i file di input, i file non sono stati accessibili, verificare la disponibilità dell'origine"
| Causa | Soluzione |
|---|---|
| Se si usa un token di firma di accesso condiviso per accedere al file, potrebbe essere scaduto. | Modificare il codice per verificare che il token non sia scaduto prima di usarlo per l'autenticazione. |
Errori 5xx eccessivi e intermittenti
| Causa | Soluzione |
|---|---|
| La codifica locale potrebbe essere stata implementata in modo non corretto. | Verificare che il codificatore sia configurato correttamente. |
| È possibile usare un codificatore locale non testato | Usare un codificatore locale testato e verificare che sia configurato correttamente. |
| Il rapporto di memorizzazione nella cache tra endpoint di streaming e rete CDN potrebbe non essere sufficiente. | 1. Modificare il rapporto di memorizzazione nella cache in modo che la rete CDN gestisca più traffico. 2. Modificare la regola di ottimizzazione del flusso per la rete CDN. |
| La configurazione del filtro potrebbe non essere corretta. | Verificare che i filtri siano configurati correttamente. |
Vedere la guida alle procedure consigliate per lo streaming live.
Errori generali del codice
È possibile che si verifichino errori nel codice che non sono coperti dai codici di errore dell'endpoint di streaming, dai codici di errore degli eventi live o dai codici di errore del processo .
| Causa | Soluzione |
|---|---|
| È possibile provare a usare un oggetto, una proprietà o un metodo non incluso in una versione precedente dell'API. | Aggiornare la libreria API nell'ambiente di sviluppo. |
Se non è stata trovata la soluzione al problema, contattare il supporto di Servizi multimediali.
Guida e supporto tecnico
È possibile contattare Servizi multimediali con domande o seguire gli aggiornamenti in base a uno dei metodi seguenti:
- DOMANDE E RISPOSTE
- Stack Overflow. Contrassegna le domande con
azure-media-services. - @MSFTAzureMedia o usare @AzureSupport per richiedere supporto.
- Aprire un ticket di supporto tramite il portale di Azure.