Esta guía explica cómo cancelar por completo una oferta de Radio por streaming.

Introducción

• Para la mayoría de los productos, confirme la solicitud de cancelación por correo electrónico; de lo contrario, no se eliminarán datos.
• Consulte esta otra guía para eliminar un flujo de audio de su Radio por streaming, sin eliminar el producto por completo.
• Los cargos abiertos y que exceden el plan contratado deberán pagarse.
• Se enviará una confirmación de cancelación a los demás administradores de la Organización.
• Las copias de seguridad se eliminarán de forma irreversible al cancelar, lo que hará que cualquier restauración sea imposible.

Cancelar la oferta de Radio por streaming

Para acceder a la cancelación de la oferta:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic en el menú de acción ⋮ situado a la derecha del elemento correspondiente.
3. Elija Cancelar:
   
4. Siga el procedimiento hasta el final.

Esta guía explica cómo configurar correctamente un flujo en el Streaming de radio de Infomaniak.

Configurar la transmisión de un flujo de radio

Para acceder al servicio de Streaming de radio:

1. Haga clic aquí para acceder a la gestión de su producto en el Gestor de Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto correspondiente.
3. Haga clic en el nombre de la radio.
4. Haga clic en el botón Configurar flujos:
   
5. Haga clic en el botón Agregar un flujo:
   
6. Agregar un flujo estándar (consulte esta otra guía sobre los relés de flujo).
7. Haga clic en el botón para Continuar:
   
8. Elija las opciones deseadas, en particular puede activar el HLS que no se contará en el número total de flujos.
9. Configure la calidad deseada y consulte esta otra guía si busca información sobre el tipo de flujo.
10. Ajuste el tamaño del búfer si es necesario (sin olvidar de guardar si es necesario).
11. Haga clic en el botón para Guardar y salir:
    

Ahora puede configurar una aplicación con los parámetros obtenidos al final de este procedimiento.

Esta guía se refiere a la información de escucha de Streaming Radio que puede exportarse a Mediapulse.

Prólogo

• Mediapulse, organización independiente en Suiza, mide las audiencias de la radio, la televisión y las plataformas en línea.
• Estos datos, reconocidos como referencia oficial, ayudan al mercado de los medios y la publicidad a analizar, comparar y estructurar sus actividades.
• Sometida a la supervisión del DETEC a través de la OFCOM, Mediapulse garantiza transparencia, independencia y rigor científico; asegura medidas fiables y adaptadas a la evolución de los medios.
• Es posible exportar sus registros de radio a este servicio.
• Tenga en cuenta también esta otra guía sobre un servicio similar, pero destinado a Francia.

Gestionar la certificación Mediapulse

Requisitos previos

• La Organización en la que se encuentra el servicio de Streaming debe estar establecida con una dirección en Suiza.
• Para activar la certificación Mediapulse, por favor póngase en contacto con este servicio por correo electrónico: info@mediapulse.ch.
• Una vez establecido el contrato con ellos, contacte con el soporte de Infomaniak indicando la información relativa a su contrato Mediapulse e Infomaniak.

Para gestionar la activación o desactivación del servicio:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto concernido.
3. Haga clic en el nombre del flujo de audio concernido.
4. Haga clic en Configuración en el menú lateral izquierdo.
5. Active o desactive la exportación de los registros a Mediapulse con el botón de alternancia (toggle switch):
   ‍

Esta guía explica cómo transferir los flujos de audio presentes en una de sus Radios de Streaming de Infomaniak a otra de sus radios, presente en la misma Organización.

Transferir los flujos de audio

Para ello: 

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto concernido.
3. Haga clic en el menú de acción ⋮ situado a la derecha del elemento concernido.
4. Seleccione Transferir:
   
5. Busque y valide el nombre de la otra radio que posee en la misma Organización.
6. Valide la transferencia:
   

Actualice las páginas del Manager si es necesario para actualizar la información mostrada.

Esta guía trata sobre el control en directo (timeshift), que permite a sus oyentes pausar, retroceder y volver a la transmisión en directo de sus flujos HLS, con una profundidad de retroceso de hasta 2 horas.

Introducción

• A diferencia del Timeshift de transmisión de vídeo, no existe una herramienta de programación relacionada en el lado de la radio.
• La reproducción/retroceso está desactivada por defecto en el reproductor para que usted tenga el control sobre la exposición al público.

Ofrecer el control en directo a los oyentes

Requisitos previos

• Crear o editar un flujo HLS en su producto de transmisión de radio.

A continuación:

1. Al crear (o modificar) un flujo HLS, defina el búfer entre 00:00:25 y 02:00:00. Este valor, entre 25 segundos y 2 horas, corresponde a la duración máxima durante la cual los oyentes pueden retroceder y pausar la transmisión en directo antes de volver a la transmisión en directo. Determina la profundidad del control en directo. Ejemplos:
   
   • 00:00:25 → 05:00: tolerancia mínima para pausas cortas.
   • 10:00 → 30:00: ideal para formatos de noticias/programas de entrevistas.
   • 30:00 → 02:00:00: máxima comodidad para programas de música y eventos.
2. Activar la función de reproducción continua en su reproductor (consulte esta otra guía) si desea ofrecerla a los oyentes (está desactivada por defecto):
   

Esta guía presenta HLS, que segmenta su audio para una transmisión HTTP confiable, compatible y altamente distribuible, ideal para audiencias móviles y grandes.

¿Qué es HLS?

HLS (HTTP Live Streaming) es un protocolo de transmisión en continuo que divide el audio en pequeños segmentos de unos pocos segundos y publica un manifiesto .m3u8 que lista estos segmentos. El reproductor descarga estos segmentos a través de HTTP/HTTPS (puertos 80/443), lo que facilita la puesta en caché, la reanudación después de una interrupción y la distribución a gran escala.

En su servicio de Radio en Continuo, la activación de HLS añade un flujo adicional dedicado. Tiene su propia URL de escucha (manifiesto HLS) y puede ser seleccionado y priorizado en el reproductor de infomaniak. El flujo HLS coexiste con sus flujos históricos (por ejemplo, MP3/AAC), sin interrupción del servicio.

Ventajas para un flujo de radio

• Compatibilidad extendida: soporte nativo en iOS/iPadOS (Safari) y amplio soporte a través de reproductores HTML5 modernos y aplicaciones de terceros.
• Escalabilidad y rendimiento: transmisión a través de HTTP(S) fácilmente distribuible por CDN y caches; mejor escalabilidad que un flujo continuo único.
• Robustez: en caso de microcortes, el reproductor puede recuperar los segmentos siguientes y reanudar rápidamente; menos sensible a las pérdidas momentáneas.
• Transmisión a través de redes: funciona en 80/443, generalmente mejor aceptado por firewalls y proxys de empresa que ciertos flujos “ICY”.
• HTTPS simplificado: entrega segura sin plugins ni protocolos exóticos.
• Adaptación de velocidad (ABR): cuando se ofrecen varias variantes, el reproductor puede cambiar automáticamente según la calidad de la red para limitar los cortes en movilidad.
• Flexibilidad de integración: un punto de escucha distinto permite exponer HLS como flujo principal, secundario o de respaldo en su reproductor.

Especificidades y puntos de atención

• Latencia: HLS añade una latencia generalmente de unas pocas decenas de segundos (relacionada con el tamaño de los segmentos y el buffering). Es normal para este protocolo.
• Reproductor compatible requerido: utilice el reproductor de infomaniak o un reproductor/web SDK que soporte los manifiestos .m3u8.
• Parque heterogéneo: ciertos receptores de hardware antiguos (webradios, autorradios IP) solo aceptan flujos MP3/Icecast; conserve sus URLs históricas en paralelo.
• ABR condicional: la adaptación de velocidad solo es efectiva si se publican varios perfiles; de lo contrario, el flujo HLS sigue siendo funcional en calidad única.

Esta guía explica cómo mantener el control sobre sus flujos de Streaming Radio MP3/AAC o HLS activando la protección por clave única (token) para decidir, por ejemplo, si un oyente puede escuchar su radio o no.

Prólogo

• Cada vez que se conecte, realizará una solicitud a la API de Infomaniak que le devolverá un token único con una duración limitada y configurable.
• Este token permitirá a quien lo posea consumir el flujo durante este período.
• Puede proteger un flujo MP3/AAC o HLS de forma independiente (lo mismo ocurre con la geolocalización).
• La activación de la restricción implica un cambio en la configuración del flujo que puede tardar unos minutos en replicarse en los servidores.

Proteger un flujo de audio por clave única

Para hacerlo, simplemente vaya a los parámetros de restricciones y active la protección por token en el flujo que desea asegurar:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto correspondiente:
   
3. Haga clic:
   1. en el nombre de la radio:
      
   2. o en Restricciones en el menú lateral izquierdo para aplicar restricciones al producto completo:
      
4. Al elegir a arriba, haga clic luego en Restricciones en el menú lateral izquierdo.
5. Seleccione HLS si es necesario.
6. Haga clic en el menú de acción ⋮ situado a la derecha del elemento correspondiente.
7. Haga clic en Restricción por token:
   
    

Active luego la protección.

Atención, en el momento en que active esta opción, el acceso al flujo se bloqueará instantáneamente para las nuevas conexiones. Adapte sus reproductores para tener en cuenta la restricción, como se ilustra en el ejemplo a continuación:

Crear un token de API de Radio

Para acceder a la API de Radio, primero debe autenticarse utilizando un token de aplicación. Este paso solo debe realizarse una vez. Para crear este token de aplicación, consulte esta otra guía.

El ámbito es radio y la duración es ilimitada para evitar tener que regenerar un código de manera regular. Una vez generado el token, cópielo para pegarlo en el ejemplo a continuación.

Ejemplo de uso en lenguaje PHP

Para MP3/AAC o HLS, el código puede ser similar, solo cambia la URL llamada en POST en cuanto a su 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'];
}

Vamos a crear el token, la URL de creación del token se desglosa de la siguiente manera:

• Para un flujo MP3 / AAC

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

Ejemplo para proteger https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac la ruta será: https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token

• Para un flujo HLS

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

Ejemplo para proteger https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8 la ruta será: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Ejemplo en el caso del MP3 / AAC, asegúrese de ajustar:

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

Es importante tener en cuenta que si este código se genera en el momento de cargar la página, el oyente tendrá "window" segundos para iniciar la reproducción del flujo. Pasado este plazo, el token expirará y el flujo no podrá iniciarse a menos que la página se recargue. Según sus necesidades y su caso de uso, será necesario ajustar este plazo de la mejor manera posible.

También deberá reemplazar a continuación la URL de reproducción de su flujo en lugar de la indicada, conservando el parámetro $token al final. Y para terminar, se muestra el reproductor (aquí una simple etiqueta html5, pero se puede agregar cualquier sobrecarga después, ya que el token se pasa en los parámetros $_GET de la url).

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

Esta guía se refiere a las estadísticas de Radio en Streaming que le permiten, entre otras cosas, consultar posibles cortes de flujo.

Analizar las estadísticas recientes

Para acceder a esta información:

1. Haga clic aquí para acceder a la gestión de su producto en el Gestor Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto correspondiente:
   
3. Haga clic en Estadísticas en el menú lateral izquierdo:
   
4. Haga clic en Audiencia en tiempo real en el menú lateral izquierdo.
5. Elija una fecha para cargar el gráfico correspondiente.
6. Pase el ratón sobre los posibles cortes señalados en color para obtener información:
   
7. Aproxime el gráfico con la rueda del ratón o seleccionando el período.
8. Puede volver a la vista inicial haciendo clic en la parte inferior derecha:
   

Esta guía detalla la configuración de un reproductor para su Radio por streaming de Infomaniak.

Requisitos previos

• Agregar un reproductor utilizando la plantilla de Infomaniak.

Configurar las opciones del reproductor de Infomaniak

Una vez que haya vinculado su flujo al reproductor y haya creado el reproductor:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto correspondiente.
3. Haga clic en Mis reproductores en el menú lateral izquierdo.
4. Haga clic en el nombre del reproductor que desea configurar (o agregue un nuevo reproductor haciendo clic en el botón de arriba):
   

1. Pestaña Apariencia

Aquí puede elegir el tamaño del reproductor (grande, mediano, mini o reproductor de varias radios) y su porcentaje de visualización.

Puede personalizar los colores del fondo, los botones y el texto:

Un interruptor permite activar o desactivar la visualización de las canciones que se están reproduciendo, con o sin sus horas de reproducción:

• Consulte los detalles al respecto al final de esta guía.

El reproductor puede mostrar:

• una ilustración que represente la portada del álbum, o una imagen de sustitución si no está disponible,
• una imagen fija (3 MB máx.),
• el logotipo de su emisora de radio, que puede personalizar aquí:
  
• una visualización del espectro de audio (espectrograma).

2. Pestaña Emisión

Aquí puede vincular sus flujos de radio (HLS u otros) al reproductor que está configurando.

Consulte esta otra guía sobre las opciones disponibles para la gestión de la transmisión en directo:

3. Pestaña Miniaturas (vista previa del contenido multimedia)

Aquí puede modificar la imagen de vista previa (miniatura) que se muestra en el reproductor del oyente cuando el contenido multimedia se está cargando o está indisponible/restringido:

4. Pestaña Información del reproductor

Aquí puede asignar un nombre a su reproductor y decidir si desea mostrar u ocultar:

• el título y el artista en lugar del nombre de la emisora,
• el número de oyentes,
• el logotipo de Infomaniak.

5. Pestaña Opciones de uso compartido

Un interruptor (toggle switch) permite activar o desactivar ciertos servicios, como Facebook:

Una vez activado, aparecerá un botón para compartir en estos servicios en su reproductor:

Detalles del historial de reproducción (pestaña #1)

El historial de reproducción permite volver a escuchar las canciones reproducidas (entre 1 y 40) si su flujo es de tipo HLS (en este caso, podrá definir un búfer de memoria que oscile entre 25 segundos y 2 horas):

La función de retroceso y reproducción no está activada por defecto: sigue siendo opcional para respetar las restricciones de algunos países o emisoras. Una vez activada, el administrador de la emisora puede elegir qué flujos estarán disponibles para la reproducción (véase la pestaña #2 anterior), mientras que el oyente puede seleccionar la calidad de audio en el reproductor:

Position & intégration de l'historique de diffusion

La lista se puede consultar de las siguientes maneras:

• directamente debajo del reproductor,
• en el reproductor,
• o de forma independiente en la integración de su sitio web…

De hecho, es posible mostrar el historial en un segundo iframe, distinto del reproductor principal. Ejemplo de URL para el reproductor:
https://player-radio.infomaniak.com/2/prod/super/7cbaa24a-3510-47a4-b41e-b99218bfd507

Y para el historial: 
https://player-radio.infomaniak.com/2/prod/history

Ambos iframes deben integrarse en la misma página y se comunican entre sí para actualizar el historial o reproducir un título que se emitió previamente.

Un segundo modo de integración permite mostrar un historial independiente, sin el iframe principal. Basta con añadir el ID del reproductor a la URL: 
https://player-radio.infomaniak.com/2/prod/history/7cbaa24a-3510-47a4-b41e-b99218bfd507

Este modo es adecuado, por ejemplo, para los usuarios de otro reproductor que deseen mostrar únicamente el historial de títulos.