With Stream Monkey, you have a lot of control over your player, both through the initial player setup (in your account) and through query parameters that you can add to the embeddable player link. Below we’ve provided a breakdown of all the cool things you can do just by adding a query parameter to the end of your embed code.

Start out by finding your embed code in your account. You can find this under your stream or video under the “Embed” button. It will look something like this:

<div class="smEmbed" style="padding: 0 0 56.25% 0;position: relative;height: 0;overflow: hidden;"><iframe src="//player.streammonkey.com/iframe/2rpd0r6a" width="100%" height="100%" frameborder="0" style="position: absolute;top: 0;left: 0;width: 100%;height: 100%;" allow="autoplay" allowfullscreen webkitAllowFullScreen mozAllowFullscreen></iframe></div>

To add a query string below, you'll add it into your embeddable player code with a ?code. For example, adding a range of bitrate from 0-5000 kbps would look like:

https://player.streammonkey.com/iframe/[ID]?range=0-5000

After adding that into the embed code it would look like this:

<div class="smEmbed" style="padding: 0 0 56.25% 0;position: relative;height: 0;overflow: hidden;"><iframe src="//player.streammonkey.com/iframe/1r0dbrja?range=0-5000" width="100%" height="100%" frameborder="0" style="position: absolute;top: 0;left: 0;width: 100%;height: 100%;" allow="autoplay" allowfullscreen webkitAllowFullScreen mozAllowFullscreen></iframe></div>

If you want to add multiple options, you can do so using an & in between each request. For example:

https://player.streammonkey.com/iframe/[ID]?range=0-5000&autostart=false

Bandwidth, Bitrates, and Start/End Times

  • Bandwidth Correction ( bwcorrection )
    This query string can be used to adjust the bitrate advertised in the Variant Playlist’s BANDWIDTH attribute (values are space-delimited). Values can be from 0 to +/-100.For example: ?bwcorrection=5 10-10

  • Bitrate Filtering ( range )
    Designate a bitrate range (in kbps) outside of which the stream or streams you wish to filter fall. For example: ?range=500-1200
    You may also specify lower or upper ranges. For example, if you want all bitrates greater than 500: ?range=500-
    If you want to exclude bitrates between 400 and 700: ?range=0-400,700-

  • Start time ( start )
    This query string can be used to set how many seconds into the video you would like playback to start. For example, to start 2 minutes and 15 seconds into the video, ?start=135 .
    Rather than scrubbing to that part of the video, viewers will not be able to access time before the start of the query string, and the player will show the start time as the beginning of the video.

  • End Time ( end )
    Much like start time, this can be used to set how many seconds into playback the video will end. The behavior is similar to that of end time.
    For example, ?end=360 will end playback at 6 minutes.
    Combined, a sample query string could look like ?start=28&end=183

Player UI Controls

  • Autostart ( autostart )
    This controls if the player will auto play the video on load. Possible values are true and false.For example: ?autostart=false

  • Controls ( controls )
    You can disable the player controls below the seek bar by setting this to false. By default, true is enabled.For example: ?controls=false

  • Play scrub control bar ( controlbar )
    If you need to remove the scrub control bar (for example in a live stream with DVR enabled where you don't want the viewer to scrub back in time), you can set this to false .For example: ?controlbar=false

  • Mute ( mute )
    To ensure audio is turned off when a video plays, you will set this query string to true. Mute being true will ensure no audio is present. By default, this is set to false.For example: ?mute=true

  • Closed Captioning ( vod-cc )
    To disable loading of closed caption tracks, you can set this query string to false. This will prevent the tracks from being loaded entirely, and does not just turn them off in the player.For example: ?vod-cc=false

  • Color ( color )
    You can control the color of the progress bar and volume slider by passing the hex code, without the # character.For example: ?color=EA3E26

  • Theme ( theme )
    To change the theme, pass the name of the theme you would like. Capitalization does matter, so please match the names in the platform directly.For example: ?theme=Bold

*Note: These values are in kbps and are applied to the combined audio + video bitrate.

Did this answer your question?