Getting the most out of Clevercast Player

Use of Clevercast Player is included in all our plans. It is an interactive HTML5 player that works on all modern browsers and devices. It can be embedded on your site and on a third-party platform by simply copying the embed code from Clevercast. Alternatively, you can use its javascript API to instantiate it.

Unlike YouTube or Vimeo, Clevercast offers exhaustive control over your video player. You can style the player even in the smallest details, making sure it maintains the outlook of your website and reflects your corporate identity.

The same goes for the behaviour of the player: settings such as autoplay, loop, buffer size and sharing options can be tweaked to match your requirements, The player can work together with your Ad Server to display advertisements for both live and VoD streams.


Player profiles

By default, your account contains two default player profiles: one for VoD and one for live streaming. A player profile determines the way Clevercast Player looks and behaves when streaming your video and audio. Go to the Media > Players menu in Clevercast to see your player profiles. The default player profiles can be adjusted to a certain extent.

If you want to customize more, create your own player profile and attach it to a VoD item or live event. (Note: if you create a player profile with autoplay, keep in mind that most browsers require audio to be initially muted.) You can set your custom profile as the default player profile for VoD and/or Live via the ‘Account > Settings’ page. This will result in your player being used for any new live event or VoD item, unless specified otherwise.

The video below shows how to customize a player profile, copy the embed code and paste in a WordPress site.


Customizing the embed code

Both the VoD item and live event management pages allow you to generate a custom embed code. This is mainly used to generate a responsive embed code for your website (adapted to the screen size of the viewer), instead of using a fixed width and height.

You can also specify the ID of a player profile in the embed code, thereby overriding the default player. This way, you can embed players that are branded differently, depending on the site on which they are embedded. 

In the same way, you can add extra options to the ‘src’ element of the embed code to further customize the behaviour of a specific embedded player. See the Player API docs for which options are available. If you use the Player API you can, in addition to these options, also use the methods defined by the API.


Adaptive streaming

Live and on-demand video is delivered using the HTTP Live Streaming (HLS) protocol, in order to display the most suitable video stream on any device at any time. When playing the video, the player will switch dynamically between streams with a different resolution and choose the most suitable stream for the playback device (depending on screen size and available bandwidth, memory, available CPU and GPU resources).

The player supports High Definition (HD) video, live and on-demand. The use of adaptive streaming allows viewers with non-HD compliant devices or insufficient bandwidth to watch videos in a lower resolution.

To make this possible, Clevercast will transcode your video stream into different resolutions. With VoD this is done beforehand. With a live stream, this happens in real time. You can decide which resolutions are available to the player.


Viewing profiles

Availability of a VoD or live stream can be limited to certain countries, domains or IP addresses. This is done by creating viewing profiles, that let you white- and blacklist countries, domain names and IP addresses. These viewing profiles can then be linked the VoD item or live event in Clevercast, or by specifying the viewing profile in the embed code.


Live streaming features

If you use Clevercast player to display the live stream – whether it is as part of a Clevercast application, embedded in your site or in a 3rd party platform – you also get all Clevercast features. These include:

  • Automatic failover to backup stream: Clevercast has a main and backup streaming server on different geographical locations. You can send the same broadcast to both servers simultaneously for achieving full redundancy. Clevercast player will detect if one of the streams is down and automatically switch to the backup stream, without your viewers having to refresh the page.
  • Event status switching: in Clevercast, you can change the status of a live stream. As long as the event status is not set to started, viewers will not see the stream in the embedded player. Instead, they will see the poster images (or messages) that you have set. You can set a single image or message, or different ones depending on the event status (before, after, during a pause).
  • Player countdown:​ the player can be configured to display a countdown timer until the scheduled start time of your event. When the event is started, the timer automatically disappears.
  • Interactive messages: during the live stream, you can show messages in a player overlay (eg in case of technical difficulties) by typing them in Clevercast’s admin interface. You decide how long the message is displayed in the player.