Clip e VOD di Kick: cosa dice il link al downloader
Kick risponde a tre domande diverse a seconda del link che incolli: una clip, una trasmissione passata o un canale che in questo momento è in diretta. Il downloader legge prima l'URL e sceglie quello giusto.
La struttura degli indirizzi di Kick è la mappa più chiara di ciò che hai tra le mani. Una clip è un momento breve e montato. Una VOD è una trasmissione passata completa. La pagina di un canale non è né l'una né l'altra, e se lo streamer è in diretta in quel momento non c'è nulla da scaricare: una diretta non ha fine, quindi non ha un file.
I tre link, e in cosa diventa ciascuno
| Forma del link | Che cosa fa il resolver |
|---|---|
kick.com/<channel>/clips/clip_… | Legge l'API delle clip e restituisce la qualità originale della clip. |
kick.com/<channel>/videos/<id> e /video/<id> | Legge l'API dei video ed elenca ogni versione contenuta nella playlist master della VOD. |
kick.com/<channel> | Elenca le VOD recenti del canale; un canale in diretta risponde invece live. |
| Un id di clip da solo | Chiede prima il canale (need_channel), perché l'API delle clip di Kick ha bisogno di entrambi. |
Un id di clip ha una forma fissa — clip_ seguito da un codice in stile ULID — quindi il resolver può riconoscerlo senza alcuna chiamata di rete. Un id da solo non basta: l'API di Kick vuole il canale nel percorso, ed è per questo che un id incollato da solo torna indietro chiedendo altro.
Da dove arrivano le qualità
Per una VOD, Kick pubblica una playlist master HLS: un piccolo file che elenca ogni versione, ciascuna con la propria risoluzione, larghezza di banda e frame rate. Il resolver legge quella master e nulla più: non scarica frammenti e non chiede a Kick un file già unito, perché Kick non ne offre uno.
- Ogni versione mantiene il miglior bitrate disponibile per la sua risoluzione, così l'elenco non mostra mai due voci della stessa dimensione.
- Le varianti sono ordinate per larghezza di banda, dalla più alta: la riga in alto è la sorgente.
- Una versione a 50 fps o più è etichettata con il frame rate, per esempio
1080p60; sotto quella soglia l'etichetta è solo l'altezza. - Se la master non è analizzabile, il resolver ripiega su una singola voce
sourceche punta alla playlist stessa.
Le clip sono più semplici: di solito contengono un solo file, alla qualità con cui la clip è stata tagliata, ed è per questo che scaricare una clip raramente ti chiede di scegliere qualcosa.
Perché le dirette vengono rifiutate
Una diretta è una finestra che scorre, non un file. Kick segnala un canale in diretta in tre punti diversi — l'oggetto VOD, l'elenco dei video del canale e la pagina del canale stesso — e il resolver li converte tutti e tre nella stessa risposta: live. Prova invece una clip o una VOD.
Altri due stati sembrano errori ma non lo sono: processing significa che la trasmissione è finita da pochi minuti e Kick non ha ancora finito di preparare la VOD, e no_source significa che la VOD è stata rimossa o è scaduta. Entrambi sono lo stato di Kick, non un guasto del download.
Nulla viene salvato
Le CDN di Kick inviano access-control-allow-origin: *, quindi il browser può leggere il file direttamente. Il download avviene nella pagina, direttamente dall'edge di Kick al tuo disco; il resolver ha sempre e solo gestito i metadati. Nulla viene ricodificato, contrassegnato con filigrana o conservato.
Una nota pratica: le VOD lunghe è meglio salvarle da un browser desktop, dove il file viene trasmesso direttamente su disco. Su un telefono, una trasmissione di più ore resta in memoria mentre viene scaricata, e il browser può arrendersi prima che il file finisca.
In breve
- I link alle clip restituiscono la clip; i link alle VOD restituiscono un elenco di versioni; i link ai canali elencano le VOD recenti.
- Le dirette vengono rifiutate: non c'è un file da salvare mentre una diretta è in corso.
- Le righe delle qualità provengono dalla playlist master HLS di Kick, con il miglior bitrate per risoluzione.
- I byte viaggiano dalla CDN di Kick al tuo browser; il resolver non conserva nulla.
Domande
Posso scaricare una diretta di Kick mentre è in corso?
No. Una diretta non ha fine né file; Kick la segnala come live e il resolver la rifiuta. Quando la trasmissione finisce e Kick ha finito di elaborarla, il link della VOD funziona.
Perché le VOD elencano diverse qualità ma le clip solo una?
Una VOD porta con sé una playlist master HLS con ogni versione codificata da Kick, quindi il resolver può elencarle tutte. Una clip è tagliata da un singolo file, quindi di norma c'è solo quella qualità da offrire.
Che cosa significa la qualità `source`?
È la playlist master stessa, offerta quando le singole versioni non sono analizzabili. È lo stesso video, solo senza la suddivisione per risoluzione.