Questa guida spiega come disattivare completamente un'offerta Streaming Radio.

Premessa

• Per la maggior parte dei prodotti, confermare la richiesta di disattivazione tramite e-mail, altrimenti nessun dato verrà eliminato.
• Consultare questa guida per rimuovere un flusso audio dalla propria Streaming Radio, senza disattivare l'intero prodotto.
• Le tariffe o i costi non inclusi nel pacchetto rimangono dovuti.
• Una conferma di disattivazione viene inviata agli eventuali altri amministratori dell'Organizzazione.
• I backup verranno eliminati in modo irreversibile in caso di disattivazione, rendendo impossibile qualsiasi ripristino.

Disattivare l'offerta Streaming Radio

Per accedere alla disattivazione dell'offerta:

1. Fare clic qui per accedere alla gestione del prodotto nel Manager Infomaniak (necessiti di aiuto?).
2. Fare clic sul menu azioni ⋮ situato a destra dell'elemento interessato.
3. Scegliere Disattiva:
   
4. Seguire la procedura fino alla fine.

Questa guida spiega come configurare correttamente un flusso su Streaming radio Infomaniak.

Configurare la trasmissione di un flusso radio

Per accedere al servizio di Streaming radio:

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 nome della radio.
4. Clicca sul pulsante Configura i flussi:
   
5. Clicca sul pulsante Aggiungi un flusso:
   
6. Aggiungi un flusso standard (prendi visione di questa altra guida riguardo ai relay di flusso).
7. Clicca sul pulsante per Continuare:
   
8. Scegli le opzioni desiderate, in particolare puoi attivare il HLS che non sarà conteggiato nel numero totale di flussi.
9. Configura la qualità desiderata e prendi visione di questa altra guida se stai cercando informazioni riguardo al tipo di flusso.
10. Imposta la dimensione del buffer se necessario (senza dimenticare di salvare se necessario).
11. Clicca sul pulsante per Salvare ed uscire:
    

Ora puoi configurare un'applicazione con i parametri ottenuti alla fine di questa procedura.

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

Premessa

• Mediapulse, organizzazione indipendente in Svizzera, misura gli ascolti della radio, della televisione e delle piattaforme online.
• Questi dati, riconosciuti come riferimento ufficiale, aiutano il mercato dei media e della pubblicità ad analizzare, confrontare e strutturare le loro attività.
• Sottoposta alla vigilanza del DETEC tramite l’OFCOM, Mediapulse garantisce trasparenza, indipendenza e rigore scientifico; assicura misurazioni affidabili e adattate all’evoluzione dei media.
• È possibile esportare i vostri log radio verso questo servizio.
• Prendete anche visione di questa altra guida riguardante un servizio simile ma destinato alla Francia.

Gestire la certificazione Mediapulse

Prerequisiti

• L'Organizzazione in cui si trova il servizio di Streaming deve essere costituita con un indirizzo in Svizzera.
• Per attivare la certificazione Mediapulse, vi preghiamo di contattare questo servizio via mail: info@mediapulse.ch.
• Una volta stabilito il contratto con questi ultimi, contattate il supporto Infomaniak indicando le informazioni relative al vostro contratto Mediapulse e Infomaniak.

Per gestire l'attivazione o la disattivazione del servizio:

1. Cliccate qui per accedere alla gestione del vostro prodotto sul Manager Infomaniak (bisogno di aiuto?).
2. Cliccate direttamente sul nome attribuito al prodotto interessato.
3. Cliccate sul nome del flusso audio interessato.
4. Cliccate su Impostazioni nel menu laterale sinistro.
5. Attivate o disattivate l'esportazione dei log verso Mediapulse con il pulsante a scorrimento (toggle switch):
   ‍

Questa guida spiega come trasferire i flussi audio presenti su una delle tue Radio in Streaming Infomaniak a un'altra delle tue radio, presente nella stessa Organizzazione.

Trasferire i flussi audio

Per fare questo: 

1. Clicca qui per accedere alla gestione del tuo prodotto sul Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Clicca su il menu delle azioni ⋮ posizionato a destra dell'elemento interessato.
4. Seleziona Trasferisci:
   
5. Cerca e conferma il nome dell'altra radio che possiedi nella stessa Organizzazione.
6. Conferma il trasferimento:
   

Aggiorna le pagine del Manager se necessario per aggiornare le informazioni visualizzate.

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 presenta HLS, che segmenta il tuo audio per una trasmissione HTTP affidabile, compatibile e altamente distribuibile, ideale per un pubblico mobile e numeroso.

Cos'è HLS?

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

Nel tuo servizio di Streaming Radio, l'attivazione di HLS aggiunge un flusso aggiuntivo dedicato. Ha la propria URL di ascolto (manifesto HLS) e può essere selezionato e prioritizzato nel Player infomaniak. Il flusso HLS coesiste con i tuoi flussi storici (es. MP3/AAC), senza interruzioni del servizio.

Vantaggi per un flusso radiofonico

• Compatibilità estesa: supporto nativo su iOS/iPadOS (Safari) e ampia compatibilità tramite lettori HTML5 moderni e applicazioni di terze parti.
• Scalabilità e prestazioni: trasmissione via HTTP(S) facilmente distribuibile tramite CDN e cache; migliore scalabilità rispetto a un singolo flusso continuo.
• Robustezza: in caso di micro-interruzioni, il lettore può recuperare i segmenti successivi e riprendere rapidamente; meno sensibile alle perdite momentanee.
• Attraversamento delle reti: funziona su 80/443, generalmente meglio accettato dai firewall e proxy aziendali rispetto a certi flussi “ICY”.
• HTTPS semplificato: consegna sicura senza plugin o protocolli esotici.
• Adattamento del bitrate (ABR): quando vengono offerte più varianti, il lettore può passare automaticamente in base alla qualità della rete per limitare le interruzioni in mobilità.
• Flessibilità di integrazione: un punto di ascolto distinto permette di esporre HLS come flusso principale, secondario o di backup nel tuo Player.

Specifiche e punti di attenzione

• Latenza: HLS aggiunge una latenza generalmente di qualche decina di secondi (legata alla dimensione dei segmenti e al buffering). È normale per questo protocollo.
• Lettore compatibile richiesto: utilizza il player infomaniak o un lettore/web SDK che supporti i manifesti .m3u8.
• Parco eterogeneo: alcuni ricevitori hardware obsoleti (webradio, autoradio IP) accettano solo flussi MP3/Icecast; conserva le loro URL storiche in parallelo.
• ABR condizionale: l'adattamento del bitrate è efficace solo se vengono pubblicati più profili; in mancanza, il flusso HLS rimane funzionante in qualità unica.

Questa guida spiega come mantenere il controllo sui vostri flussi di Streaming Radio MP3/AAC o HLS attivando la protezione con chiave unica (token) per decidere, ad esempio, se un ascoltatore può ascoltare la vostra radio o meno.

Premessa

• Ad ogni connessione, effettuerete una richiesta all'API Infomaniak che vi restituirà un token unico con una durata limitata e parametrabile.
• Questo token autorizzerà chiunque lo possieda a consumare il flusso durante questo periodo.
• Potete proteggere un flusso MP3/AAC o HLS indipendentemente l'uno dall'altro (stesso discorso per la geolocalizzazione, del resto).
• L'attivazione della restrizione comporta una modifica della configurazione del flusso che può richiedere alcuni minuti per essere replicata sui server.

Proteggere un flusso audio con chiave unica

Per farlo, basta andare nelle impostazioni delle restrizioni e attivare la protezione con token sul flusso che si desidera proteggere:

1. Cliccate qui per accedere alla gestione del vostro prodotto sul Manager Infomaniak (bisogno di aiuto?).
2. Cliccate direttamente sul nome attribuito al prodotto interessato:
   
3. Cliccate:
   1. oppure sul nome della radio:
      
   2. oppure su Restrizioni nel menu laterale sinistro per applicare restrizioni all'intero prodotto:
      
4. Quando scegliete a sopra, cliccate poi su Restrizioni nel menu laterale sinistro.
5. Scegliete HLS se necessario.
6. Cliccate sul menu di azione ⋮ situato a destra dell'elemento interessato.
7. Cliccate su Restrizione con token:
   
    

Attivate quindi la protezione.

Attenzione, nel momento in cui attivate questa opzione, l'accesso al flusso sarà immediatamente bloccato per le nuove connessioni. Adattate i vostri Player per tenere conto della restrizione, come illustrato nell'esempio qui sotto:

Creare un token API Radio

Per accedere all'API Radio, è necessario autenticarsi innanzitutto con un token di applicazione. Questa operazione va eseguita una sola volta. Per creare questo token di applicazione, consultare questa altra guida.

Lo scope è radio e la durata è illimitata per evitare di dover rigenerare un codice in modo regolare. Una volta generato il token, copiarlo per incollarlo nell'esempio qui sotto.

Esempio di utilizzo in linguaggio PHP

Per MP3/AAC o HLS, il codice può essere sostanzialmente lo stesso, cambia solo l'URL chiamata in POST a livello della sua forma.

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'];
}

Vediamo come creare il token, l'URL di creazione del token si scompone come segue:

• Per un flusso MP3 / AAC

POST https://api.infomaniak.com/1/radios/acl/streams/mountpoint.mp3/token

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 un flusso HLS

POST https://api.infomaniak.com/1/radios/acl/hls_streams/<stream>/token

Esempio per proteggere https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8 il percorso sarà: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Esempio nel caso del MP3 / AAC, ricordarsi di regolare:

$token = request(
    'POST',
   'https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token',
    // 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'ascoltatore avrà "window" secondi per avviare la riproduzione del flusso. Oltre questo intervallo di tempo, il token scadrà e il flusso non potrà più essere avviato a meno che la pagina non venga ricaricata. A seconda delle esigenze e del caso d'uso, sarà necessario regolare questo intervallo nel modo migliore possibile.

Sarà anche necessario sostituire qui sotto l'URL di lettura del proprio flusso al posto di quella indicata mantenendo il parametro $token alla fine. E per finire, si visualizza il Player (qui una semplice etichetta html5, ma si può aggiungere ovviamente qualsiasi sovrapposizione dopo, il token essendo passato nei parametri $_GET dell'url).

$streamUrl = "https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac?$token";
echo "<audio controls=""><source src="$streamUrl"></audio>";

Questa guida riguarda le statistiche di Streaming Radio che vi permettono, tra le altre cose, di consultare eventuali interruzioni del flusso.

Analizzare le statistiche recenti

Per accedere a queste informazioni:

1. Clicca qui per accedere alla gestione del tuo prodotto su Infomaniak Manager (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato:
   
3. Clicca su Statistiche nel menu laterale sinistro:
   
4. Clicca su Audience in tempo reale nel menu laterale sinistro.
5. Scegli una data per caricare il grafico corrispondente.
6. Passa con il mouse sulle eventuali interruzioni segnalate a colori per ottenere informazioni:
   
7. Ingrandisci il grafico con la rotellina del mouse o selezionando il periodo.
8. Puoi tornare alla visualizzazione iniziale cliccando 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.