MediaCP Manual
HTML5-audiospeler

Last updated 2 maanden ago

De audiospeler is compatibel met alle moderne browsers, ondersteunt native HTML5- en SSL-streaming en is verkrijgbaar in 3 verschillende formaten: Groot, Klein en Compact. De speler is alleen beschikbaar met de MediaCP-software en kan niet worden gebruikt met externe streams buiten de MediaCP.

De audiospeler bevat de volgende primaire functies:

  • Automatische album hoezen van iTunes of LastFM
  • Aangepaste achtergrond voor terugval waarbij een relatieve afbeelding niet kan worden gevonden of omslagalbums zijn uitgeschakeld
  • Directe speler links
  • Selectie van koppelpunt
  • Aantal listener
  • Domeinbeperkingen – Speel alleen op specifieke websites

HTTPS / SSL en streamproxy

De audiospeler is ontworpen om te werken met native SSL van de streamingdienst (Shoutcast of Icecast) of met de MediaCP Stream Proxy. Als de streamproxy is ingeschakeld op een service, wordt deze methode gebruikt als de gewenste streaming-URL door de speler. De streamproxy wordt geleverd via nginx proxy_pass-functie en biedt een minimaal overhead- en CPU-verbruik.

De streamproxy wordt automatisch ingeschakeld voor servertypen waarbij SSL niet beschikbaar is. of niet ideaal. Dit omvat:

  • Shoutcast 2.5 – SSL-ondersteuning is niet beschikbaar in de serversoftware
  • Shoutcast 2.6 – SSL-ondersteuning is een premium betaalde functie van www.shoutcast.com

Automatisch afspelen

Het automatisch afspelen van een stream is een ingewikkeld proces met moderne browsers, omdat de Chrome-engine Autoplay Policy Changes heeft geïmplementeerd die een stream verbieden om automatisch af te spelen, tenzij bepaalde voorwaarden worden gesteld

Het beleid geeft aan dat automatisch afspelen alleen mogelijk is als:

  1. De audio is gedempt; Of
  2. De gebruiker heeft zich met de website beziggehouden voordat autoplay begint; Of
  3. De gebruiker heeft eerder media op de website afgespeeld met geluid.

Vanwege deze beperkingen heeft het niet veel zin om een audiostream te starten die alleen is gedempt; omdat het de gebruiker die de website bezoekt zal verwarren.

We zullen in de toekomst aan enkele wijzigingen werken om automatisch de laatste 2 bovenstaande voorwaarden te detecteren en automatisch af te spelen zodra aan een of meer van de voorwaarden is voldaan.

Bevestigingspunten

De audiospeler streamt de standaard URL van het koppelpunt zoals gedefinieerd in de MediaCP, dus het is belangrijk dat u uitzendt naar dezelfde koppelpunten die worden vermeld in de configuratie Van koppelpunten.

Wanneer er meer dan één koppelpunt is opgegeven, toont de speler een vervolgkeuzelijst waarmee de gebruiker kan overschakelen naar een andere stream. Dit kan handig zijn voor het leveren van meerdere bitrate streams.

Albumhoezen

Albumhoezen worden standaard op de stream weergegeven. De afbeelding bevindt zich vanuit iTunes of Last.fm afhankelijk van de paneelconfiguratie. Als er geen afbeelding beschikbaar is, wordt in plaats daarvan de geconfigureerde spelerachtergrond weergegeven.

Het is mogelijk om albumhoezen uit te schakelen vanuit de spelerconfiguratie door het item Covers uit te schakelen in weergaveopties.

Player-configuratie

Het is mogelijk om toegang te krijgen tot de spelerconfiguratie terwijl u bent aangemeld bij de MediaCP. U ziet het configuratiepictogram dat beschikbaar is op de speler zelf.

Toegestane domeinen

Het is mogelijk om de speler zo te vergrendelen dat deze alleen werkt vanuit een opgegeven lijst met domeinen. Hiermee kunt u bepalen waar de speler kan worden gebruikt. De lijst met domeinen moet alleen worden opgenomen in een eenvoudige lijst met domeinnamen, zonder iets extra’s op te nemen (geen http:// of https://). Bijvoorbeeld: mediacp.net, mydomain.com

Deze functie werkt door gebruik te maken van de browser Access-Control-Allow-Origin-functie in combinatie met de JSON-configuratie-URL (waar de speler informatie over de stream krijgt). Als een domein niet is opgenomen in de toegestane lijst, wordt het door de browser zelf geblokkeerd voor toegang tot de configuratiegegevens.

Table of Contents