Base di conoscenze

La piattaforma di Streaming video di Infomaniak offre due opzioni per ottenere flussi video da trasmettere:

• Modalità PUSH: invii il flusso alla piattaforma di Infomaniak
• Modalità PULL: specifica un URL di origine da cui Infomaniak recupererà il flusso; questo metodo consente di trasmettere un flusso esistente tramite Infomaniak

Telecamera IP (Modalità PUSH)

Il caso d'uso più comune coinvolge telecamere IP, accessibili tramite un URL o un indirizzo IP.

Per un funzionamento ottimale:

• Il tuo hardware deve supportare il protocollo RTSP e il codec video H264 (non fidarti dell'indicazione di MPEG4)
• Il tuo hardware deve essere accessibile pubblicamente da Internet sulla porta 554 (altre porte verranno rifiutate)
• L'indirizzo RTSP deve funzionare in un lettore video (VLC, mplayer, ...)
• L'indirizzo RTSP deve essere ottenibile tramite l'interfaccia di amministrazione del tuo hardware

Origine Esterna (Modalità PULL)

È anche possibile recuperare il flusso da una fonte esterna, il che consente, ad esempio, di elaborare nuovamente un flusso esistente aggiungendo un watermark e utilizzare i server di trasmissione di Infomaniak per raggiungere un vasto pubblico.

Attualmente, sono supportati i seguenti formati di flusso:

• RTP
• RTSP
• RTMP

Questa guida spiega come trasmettere una riunione online tramite kMeet in uno stream separato accessibile tramite un URL unico utilizzando lo Streaming Video di Infomaniak.

Premessa

• Trasmettere una riunione tipo conferenza in un flusso di Streaming Video piuttosto che all'interno dell'app kMeet offre diversi vantaggi:
  • Trasmissione pubblica su larga scala senza limitare l'accesso a un pubblico ristretto solo agli invitati.
  • Attirare un pubblico più ampio, come conferenze, webinar o eventi dal vivo, in cui centinaia o migliaia di spettatori possono seguire l'evento senza unirsi a una chiamata privata.
  • Permette di raggiungere un numero illimitato di spettatori.
  • Nessuna necessità di gestire l'accesso per ciascun partecipante, il flusso può essere visualizzato tramite un semplice link.
  • Basta un semplice browser Web per accedere al flusso di streaming.
  • Accesso passivo: gli spettatori non sono costretti a partecipare attivamente o interagire; possono semplicemente guardare l'evento senza registrarsi o effettuare l'accesso, il che è più adatto per eventi di grandi dimensioni.
  • Nessuna interruzione vocale o disturbi legati alla gestione dei microfoni; questo mantiene il flusso più fluido e concentrato sull'interlocutore.
  • Risoluzione di streaming più alta quando kMeet potrebbe essere limitato da vincoli di larghezza di banda e qualità video inferiore per evitare sovraccarichi di rete.

Creare il link di condivisione dello Streaming Video

Prerequisiti

• Lo streaming di un flusso video kMeet all'interno di un flusso di Streaming Video è possibile con l'offerta kSuite Pro o Enterprise.
• È necessario essere moderatore di kMeet per creare un link di streaming live, ma non è necessario possedere un'offerta Infomaniak di Streaming Video.

Successivamente:

1. Avvia kMeet tramite kmeet.infomaniak.com o da una delle applicazioni per computer o dispositivi mobili.
2. Una volta nella riunione, fai clic sul menu azioni ○○○ nella barra degli strumenti di kMeet.
3. Seleziona Avvia streaming live:
   
4. Fai clic sul pulsante Avvia:
   
5. Attendi la creazione del flusso di Streaming Video:
   
6. Una volta visualizzato il link dello stream, fai clic sull'icona a destra per copiare l'URL corrispondente al flusso live; incolla l'URL in un messaggio da inviare ai partecipanti o a chiunque debba assistere alla trasmissione in diretta.
7. Un simbolo su kMeet e un segnale acustico indicheranno l'inizio dello streaming live tramite Streaming Video:
   

Il flusso verrà trasmesso ininterrottamente per un massimo di 24 ore e non sarà più accessibile una volta che la riunione kMeet sarà terminata.

Questa guida spiega come trasmettere in diretta una lista di video del servizio VOD utilizzando il prodotto Streaming video.

A cosa serve?

Questa funzionalità consente di utilizzare il servizio VOD per creare una playlist di video e quindi utilizzare il servizio Streaming video per trasmetterla effettivamente in diretta, ad esempio in un canale di videoclip, televendite, documentari, ecc. È possibile inserire annunci tra ogni video, manualmente o mediante l'uso di tag VAST. La playlist verrà trasmessa in loop all'infinito fino a quando l'utente non la ferma.

Alcuni esempi di utilizzo

La trasmissione di una playlist può servire come soluzione di fallback nel caso in cui una trasmissione in diretta venga interrotta (volontariamente o involontariamente) e, in tal caso, prendere il controllo dell'antenna. Non appena l'encoder in diretta riprenderà a trasmettere un flusso, riprenderà la playlist. Ciò consente di trasmettere un contenuto alternativo in caso di problemi con la trasmissione in diretta o se l'utente trasmette solo contenuti in diretta di sera, ad esempio, può automatizzare la trasmissione di contenuti dalla playlist per il resto della giornata.

È inoltre possibile programmare la trasmissione di una playlist dall'utility di pianificazione dello Streaming video. In questo modo è possibile selezionare anticipatamente i periodi di trasmissione della playlist unica o diversi, o in modo ricorrente. L'encoder in diretta verrà disconnesso automaticamente per tutta la durata della trasmissione della playlist; una volta terminato l'orario, l'encoder si riconnetterà e il suo contenuto verrà trasmesso.

Prerequisiti

• Avere un servizio VOD (almeno lo spazio VOD gratuito con il servizio Streaming video)
• Avere un servizio Streaming video nella stessa organizzazione e gestito dallo stesso account

Trasmettere una playlist VOD in streaming live

Creare la playlist da alcuni video importati

Importare i video nello spazio VOD:

1. Effettuare l'accesso al Manager di Infomaniak (manager.infomaniak.com) da un browser web come Brave o Edge
2. Fare clic sull'icona nell'angolo in alto a destra dell'interfaccia (o navigare attraverso il menu laterale sinistro, ad esempio)
3. Scegliere VOD/AOD (universo di Streaming)
4. Fare clic sul nome dell'oggetto rilevante nella tabella visualizzata
5. Fare clic sul pulsante Selezionare (nella sezione Importazione rapida)

Una volta importati i video:

1. Fare clic su Media nel menu laterale sinistro
2. Fare clic su Liste di riproduzione / WebTV nel menu laterale sinistro
3. Fare clic sul pulsante per aggiungere una nuova lista di riproduzione
4. Nominare la playlist e determinare se deve essere automatica (collegata a una cartella) o manuale
5. Scegliere la cartella o i video specifici da utilizzare per creare la playlist
6. Fare clic sul pulsante Crea in diretta
   
7. Scegliere il flusso di Streaming video che trasmetterà la playlist e configurare le preferenze:
   

Questa guida fornisce istruzioni per proteggere uno Streaming video con una chiave unica (hash).

Questo metodo offre il massimo livello di protezione e consente, ad esempio, di limitare le trasmissioni a un'area riservata ai membri che richiede l'autenticazione. Dato che il modo di generare questo codice è specifico per ogni sito, sarà necessario implementare le funzioni PHP necessarie e adattare il codice di integrazione del lettore di conseguenza.

Restrizione tramite chiave unica (hash)

Per fare ciò:

1. Accedi al Manager di Infomaniak (manager.infomaniak.com) da un browser web come Brave o Edge
2. Fai clic sull'icona nell'angolo in alto a destra dell'interfaccia (o naviga tramite il menu laterale sinistro, ad esempio)
3. Scegli Streaming video (universo Streaming)
4. Fai clic sul nome dell'oggetto corrispondente nella tabella visualizzata
5. Fai clic su Impostazioni nel menu laterale sinistro
   
6. Fai clic su Restrizioni nel menu laterale sinistro
7. Nella scheda Restrizione per hash univoco
   

Funzionamento delle restrizioni

Questo metodo richiede di ottenere informazioni relative alla configurazione del flusso e all'utente che si sta connettendo.

In primo luogo, è necessario definire una password (una chiave) nella console di amministrazione. Una volta aggiunta questa chiave, gli spettatori connessi e coloro che tentano di visualizzare il flusso saranno bloccati istantaneamente.

Ecco il principio da seguire per autorizzare l'accesso al flusso:

• Progettare un proprio sistema di autenticazione (ad esempio, un'area riservata ai membri)
• Usa la password configurata precedentemente nella nostra console
• Ottenere gli indirizzi IP degli utenti tramite $_SERVER["REMOTE_ADDR"], ad esempio
• Usa l'identificatore del flusso da indirizzare
• Ottenere la data e l'ora attuali (senza minuti e secondi)

Questi elementi saranno quindi hasheadi dal codice fornito nel Manager per generare un token unico che verrà trasmesso al flusso al momento del caricamento. La piattaforma di streaming verificherà quindi la validità dell'hash per autorizzare o respingere la connessione.

Note importanti

• Per garantire la sicurezza dell'accesso al flusso, la validità di ogni token è limitata nel tempo
• È importante disabilitare la cache nelle pagine che consentono l'accesso al flusso; infatti, se la generazione del token viene memorizzata nella cache, altri utenti proveranno ad autenticarsi con l'hash di qualcun altro, causando il loro rifiuto anche se hanno il permesso di consumare il flusso

Questa guida spiega come fare una diretta a 360° utilizzando il servizio di streaming video di Infomaniak.

Requisiti

• Avere una telecamera 360 compatibile con uno dei seguenti formati:
  • equirettangolare 360 monoscopico (2D)
  • equirettangolare 360 stereoscopico (3D) side by side (separazione sinistra/destra)
  • equirettangolare 360 stereoscopico (3D) top/bottom (separazione sopra/sotto)
• Il tuo encoder o la tua telecamera deve anche essere in grado di inviare uno stream tramite una connessione RTMP (maggiori informazioni)
• Infine, tieni presente che uno stream video a 360° richiede una sorgente con un bitrate elevato e un controllo del bitrate impostato in modalità CBR; il bitrate dipenderà dal tipo di contenuto e il consumo di dati sarà maggiore rispetto a uno stream standard
   

Creare un player 360°

Per trasmettere un live a 360° è necessario un player a 360°. Questa opzione è gratuita e si configura rapidamente:

1. Accedi a Infomaniak Manager (manager.infomaniak.com) da un browser web come Brave o Edge
2. Clicca sull'icona in alto a destra dell'interfaccia (o naviga tramite il menu laterale sinistro, ad es.)
3. Seleziona Streaming video (nell'universo Streaming)
4. Clicca sul nome dell'oggetto rilevante nella tabella visualizzata
5. Clicca su Integrazione e poi su Players nel menu laterale sinistro per creare o modificare un player esistente
6. Seleziona la casella Player 360 e configura la proiezione (formato 360)
   
7. Clicca sul pulsante Salva
8. Tutti i contenuti trasmessi tramite questo player (che siano in formato 360 o meno) verranno ora interpretati come 360°

Questa guida spiega come registrare o archiviare tutte le tue Trasmissioni video, il che può essere utile per creare repliche TV o rivedere i video registrati da telecamere di sorveglianza, ad esempio.

Abilitare o disabilitare la registrazione automatica delle dirette

Per abilitare questa opzione:

1. accedere al Manager Infomaniak (manager.infomaniak.com) da un browser web come Brave o Edge
2. fare clic sull'icona ‍ in alto a destra dell'interfaccia (o navigare utilizzando il menu laterale sinistro, ad esempio)
3. selezionare Trasmissioni video (nella sezione Streaming)
4. fare clic sul nome dell'oggetto rilevante nella tabella visualizzata
5. abilitare la registrazione delle dirette dalla dashboard del flusso
   

Una volta attivata questa funzione, il flusso verrà automaticamente e perpetuamente registrato dal momento in cui viene inviato a (o prelevato da) la piattaforma Infomaniak.

Rimanere vigili riguardo al tuo spazio FTP, che potrebbe saturarsi rapidamente. Se necessario, hai anche la possibilità di programmare manualmente registrazioni tramite lo strumento di pianificazione.

Funzionamento delle registrazioni automatiche

Una volta attivata questa opzione, verrà generato automaticamente un file mp4 dopo ogni trasmissione, che verrà trasferito nello spazio FTP o VOD che hai configurato.

Dettagli importanti:

• una trasmissione è definita come il momento tra la connessione e la disconnessione dal codificatore video
• qualità delle registrazioni: nel caso di un flusso multi-bitrate, verrà preservata la qualità massima di origine
• limitazione delle dimensioni dei file: nel caso di streaming, hai la possibilità di impostare la durata massima di ogni file mp4; questa opzione ti consente di evitare la generazione di file troppo grandi e garantisce la registrazione dei tuoi archivi nello spazio FTP o VOD di tua scelta (una volta raggiunta la durata, la registrazione si interromperà automaticamente, verrà inviata via FTP e verrà avviata una nuova registrazione)

Personalizzazione dei nomi delle registrazioni

Per consentirti di identificare e classificare facilmente i tuoi archivi, il nome delle registrazioni può essere personalizzato dinamicamente utilizzando parametri specificati tra parentesi graffe.

Esempio: template_{stream_id}_{date|format:YYYY-MM-dd_hh:mm:ss}_{fragment_id|from:1|prefix:fragment_(|suffix:)}.{extension}

• stream_id // rappresenta l'ID dello stream come stringa.
• date | format: ISO 8601 // data del giorno di registrazione.
• time | format: ISO 8601 // ora della registrazione.
• datetime | format: ISO 8601 // data e ora della registrazione.
• fragment_id | from: number | prefix: string | suffix: string // numero del frammento nel caso in cui una registrazione venga divisa, con la possibilità di prefissarlo e/o suffiggere. Ogni frammento sarà incrementato, "from" permette di indicare quale sarà il primo frammento di riferimento.
• extension // estensione finale del file.

Questi parametri e le loro opzioni sono facoltativi e il loro ordine è completamente flessibile. Possono essere utilizzati quante volte si desidera. Se si specifica la stessa opzione più volte, verrà presa in considerazione solo l'ultima. Qualsiasi opzione non riconosciuta verrà semplicemente ignorata.

Esempio 1

Situazione: hai due programmi giornalieri, il primo inizia alle 10:00 e il secondo alle 20:05. Configurando la denominazione dei file in questo modo: template_{date|format:hh:mm:ss}, otterrai i seguenti nomi di file:

Per il 5 dicembre 2019:

• La prima registrazione delle 10:00 verrà chiamata: template-10:00:00.mp4
• La seconda registrazione delle 20:05 verrà chiamata: template-20:05:00.mp4

Per il 6 dicembre 2019:

• La prima registrazione delle 10:00 verrà chiamata: template-10:00:00.mp4
  La registrazione del giorno precedente con lo stesso nome verrà sovrascritta e sostituita da questa.
• La seconda registrazione delle 20:05 verrà chiamata: template-20:05:00.mp4
  La registrazione del giorno precedente con lo stesso nome verrà sovrascritta e sostituita da questa.
• E così via.

Questa logica può essere particolarmente utile per avere un sistema di registrazione a ciclo continuo, ad esempio per la videosorveglianza. L'utente recupererà il video solo in caso di necessità, evitando di archiviare un numero potenzialmente infinito di video e il rischio di saturare lo spazio FTP.

Esempio 2

Situazione: questa volta hai una registrazione perpetua, 24/7, con un limite di durata dei file fissato a 360 minuti. Configurando la denominazione dei file in questo modo: template_{date|format:YYYY-MM-dd}_{fragment_id|from:1|prefix:fragment_(|suffix:)}.{extension}, otterrai i seguenti nomi di file:

• Il primo file del giorno alle 00:00 verrà chiamato: template_2019-02-05.mp4
• Il secondo file del giorno alle 06:00 verrà chiamato: template_2019-02-05_fragment(1).mp4
• Il terzo file del giorno alle 12:00 verrà chiamato: template_2019-02-05_fragment(2).mp4
• Il quarto file del giorno alle 18:00 verrà chiamato: template_2019-02-05_fragment(3).mp4

Se configuri la denominazione dei file in questo modo: template_{date|format:YYYY-MM-dd}_{fragment_id|from:0|prefix:fragment_(|suffix:)}.{extension}, otterrai i seguenti nomi:

• Il primo file del giorno alle 00:00 verrà chiamato: template_2019-02-05_fragment(0).mp4
• Il secondo file del giorno alle 06:00 verrà chiamato: template_2019-02-05_fragment(1).mp4
• Il terzo file del giorno alle 12:00 verrà chiamato: template_2019-02-05_fragment(2).mp4
• Il quarto file del giorno alle 18:00 verrà chiamato: template_2019-02-05_fragment(3).mp4

Se desideri evitare che il tuo flusso TV o video venga visualizzato su altri siti web che non ti appartengono, puoi limitare la trasmissione solo al tuo sito e vietarne l'integrazione altrove.

Restrizione per dominio

Per fare questo:

1. Accedi al Manager di Infomaniak (manager.infomaniak.com) da un browser web come Brave o Edge
2. Fai clic sull'icona nell'angolo in alto a destra dell'interfaccia (o naviga attraverso il menu laterale sinistro, ad esempio)
3. Seleziona Streaming video (universo di Streaming)
4. Fai clic sul nome dell'oggetto rilevante nella tabella visualizzata
5. Fai clic su Impostazioni nel menu laterale sinistro
   
6. Fai clic su Restrizioni nel menu laterale sinistro
7. Nella scheda Restrizione per dominio
   
8. Aggiungi la restrizione per dominio, con il tuo sito web e tutti i siti autorizzati a caricare il flusso

Questa guida spiega come personalizzare un lettore con l'immagine di tua scelta se hai aggiunto restrizioni al tuo flusso o nei seguenti casi:

• Interruzione programmata della trasmissione (possibilità di visualizzare un conto alla rovescia prima della ripresa della trasmissione)
• Limiti geografici
• Altre restrizioni (blocco tramite IP, dominio/i, token, ecc.)

Personalizzare le miniature di un lettore

1. aprire il Manager (https://login.infomaniak.com/it/login)
2. andare in Streaming video
3. cliccare sul flusso in questione
4. cliccare su Integrazione quindi su Lettori nel menu a sinistra
5. cliccare sul lettore da personalizzare
6. andare nella scheda Miniature
7. personalizzare le miniature personalizzate

Questa guida spiega come gestire eventuali superamenti del consumo dei servizi di video streaming di Infomaniak.

Agire prima del superamento

In caso di superamento del pacchetto, verrà generata una fattura aggiuntiva che potrebbe comportare costi aggiuntivi. È quindi importante scegliere l'opzione corretta da applicare in caso di sovraconsumo.

Per accedere al servizio di video streaming:

1. Effettua l'accesso al Manager di Infomaniak (manager.infomaniak.com) da un browser web come Brave o Edge
2. Fai clic sull'icona nell'angolo in alto a destra dell'interfaccia (o naviga tramite il menu laterale sinistro, ad esempio)
3. Seleziona Video Streaming (in Streaming)
4. Fai clic su Gestione
5. Fai clic su Gestione superamenti
   

Le 3 opzioni in caso di superamento sono:

• A. Interrompere la trasmissione in diretta 
• B. Impostare un limite (in GB o TO) prima che le trasmissioni in diretta vengano interrotte
• C. Continuare la trasmissione 

Questa guida spiega le possibili cause di una eventuale latenza che potresti notare tra la fonte di un video e la sua trasmissione in diretta attraverso il servizio di video streaming di Infomaniak.

Disponibilità in caso di...

... riproduzione nel Pannello di controllo

Una volta che il tuo codificatore è collegato ai server principali di Infomaniak, il flusso può subire diverse trasformazioni, specialmente nel caso della trascodifica o dell'aggiunta di un watermark. In questi casi, il video deve essere ricodificato in uno o più formati, il che richiede tempo di elaborazione che inevitabilmente influisce sulla riproduzione finale.

... flusso a singola velocità di bit senza elaborazione

In questo caso, il flusso è disponibile in pochi secondi.

... flusso transcodificato o con watermark

Questa elaborazione richiede circa 25 secondi affinché il flusso trasformato sia visibile nelle diverse qualità.

... ritardo tra la fonte e la riproduzione per gli spettatori

Per evitare microinterruzioni durante la trasmissione, il lettore video memorizza in buffer diversi secondi del video. Pertanto, è possibile notare facilmente un ritardo di 30-60 secondi tra la fonte originale e il flusso riprodotto per gli spettatori.

Per ridurre al minimo questo ritardo, l'unico modo è avere un flusso a singola velocità di bit, senza trascodifica, senza watermark, con una velocità di bit non troppo alta e ridurre al massimo il buffer nelle impostazioni del lettore. In base alle tue esigenze, è necessario trovare un equilibrio tra l'immediatezza della trasmissione e le funzionalità che desideri utilizzare per migliorare l'esperienza dei tuoi spettatori e personalizzare il marchio delle tue trasmissioni in diretta.