Base de conocimientos

Esta guía se refiere a la información de escucha de Streaming Radio que pueden exportarse a través del Protocolo FTP ; estos logs (de los cuales también proceden los estadísticas de escucha A continuación, FTP transfiere automáticamente el tratamiento después de la depuración" o "limpieza de la limpieza."

Preámbulo

• Los registros de su radio se proporcionarán en forma de archivo comprimido xyz.mp3-20140805.log.gz (la fecha del log es YYYMMDD).
• Cada log comienza a las 04:00 hora suiza y termina a las 03:59:59 al día siguiente.
• El log está en la formaip user-identifier authuser [date-time] "request" status octets "referer" "useragent" listening-time:

  • 81.56.215.98 - - [09/Apr/2019:08:23:18 +0200] "GET /toto.mp3 HTTP/1.1" 200 1211297 "-" "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.0.8) Gecko/2019032711 Ubuntu/8.10 (intrepid) Firefox/3.0.8" 69

  • Puede suceder que la línea de log esté mal formada, debido a un referer demasiado largo p.ex; este comportamiento de Icecast no puede ser modificado.
• Las direcciones de la fila IP 84.16.67.128/25 deben ser ignoradas porque son servidores de streaming.
• Desde la página de configuración del Manager, puede volver a solicitar los registros de los días pasados.
• También puede exportarlos directamente a ACPM o Mediapulse.

Activar envío de logs por FTP

Para ello:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente sobre el nombreasignado al producto afectado.
3. Haga clic en el nombre del flujo de audio de que se trate.
4. Haga clic en Parámetros en el menú lateral izquierdo.
5. Active la exportación de logs por FTP con el botón de cambio (toggle switch).
6. Adelante. nombre de host: dirección del servidor FTP.
7. Adelante. nombre de usuario: nombre de la cuenta FTP.
8. Adelante. contraseña: la cuenta FTP.
9. Introduzca el directorio en el servidor en el que almacenar los logs.
10. Haga clic en el botón Guardar al pie de la página:
    

Procesar logs

Lo mejor es usar una expresión regular como la siguiente:

"/^(\S+)\s(.+)\s(\S+)?\s\[((\d\d)\/([a-zA-Z]{3,3})\/(\d\d\d\d)\:(\d\d)\:(\d\d)\:(\d\d)\s\+\d\d\d\d)\]\s"GET\s\/([\-a-z0-9]{1,40}(\.)?(mp3|aac|ogg){0,1})(.*)?"\s(\d{3,3})\s(\d+)\s"(.+)"\s"(.+)"\s(\d+)$/i";

Esta sintaxis es la de la función PHP preg_match y deberá adaptarse si se utilizan otras funciones/lenguajes.

Función preg_match da un cuadro con las siguientes posiciones significativas:

Esta guía explica cómo transmitir metadata (metadatos) para el flujo de radio enviado desde su codificador de Streaming radio .

Usar la URL disponible

Sólo tienes que hacer un GET en una URL de tipo:

https://[flux]:[password]@api.infomaniak.com/1/radios/stats/metadata?data=artist - title

La URL completa está disponible en la interfaz de administración:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente sobre el nombreasignado al producto afectado.
3. Haga clic en el nombre del flujo de audio de que se trate.
4. Haga clic en Parámetros en el menú lateral izquierdo.
5. Haga clic en el botón para copiar el vínculo de metadata:
   

Más información

Para los desarrolladores que codifiquen un Player, existen librerías que pueden buscar la información transmitida y mostrarla, ya que en los datos del flujo se transmiten los datos. La otra posibilidad es recuperar la información del flujo en el servidor mismo.

Esta guía se refiere a las estadísticas de audiencia y escucha de Streaming Radio que le permiten ver toda la información sobre los oyentes & diferentes audiencias de sus canales de radio.

Preámbulo

• Conozca esta otra guía si desea tratar los logs brutos por sí mismo.

Acceso a las estadísticas de escucha

Para acceder a esta información:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente sobre el nombreasignado al producto afectado.
3. Haga clic en Estadísticas en el menú lateral izquierdo:
   
4. Haga clic en los diferentes menús en el menú lateral izquierdo:

Sinopsis

Audiencia en tiempo real

Conozca esta otra guía Acerca de eso.

Auditores

Tiempo de escucha

Consumo

Geolocalización

La exportación en formato .csv es posible:

Players

Esta guía explica cómo eliminar un flujo de audio de su Streaming Radio, sin eliminar el producto completo.

Borrar radio

Con el fin de acceder al servicio de Streaming y eliminar uno de los flujos:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente en el nombreasignado al producto afectado:
   
3. Haga clic en el nombre de la radio:
   
4. Haga clic en el menú de acciónsituado a la derecha del elemento afectado.
5. Haga clic en Eliminar:
   
6. Introduzca el nombre de la radio para validar la eliminación.

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

Configurar la difusión de un flujo de radio

Para acceder al servicio de radio de Streaming:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente sobre el nombreasignado al producto afectado.
3. Haga clic en el nombre de la radio.
4. Haga clic en el botón Añadir flujo:
   
5. y una segunda vez en el botón Añadir flujo:
   
6. Añadir un flujo estándar:
   
7. Elija las opciones deseadas:
   
8. Haga clic en el botón Guardar.

Esta guía explica cómo especificar un flujo de audio de emergencia en el Streaming radio Infomaniak.

Así que si su flujo principal no está disponible, el flujo de emergencia tomará automáticamente el relevo de la difusión.

Crear un flujo de socorro

Para acceder al servicio de radio de Streaming:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente sobre el nombreasignado al producto afectado.
3. Haga clic en el nombre de la radio.
4. Haga clic en el botón Añadir flujo para crear un nuevo flujo y adjuntarle un flujo de emergencia o Configurar un flujo existente para activar la opción:
   
5. Haga clic en el botón de cambio (toggle switch) para activar el flujo de emergencia en su flujo:
   
6. Copia la información a tu disposición para configurar tu codificador de emergencia.
7. Guarde la activación del flujo de emergencia en la parte inferior derecha de la página.

En el mismo lugar usted puede definir el flujo de emergencia como un relés de flujo para introducir manualmente los parámetros correspondientes al flujo de audio de emergencia:

Guarde la nueva información en la parte inferior derecha de la página.

Esta guía se refiere a la información de escucha de Streaming Radio que pueden exportarse a ACPM (ex OJD Digital).

Preámbulo

• La Alianza para las Cifras de Prensa y Medios de Comunicación es una organización independiente en Francia que certifica los datos relativos a la difusión, la audiencia y la frecuentación de los medios de comunicación.
• Estos datos, reconocidos como referencia oficial, apoyan a los agentes del mercado de los medios de comunicación y de la publicidad en el análisis, la comparación y la estructuración de sus estrategias.
• Bajo la gobernanza de sus instancias integradas por profesionales de los medios de comunicación, la Comisión garantiza la transparencia, la independencia y el rigor metodológico; garantiza certificaciones fiables y coherentes con la evolución del sector de los medios de comunicación.
• Conozca también esta otra guía sobre un servicio similar pero destinado a Suiza.

Gestionar la certificación ACPM

Requisitos previos

• La Organización en la que se encuentre el servicio de Streaming debe establecerse con una dirección en Francia.
• Para activar la certificación ACPM, por favor, póngase en contacto con este servicio por correo electrónico:equipe-ojdnumerique@acpm.fr.
• Una vez establecido el contrato con estos últimos,Póngase en contacto con el soporte Infomaniakindicando la información relativa a su contrato ACPM 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 (¿Necesitas ayuda?).
2. Haga clic directamente sobre el nombreasignado al producto afectado.
3. Haga clic en el nombre del flujo de audio de que se trate.
4. Haga clic en Parámetros en el menú lateral izquierdo.
5. Active o desactive la exportación de logs a ACPM con el botón de cambio (toggle switch):
   ‍

SpacialAudio SAM Cast es compatible con la oferta de transmisión de audio.

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

Preámbulo

• El principio es simple: en cada conexión, harás una consulta a la API Infomaniak que te devolverá un token único con una vida útil limitada y parametrable. Este token permitirá a cualquiera que lo posea consumir el flujo durante este período.
• Usted puede proteger un flujo MP3/AAC o HLS independientemente uno del otro (idem para la geolocalización por otra parte).
• La activación de la restricción implica un cambio en la configuración del flujo que puede tomar unos minutos para ser replicada en los servidores.

Proteger un flujo de audio por clave única

Para ello, sólo tienes que ir a la configuración de restricciones y activar la protección de token en el flujo que deseas asegurar:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente sobre el nombreasignado al producto afectado.
3. Haga clic en el nombre del flujo de audio de que se trate.
4. Haga clic en Restricciones en el menú lateral izquierdo.
5. Elija HLS si es necesario.
6. Haga clic en el menú de acción ⋮situado a la derecha del elemento afectado.
7. Haga clic en Restricción por token:
   
    

A continuación, active la protección.

Atención, al activar esta opción, el acceso al flujo se bloqueará instantáneamente para las nuevas conexiones. Adapte sus Players para tener en cuenta la restricción, como se muestra en el ejemplo siguiente:

 

Crear un token API Radio

Para tener acceso a la API Radio, primero debe autentificarse con un token aplicación. Este paso sólo tiene que hacerse una vez. Para crear este token de aplicación, lea esta guía.

El scope es Radio y la duración de vida ilimitada para evitar tener que regenerar un código de manera regular. Una vez generado el token, copiarlo para pegarlo en el ejemplo de abajo.

Ejemplo de uso en lenguaje PHP

Para MP3/AAC o HLS, el código puede ser sustancialmente el mismo, sólo la URL llamada POST cambia en 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 carretera 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 carretera será: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Ejemplo en el caso del MP3 / AAC, piense en 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 auditor tendrá "window" segundos para iniciar la lectura del flujo. Más allá de este plazo, el token expirará, y el flujo no podrá ser lanzado a menos que se cargue la página. Según sus necesidades y su caso de uso, será necesario ajustar este plazo de la mejor manera posible.

También será necesario reemplazar a continuación la URL de lectura de su feed en lugar de la indicada, manteniendo al mismo tiempo el parámetro $token Al final. Y por último, se muestra el Player (aquí una simple etiqueta html5, pero se puede añadir por supuesto cualquier sobrecapa después, ya que el token ha pasado a los parámetros $_GET del url).

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