Wissensdatenbank

Dieser Leitfaden enthält Informationen über Streaming Radio die mit Hilfe von FTP-Protokoll ; diese Logs (von denen auch die Zuhörerstatistiken Nach der Reinigung" oder "Reinigung" werden dann automatisch von FTP übertragen, um dann behandelt zu werden.

Präambel

• Die Logs Ihres Radios werden als komprimierte Datei zur Verfügung gestellt. xyz.mp3-20140805.log.gz (Das Datum des Logs ist YYYMMDD).
• Jeder Log beginnt um 04:00 Schweizer Zeit und endet um 03:59:59 am nächsten Tag.
• Das Log ist in der Formip 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

  • Es kann vorkommen, dass die Log-Linie schlecht gebildet ist, weil sie zu lange referer z.B. ist; dieses Verhalten von Icecast kann nicht geändert werden.
• Adressen in der IP-Reihe 84.16.67.128/25 müssen ignoriert werden, da es sich um Streaming-Server handelt.
• Von der Einstellungsseite des Managers aus können Sie die Logs der vergangenen Tage erneut anfordern.
• Sie können sie auch direkt nach AKPM oder Mediapulse.

Senden von Logs über FTP aktivieren

Zu diesem Zweck:

1. Klicken Sie hier um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Brauchst du Hilfe?).
2. Direkt klicken auf den Namender betroffenen Ware zugeordnet werden.
3. Klicken Sie auf den Namen des betreffenden Audiostreams.
4. Klicken Sie auf Parameter im linken Seitenmenü.
5. Aktivieren Sie den Log-Export über FTP mit der Schaltfläche (toggle switch).
6. Geben Sie ein HostnameAdresse des FTP-Servers.
7. Geben Sie ein BenutzernameName des FTP-Kontos.
8. Geben Sie ein Passwort: das Konto des FTP-Kontos.
9. Geben Sie das Verzeichnis auf dem Server ein, in dem die Logs gespeichert werden sollen.
10. Klicken Sie auf die Schaltfläche Speichern Am Ende der Seite:
    

Logs bearbeiten

Am besten ist es, einen regulären Ausdruck wie diesen unten zu verwenden:

"/^(\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";

Diese Syntax ist die Syntax der PHP-Funktion. preg_match und muss angepasst werden, wenn andere Funktionen/Sprachen verwendet werden.

Die Funktion preg_match gibt eine Tabelle an, deren signifikante Positionen wie folgt lauten:

In diesem Leitfaden wird erläutert, wie Metadata (Metadaten) für den von Ihrem Encoder gesendeten Radiostream übertragen werden kann. Streaming-Radio .

Zur Verfügung stehende URL verwenden

Machen Sie einfach ein GET auf einer Typ URL:

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

Die vollständige URL ist auf der Administrationsoberfläche verfügbar:

1. Klicken Sie hier um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Brauchst du Hilfe?).
2. Direkt klicken auf den Namender betroffenen Ware zugeordnet werden.
3. Klicken Sie auf den Namen des betreffenden Audiostreams.
4. Klicken Sie auf Parameter im linken Seitenmenü.
5. Klicken Sie auf die Schaltfläche Kopieren die Verknüpfung von Metadata:
   

Sie möchten mehr wissen?

Für Entwickler, die einen Player kodieren, gibt es Bibliotheken, die die übermittelten Informationen abrufen und anzeigen können, da die Daten in den Stream-Daten übertragen werden. Die andere Möglichkeit besteht darin, die Nachrichten aus dem Feed auf dem Server selbst abzurufen.

Dieser Leitfaden betrifft die Statistik des Audimats und des Hörens von Streaming Radio mit denen Sie alle Informationen über & verschiedene Hörer Ihrer Radiostreams abrufen können.

Präambel

• Erfahren Sie mehr über dieser andere Leitfaden wenn Sie die Rohlogs selbst behandeln möchten.

Zugriff auf Zuhörerstatistiken

Diese Informationen finden Sie unter:

1. Klicken Sie hier um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Brauchst du Hilfe?).
2. Direkt klicken auf den Namender betroffenen Ware zugeordnet werden.
3. Klicken Sie auf Statistik im linken Seitenmenü:
   
4. Klicken Sie auf die verschiedenen Menüs im linken Seitenmenü:

Überblick

Audienz in Echtzeit

Erfahren Sie mehr über dieser andere Leitfaden In diesem Zusammenhang.

Zuhörer

Abhörzeit

Verbrauch

Geolokalisierung

Ausfuhr im Format .csv ist möglich:

Player

Diese Anleitung erklärt, wie Sie einen Audio-Stream von Ihrem Streaming Radio, ohne das vollständige Produkt zu entfernen.

Radio löschen

Um auf den Streaming-Service zuzugreifen und einen der Feeds zu löschen:

1. Klicken Sie hier um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Brauchst du Hilfe?).
2. Klicken Sie direkt auf Namedem betreffenden Produkt zugewiesen:
   
3. Klicken Sie auf den Namen des betreffenden Radios:
   
4. Klicken Sie auf das Aktionsmenü ⋮ auf der rechten Seite des betreffenden Elements.
5. Klicken Sie auf Entfernen:
   
6. Geben Sie den Namen des Radios ein, um die Löschung zu bestätigen.

In diesem Leitfaden wird erläutert, wie man einen Stream auf dem Streaming-Radio Infomaniak.

Einrichten der Übertragung eines Radiostreams

Um Zugang zum Streaming-Radio-Service zu erhalten:

1. Klicken Sie hier um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Brauchst du Hilfe?).
2. Direkt klicken auf den Namender betroffenen Ware zugeordnet werden.
3. Klicken Sie auf den Namen des Radios.
4. Klicken Sie auf die Schaltfläche Stream hinzufügen:
   
5. dann ein zweites Mal auf der Schaltfläche Stream hinzufügen:
   
6. Standard-Stream hinzufügen:
   
7. Wählen Sie die gewünschten Optionen:
   
8. Klicken Sie auf die Schaltfläche Speichern.

In diesem Handbuch wird erläutert, wie man einen Not-Audio-Stream auf dem Streaming-Radio Infomaniak.

Wenn also Ihr Hauptstrom nicht verfügbar wird, wird der Backup-Stream automatisch die Übertragungsrelais übernehmen.

Einen Notstrom erstellen

Um Zugang zum Streaming-Radio-Service zu erhalten:

1. Klicken Sie hier um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Brauchst du Hilfe?).
2. Direkt klicken auf den Namender betroffenen Ware zugeordnet werden.
3. Klicken Sie auf den Namen des Radios.
4. Klicken Sie auf die Schaltfläche Stream hinzufügen um einen neuen Strom zu erzeugen und einen Notstrom zu verbinden oder Einen bestehenden Stream einrichten Um die Option zu aktivieren:
   
5. Klicken Sie auf den Umschaltknopf (toggle switch), um den Notstrom auf Ihrem Feed zu aktivieren:
   
6. Kopieren Sie die Ihnen zur Verfügung stehenden Informationen, um Ihren Backup-Encoder einzustellen.
7. Speichern Sie die Aktivierung des Notstroms am unteren rechten Rand der Seite.

An der gleichen Stelle können Sie den Notstrom als ein Flussrelais zur manuellen Eingabe der entsprechenden Parameter für den Not-Audio-Stream:

Speichern Sie die neuen Informationen unten rechts auf der Seite.

Dieser Leitfaden enthält Informationen über Streaming Radio die nach ausgeführt werden können AKPM (ehemaliges digitales OJD).

Präambel

• Die APCAM, Alliance pour les Figures de la Presse et des Media, ist eine unabhängige Organisation in Frankreich, die Daten über die Verbreitung, die Anhörung und den Medienbesuch bescheinigt.
• Diese als offizielle Referenz anerkannten Daten unterstützen die Akteure des Medien- und Werbemarktes bei der Analyse, dem Vergleich und der Strukturierung ihrer Strategien.
• Unter der Leitung seiner aus Medienfachleuten zusammengesetzten Gremien gewährleistet die CAPM Transparenz, Unabhängigkeit und methodische Strenge und gewährleistet zuverlässige Zertifizierungen, die mit den Entwicklungen im Mediensektor im Einklang stehen.
• Erfahren Sie auch mehr über dieser andere Leitfaden über einen ähnlichen, aber für die Schweiz bestimmten Dienst.

Verwaltung der AKPM-Zertifizierung

Voraussetzungen

• Die Organisation, in der sich der Streaming-Dienst befindet, muss mit einer Adresse in Frankreich eingerichtet werden.
• Um die ACPM-Zertifizierung zu aktivieren, kontaktieren Sie bitte diesen Service per E-Mail:equipe-ojdnumerique@acpm.fr.
• Sobald der Vertrag mit diesen abgeschlossen ist,Kontaktieren Sie Infomaniak SupportAngaben zu Ihrem AKPM- und Infomaniak-Vertrag.

Um die Aktivierung oder Deaktivierung des Dienstes zu verwalten:

1. Klicken Sie hier um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Brauchst du Hilfe?).
2. Direkt klicken auf den Namender betroffenen Ware zugeordnet werden.
3. Klicken Sie auf den Namen des betreffenden Audiostreams.
4. Klicken Sie auf Parameter im linken Seitenmenü.
5. Aktivieren oder deaktivieren Sie den Export von Logs nach AKPM mit dem Umschaltknopf (toggle switch):
   ‍

SpacialAudio SAM Cast ist mit dem Audio-Streaming-Angebot kompatibel.

In diesem Leitfaden wird erläutert, wie Sie die Kontrolle über Ihre Stromflüsse von Streaming Radio MP3/AAC oder HLS, indem Sie den Einzelschlüsselschutz (token) aktivieren, um z.B. zu entscheiden, ob ein Hörer Ihr Radio hören kann oder nicht.

Präambel

• Das Prinzip ist einfach: Bei jeder Verbindung werden Sie eine Anfrage an die Infomaniak API stellen, die Ihnen einen einzigartigen Token mit einer begrenzten Lebensdauer zurücksendet. Dieser Token wird es jedem erlauben, den Strom in diesem Zeitraum zu verbrauchen.
• Sie können einen MP3/AAC- oder HLS-Feed unabhängig voneinander schützen (z. B. für die Geolokalisierung).
• Die Aktivierung der Einschränkung beinhaltet eine Änderung der Stream-Konfiguration, die einige Minuten dauern kann, um auf Servern repliziert werden.

Einen Audiostream pro Schlüssel schützen

Um dies zu tun, gehen Sie einfach in die Beschränkungseinstellungen und aktivieren Sie den Token-Schutz auf dem Feed, den Sie sichern möchten:

1. Klicken Sie hier um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Brauchst du Hilfe?).
2. Direkt klicken auf den Namender betroffenen Ware zugeordnet werden.
3. Klicken Sie auf den Namen des betreffenden Audiostreams.
4. Klicken Sie auf Beschränkungen im linken Seitenmenü.
5. Wählen Sie HLS bei Bedarf aus.
6. Klicken Sie auf das Aktionsmenü ⋮auf der rechten Seite des betreffenden Elements.
7. Klicken Sie auf Beschränkung durch Token:
   
    

Aktivieren Sie dann den Schutz.

Achtung, wenn Sie diese Option aktivieren, wird der Zugriff auf den Stream sofort für neue Verbindungen blockiert. Passen Sie Ihre Player an, um die Einschränkung zu berücksichtigen, wie im folgenden Beispiel gezeigt:

 

Erstellen Sie eine Radio-API token

Um Zugriff auf die Radio-API zu haben, müssen Sie sich in erster Linie mit einer token App authentifizieren. Dieser Schritt ist nur einmal zu tun. Um diese token-Anwendung zu erstellen, lesen Sie Dieser Leitfaden.

Das Scope ist... Radio und unbegrenzte Lebensdauer, um zu vermeiden, dass ein Code regelmäßig regeneriert werden muss. Sobald das Token erzeugt ist, kopieren Sie es, um es in das untenstehende Beispiel einzufügen.

Beispiel für die Verwendung in PHP-Sprache

Für MP3/AAC oder HLS kann der Code im Wesentlichen der gleiche sein, nur die URL, die in POST aufgerufen wird, ändert sich in ihrer 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'];
}

Wir erstellen das Token, die Token-Erstellungs-URL setzt sich wie folgt zusammen:

• Für einen MP3 / AAC-Stream

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

Beispiel zum Schutz https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac Die Straße wird sein: https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token

• Für einen HLS-Stream

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

Beispiel zum Schutz https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8 Die Straße wird sein: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Beispiel im Fall von MP3 / AAC, denken Sie daran, anzupassen:

$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 ist wichtig zu beachten, dass, wenn dieser Code zum Zeitpunkt des Ladens der Seite generiert wird, der Zuhörer "window" Sekunden haben, um die Wiedergabe des Streams zu starten. Nach Ablauf dieser Frist wird der Token auslaufen, und der Feed kann nicht mehr gestartet werden, es sei denn, die Seite wird neu geladen. Abhängig von Ihren Bedürfnissen und Ihrem Anwendungsfall, wird es notwendig sein, diesen Zeitraum auf die bestmögliche Weise anzupassen.

Sie müssen auch die URL für die Wiedergabe Ihres Streams anstelle der angegebenen URL ersetzen, während der Parameter beibehalten wird. $token Am Ende. Und schließlich zeigt man den Player an (hier ist ein einfaches html5-Tag, aber man kann natürlich jede Überschichtung hinzufügen, nachdem der Token in die Einstellungen übergeben wurde. $_GET der URL).

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