Skip to content

playback stream policy it

alvit edited this page Oct 22, 2026 · 1 revision

Limiti di qualità e recupero dei flussi in diretta

English · العربية · বাংলা · Čeština · Deutsch · Español · فارسی · Français
עברית · हिन्दी · Bahasa Indonesia · Italiano · 日本語 · 한국어 · Nederlands · Polski
Português · Русский · ไทย · Türkçe · Українська · Tiếng Việt · 简体中文 · 繁體中文

Proprietà del decoder

Il lettore HTML5/HLS/Shaka gestito mantiene un solo diritto di riproduzione mentre recupera da una sorgente guasta. Può inoltre usare fino a tre URL di riserva configurati esplicitamente per un canale in diretta. Non scopre, indovina o sostituisce mai un canale in base al titolo.

Recupero: un diritto di riproduzione, tentativi finiti e riserve esplicite

Impostare un limite di qualità

Aprire Impostazioni → Impostazioni interfaccia e impostare Altezza video massima (HLS/Shaka) e/o Bitrate massimo del flusso (HLS/Shaka). I due vincoli si applicano insieme. Automatico rimuove il vincolo corrispondente. Le scelte supportate sono 360/480/720/1080/2160 pixel e 1/2/4/8/16 Mbps. Le impostazioni sono salvate localmente, seguono il normale flusso salva/annulla e si applicano al successivo avvio della riproduzione, incluso un riavvio di recupero.

Sono limiti superiori, non impostazioni di transcodifica. Un flusso disponibile solo in 1080p non diventa 720p. Se nessuna variante dichiarata soddisfa i limiti, il lettore segnala No stream meets the quality limits e smette di ritentare la richiesta. Altezza/bitrate sconosciuti non dimostrano che una variante HLS rispetti il vincolo.

Il filtraggio delle varianti HLS precede il caricamento dei frammenti. L'hls.js attuale elimina le varianti non idonee; le vecchie versioni senza removeLevel possono conservare solo un prefisso contiguo sicuro e rifiutare un manifesto con varianti successive altrimenti idonee. Shaka usa i vincoli applicativi maxHeight/maxBandwidth. L'adattamento automatico continua fra le varianti rimaste.

Le impostazioni valgono per i motori HLS e Shaka gestiti. HTML5 semplice, decoder nativi di piattaforma e motori TV/STB mantenuti non espongono gli stessi controlli. Auto può scegliere la riproduzione nativa; l'impostazione non la forza a MSE. Il lettore non sposta una richiesta HLS già vincolata su una riproduzione nativa senza limiti solo per aggirare un errore di decodifica. Non sono impliciti un transcodificatore nativo, un benchmark hardware automatico o una garanzia di uscita fisica a 720p.

Configurare riserve esplicite

  1. Avviare il canale in diretta desiderato.
  2. Aprire Informazioni → Flussi di riserva.
  3. Selezionare lo spazio 1, 2 o 3 e inserire un URL multimediale HTTP/HTTPS completo.
  4. Riaprire uno spazio occupato per Modificare o Eliminare. Avviare di nuovo il canale per usare l'elenco aggiornato.

Ogni spazio appartiene al namespace di archiviazione del provider corrente e alla coppia esatta sourceId/channelId. La generazione di riproduzione e la configurazione della sorgente correnti delimitano l'editor. Cambiare sorgente con un dialogo aperto impedisce a quel dialogo di salvare nella sorgente sostitutiva. Una modifica concorrente allo stesso spazio viene rifiutata invece di sovrascritta.

Il primo URL rimane la sorgente ordinaria del canale. Gli spazi duplicati e vuoti vengono saltati. Si accettano al massimo 256 record di canale e 256 KiB di configurazione. Si rifiutano URL con credenziali user-info, spazi bianchi, caratteri di controllo, barre inverse o porta non valida. I token di query del provider possono comunque far parte di un URL multimediale: queste impostazioni sono configurazione locale della sorgente, non un meccanismo per condividere o pubblicare credenziali.

Le riserve valgono solo per la diretta. Le richieste archivio e VOD non usano mai un'alternativa in diretta: registrazione, origine temporale, diritti e semantica di ricerca possono differire. Il proprietario deve fornire endpoint live equivalenti e autorizzati. Un titolo di canale uguale non prova l'equivalenza. Identità salvata del canale, preferiti e associazione EPG restano invariati quando cambia l'endpoint di trasporto.

Garanzie di recupero

  • La richiesta ha al massimo due tentativi transitori differiti sullo stesso URL in totale e al massimo un avanzamento verso ciascuno dei tre spazi di riserva: non più di cinque ricreazioni dopo l'avvio iniziale. Una nuova istanza del decoder o un manifesto riuscito non azzerano il budget. Il recupero HLS limitato di rete e decodifica interno al motore precede questa politica esterna.
  • Errori di analisi di manifesto/livello HLS consentono al massimo una riconnessione allo stesso URL per richiesta, conteggiata nello stesso totale di due tentativi. Un nuovo decoder o endpoint di riserva non azzera questo limite.
  • Errori di rete senza stato, HTTP 408/429 e 5xx possono usare il budget transitorio. Altri HTTP 4xx possono avanzare a un'alternativa configurata, ma non ritentano lo stesso URL. HTTP 401/403 ed errori di accesso alla sorgente terminano la richiesta, senza provare credenziali alternative o endpoint di riserva.
  • Errori di decodifica possono avanzare a una riserva esplicita. Limiti di qualità impossibili terminano la richiesta. Non si torna ciclicamente alla sorgente primaria.
  • Il ritardo è 500 ms, 1 s, 1.5 s, poi al massimo 2 s. Le callback ripetute vengono accorpate.
  • Pause rimuove il timer pianificato mantenendo il tentativo in attesa; Resume lo pianifica di nuovo. Stop, standby e sostituzione di sorgente o canale invalidano le callback differite. Una richiesta fallita definitivamente richiede una nuova selezione esplicita, non la riproduzione automatica del decoder ritirato.
  • Errori di caricamento Shaka ed eventi di errore critici condividono questo percorso; gli errori di annullamento vengono ignorati. Il ricollegamento attende la distruzione asincrona di Shaka.
  • Il recupero risolve nuovamente un riferimento opaco Stalker e prepara di nuovo l'accesso protetto alla sorgente. Non riutilizza URL loopback iOS scaduti. La posizione VOD/archivio viene rilevata prima dello smontaggio; le riserve live partono dal loro limite attuale della diretta.

La politica non introduce un secondo sorvegliante dei fotogrammi bloccati. Il recupero esistente kiosk, Auto/native e HLS continua a coprire i propri casi di guasto osservati. Un flusso che si blocca silenziosamente senza errori segnalati dai rilevatori esistenti richiede una diagnosi separata.

Verifica e osservabilità

window.__ottStreamPolicy.snapshot() espone nome del motore, limiti richiesti, capacità/disponibilità, numero di tentativi, indice dell'endpoint e stato di recupero. Non contiene URL del flusso né credenziali del provider. L'indice zero indica la sorgente ordinaria; i successivi le alternative uniche non vuote. È stato diagnostico, non un'API stabile di controllo remoto.

Eseguire:

node tests/test_stream_policy.cjs
node tests/test_port_engine_lifecycle.cjs
node tests/test_settings_parity.cjs
node tests/test_media_backend.cjs
npm run test:localization
npm run typecheck
npm run build:server
node scripts/check-es5.cjs --server-only

I test esercitano filtraggio di qualità con ordine non monotono delle varianti, metadati indisponibili, modifica per sorgente, conflitti degli spazi, errori duplicati, budget limitati, errori di autorizzazione HTTP, annullamento per pausa/stop/sorgente, smontaggio Shaka e mantenimento della posizione VOD. Le cinque nuove etichette di riproduzione sono tradotte negli 88 pacchetti linguistici inclusi; la parità automatica non è revisione di madrelingua. La riproduzione fisica TV/D1 e i manifesti specifici dei provider richiedono ancora verifica sul dispositivo. Sorgente modificabile del diagramma.


Source revision: f51bac7a. This documentation may describe changes awaiting release; use the matching build.

Clone this wiki locally