Wissensdatenbank

Dieser Leitfaden erklärt, wie Sie einen Audiostrom aus Ihrem Radiostreaming entfernen, ohne das gesamte Produkt zu löschen.

Eine Radio löschen

Um auf den Streaming-Dienst zuzugreifen und einen der Streams zu löschen:

1. Melden Sie sich im Infomaniak Manager (manager.infomaniak.com) von einem Webbrowser wie Brave oder Edge aus an.
2. Klicken Sie oben rechts in der Benutzeroberfläche auf das Symbol (oder navigieren Sie beispielsweise durch das Menü auf der linken Seite).
3. Wählen Sie Radio-Streaming (Streaming-Universum).
4. Klicken Sie auf den Namen des entsprechenden Objekts in der angezeigten Tabelle.
5. Klicken Sie auf das Aktionsmenü ⋮ rechts neben dem relevanten Objekt in der angezeigten Tabelle.
6. Klicken Sie auf Löschen
   
7. Geben Sie Ihr Kontopasswort ein und bestätigen Sie die Löschung.

Dieser Leitfaden erklärt, wie Sie einen Backup-Audiostream im Infomaniak Streaming Radio angeben können.

Wenn Ihr Hauptstream also nicht mehr verfügbar ist, übernimmt der Backup-Stream automatisch die Übertragung.

Backup-Stream erstellen

Um auf den Streaming-Radio-Dienst zuzugreifen:

1. melden Sie sich beim Infomaniak Manager (manager.infomaniak.com) mit einem Webbrowser wie Brave oder Edge an
2. klicken Sie auf das Symbol oben rechts in der Benutzeroberfläche (oder navigieren Sie mit dem linken Seitenmenü)
3. wählen Sie Streaming Radio (Streaming Universum)
4. klicken Sie auf den Namen des entsprechenden Objekts in der angezeigten Tabelle
5. klicken Sie auf den Namen des Radios
6. klicken Sie auf die Schaltfläche Stream hinzufügen, um einen neuen Stream zu erstellen und einen Backup-Stream anzuhängen, oder einen vorhandenen Stream konfigurieren, um die Option zu aktivieren:
   
7. klicken Sie auf die Umschalttaste, um den Backup-Stream auf Ihrem Stream zu aktivieren:
   
8. kopieren Sie die bereitgestellten Informationen, um Ihren Backup-Codierer zu konfigurieren
9. speichern Sie die Aktivierung des Backup-Streams unten rechts auf der Seite

Am selben Ort können Sie den Backup-Stream als Stream-Relay definieren, um die Parameter des Backup-Audiostreams manuell einzugeben:

Speichern Sie die neuen Informationen unten rechts auf der Seite.

Dieser Leitfaden erklärt, wie Sie die Kontrolle über Ihre Streaming-Radio-MP3/AAC- oder HLS-Streams aufrechterhalten können, um beispielsweise zu entscheiden, ob ein Hörer Ihr Radio hören kann, indem Sie den Schutz durch einen einzigartigen Schlüssel (Token) aktivieren.

Ein Audio-Stream mit einem einzigartigen Schlüssel schützen

Das Prinzip ist einfach: Bei jeder Verbindung senden Sie eine Anfrage an die Infomaniak-API, die Ihnen ein einzigartiges Token mit einer begrenzten und konfigurierbaren Lebensdauer zurückgibt. Dieses Token erlaubt es jedem, der es besitzt, den Stream während dieser Zeit zu konsumieren.

Sie können einen MP3/AAC- oder HLS-Stream unabhängig voneinander schützen (das gleiche gilt für die Geolokalisierung).

Um dies zu tun, gehen Sie einfach zu den Einschränkungseinstellungen und aktivieren Sie den Token-Schutz für den Stream, den Sie sichern möchten:

1. melden Sie sich beim Infomaniak Manager (manager.infomaniak.com) mit einem Webbrowser wie Brave oder Edge an
2. klicken Sie auf das Symbol ‍ in der oberen rechten Ecke der Benutzeroberfläche (oder navigieren Sie über das linke Seitenmenü, z. B.)
3. wählen Sie Radio Streaming (Streaming-Universum)
4. klicken Sie auf den Namen des relevanten Objekts in der angezeigten Tabelle
5. klicken Sie auf Einschränkungen im linken Seitenmenü
6. wählen Sie HLS, falls erforderlich
7. klicken Sie auf das Aktionsmenü ⋮ rechts neben dem betreffenden Stream in der angezeigten Tabelle
8. klicken Sie auf Token-Einschränkung
   
    

Aktivieren Sie dann den Schutz.

Hinweis: Sobald 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:

Ein Radio-API-Token erstellen

Um auf die Radio-API zuzugreifen, müssen Sie sich zunächst mit einem Anwendungstoken authentifizieren. Dieser Schritt muss nur einmal durchgeführt werden. Um dieses Anwendungstoken zu erstellen, lesen Sie diesen Leitfaden.

Der Umfang ist radio und die Lebensdauer ist unbegrenzt, um zu vermeiden, dass ein Code regelmäßig regeneriert werden muss. Sobald das Token generiert wurde, kopieren Sie es, um es im folgenden Beispiel einzufügen.

Beispiel für die Verwendung in PHP

Für MP3/AAC oder HLS kann der Code im Wesentlichen gleich sein; nur die aufgerufene URL in POST ändert sich in ihrer Form.

if (!defined('API_TOKEN')) {
     define('API_TOKEN', 'AYF5lSh3c7Xy5974Fs12RTkTThujT-L9R4Xk2ZfGyP6sV7QqJ1oC3jD8nFtKzIxUeMw5oNzR6');
}
/**
 * Allgemeine Funktion zur Ausführung von cURL-Anfragen
 *
 * @param string $method HTTP-Methode (GET, POST, PUT usw.)
 * @param string $url URL der zu abfragenden API
 * @param array $headers Liste der HTTP-Header (die Autorisierung muss hier mit ['Authorization: Bearer ']
 * @param array $payload Ein Array, das die Daten zum Erstellen eines Tokens enthält
 * @return mixed
 */

function request(string $method, string $url, array $headers = [], array $payload = []): mixed{
    // Optionen-Array vorbereiten
    $opts = [
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_URL => $url,
        CURLOPT_CUSTOMREQUEST => strtoupper($method),
    ];

    // Payload hinzufügen, wenn 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'] ?? 'ein Fehler ist aufgetreten');
    }
    return $data['data'];
}

Wir werden das Token erstellen; die URL zum Erstellen des Tokens gliedert sich wie folgt:

• Für einen MP3/AAC-Stream

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

Beispiel zum Schützen von https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac, die Route 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 Schützen von https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8, die Route wird sein: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

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

$token = request(
    'POST',
   'https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token',
    // Autorisierungsheader
    [
        'Authorization: Bearer ' . API_TOKEN,
        'Content-Type: application/json',
    ],
    /**
     * Payload zum Erstellen des Tokens, Sie können die folgenden Werte übergeben
     * window      | 300                | optional | Gültigkeitsdauer des Tokens (Standard: 5 Minuten)
     */

    [
        'window' => 3600, // 1h Gültigkeit
    ]
);

Es ist wichtig zu beachten, dass wenn dieser Code beim Laden der Seite generiert wird, der Hörer "window" Sekunden Zeit hat, um die Wiedergabe des Streams zu starten. Nach diesem Zeitraum läuft das Token ab und der Stream kann nicht mehr gestartet werden, es sei denn, die Seite wird neu geladen. Je nach Ihren Bedürfnissen und Anwendungsfällen müssen Sie diese Frist bestmöglich anpassen.

Sie müssen auch die URL Ihres Streams unten anstelle der angegebenen URL ersetzen, während Sie den Parameter $token am Ende beibehalten. Schließlich zeigen wir den Player an (hier ein einfaches HTML5-Tag, aber Sie können natürlich jede Art von Overlay hinzufügen, wobei das Token in den $_GET-Parametern der URL übergeben wird).

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