Diese Anleitung erklärt, wie Sie ein Streaming Radio-Abonnement vollständig kündigen.

Einleitung

• Bei den meisten Produkten müssen Sie die Kündigungsanfrage per E-Mail bestätigen, andernfalls werden keine Daten gelöscht.
• Lesen Sie diese andere Anleitung, um einen Audiostream aus Ihrem Streaming-Radio zu entfernen, ohne das gesamte Produkt zu löschen.
• Die angefallenen und nicht im Pauschalpreis enthaltenen Gebühren bleiben bestehen.
• Eine Bestätigung der Kündigung wird an die übrigen Administratoren der Organisation gesendet.
• Bei der Kündigung werden die Backups unwiderruflich gelöscht, wodurch eine Wiederherstellung unmöglich wird.

Streaming-Radio-Angebot kündigen

Um die Kündigung Ihres Angebots zu veranlassen:

1. Klicken Sie hier, um zur Verwaltung Ihres Produkts im Infomaniak Manager zu gelangen (Benötigen Sie Hilfe?).
2. Klicken Sie auf das Aktionsmenü ⋮ rechts neben dem betreffenden Element.
3. Wählen Sie Kündigen:
   
4. Führen Sie die Prozedur vollständig durch.

Diese Anleitung erklärt, wie Sie einen Stream im Infomaniak Streaming Radio korrekt konfigurieren.

Konfiguration eines Radiostreamings

Um auf den Radiostreaming-Dienst zuzugreifen:

1. Klicken Sie hier, um die Verwaltung Ihres Produkts im Infomaniak Manager aufzurufen (Benötigen Sie Hilfe?).
2. Klicken Sie direkt auf den Namen des betreffenden Produkts.
3. Klicken Sie auf den Namen des Radiosenders.
4. Klicken Sie auf die Schaltfläche Feeds konfigurieren:
   
5. Klicken Sie auf die Schaltfläche Feed hinzufügen:
   
6. Einen Standard-Feed hinzufügen (lesen Sie diese andere Anleitung zu Feed-Relays).
7. Klicken Sie auf die Schaltfläche Weiter:
   
8. Wählen Sie die gewünschten Optionen aus, darunter die Möglichkeit, HLS zu aktivieren, das nicht in die Gesamtanzahl der Streams einbezogen wird.
9. Konfigurieren Sie die gewünschte Qualität und informieren Sie sich in diesem anderen Leitfaden, wenn Sie Informationen zum Stream-Typ suchen.
10. Passen Sie gegebenenfalls die Puffergröße an (und vergessen Sie nicht, die Änderungen gegebenenfalls zu speichern).
11. Klicken Sie auf die Schaltfläche Speichern und schließen:
    

Sie können nun eine Anwendung konfigurieren, indem Sie die Parameter verwenden, die Sie am Ende dieses Vorgangs erhalten haben.

Dieses Handbuch bezieht sich auf die Streaming-Radio-Daten, die zu Mediapulse exportiert werden können.

Einleitung

• Mediapulse, eine unabhängige Organisation in der Schweiz, misst die Reichweite von Radio, Fernsehen und Online-Plattformen.
• Diese Daten, die als offizielle Referenz anerkannt sind, helfen dem Medien- und Werbemarkt, seine Aktivitäten zu analysieren, zu vergleichen und zu strukturieren.
• Mediapulse unterliegt der Aufsicht des DETEC über die OFCOM und gewährleistet Transparenz, Unabhängigkeit und wissenschaftliche Genauigkeit. Es garantiert zuverlässige Messungen, die an die Entwicklung der Medien angepasst sind.
• Es ist möglich, Ihre Radiologdaten in diesen Dienst zu exportieren.
• Lesen Sie auch diesen anderen Leitfaden zu einem ähnlichen Dienst, der jedoch für Frankreich bestimmt ist.

Verwaltung der Mediapulse-Zertifizierung

Voraussetzungen

• Die Organisation, zu der der Streaming-Dienst gehört, muss eine Adresse in der Schweiz haben.
• Um die Mediapulse-Zertifizierung zu aktivieren, kontaktieren Sie bitte diesen Dienst per E-Mail:info@mediapulse.ch.
• Sobald ein Vertrag mit diesem Dienst abgeschlossen wurde,kontaktieren Sie den Infomaniak-Supportindem Sie die Informationen zu Ihrem Mediapulse- und Infomaniak-Vertrag angeben.

Um die Aktivierung oder Deaktivierung des Dienstes zu verwalten:

1. Klicken Sie hier, um die Verwaltung Ihres Produkts im Infomaniak Manager aufzurufen (Benötigen Sie Hilfe?).
2. Klicken Sie direkt auf den Namen des betreffenden Produkts.
3. Klicken Sie auf den Namen des betreffenden Audio-Streams.
4. Klicken Sie im linken Menü auf Einstellungen.
5. Aktivieren oder deaktivieren Sie die Protokollexportfunktion für Mediapulse mit dem Schalter:
   ‍

Dieser Leitfaden erklärt, wie Sie die Audiostreams, die auf einem Ihrer Infomaniak Streaming Radios vorhanden sind, auf ein anderes Ihrer Radios, das sich in derselben Organisation befindet, übertragen.

Audiostreams übertragen

Dazu:

1. Klicken Sie hier, um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Hilfe benötigt?).
2. Klicken Sie direkt auf den Namen des betreffenden Produkts.
3. Klicken Sie auf das Aktionsmenü ⋮, das sich rechts neben dem betreffenden Element befindet.
4. Wählen Sie Übertragen:
   
5. Suchen und bestätigen Sie den Namen des anderen Radios, das Sie in derselben Organisation besitzen.
6. Bestätigen Sie die Übertragung:
   

Aktualisieren Sie die Seiten des Managers bei Bedarf, um die angezeigten Informationen zu aktualisieren.

Diese Anleitung behandelt die Steuerung des Live-Streams (Timeshift), die es Ihren Zuhörern ermöglicht, den Stream anzuhalten, zurückzuspulen und dann zum Live-Stream zurückzukehren, wobei die Rückspulfunktion bis zu 2 Stunden beträgt.

Einleitung

• Im Gegensatz zum Timeshift-Video-Streaming gibt es auf der Radio-Seite kein Planungstool.
• Die Wiederholung/Rückspulfunktion ist standardmäßig im Player deaktiviert, damit Sie die Kontrolle darüber haben, wie der Stream für die Öffentlichkeit zugänglich ist.

Zuhörern die Steuerung des Live-Streams ermöglichen

Voraussetzungen

• Erstellen oder bearbeiten Sie einen HLS-Stream in Ihrem Radio-Streaming-Produkt.

Anschließend:

1. Definieren Sie beim Erstellen (oder Bearbeiten) eines HLS-Streams den Puffer zwischen 00:00:25 und 02:00:00. Dieser Wert zwischen 25 Sekunden und 2 Stunden entspricht der maximalen Dauer, für die die Zuhörer den Stream zurückspulen und anhalten können, bevor sie zum Live-Stream zurückkehren. Er bestimmt die Tiefe der Live-Stream-Steuerung. Beispiele:
   
   • 00:00:25 → 05:00: minimale Toleranz für kurze Pausen.
   • 10:00 → 30:00: ideal für Nachrichten-/Talkformate.
   • 30:00 → 02:00:00: maximaler Komfort für Musiksendungen und Veranstaltungen.
2. Die Wiedergabefunktion aktivieren in Ihrem Player (lesen Sie diese Anleitung, wenn Sie diese Funktion für Ihre Zuhörer anbieten möchten (standardmäßig deaktiviert)):
   

Dieser Leitfaden stellt HLS vor, das Ihre Audiodaten segmentiert, um eine zuverlässige, kompatible und hochgradig verteilbare HTTP-Übertragung zu ermöglichen, ideal für mobile Nutzer und große Zielgruppen.

Was ist HLS?

HLS (HTTP Live Streaming) ist ein Streaming-Protokoll, das Audio in kleine Segmente von wenigen Sekunden aufteilt und eine .m3u8-Manifestdatei veröffentlicht, die diese Segmente auflistet. Der Player lädt diese Segmente über HTTP/HTTPS (Ports 80/443) herunter, was das Caching, die Wiederaufnahme nach Unterbrechungen und die großflächige Verteilung erleichtert.

In Ihrem Streaming-Radiodienst ermöglicht die Aktivierung von HLS die Hinzufügung eines zusätzlichen Streams. Dieser verfügt über eine eigene URL zum Abspielen (HLS-Manifest) und kann im infomaniak-Player ausgewählt und priorisiert werden. Der HLS-Stream existiert parallel zu Ihren bisherigen Streams (z. B. MP3/AAC), ohne dass es zu einer Unterbrechung des Dienstes kommt.

Vorteile für einen Radiostream

• Umfassende Kompatibilität: Native Unterstützung auf iOS/iPadOS (Safari) und breite Unterstützung über moderne HTML5-Player und Drittanbieter-Apps.
• Skalierbarkeit und Leistung: Übertragung über HTTP(S), die sich leicht über CDNs und Caches verteilen lässt; bessere Skalierbarkeit als ein einzelner, kontinuierlicher Stream.
• Robustheit: Bei kurzen Unterbrechungen kann der Player die folgenden Segmente abrufen und die Wiedergabe schnell fortsetzen; weniger anfällig für vorübergehende Ausfälle.
• Durchquerung von Netzwerken: Funktioniert über Port 80/443 und wird von Firewalls und Unternehmensproxys in der Regel besser akzeptiert als bestimmte „ICY“-Streams.
• Vereinfachtes HTTPS: Sichere Bereitstellung ohne Plugin oder exotisches Protokoll.
• Adaptive Bitrate (ABR): Wenn mehrere Varianten angeboten werden, kann der Player automatisch zwischen ihnen wechseln, je nach Netzwerkqualität, um Unterbrechungen bei der mobilen Nutzung zu minimieren.
• Flexible Integration: Ein separater Endpunkt ermöglicht es, HLS als Haupt-, Neben- oder Ausweichstream in Ihrem Player zu verwenden.

Besonderheiten und wichtige Hinweise

• Latenz: HLS verursacht in der Regel eine Latenz von einigen Dutzend Sekunden (bedingt durch die Segmentgröße und das Puffern). Dies ist für dieses Protokoll normal.
• Erforderlicher kompatibler Player: Verwenden Sie den Infomaniak-Player oder einen Player/Web-SDK, der .m3u8-Manifeste unterstützt.
• Heterogene Umgebung: Einige ältere Hardware-Receiver (Webradios, IP-Autoradios) akzeptieren nur MP3/Icecast-Streams; behalten Sie deren ursprüngliche URLs parallel bei.
• ABR-Bedingung: Die Anpassung der Bitrate erfolgt nur, wenn mehrere Profile hochgeladen werden; andernfalls bleibt der HLS-Stream in einer einzigen Qualität funktionsfähig.

Dieser Leitfaden erklärt, wie Sie die Kontrolle über Ihre Streaming-Radio-MP3/AAC- oder HLS-Streams durch Aktivierung des Schutzes durch einzigartigen Schlüssel (Token) behalten können, um beispielsweise zu entscheiden, ob ein Hörer Ihren Radiosender hören darf oder nicht.

Vorwort

• Bei jeder Verbindung führen Sie eine Anfrage an die Infomaniak-API durch, die Ihnen im Gegenzug ein einzigartiges Token mit einer begrenzten und einstellbaren Lebensdauer zurücksendet.
• Dieses Token ermöglicht es jedem, der es besitzt, den Stream während dieser Zeit zu nutzen.
• Sie können einen MP3/AAC- oder HLS-Stream unabhängig voneinander schützen (ebenso wie die Geolokalisierung übrigens).
• Die Aktivierung der Einschränkung erfordert eine Änderung der Stream-Konfiguration, die einige Minuten in Anspruch nehmen kann, um auf den Servern repliziert zu werden.

Audio-Stream durch einzigartigen Schlüssel schützen

Dazu müssen Sie lediglich zu den Einschränkungsparametern gehen und den Schutz durch Token für den Stream, den Sie sichern möchten, aktivieren:

1. Klicken Sie hier, um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Hilfe benötigt?).
2. Klicken Sie direkt auf den Namen, der dem betreffenden Produkt zugewiesen wurde:
   
3. Klicken Sie:
   1. entweder auf den Namen des Radiosenders:
      
   2. oder auf Einschränkungen im linken Seitenmenü, um Einschränkungen für das gesamte Produkt anzuwenden:
      
4. Wenn Sie die obige Option a auswählen, klicken Sie anschließend auf Einschränkungen im linken Seitenmenü.
5. Wählen Sie HLS aus, falls erforderlich.
6. Klicken Sie auf das Aktionsmenü ⋮, das sich rechts neben dem betreffenden Element befindet.
7. Klicken Sie auf Einschränkung durch Token:
   
    

Aktivieren Sie dann den Schutz.

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

Radio-API-Token erstellen

Um auf die Radio-API zugreifen zu können, müssen Sie sich zunächst mit einem Anwendungstoken authentifizieren. Dieser Schritt muss nur einmal durchgeführt werden. Um dieses Anwendungstoken zu erstellen, nehmen Sie sich diesen anderen Leitfaden zur Kenntnis.

Der Umfang ist radio und die Laufzeit unbegrenzt, um zu vermeiden, dass ein Code regelmäßig neu generiert werden muss. Sobald das Token generiert ist, kopieren Sie es, um es in das unten stehende Beispiel einzufügen.

Beispiel für die Verwendung in der Programmiersprache PHP

Für MP3/AAC oder HLS kann der Code im Wesentlichen derselbe sein, nur die im POST aufgerufene URL ä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 werden das Token erstellen, die URL zur Token-Erstellung 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 von https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac der Pfad 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 von https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8 der Pfad 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 Hörer "window" Sekunden Zeit hat, um die Wiedergabe des Streams zu starten. Nach Ablauf dieser Frist verfällt das Token und der Stream kann nicht mehr gestartet werden, es sei denn, die Seite wird neu geladen. Je nach Ihren Anforderungen und Ihrem Anwendungsfall wird es notwendig sein, diese Frist bestmöglich anzupassen.

Sie müssen auch unten die Abspiel-URL Ihres Streams anstelle der angegebenen ersetzen, wobei der Parameter $token am Ende beibehalten wird. Und schließlich wird der Player angezeigt (hier ein einfaches html5-Tag, aber man kann natürlich jede beliebige Schicht hinzufügen, wobei das Token in den Parametern $_GET der URL übergeben wird).

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

Dieses Handbuch bezieht sich auf die Statistiken von Streaming Radio, mit denen Sie unter anderem mögliche Unterbrechungen des Streams überprüfen können.

Die aktuellen Statistiken analysieren

Um auf diese Informationen zuzugreifen:

1. Klicken Sie hier, um die Verwaltung Ihres Produkts im Infomaniak Manager aufzurufen (Benötigen Sie Hilfe?).
2. Klicken Sie direkt auf den Namen des betreffenden Produkts:
   
3. Klicken Sie im linken Menü auf Statistiken:
   
4. Klicken Sie im linken Menü auf Echtzeit-Zielgruppe.
5. Wählen Sie ein Datum aus, um das entsprechende Diagramm zu laden.
6. Fahren Sie mit der Maus über die farblich markierten Bereiche, um Informationen zu erhalten:
   
7. Zoomen Sie in das Diagramm, indem Sie das Mausrad verwenden oder den gewünschten Zeitraum auswählen.
8. Sie können zur ursprünglichen Ansicht zurückkehren, indem Sie unten rechts klicken:
   

Dieser Leitfaden beschreibt die Konfiguration eines Players für Ihr Infomaniak-Streaming-Radio.

Voraussetzungen

• Einen Player mit der Infomaniak-Vorlage hinzufügen.

Optionen des Infomaniak-Players konfigurieren

Sobald Sie Ihren Stream mit Ihrem Player verknüpft und Ihren Player erstellt haben:

1. Klicken Sie hier, um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Benötigen Sie Hilfe?).
2. Klicken Sie direkt auf den Namen des betreffenden Produkts.
3. Klicken Sie im linken Menü auf Meine Player.
4. Klicken Sie auf den Namen des zu konfigurierenden Players (oder fügen Sie einen neuen Player hinzu, indem Sie auf die Schaltfläche oben klicken):
   

1. Reiter Aussehen

Hier können Sie die Größe des Players (groß, mittel, mini oder Player für mehrere Radios) und den Prozentsatz der Anzeige festlegen.

Sie können die Farben des Hintergrunds, der Schaltflächen und des Textes anpassen:

Mit einem Schalter können Sie die Anzeige der gespielten Titel aktivieren oder deaktivieren, mit oder ohne deren Sendezeiten:

• Weitere Details dazu finden Sie am Ende dieses Leitfadens.

Der Player kann Folgendes anzeigen:

• ein Bild, das das Albumcover oder ein Ersatzbild darstellt, falls kein Cover verfügbar ist,
• ein statisches Bild (max. 3 MB),
• das Logo Ihres Radiosenders, das Sie hier anpassen können: 
  
• eine Visualisierung des Audiospektrums (Spektrogramm).

2. Registerkarte Übertragung

Hier können Sie Ihre Radiostreams (HLS oder andere) mit dem Player verknüpfen, den Sie gerade konfigurieren.

Informieren Sie sich in diesem anderen Leitfaden über die angebotenen Optionen zur Verwaltung des Live-Streams:

3. Registerkarte Vorschaubilder (Medienvorschau)

Hier können Sie das Vorschaubild (Miniaturansicht) ändern, das auf dem Player des Hörers angezeigt wird, wenn das Medium geladen wird oder nicht verfügbar/eingeschränkt ist:

4. Registerkarte Player-Informationen

Hier können Sie Ihrem Player einen Namen geben und entscheiden, ob Sie Folgendes anzeigen oder ausblenden möchten:

• den Titel und den Interpreten anstelle des Namens des Radiosenders,
• die Anzahl der Zuhörer,
• das Infomaniak-Logo.

5. Registerkarte Freigabeoptionen

Ein Schalter (Toggle-Schalter) ermöglicht das Aktivieren oder Deaktivieren bestimmter Dienste wie Facebook:

Nach der Aktivierung wird ein Schaltfläche zum Teilen in diesen Diensten in Ihrem Player angezeigt:

Details zur Wiedergabeverlaufsfunktion (Registerkarte #1)

Der Wiedergabeverlauf ermöglicht das erneute Abspielen der abgespielten Musiktitel (zwischen 1 und 40), sofern Ihr Stream vom Typ HLS ist (Sie können dann einen Puffer festlegen, der zwischen 25 Sekunden und 2 Stunden liegt):

Die Funktion zum Zurückspulen und erneuten Abspielen ist standardmäßig nicht aktiviert: Sie bleibt optional, um die Einschränkungen bestimmter Länder oder Radiosender zu berücksichtigen. Nach der Aktivierung kann der Administrator des Radiosenders auswählen, welche Streams für die Wiedergabe verfügbar sein sollen (siehe Registerkarte #2 oben), während der Hörer die Wiedergabequalität im Player auswählen kann:

Position & intégration de l'historique de diffusion

Die Liste kann nach Wahl angezeigt werden:

• direkt unter dem Player,
• im Player,
• oder ausgelagert in die Integration Ihrer Website…

Es ist möglich, den Verlauf in einem zweiten iFrame anzuzeigen, das von dem Haupt-Player-iFrame getrennt ist. Beispiel-URL für den Player:
https://player-radio.infomaniak.com/2/prod/super/7cbaa24a-3510-47a4-b41e-b99218bfd507

Und für den Verlauf, der auf einer separaten Seite angezeigt wird:

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

Die beiden Iframes müssen auf derselben Seite eingebettet werden und kommunizieren miteinander, um den Verlauf zu aktualisieren oder einen zuvor gespielten Titel abzuspielen.

Eine zweite Einbettungsmethode ermöglicht die Anzeige eines unabhängigen Verlaufs, ohne das Haupt-Iframe. Fügen Sie dazu einfach die ID des Players zur URL hinzu: