Base di conoscenze

Questa guida illustra la funzionalità Auto DJ del servizio di Streaming Radio di Infomaniak, che consente di creare una stazione radio in diretta 24 ore su 24 utilizzando i propri contenuti audio (musiche, programmi, podcast, jingle, ecc.) precedentemente caricati nello spazio di archiviazione.

Organizzare e importare i file audio

Prerequisiti

• Attivare la funzione Auto DJ nella vostra Radio in streaming (❓: guida).

Il primo passo consiste nel preparare i tuoi contenuti. Lo strumento supporta attualmente i file nei formati .mp3 e .aac. Puoi importare un'intera cartella contenente i tuoi file audio:

La cartella predefinita si chiama Music. Puoi creare nuove cartelle al suo interno per importare i file dal tuo dispositivo.

È possibile gestire la propria libreria anche direttamente dall’area VOD/AOD:

Gestione dei metadati

È possibile modificare direttamente i tag ID3 (titolo, artista, album, copertina) di un file audio dall'interfaccia, in modo che queste informazioni vengano visualizzate correttamente sui tuoi lettori musicali:

Creare playlist

Una volta importati i file, è possibile raggrupparli in playlist:

Playlist manuale

1. Crea una playlist manualmente:
   
2. Seleziona con precisione i brani e l'ordine in cui verranno riprodotti:
   

Playlist automatica

1. Seleziona una playlist automatica:
   
2. Di seguito, definisci dei criteri intelligenti (tramite tag, stili o artisti) affinché il sistema generi dinamicamente la playlist:
   

Playlist avanzata

A differenza delle playlist sopra indicate, la playlist avanzata consente di programmare una sequenza precisa di contenuti che verrà riprodotta in loop durante l'intervallo di tempo selezionato. Questa funzionalità è ideale per inserire automaticamente jingle o intermezzi a intervalli regolari e per raggruppare tracce provenienti da diverse fonti all'interno della stessa fascia oraria:

1. Seleziona una playlist avanzata:
   
2. Di seguito, definisci la struttura dei tuoi cicli di riproduzione combinando diverse fonti della tua libreria (cartelle, playlist o tag) e indicando il numero di brani da riprodurre per ciascun elemento:
   
   Esempio di programmazione:
   • Riproduci 3 brani dalla playlist Musiche di film
   • Riproduci 1 brano dalla cartella Night
   • Riproduci 1 suono con il tag Jingle
3. L'Auto DJ riprodurrà quindi la sequenza in loop (1 → 2 → 3 → 1 → 2 → 3, ecc.).
   • Un meccanismo di ponderazione garantisce una rotazione equa dei contenuti multimediali: il sistema non riprodurrà gli stessi brani nello stesso momento, assicurando così un reale rinnovamento dei tuoi contenuti ad ogni ciclo.

Pianificare la trasmissione (Planning)

Lo strumento di pianificazione consente di gestire la programmazione in modo molto dettagliato:

• Programmazione a blocchi orari: organizza le tue trasmissioni tramite playlist o cartelle su un calendario settimanale:
  
• Playlist di riempimento (esistente per impostazione predefinita): configura una playlist di riserva che verrà trasmessa automaticamente quando non è programmato alcun contenuto specifico, garantendo così un flusso ininterrotto.
• Passaggio da trasmissione in diretta ad AutoDJ: è possibile programmare fasce orarie o automatizzare la ripresa del flusso AutoDJ non appena un encoder (sorgente esterna) interrompe la trasmissione del proprio flusso.

Impostazioni audio avanzate

Per garantire una qualità di ascolto professionale, sono disponibili diverse opzioni di elaborazione:

• Normalizzazione audio: uniforma il livello sonoro di tutti i file per evitare variazioni di volume tra i diversi brani.
• Transizioni: imposta le dissolvenze incrociate e le sovrapposizioni tra le tracce:
  

Integrazione e statistiche

Lo streaming generato dall'Auto DJ è uno streaming standard che beneficia di tutti gli strumenti dell'ecosistema Infomaniak:

• Player Infomaniak: visualizzazione automatica dei titoli in riproduzione e della cronologia delle trasmissioni.
• Distribuzione in più formati: supporto HLS e transcodifica dei flussi.
• Statistiche avanzate: monitoraggio preciso del pubblico in tempo reale e report dettagliati.

Questa guida spiega come configurare correttamente uno streaming sulla piattaforma Streaming radio di Infomaniak.

Configurare la trasmissione di uno streaming radio

Per accedere al servizio di streaming radio:

1. Clicca qui per accedere alla gestione del tuo prodotto tramite il Manager Infomaniak (hai bisogno di aiuto?).
2. Fate clic direttamente sul nome assegnato al prodotto in questione.
3. Fate clic sul nome della stazione radio.
4. Fare clic sul pulsante Configura i feed:
   
5. Fare clic sul pulsante Aggiungi un feed:
   
6. Aggiungi un feed standard (consulta questa guida sui relay di feed).
7. Fai clic sul pulsante per continuare:
   
8. Seleziona le opzioni desiderate, tra cui puoi attivare la funzione HLS, che non verrà conteggiata nel numero totale di stream.
9. Configura la qualità desiderata e consulta questa guida se desideri maggiori informazioni sul tipo di stream.
10. Regola le dimensioni del buffer, se necessario (e ricorda di salvare, se necessario).
11. Fai clic sul pulsante per Salvare ed uscire:
    

Ora puoi configurare un'applicazione utilizzando le impostazioni ottenute al termine di questa procedura.

Questa guida riguarda le informazioni di ascolto di Streaming Radio che possono essere esportate in Mediapulse.

Introduzione

• Mediapulse, un'organizzazione indipendente in Svizzera, misura l'audience di radio, televisione e piattaforme online.
• Questi dati, riconosciuti come riferimento ufficiale, aiutano il mercato dei media e della pubblicità ad analizzare, confrontare e strutturare le proprie attività.
• Soggetto alla supervisione del DETEC tramite l'OFCOM, Mediapulse garantisce trasparenza, indipendenza e rigore scientifico; assicura misurazioni affidabili e adatte all'evoluzione dei media.
• È possibile esportare i log radio verso questo servizio.
• Consultate anche questa altra guida relativa a un servizio simile, ma destinato alla Francia.

Gestire la certificazione Mediapulse

Prerequisiti

• L'organizzazione in cui si trova il servizio di streaming deve essere registrata con un indirizzo in Svizzera.
• Per attivare la certificazione Mediapulse, si prega di contattare questo servizio via e-mail:info@mediapulse.ch.
• Una volta stipulato il contratto con loro,contattare l'assistenza Infomaniakindicando le informazioni relative al contratto Mediapulse e Infomaniak.

Per gestire l'attivazione o la disattivazione del servizio:

1. Clicca qui per accedere alla gestione del tuo prodotto tramite il pannello di controllo Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome assegnato al prodotto in questione.
3. Fare clic sul nome dello stream audio interessato.
4. Fare clic su Impostazioni nel menu laterale sinistro.
5. Attiva o disattiva l'esportazione dei log verso Mediapulse tramite l'interruttore:
   ‍

Questa guida spiega come trasferire i flussi audio presenti in una delle tue Radio in streaming Infomaniak a una delle tue altre radio, presente nella stessa organizzazione.

Trasferire gli stream audio

Per farlo:

1. Clicca qui per accedere alla gestione del tuo prodotto tramite il pannello di controllo Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome assegnato al prodotto in questione.
3. Fare clic sul menu azioni ⋮ situato a destra dell'elemento in questione.
4. Scegliere Trasferisci:
   
5. Cerca e conferma il nome dell'altra radio che possiedi all'interno della stessa organizzazione.
6. Conferma il trasferimento:
   

Aggiorna le pagine del pannello di controllo, se necessario, per visualizzare le informazioni più recenti.

Questa guida riguarda il controllo del flusso in diretta (timeshift), che consente agli ascoltatori di mettere in pausa, tornare indietro e poi riprendere il flusso in diretta dei vostri canali HLS, con una profondità di ritorno fino a 2 ore.

Introduzione

• A differenza del Timeshift Streaming Video, non esiste uno strumento di pianificazione integrato per la radio.
• La funzione di riascolto/ritorno indietro è disattivata per impostazione predefinita nel Player, per consentirvi di controllare l'esposizione al pubblico.

Offrire il controllo del flusso in diretta agli ascoltatori

Prerequisiti

• Creare o modificare un flusso HLS nel vostro prodotto Streaming Radio.

Successivamente:

1. Durante la creazione (o la modifica) di un flusso HLS, impostate la Memoria buffer tra 00:00:25 e 02:00:00. Questo valore, compreso tra 25 secondi e 2 ore, corrisponde alla durata massima durante la quale gli ascoltatori possono tornare indietro e mettere in pausa il flusso in diretta, prima di riprendere il flusso in diretta. Determina la profondità del controllo del flusso in diretta. Esempi:
   
   • 00:00:25 → 05:00: tolleranza minima per brevi pause.
   • 10:00 → 30:00: ideale per i formati notizie/talk.
   • 30:00 → 02:00:00: comfort massimo per programmi musicali ed eventi.
2. Attiva la funzione di riascolto nel tuo lettore (consulta questa guida) se desideri offrirla agli ascoltatori (è disattivata per impostazione predefinita):
   

Questa guida illustra il protocollo HLS, che suddivide l'audio in segmenti per una trasmissione HTTP affidabile, compatibile e altamente distribuibile, ideale per un vasto pubblico e per dispositivi mobili.

Cos'è HLS?

HLS (HTTP Live Streaming) è un protocollo di streaming che suddivide l'audio in piccoli segmenti di pochi secondi e pubblica un file manifesto .m3u8 che elenca questi segmenti. Il lettore scarica questi segmenti tramite HTTP/HTTPS (porte 80/443), il che facilita la memorizzazione nella cache, la ripresa dopo un'interruzione e la distribuzione su larga scala.

Nel tuo servizio di Streaming Radio, l'attivazione di HLS aggiunge un flusso aggiuntivo dedicato. Questo flusso ha un proprio URL di ascolto (file manifesto HLS) e può essere selezionato e prioritizzato nel lettore infomaniak. Il flusso HLS coesiste con i tuoi flussi esistenti (ad esempio MP3/AAC), senza interruzioni del servizio.

Vantaggi per uno streaming radio

• Ampia compatibilità: supporto nativo su iOS/iPadOS (Safari) e ampia compatibilità tramite lettori HTML5 moderni e applicazioni di terze parti.
• Scalabilità e prestazioni: la trasmissione tramite HTTP(S) consente una facile distribuzione tramite CDN e cache; offre una migliore scalabilità rispetto a un flusso continuo singolo.
• Affidabilità: in caso di brevi interruzioni, il lettore può recuperare i segmenti successivi e riprendere rapidamente la riproduzione; è meno sensibile alle perdite temporanee.
• Attraversamento delle reti: funziona sulle porte 80/443, ed è generalmente meglio accettato dai firewall e dai proxy aziendali rispetto ad alcuni flussi “ICY”.
• HTTPS semplificato: trasmissione sicura senza plugin o protocolli particolari.
• Adattamento della velocità di trasmissione (ABR): quando vengono offerte diverse varianti, il lettore può passare automaticamente in base alla qualità della rete per ridurre al minimo le interruzioni in mobilità.
• Flessibilità di integrazione: un endpoint dedicato consente di esporre HLS come flusso principale, secondario o di backup nel tuo lettore.

Caratteristiche e aspetti importanti

• Latenza: HLS introduce una latenza che si aggira generalmente intorno a qualche decina di secondi (legata alla dimensione dei segmenti e al buffering). Questo è normale per questo protocollo.
• Lettore compatibile richiesto: utilizzare il lettore Infomaniak o un lettore/SDK web che supporti i manifesti .m3u8.
• Ambiente eterogeneo: alcuni vecchi ricevitori hardware (webradio, autoradio IP) accettano solo flussi MP3/Icecast; mantenere in parallelo i loro URL storici.
• ABR condizionale: l'adattamento della velocità di trasmissione è attivo solo se vengono pubblicati più profili; in caso contrario, lo streaming HLS rimane funzionante con una singola qualità.

Questa guida spiega come mantenere il controllo sui tuoi flussi di streaming radio MP3/AAC o HLS attivando la protezione tramite chiave univoca (token), in modo da poter decidere, ad esempio, se un ascoltatore può ascoltare la tua radio o meno.

Introduzione

• Ad ogni connessione, verrà effettuata una richiesta all'API di Infomaniak, che restituirà un token univoco con una durata limitata e configurabile.
• Questo token autorizzerà chiunque lo possieda ad accedere al flusso dati per la durata specificata.
• È possibile proteggere un flusso MP3/AAC o HLS indipendentemente l'uno dall'altro (lo stesso vale per la geolocalizzazione).
• L'attivazione della restrizione comporta una modifica della configurazione del flusso, la cui replica sui server potrebbe richiedere alcuni minuti.

Proteggere uno streaming audio tramite chiave univoca

Per farlo, è sufficiente accedere alle impostazioni di restrizione e attivare la protezione tramite token sullo streaming che si desidera proteggere:

1. Clicca qui per accedere alla gestione del tuo prodotto tramite il pannello di controllo Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome assegnato al prodotto in questione:
   
3. Fare clic:
   1. sul nome della stazione radio:
      
   2. oppure su Restrizioni nel menu laterale sinistro per applicare restrizioni all'intero prodotto:
      
4. Dopo aver selezionato a, fare clic su Restrizioni nel menu laterale sinistro.
5. Se necessario, seleziona HLS.
6. Fai clic sul menu delle azioni ⋮ situato a destra dell'elemento in questione.
7. Fare clic su Limitazione tramite token:
   
   

Attivare quindi la protezione.

Attenzione: nel momento in cui si attiva questa opzione, l'accesso allo streaming verrà immediatamente bloccato per le nuove connessioni.Adattare i lettori multimediali per tenere conto della restrizione, come illustrato nell'esempio qui sotto:

Creare un token API Radio

Per accedere all'API Radio, è necessario innanzitutto autenticarsi tramite un token applicazione. Questa operazione deve essere eseguita una sola volta. Per creare questo token applicazione, consultare questa guida.

L'ambito è radio e la durata è illimitata, per evitare di dover rigenerare il codice regolarmente. Una volta generato il token, copiarlo e incollarlo nell'esempio riportato di seguito.

Esempio di utilizzo in linguaggio PHP

Per MP3/AAC o HLS, il codice può essere sostanzialmente lo stesso, cambia solo l'URL chiamato nella richiesta POST, per quanto riguarda il suo formato.

if (!defined('API_TOKEN')) {
     define('API_TOKEN', 'AYF5lSh3c7Xy5974Fs12RTkTThujT-L9R4Xk2ZfGyP6sV7QqJ1oC3jD8nFtKzIxUeMw5oNzR6');
}
/**
 * Fonction générique pour executer des requêtes cURL
 *
 * @param string $method Méthode HTTP (GET, POST, PUT, etc...)
 * @param string $url Url de l'api a requêter
 * @param array $headers Liste des en-têtes HTTP (l'autorisation doit être passée ici avec un ['Authorization: Bearer ']
 * @param array $payload Un tableau contenant les données pour créer un token
 * @return mixed
 */

function request(string $method, string $url, array $headers = [], array $payload = []): mixed{
    // prepare options array
    $opts = [
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_URL => $url,
        CURLOPT_CUSTOMREQUEST => strtoupper($method),
    ];

    // add payload if relevant
    if ($payload && $method !== 'GET') {
        $opts[CURLOPT_POSTFIELDS] = json_encode($payload);
    }
    $ch = curl_init();
    curl_setopt_array($ch, $opts);
    $result = curl_exec($ch);
    if(curl_errno($ch)){
        throw new Exception(curl_error($ch));
    }
    $data = json_decode($result, true);
    if ($data['result'] === 'error') {
        throw new Exception($data['error']['description'] ?? 'an error occured');

    }
    return $data['data'];
}

Creeremo il token. L'URL per la creazione del token è strutturato come segue:

• Per uno streaming MP3 / AAC

POST {{URL_11}}

Esempio per proteggere https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac: il percorso sarà: https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token

• Per uno streaming HLS

POST {{URL_14}}

Esempio: per proteggere https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8, l'URL sarà: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Esempio: nel caso di file MP3/AAC, ricordati di apportare le modifiche necessarie:

$token = request(
    'POST',
   '{{URL_17}}',
    // en-tête d'authorization
    [
        'Authorization: Bearer ' . API_TOKEN,
        'Content-Type: application/json',
    ],
    /**
     * payload pour créer le token, vous pouvez passer les valeurs suivantes
     * window     | 300               | optionnel | durée de validité du token (default: 5 minutes)
     */

    [
        'window' => 3600, // 1h validity
    ]
);

È importante notare che, se questo codice viene generato al momento del caricamento della pagina, l'utente avrà "window" secondi per avviare la riproduzione dello streaming. Superato questo limite di tempo, il token scadrà e lo streaming non potrà più essere avviato a meno che la pagina non venga ricaricata. A seconda delle vostre esigenze e del caso d'uso, sarà necessario regolare questo intervallo di tempo nel modo più appropriato.

Inoltre, sarà necessario sostituire di seguito l'URL di riproduzione dello streaming con quello desiderato, mantenendo il parametro $token alla fine. Infine, viene visualizzato il lettore (qui una semplice tag HTML5, ma è possibile aggiungere qualsiasi livello aggiuntivo in seguito, passando il token nei parametri $_GET dell'URL).

$streamUrl = "{{URL_18}}";
echo "<audio controls=""><source src="$streamUrl"></audio>";

Questa guida riguarda le statistiche di Streaming Radio, che consentono, tra l'altro, di verificare eventuali interruzioni del flusso.

Analisi delle statistiche recenti

Per accedere a queste informazioni:

1. Clicca qui per accedere alla gestione del tuo prodotto tramite il pannello di controllo Infomaniak (hai bisogno di aiuto?).
2. Fate clic direttamente sul nome assegnato al prodotto in questione:
   
3. Fate clic su Statistiche nel menu laterale sinistro:
   
4. Fare clic su Pubblico in tempo reale nel menu laterale sinistro.
5. Selezionare una data per caricare il grafico corrispondente.
6. Passa il mouse sulle eventuali interruzioni indicate con un colore diverso per visualizzare le informazioni:
   
7. Ingrandisci il grafico con la rotellina del mouse o selezionando il periodo desiderato.
8. È possibile tornare alla visualizzazione iniziale facendo clic in basso a destra:
   

Questa guida illustra la configurazione di un lettore per il tuo servizio Streaming Radio di Infomaniak.

Prerequisiti

• Aggiungi un lettore utilizzando il modello Infomaniak.

Configura le opzioni del lettore Infomaniak

Una volta che hai collegato il tuo flusso al tuo lettore e che il tuo lettore è stato creato:

1. Clicca qui per accedere alla gestione del tuo prodotto nel Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome assegnato al prodotto in questione.
3. Clicca su I miei lettori nel menu laterale sinistro.
4. Clicca sul nome del lettore da configurare (o aggiungi un nuovo lettore cliccando sul pulsante in alto):
   

1. Scheda Aspetto

Qui puoi scegliere la dimensione del lettore (grande, media, mini o lettore multi-radio) e la percentuale di visualizzazione.

Puoi personalizzare i colori dello sfondo, dei pulsanti e del testo:

Un interruttore consente di attivare o disattivare la visualizzazione dei brani in riproduzione, con o senza i relativi orari di trasmissione:

• Consulta i dettagli in merito alla fine di questa guida.

Il lettore può visualizzare:

• un'immagine che rappresenta la copertina dell'album o un'immagine sostitutiva, se non disponibile,
• un'immagine fissa (massimo 3 MB),
• il logo della tua radio, personalizzabile qui:
  
• una visualizzazione dello spettro audio (Spettrogramma / Spectrum).

2. Scheda Trasmissione

Qui puoi collegare i tuoi flussi radio (HLS o meno) al tuo lettore in fase di configurazione.

Consulta questa guida per maggiori informazioni sulle opzioni disponibili per la gestione della trasmissione in diretta:

3. Scheda Miniature (anteprima del media)

Qui puoi modificare l'immagine di anteprima (miniatura) visualizzata nel lettore dell'utente quando il media è in fase di caricamento o non è disponibile/è limitato:

4. Scheda Informazioni del lettore

Qui puoi assegnare un nome al tuo lettore e decidere se visualizzare o nascondere:

• il titolo e l'artista al posto del nome della radio,
• il numero di ascoltatori,
• il logo Infomaniak.

5. Scheda Opzioni di condivisione

Un interruttore a levetta consente di attivare o disattivare determinati servizi, come Facebook:

Una volta attivato, un pulsante di condivisione per questi servizi sarà visibile nel tuo lettore:

Dettagli della cronologia di trasmissione (scheda n. 1)

La cronologia di trasmissione consente di riascoltare le tracce musicali trasmesse (da 1 a 40) se il tuo flusso è di tipo HLS (in questo caso, potrai definire un buffer da 25 secondi a 2 ore):

La funzione di riavvolgimento e riascolto non è attivata per impostazione predefinita: rimane opzionale per rispettare le restrizioni di alcuni paesi o emittenti radio. Una volta attivata, il gestore della radio può scegliere quali flussi saranno disponibili per la trasmissione (vedi scheda n. 2 sopra), mentre l'ascoltatore può selezionare la qualità dell'ascolto nel lettore:

Position & intégration de l'historique de diffusion

L'elenco può essere consultato in diversi modi:

• direttamente sotto il lettore,
• nel lettore,
• o separatamente nell'integrazione del tuo sito web…

Infatti, è possibile visualizzare la cronologia in una seconda finestra iframe, distinta da quella del lettore principale. Esempio di URL per il lettore:
https://player-radio.infomaniak.com/2/prod/super/7cbaa24a-3510-47a4-b41e-b99218bfd507

E per la cronologia: 
https://player-radio.infomaniak.com/2/prod/history

Entrambi gli iframe devono essere integrati nella stessa pagina e comunicano tra loro per aggiornare la cronologia o avviare un brano precedentemente trasmesso.

Un secondo metodo di integrazione consente di visualizzare una cronologia autonoma, senza l'iframe principale. È sufficiente aggiungere l'ID del lettore all'URL: 
https://player-radio.infomaniak.com/2/prod/history/7cbaa24a-3510-47a4-b41e-b99218bfd507

Questa modalità è adatta, ad esempio, agli utenti di un altro lettore che desiderano visualizzare solo la cronologia dei brani.