Questa guida spiega come proteggere con una password i video importati su un servizio VOD Infomaniak.

Premessa

• La riproduzione di un video all'interno di un Player configurato sul servizio VOD richiederà una password senza la quale la visione non sarà possibile.
• Non è possibile specificare più password diverse per lo stesso video.
• Altre restrizioni di accesso possono essere attivate e riguardano l'accesso al file: token | geoip

Proteggere un video con una password

La protezione con password può essere configurata in diversi modi.

1. Password a livello della cartella di importazione

Se la password viene impostata una volta per tutte a livello della cartella di destinazione, tutte le nuove importazioni di media avranno automaticamente questa password alla lettura. È comunque possibile modificare la visibilità di ogni video individualmente (leggere più avanti).

Per configurare questa cartella:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Fai clic direttamente sul nome attribuito al prodotto interessato.
3. Fai clic su Media nel menu laterale sinistro.
4. Fai clic su Gestione dei media nel menu laterale sinistro.
5. Fai clic sull'icona per creare una Nuova cartella:
   
6. Dai un nome alla cartella.
7. Fai clic sul pulsante blu per Crea la cartella.
8. Clicca su Configurazione:
   
9. Scegliete le regole di codifica per i video che verranno importati, quindi passate al passaggio successivo.
10. Configurate le opzioni della cartella al passo 2, poi passate al passo successivo.
11. Imposta la password che dovrà essere inserita per vedere un video protetto:
    
12. Fai clic sul pulsante blu una volta configurate le diverse restrizioni desiderate.
13. Carica nuovi video in questa cartella per proteggerli con una password durante la riproduzione.

2. Password definito manualmente su ogni video

Per modificare la visibilità di un video su un servizio VOD:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Fai clic direttamente sul nome attribuito al prodotto interessato.
3. Fai clic su Media nel menu laterale sinistro.
4. Fai clic su Gestione dei media nel menu laterale sinistro.
5. Fai clic sul video interessato:
   
6. Fai clic su Modifica nella sezione Stato.
7. Fai clic su Password per impostare una password.
8. Clicca sul pulsante blu per Modifica lo stato:
   
9. Il video diventa protetta da password:
   

Questa guida riguarda i token di autenticazione o tokens Infomaniak, che servono a verificare l'identità dell'applicazione e a concederle autorizzazioni specifiche per interagire in modo sicuro con le funzionalità e i dati dell'API Infomaniak.

Premessa

• I token di autenticazione o tokens servono a verificare l'identità dell'applicazione e a concederle autorizzazioni specifiche per interagire in modo sicuro con le funzionalità e i dati dell'API Infomaniak.
• Non c'è nessun limite al numero di token che puoi creare.
• La durata di un token di accesso è "illimitata" per impostazione predefinita, ma è possibile definire una durata personalizzata al momento della sua creazione.
• Attenzione, se non viene effettuata alcuna chiamata con il token per un anno, viene disattivato automaticamente; sarà quindi necessario generarne uno nuovo.

Gestire i token API Infomaniak

Al momento della creazione di un token API, sarà possibile scegliere l'applicazione e l'ambito accessibile tramite il token (per corrispondere al proprio bisogno e progetto attuale).

Per questo:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca il pulsante blu Crea un token.
3. Seleziona dal menu a discesa il prodotto adeguato in base alle tue esigenze e al tuo progetto attuale.
4. Scegli una durata di validità.
5. Clicca sul pulsante blu Crea un token.
6. Inserisci la password di accesso al Manager come richiesto.
7. Copiate il token in un luogo sicuro - non sarà più accessibile dopo questo.

Esempio di applicazione: token per l'API Newsletter

Questa guida spiega come aggiungere i sottotitoli ai media del tuo spazio VOD Infomaniak.

Premessa

• I sottotitoli dei tuoi video non sono distruttivi per il video stesso; questo non viene alterato, si tratta semplicemente di un file *.srt caricato dal Player.
• È possibile gestire l'avvio automatico dei sottotitoli direttamente dal Player (scheda #1).

Gestire i sottotitoli

Per accedere allo strumento di creazione dei sottotitoli per i tuoi media:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Clicca su Media nel menu laterale sinistro.
4. Fai clic su Gestione dei media nel menu laterale sinistro.
5. Fai clic sul media per il quale devono essere generati i sottotitoli.
6. Fai clic su Modifica.
7. Fai clic sulla scheda Sottotitoli.
8. Clicca sul pulsante Aggiungi una lingua per scegliere una delle 3 modalità di generazione dei sottotitoli:
   

A. Creazione dei sottotitoli in modo manuale

Con questa modalità di sottotitolazione, inserisci manualmente ciascun testo che deve apparire al timecode specificato:

B. Importazione di un file di sottotitoli

È possibile importare un file di tipo SubRip (*.srt) o SubViewer (*.sbv e *.sub) per arricchire il tuo video con i sottotitoli preparati in anticipo in un file separato:

Il pulsante di commutazione (toggle switch) consente di attivare o disattivare la pubblicazione dei sottotitoli sul Player; ciò permette, in particolare, di verificare che il contenuto sia corretto prima della pubblicazione e della condivisione del video.

C. Generare i sottotitoli automaticamente

È possibile creare sottotitoli direttamente dall'audio disponibile nel tuo media. I testi vengono generati grazie all'intelligenza artificiale (IA, o informaticamente o equivalente).

Per generare i sottotitoli, clicca sul pulsante Genera:

Tradurre i sottotitoli automaticamente

Quando esiste un sottotitolaggio, è possibile aggiungere una lingua supplementare nello stesso punto, facendo tradurre il testo automaticamente (specificare la lingua attuale), il che genererà il sottotitolaggio adeguato nella lingua desiderata:

Sottotitolare automaticamente i nuovi video

La cartella Radice o le sottocartelle del tuo spazio VOD possono avere delle regole eseguite ad ogni nuovo aggiunta di media al loro interno. Una di queste regole ordina di generare automaticamente i sottotitoli con il metodo C sopra. Per impostare questa regola:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Clicca su Media nel menu laterale sinistro.
4. Fai clic su Gestione dei media nel menu laterale sinistro.
5. Fai clic su Configura nella pagina della cartella Radice o della cartella di tua scelta:
   
6. Fai clic sulla scheda Elaborazione dei media.
7. Verificate che i trattamenti non siano configurati per essere ereditati dalla cartella Genitore (o configurate direttamente la cartella Genitore), quindi salvate le modifiche se necessario (punto 10 qui sotto).
8. Attiva la generazione dei testi.
9. Configura ciò che deve essere generato (sottotitoli, titolo del video, riassunto/descrizione, nonché le eventuali traduzioni in base alla lingua del visitatore).
10. Salva le modifiche:
    

Questa guida spiega come modificare la miniatura (anteprima o thumbnail/poster) che rappresenta un video su un servizio VOD.

Premessa

• L'uso di GIF animate non è possibile.

Modificare la miniatura del video

Per accedere a un media dello spazio VOD:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Fai clic direttamente sul nome assegnato al prodotto interessato.
3. Clicca su Media nel menu laterale sinistro.
4. Clicca su Gestione dei media nel menu laterale sinistro.
5. Fai clic sul media che desideri sostituire nella tabella visualizzata:
   
6. Clicca sul pulsante Modifica:
   
    

Due possibilità si offrono per sostituire l'immagine predefinita del video in pausa:

1. Seleziona un'immagine all'interno del video stesso (clicca per scorrere il video e premi il pulsante per estrarre l'immagine che puoi poi ritagliare/ridimensionare):
   
2. Carica un'immagine dal tuo disco rigido (massimo 10 Mo) che puoi poi ritagliare/ridimensionare.

Conferma cliccando sul pulsante blu Salva:

Questa guida spiega come trasmettere in diretta un elenco di video del servizio VOD grazie al prodotto Streaming video.

Premessa

• Questa funzionalità consente di utilizzare il servizio VOD per creare una playlist di video e di utilizzare poi il servizio Streaming video per trasmetterla in diretta vera e propria, ad esempio nel contesto di un canale di videoclip, televendite, documentari, ecc.
• È possibile inserire pubblicità tra ogni video, manualmente o utilizzando tag VAST.
• La playlist verrà trasmessa in loop all'infinito fino a quando l'utente non la fermerà.

Trasmettere una playlist VOD in live streaming

Prerequisiti

• Disporre di un servizio VOD (al minimo lo spazio VOD gratuito con il servizio Streaming video).
• Disporre di un servizio Streaming video nella stessa Organizzazione e gestito dallo stesso account.

Per creare la playlist, importare alcune video:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Clicca sul pulsante Seleziona (nella sezione Importazione rapida).

Una volta importati i video:

1. Clicca su Media nel menu laterale sinistro.
2. Clicca su Playlist / WebTV nel menu laterale sinistro.
3. Clicca sul pulsante per aggiungere una nuova playlist.
4. Nomeggia la playlist e determina se deve essere automatica (collegata a una cartella) o manuale.
5. Scegliete la cartella o i video specifici da utilizzare per costituire la playlist.
6. Clicca sul pulsante Crea un live:
   
7. Scegliete il flusso del servizio di Streaming video che dovrà trasmettere la playlist e impostate le vostre preferenze:
   

Alcuni esempi di utilizzo

La trasmissione di una playlist può essere utilizzata come soluzione di backup non appena un live si interrompe (volontariamente o involontariamente) e in questo caso prendere il relai. Non appena l'encoder live spinge un flusso, riprende il controllo della playlist. Questo permette di trasmettere un contenuto alternativo in caso di problemi con la diretta o se l'utente trasmette in diretta solo la sera, ad esempio, può automatizzare la trasmissione di contenuti provenienti da playlist per il resto della giornata.

È anche possibile programmare la trasmissione di una playlist dall'strumento di pianificazione del Streaming video. In questo modo è possibile scegliere intervalli di trasmissione di playlist uniche o diverse in anticipo, o in modo ricorrente. L'encoder che trasmette in diretta verrà disconnesso automaticamente e per tutta la durata della trasmissione della playlist; una volta terminato l'intervallo di tempo, l'encoder si riconnetterà e il suo contenuto verrà trasmesso.

Questa guida spiega come integrare nel Player VOD/AOD che serve a trasmettere il tuo video, un pulsante sovrapposto al video su cui lo spettatore potrà cliccare e così condividere facilmente il link del video (o integrare il video stesso).

Premessa

• Una condivisione automatica è prevista per Facebook, X (precedentemente Twitter), LinkedIn, WhatsApp, ma è anche possibile fornire un codice HTML per l'integrazione del Player nella posizione desiderata dal visitatore.
• Una condivisione può essere avviata anche all'interno della libreria multimediale stessa.

Aggiungere un link di condivisione al Player

Per accedere allo spazio VOD:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome assegnato al prodotto interessato.
3. Clicca su Players nel menu laterale sinistro.
4. Fai clic sull'oggetto interessato nella tabella che viene visualizzata.
5. Clicca sulla scheda Condividi.
6. Attiva una delle opzioni di condivisione con i parametri desiderati per visualizzare, sul Player, un'icona che rappresenta la possibilità di condivisione per l'utente:
   
   
    
7. Non dimenticate di salvare le modifiche se necessario.

Questa guida spiega come ottenere e configurare le notifiche in caso di incidente o superamento del consumo di VOD/AOD.

Avvisi via email

Per configurare le notifiche:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Fai clic direttamente sul nome assegnato al prodotto interessato.
3. Clicca su Impostazioni nel menu laterale sinistro.
4. Clicca su Notifiche nel menu laterale sinistro.
5. Aggiungi gli utenti dell'Organizzazione che devono essere notificati via email.
6. Configura gli orari di monitoraggio (giorni della settimana / ore).
7. Salva le modifiche:
   

Questa guida descrive alcune operazioni eseguite in background dal servizio VOD / AOD Infomaniak.

Funzionamento delle richieste SOAP e dei callback

Nel servizio di VOD (video on demand) e AOD (audio on demand), alcune operazioni come il download dei file passano attraverso richieste SOAP, un protocollo che permette a due sistemi di comunicare tra loro, spesso utilizzato per scambiare dati tra server.

Quando un file viene richiesto tramite SOAP, può esserci un ritardo prima che il server risponda. Questo ritardo dipende da diversi fattori, come la dimensione del file, il carico del server o la qualità della connessione. Il download inizia il prima possibile, ma è importante sapere che c'è una coda: se diversi utenti fanno richieste contemporaneamente, ciascuna viene elaborata in ordine, e ogni utente ha un limite di download simultanei.

Callback: una notifica alla fine del download

Un richiamo è un sistema che permette di notificare il cliente (ad esempio, la tua applicazione) una volta che il download è completato. In altre parole, invece di aspettare monitorando il download, il sistema ti « chiama » o ti invia una risposta quando tutto è pronto. Questo è utile per evitare di bloccare la tua applicazione mentre il file si sta scaricando.

Tuttavia, esiste anche un tempo massimo di attesa, chiamato timeoutSe questo ritardo viene raggiunto prima che il download sia completato, viene comunque inviata una risposta. Questo non significa che il download è fallito, ma che la risposta è stata inviata prima che fosse completato. In questo caso, l'elaborazione continua in background.

I file di grandi dimensioni richiedono più tempo

Quando il file richiesto è voluminoso (ad esempio, diversi centinaia di megabyte o anche diversi gigabyte), il download può richiedere diversi minuti. Questo tempo dipende molto dal server remoto: alcuni sono molto veloci, altri meno. Il sistema cerca di gestire al meglio possibile, ma è importante tenere a mente che il tempo di risposta non sarà sempre immediato.

Chiamate bloccanti e non bloccanti

Di default, alcuni client SOAP attendono che il server abbia finito di rispondere prima di continuare. In questo caso si parla di una chiamata bloccante : la tua applicazione è bloccata fino all'arrivo della risposta. Questo può causare problemi se la risposta impiega del tempo.

Fortunatamente, spesso è possibile configurare il client SOAP in modo che non blocchi. In questo caso si parla di una chiamata non bloccanteQuesto permette di inviare più richieste una dopo l'altra senza dover attendere la risposta di ogni chiamata. È più veloce ed efficiente, soprattutto quando si elaborano più file di seguito.

Questa guida spiega come proteggere con una chiave unica i video importati su un servizio VOD Infomaniak.

Premessa

• Attenzione, la protezione tramite token è efficace solo nel caso di un'integrazione standard tramite iframe e quindi tramite l'utilizzo del Player Infomaniak.
• Altre restrizioni di accesso possono essere attivate: password | geoip

Proteggere un video con chiave univoca

Hai la possibilità di proteggere tutti i media di una cartella creando un token. Quest'ultimo sarà unico per ciascuno dei tuoi visitatori e dovrà essere passato come parametro al tuo media per limitare la visualizzazione di quest'ultimo. Solo tu sarai in grado di generare la chiave unica, necessaria a ogni utente per vedere i video. Questa chiave consente quindi di autorizzare solo le persone precedentemente verificate da te.

Questo permette di controllare l'accesso ai video e di autorizzare solo alcune persone, mentre altre vengono rifiutate; utile in casi come il pay-per-view o le trasmissioni limitate. Tuttavia, si prega di notare che spetta a voi sviluppare l'integrazione con il vostro sistema esistente.

Se l'hash non è valido, l'accesso al video restituirà una pagina di errore "403 forbidden".

Attivare la restrizione sulla cartella di importazione

Quando la password è impostata una volta per tutte a livello della cartella di destinazione, tutte le nuove importazioni di media avranno automaticamente questo modo di lettura. Per configurare questa cartella:

1. Clicca qui per accedere alla gestione del tuo prodotto su il Manager Infomaniak (hai bisogno di aiuto?).
2. Fai clic direttamente sul nome assegnato al prodotto interessato.
3. Fai clic su Media nel menu laterale sinistro.
4. Fai clic su Gestione dei media nel menu laterale sinistro.
5. Clicca sull'icona per creare una Nuova cartella:
   
6. Dai un nome alla cartella.
7. Fai clic sul pulsante blu per Creare la cartella.
8. Clicca su Configurazione:
   
9. Scegliete le regole di codifica per i video che verranno importati, quindi passate al passaggio successivo.
10. Configurate le opzioni della cartella in questa seconda fase, quindi passate alla fase successiva.
11. Attiva la restrizione tramite chiave univoca.
12. Fai clic sul pulsante blu una volta configurate le diverse restrizioni desiderate:
    

1. Creare un token API VOD

Per accedere all'API VOD, devi autenticarti utilizzando un token applicazione. Questa operazione va eseguita una sola volta. Il token applicativo sarà comune per tutti i dossier che desideri proteggere. Per creare questo token applicativo, consulta questa guida e la documentazione https://developer.infomaniak.com/getting-started#authentication.

2. Creare il token di riproduzione

Questa fase va eseguita sul tuo sito web/applicazione e questo token dovrà essere unico, quindi generato per ogni visitatore.

È quindi importante che la pagina che avrà il compito di generare il token non abbia cache, per garantire l'unicità del token.

POST  https://api.vod2.infomaniak.com/api/pub/v1/channel/channel_id/share/share_id/token

channel_id = 1227
share_id = corrisponde all'identificativo del tuo video
Esempio: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

L'elenco dei parametri è disponibile nella documentazione https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Utilizzo del token unico su un media

Il token recuperato al punto 2 sopra sarà quindi passato come parametro al media, sarà unico quindi diverso per ogni visitatore:

<iframe frameborder="0" width="720" height="360"  src="https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html?token=st=1637143497~exp=1637143797~acl=/hls/1jhvl2uq4dnra/1jhvl2uq4dnmd/*~hmac=914aa838bdba141ec85db74266b54278572a1353a49e8851e4fd096dc6372127" allowfullscreen></iframe>

Questa guida spiega come integrare su pagine web file video/audio importati su un servizio VOD/AOD Infomaniak.

Premessa

• Questo codice di integrazione VOD/AOD è unico e corrisponde ai parametri che stai specificando sulla pagina.
• Vi permette di integrare lo stesso video con diverse configurazioni di visualizzazione a seconda delle vostre esigenze.
• In seguito, potrete modificare i parametri di questa integrazione regolandoli dalla pagina della cronologia delle integrazioni su Manager Infomaniak.
• Puoi anche condividere un media in vari modi.

Generare e copiare il codice di integrazione

Il codice di integrazione si trova nella tua interfaccia VOD; ecco un esempio con un Player predefinito:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Fai clic direttamente sul nome assegnato al prodotto interessato.
3. Fai clic su Media nel menu laterale sinistro.
4. Fai clic su Gestione dei media nel menu laterale sinistro.
5. Fai clic sul media interessato nella tabella visualizzata.
6. Fai clic sul pulsante blu Integra.
7. Clicca su Crea un'integrazione:
   
8. Personalizza l'integrazione del media (timestamp, riproduzione in loop, avvio automatico, …).
9. Fai clic sul pulsante per Generare il codice di integrazione:
   
10. Copiate il codice per integrarlo nella posizione desiderata:
    

Il media verrà inserito con il Player predefinito, ma avete la possibilità di scegliere tra i vostri Players creati quello da proporre durante l'integrazione.

Modifica un'integrazione precedente

Per personalizzare nuovamente l'integrazione già effettuata del tuo media, e con l'obiettivo di conservare il codice corrispondente senza doverlo reinserire:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Fai clic direttamente sul nome assegnato al prodotto interessato.
3. Fai clic su Media nel menu laterale sinistro.
4. Fai clic su Gestione dei media nel menu laterale sinistro.
5. Fai clic sul media interessato nella tabella visualizzata.
6. Fai clic sul pulsante blu Integra.
7. Fai clic su Modifica un'integrazione:
   
8. Fai clic sul menu azione ⋮ a destra dell'oggetto interessato nella tabella visualizzata.
9. Fai clic sull'elemento desiderato per ottenere/modificare i codici di integrazione:
   

Incolla il codice di integrazione…

Sulla pagina web di vostra scelta, incollate il codice nel punto desiderato.

… su Site Creator Infomaniak

• Per Site Creator, è necessario generare un codice di integrazione “Fisso” (e non “Reattivo”):
  
• Incolla quindi questo codice su Site Creator all'interno di un blocco “Codice HTML personalizzato”.

• Ecco un esempio di copia-incolla dalla pagina di integrazione di un media: