Este guia explica como cancelar completamente uma oferta de Rádio Online.

Introdução

• Para a maioria dos produtos, confirme o pedido de cancelamento por e-mail, caso contrário, nenhum dado será eliminado.
• Consulte este outro guia para remover um fluxo de áudio da sua Rádio Online, sem eliminar o produto por completo.
• As taxas incorridas e que não estão incluídas no plano permanecem devidas.
• Uma confirmação do cancelamento é enviada aos outros administradores da Organização, caso existam.
• Os backups serão eliminados de forma irreversível durante o cancelamento, tornando qualquer restauração impossível.

Cancelar a oferta de Rádio Online

Para aceder ao cancelamento da oferta:

1. Clique aqui para aceder à gestão do seu produto no Manager Infomaniak (precisa de ajuda?).
2. Clique no menu de ação ⋮ localizado à direita do elemento em questão.
3. Escolha Cancelar:
   
4. Siga o procedimento até ao fim.

This guide explains how to properly configure a stream on the Infomaniak Radio Streaming.

Configure radio stream broadcasting

To access the Radio Streaming service:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned.
3. Click on the radio name.
4. Click on the Configure Streams button:
   
5. Click on the Add a Stream button:
   
6. Add a standard stream (refer to this other guide regarding stream relays).
7. Click on the button to Continue:
   
8. Choose the desired options, including you can enable HLS which will not be counted in the total number of streams.
9. Configure the desired quality and refer to this other guide if you are looking for information about the type of stream.
10. Adjust the buffer size if necessary (do not forget to save if necessary).
11. Click on the button to Save and Exit:
    

You can now configure an application with the parameters obtained at the end of this procedure.

This guide covers the listening information of Streaming Radio that can be exported to Mediapulse.

Preamble

• Mediapulse, an independent organization in Switzerland, measures the audiences of radio, television, and online platforms.
• These data, recognized as the official reference, help the media and advertising market to analyze, compare, and structure their activities.
• Subject to the supervision of the DETEC via OFCOM, Mediapulse ensures transparency, independence, and scientific rigor; it guarantees reliable measurements adapted to the evolution of the media.
• It is possible to export your radio logs to this service.
• Also refer to this other guide regarding a similar service but intended for France.

Manage Mediapulse certification

Prerequisites

• The Organization in which the Streaming service is located must be established with an address in Switzerland.
• To activate Mediapulse certification, please contact this service by email: info@mediapulse.ch.
• Once the contract is established with them, contact Infomaniak support by indicating the information related to your Mediapulse and Infomaniak contract.

To manage the activation or deactivation of the service:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned.
3. Click on the name of the audio stream concerned.
4. Click on Settings in the left sidebar.
5. Activate or deactivate the export of logs to Mediapulse with the toggle switch:
   ‍

This guide explains how to transfer the audio streams present on one of your Streaming Radio Infomaniak to another of your radios, present in the same Organization.

Transfer audio streams

To do this: 

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned.
3. Click on the action menu ⋮ located to the right of the item concerned.
4. Choose Transfer:
   
5. Search for and validate the name of the other radio that you own in the same Organization.
6. Validate the transfer:
   

Refresh the Manager pages if necessary to update the displayed information.

Este guia aborda o controle ao vivo (timeshift), que permite aos seus ouvintes pausar, retroceder e, em seguida, retornar à transmissão ao vivo dos seus fluxos HLS, com uma profundidade de retrocesso de até 2 horas.

Introdução

• Ao contrário do Timeshift Streaming de Vídeo, não existe uma ferramenta de agendamento relacionada ao lado do Rádio.
• A reprodução/retrocesso está desativada por padrão no Player para que você tenha controle sobre a exposição ao público.

Oferecer o controle ao vivo aos ouvintes

Pré-requisitos

• Criar ou editar um fluxo HLS no seu produto Streaming de Rádio.

Em seguida:

1. Ao criar (ou modificar) um fluxo HLS, defina o Buffer entre 00:00:25 e 02:00:00. Este valor, entre 25 segundos e 2 horas, corresponde à duração máxima durante a qual os ouvintes podem retroceder e pausar a transmissão ao vivo, antes de retornar à transmissão ao vivo. Ele determina a profundidade do controle ao vivo. Exemplos:
   
   • 00:00:25 → 05:00: tolerância mínima para pausas curtas.
   • 10:00 → 30:00: ideal para formatos de notícias/talk.
   • 30:00 → 02:00:00: conforto máximo para programas de música e eventos.
2. Ativar a função de retomar a reprodução no seu reprodutor (consulte este outro guia) se desejar disponibilizá-la aos ouvintes (desativada por padrão):
   

This guide introduces HLS, which segments your audio for reliable, compatible, and highly distributable HTTP streaming, ideal for mobile and large audiences.

What is HLS?

HLS (HTTP Live Streaming) is a streaming protocol that cuts audio into small segments of a few seconds and publishes a .m3u8 manifest listing these segments. The Player downloads these segments via HTTP/HTTPS (ports 80/443), which facilitates caching, recovery after interruption, and large-scale distribution.

On your Radio Streaming service, activating HLS adds an additional dedicated stream. It has its own listening URL (HLS manifest) and can be selected and prioritized in the infomaniak Player. The HLS stream coexists with your historical streams (e.g., MP3/AAC), without service disruption.

Benefits for a radio stream

• Extended compatibility: native support on iOS/iPadOS (Safari) and wide support via modern HTML5 players and third-party applications.
• Scalability and performance: streaming via HTTP(S) easily distributable by CDN and caches; better scalability than a single continuous stream.
• Robustness: in case of micro-cuts, the player can recover the following segments and resume quickly; less sensitive to temporary losses.
• Network traversal: works on 80/443, generally better accepted by corporate firewalls and proxies than certain “ICY” streams.
• Simplified HTTPS: secure delivery without plugins or exotic protocols.
• Bitrate adaptation (ABR): when multiple variants are offered, the player can automatically switch according to network quality to limit interruptions in mobility.
• Integration flexibility: a distinct listening point allows exposing HLS as the main, secondary, or backup stream in your Player.

Specificities and points of attention

• Latency: HLS adds latency generally in the order of a few tens of seconds (related to the size of the segments and buffering). This is normal for this protocol.
• Compatible player required: use the infomaniak player or a player/web SDK supporting .m3u8 manifests.
• Heterogeneous fleet: some older hardware receivers (web radios, IP car radios) only accept MP3/Icecast streams; keep their historical URLs in parallel.
• Conditional ABR: bitrate adaptation is only effective if multiple profiles are published; otherwise, the HLS stream remains functional in single quality.

This guide explains how to maintain control over your Radio Streaming MP3/AAC or HLS by activating protection by unique key (token) to decide, for example, whether a listener can listen to your radio or not.

Preamble

• With each connection, you will make a request to the Infomaniak API, which will return a unique token with a limited and configurable lifespan.
• This token will authorize anyone who possesses it to consume the stream during this period.
• You can protect an MP3/AAC or HLS stream independently of each other (the same applies to geolocation, by the way).
• Activating the restriction involves changing the stream configuration, which may take a few minutes to be replicated on the servers.

Protect an audio stream by unique key

To do this, simply go to the restriction settings and activate token protection on the stream you want to secure:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned:
   
3. Click:
   1. either on the radio name:
      
   2. or on Restrictions in the left sidebar to apply restrictions to the entire product:
      
4. When choosing a above, then click on Restrictions in the left sidebar.
5. Choose HLS if necessary.
6. Click on the action menu ⋮ located to the right of the item concerned.
7. Click on Token restriction:
   
    

Then activate the protection.

Warning, at the moment you activate this option, access to the stream will be instantly blocked for new connections. Adapt your Players to take into account the restriction, as illustrated in the example below:

Create a Radio API token

To access the Radio API, you must first authenticate using an application token. This step only needs to be done once. To create this application token, refer to this other guide.

The scope is radio and the duration is unlimited to avoid having to regenerate a code regularly. Once the token is generated, copy it to paste it into the example below.

Example of use in PHP language

For MP3/AAC or HLS, the code can be substantially the same, only the URL called in POST changes in its form.

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

We will create the token, the URL for creating the token breaks down as follows:

• For an MP3/AAC stream

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

Example to protect https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac the route will be: https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token

• For an HLS stream

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

Example to protect https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8 the route will be: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Example in the case of MP3/AAC, remember to adjust:

$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
    ]
);

It is important to note that if this code is generated at the time the page is loaded, the listener will have "window" seconds to start playing the stream. Beyond this time limit, the token will expire, and the stream will no longer be able to be started unless the page is reloaded. Depending on your needs and use case, it will be necessary to adjust this delay in the best possible way.

You will also need to replace the playback URL of your stream below with the one indicated while keeping the parameter $token at the end. And finally, we display the Player (here a simple html5 tag, but you can of course add any overlay afterwards, the token being passed in the parameters $_GET of the url).

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

This guide covers the statistics of Streaming Radio which allow you, among other things, to check any possible stream interruptions.

Analyze recent statistics

To access this information:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned:
   
3. Click on Statistics in the left sidebar:
   
4. Click on Real-time audience in the left sidebar.
5. Choose a date to load the corresponding graph.
6. Hover over any reported interruptions highlighted in color to get information:
   
7. Zoom in on the graph with the mouse wheel or by framing the period.
8. You can return to the initial display by clicking at the bottom right:
   

Este guia detalha a configuração de um reprodutor para o seu Streaming de Rádio Infomaniak.

Pré-requisitos

• Adicionar 1 reprodutor usando o modelo Infomaniak.

Configurar as opções do reprodutor Infomaniak

Depois de vincular o seu fluxo ao seu reprodutor e de o seu reprodutor ser criado:

1. Clique aqui para acessar o gerenciamento do seu produto no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao produto em questão.
3. Clique em Meus reprodutores no menu lateral esquerdo.
4. Clique no nome do reprodutor a ser configurado (ou adicione um novo reprodutor clicando no botão acima):
   

1. Guia Aparência

É aqui que pode escolher o tamanho do reprodutor (grande, médio, mini ou reprodutor de várias rádios) e a sua percentagem de exibição.

Pode personalizar as cores do fundo, dos botões e do texto:

Um botão de alternância permite ativar ou desativar a exibição das faixas reproduzidas, com ou sem os seus horários de reprodução:

• Consulte os detalhes sobre este assunto no final deste guia.

O reprodutor pode exibir:

• uma ilustração que representa a capa do álbum ou uma imagem de substituição, caso não esteja disponível,
• uma imagem estática (3 MB máx.),
• o logotipo da sua rádio, que pode personalizar aqui:
  
• uma visualização do espectro de áudio (Espectrograma/Espectro).

2. Separador Transmissão

É aqui que pode associar os seus fluxos de rádio (HLS ou não) ao seu reprodutor que está a configurar.

Consulte este outro guia sobre as opções disponíveis para a gestão da transmissão em direto:

3. Separador Miniaturas (pré-visualização da mídia)

É aqui que pode alterar a imagem de pré-visualização (miniatura) visível no reprodutor do ouvinte quando a mídia está a carregar ou indisponível/restrita:

4. Separador Informações do reprodutor

É aqui que pode dar um nome ao seu reprodutor e decidir se quer mostrar ou ocultar:

• o título e o artista em vez do nome da rádio,
• o número de ouvintes,
• o logótipo da Infomaniak.

5. Separador Opções de partilha

Um botão de alternância (toggle switch) permite ativar ou desativar certos serviços, como o Facebook:

Uma vez ativado, um botão de compartilhamento para esses serviços será visível no seu Player:

Detalhes do histórico de transmissão (guia #1)

O histórico de transmissão permite ouvir novamente as músicas transmitidas (entre 1 e 40), caso o seu fluxo seja do tipo HLS (você poderá então definir um buffer que varia de 25 segundos a 2 horas):

A funcionalidade de retroceder e ouvir novamente não está ativada por padrão: ela permanece opcional, a fim de respeitar as restrições de alguns países ou rádios. Uma vez ativada, o administrador da rádio pode escolher quais fluxos estarão disponíveis para transmissão (consulte a guia #2 acima), enquanto o ouvinte pode selecionar a qualidade do áudio no Player:

Position & intégration de l'historique de diffusion

A lista pode ser consultada das seguintes formas:

• diretamente abaixo do Player,
• no Player,
• ou em uma janela separada na integração do seu site…

De fato, é possível exibir o histórico em uma segunda iframe, distinta da do Player principal. Exemplo de URL para o Player:
https://player-radio.infomaniak.com/2/prod/super/7cbaa24a-3510-47a4-b41e-b99218bfd507

E para o histórico arquivado:

https://player-radio.infomaniak.com/2/prod/history

As duas iframes devem ser integradas na mesma página e comunicam entre si para atualizar o histórico ou iniciar uma faixa que já foi transmitida.

Um segundo modo de integração permite exibir um histórico autônomo, sem a iframe principal. Basta adicionar o ID do Player à URL: