Welcome to Viblast Documentation

Everything you need to know about Viblast Solutions. For more information contact us.

Viblast Documentation

Troubleshooting common problems

If video playback doesn't start at all

If video playback doesn't start after everything seems to be set up, then you can do the following things:

  • Make sure that you are using a supported browser.

  • See if the video tag has the data-viblast-key="..." attribute set.

  • Open the development console of your browser and look for any error messages. To open the console in Chrome press Control + Shift + J (Windows/Linux) or Command + Option + J (Mac). To open the console in IE11 press F12.

  • Add data-viblast-log="warning" to the video tag attributes. This will activate logging of warning messages. Open the development console as described above and look for any warning messages that may point you in the direction of the problem.

  • If the video stream originates from a different domain than the website where you are trying to play the video then please make sure that CORS is enabled. The error that the browser logs when CORS is not enabled usually reads:

    No 'Access-Control-Allow-Origin' header is present on the requested resource.

  • Versions of Chrome less than 50 don't auto detect the HE-AAC audio codec. If you are streaming HLS with HE-AAC encoded audio and experiencing problems with such Chromes then try setting data-viblast-he-aac="true" as an attribute to the video tag and see if that solves the problem. For examle:

<video src="http://myserver.com/playlist.m3u8" data-viblast-key="N8FjNTQ3NDdhZqZhNGI5NWU5ZTI=" data-viblast-he-aac="true"></video>
  • If you are unsure whether Viblast Player is being initialized for a particular video element, try adding data-viblast="true" to the video element:
<video src="http://myserver.com/stream?format=hls" data-viblast="true" data-viblast-key="N8FjNTQ3NDdhZqZhNGI5NWU5ZTI="></video>
  • The HLS playlist (if you are using HLS) must be transfered with the content type of application/vnd.apple.mpegurl or application/x-mpegURL. Otherwise this may cause problems on iOS and Android devices. You can check the content type using curl:
curl -vX HEAD http://cdn3.viblast.com/streams/hls/airshow/playlist.m3u8
...
< Content-Type: application/vnd.apple.mpegurl
...

Problems with DRM protected streams

If normal streams are played just fine but DRM protected ones don't start then:

  • Make sure that you've specified viblast-widevine-licensing-server. More info can be found in our documentation on Viblast Player and DRM

  • If the widevine licensing server is not specified or miss-configure then Viblast Player will log an error that says something along the lines of

    viblast-config.widevine.licensing-server is mandatory

  • Check if the licensing server is operating properly

  • Make sure that Viblast Player is contacting the proper licensing server by opening the development console (as specified above), clicking on the Network tab and searching for the url of the licensing server.

If none of these work, feel free to contact us. We will be happy to assist. It would also help if you could attach some debug information.