AIO Radio Station Player mit SPCast Server über MSE (Media Server Extension) verbinden

Was ist der AIO Radio Station Player und wie kann ich ihn nutzen?

Der AIO Radio Station Player ist ein vielseitiger HTML5-Player, der speziell für Radio-Streaming entwickelt wurde. Er unterstützt verschiedene Server, wie z.B. Icecast, Shoutcast, und jetzt auch SPCast Server. Mit dieser Anleitung können Sie den Player erweitern, um ihn für SPCast über die MSE (Media Server Extension) zu nutzen.

Was ist die Media Server Extension (MSE) für SPCast?

Die Media Server Extension (MSE) für SPCast erweitert die Funktionen des AIO Radio Station Players, sodass Sie Audio-Streams vom SPCast-Server empfangen und wiedergeben können. Diese Erweiterung ist besonders nützlich für Benutzer, die auf SPCast-Servern hosten und eine einfache Integration benötigen.

Wie füge ich MSE für SPCast zu meinem AIO Radio Station Player hinzu?

Die Integration ist sehr einfach und erfordert nur eine kleine Änderung in Ihrer template.html-Datei. Folgen Sie diesen Schritten:

  1. Öffnen Sie die template.html Datei, im jeweiligen “template” Ordner welcher im AIO Radio Station Player integriert ist.
  2. Scrollen Sie zum Ende des Dokuments und suchen Sie den abschließenden </body>-Tag.
  3. Fügen Sie direkt vor dem </body>-Tag den folgenden Code ein:
<!-- MSE for SPCast -->
<script>
    const script = document.createElement("script");
    script.src = "https://HOSTNAME.sp.radio.fm/js/mse/spAudioPlayer.js?v=" + new Date().getTime();
    script.type = "text/javascript";
    document.head.appendChild(script);
</script>

Was muss ich bei der Integration beachten?

Achten Sie darauf, den Platzhalter HOSTNAME in der URL durch den tatsächlichen Hostnamen Ihres SPCast-Servers zu ersetzen. Dadurch wird sichergestellt, dass der Player die richtige Datei lädt und auf Ihren Server zugreift.

Warum muss ich die URL jedes Mal mit einem neuen Zeitstempel laden?

Der Zeitstempel (?v=" + new Date().getTime()) dient dazu, den Browser-Cache zu umgehen. Dadurch wird sichergestellt, dass die aktuellste Version des Skripts geladen wird und keine veralteten Skripte zwischengespeichert werden.

Ist diese Erweiterung für alle Browser geeignet?

Ja, die MSE-Erweiterung ist so konzipiert, dass sie in allen gängigen Browsern funktioniert, die HTML5 und JavaScript unterstützen. Bei älteren Browsern oder veralteten Versionen kann es jedoch Einschränkungen geben.

Was kann ich tun, wenn die Integration nicht funktioniert?

Wenn die Integration Probleme bereitet, überprüfen Sie bitte die folgenden Punkte:

  • Stellen Sie sicher, dass Sie den korrekten Hostnamen verwenden.
  • Überprüfen Sie, ob JavaScript im Browser aktiviert ist.
  • Prüfen Sie, ob der SPCast-Server ordnungsgemäß läuft und erreichbar ist.
  • Prüfen Sie hier ob Ihr Browser MSE für reine Audio-Tags unterstützt.

Kann ich die MSE-Erweiterung auch mit anderen Playern verwenden?

Die Einbindung wurde extra für den AIO Radio Station Player entwickelt. Ziel war eine Integration ohne den Code des eigentlichen Entwicklers anzufassen. Dies wurde durch die Einbindung einer einfachen JavaScript-Datei erreicht. Sie können die Einbindung nicht ohne weiteres für andere Radioplayer nutzen.