Get the world's best live streaming in your company's app

Learn more

Developer Resources - Bambuser Embed API:s

« Back


HTML player embed

Revision 1.10 - updated 2014.09.16

Iframe based embed which automatically displays your content in a Flash player or in one of the supported mobile friendly formats.

This is the default way to embed Bambuser on a third party site and also the easiest way to display broadcasts on a mobile website or within a mobile application.

Embed a specific broadcast

To target a single broadcast, use the following HTML:

<iframe src="https://embed.bambuser.com/broadcast/<VID>" width="320" height="276" frameborder="0"></iframe>

Replace <VID> with the actual id of the broadcast you want to embed.
A few ways to obtain a vid:

  • vid is included in responses from the metadata feed API
  • vid can be derived from the following url scheme:
    http://bambuser.com/v/[vid]
  • vid is included in auto-generated embed codes on the site.
Example:
<iframe src="https://embed.bambuser.com/broadcast/1866190" width="320" height="276" frameborder="0"></iframe>

Embed a channel

To target a channel, use the following HTML:

<iframe src="https://embed.bambuser.com/channel/<USERNAME>" width="320" height="276" frameborder="0"></iframe>

Replace <USERNAME> with an actual Bambuser username.
This embed approach will display the latest content from the selected user, ie either the current live broadcast or the latest archived broadcast if no ongoing broadcast is found.

The value must be url encoded i.e.

' ' (space)»+
Å»%C3%A5
etc...
Example:

The channel embed for user Månster

<iframe src="https://embed.bambuser.com/channel/M%C3%A5nster" width="320" height="276" frameborder="0"></iframe>

Optional parameters

autoplay: You can set the autoplay parameter to hint what kind of playback behavior you prefer. Autoplay is not suitable or even possible at all on some mobile platforms, in which case use of autoplay=1 will be ignored.

autoplay=1: always attempt to play automatically
autoplay=0: do not autoplay

Default behavior: Attempt to play live broadcasts automatically. Do not autoplay archived broadcasts.

Example:
<iframe src="https://embed.bambuser.com/broadcast/1866190?autoplay=1" width="320" height="276" frameborder="0"></iframe>

chat: You can set the chat parameter to hint if the chat should be included in the embed or not. If the broadcast owner has disabled the chat entirely the chat parameter will not have any effect.

chat=1: chat is included, if account settings allow it
chat=0: chat is disabled

Default behavior: Chat is added to the embed.

Example:
<iframe src="https://embed.bambuser.com/broadcast/1866190?chat=0" width="320" height="276" frameborder="0"></iframe>

mute: You can set the mute parameter to hint if audio should be turned on or off during playback. Mute is not suitable or even possible at all on some mobile platforms, in which case use of the mute option will be ignored.

mute=1: audio is turned off
mute=0: audio is turned on

Default behavior: Audio is turned on.

Example:
<iframe src="https://embed.bambuser.com/broadcast/1866190?mute=1" width="320" height="276" frameborder="0"></iframe>

Custom start time

You can specify a desired starting point by adding a #t at the end of the iframe src string. The player will start playing at the video keyframe found closest to the desired time. This option will only work on archived broadcasts and is currently ignored on mobile platforms.

The time can be specified in seconds, or in larger units for readability.

  • d for days
  • h for hours
  • min or m for minutes
  • sec or s for seconds
Example:
<iframe src="https://embed.bambuser.com/broadcast/2279611?autoplay=1#t=14s" width="320" height="276" frameborder="0"></iframe>

Embed customization

Some aspects of the embed, like the availability of various information overlays, are controlled by the owner of each broadcast, via the account Settings.

See also: Help - "Customize your player"

Player dimensions

The player's width and height can be chosen freely as long as the player is large enough to fit its visual elements and it's aspect ratio makes sense. Width below 220px is not recommended.

Compact mode: When the player's aspect ratio is close to the broadcast's aspect ratio, functionality like chat and broadcast archive is layered on top of the video.
Note: Non-flash presentation might not have the extra functionality implemented to the same degree as the Flash version do.

Expanded mode: When the player has a significant amount of extra space below the video, extra functionality is automatically placed there instead.

See also: Help - "How do I embed my broadcasts on other sites?"

Example:

The channel embed for user Bambuser, with enough height to trigger expanded mode.

<iframe src="https://embed.bambuser.com/channel/Bambuser" width="400" height="800" frameborder="0"></iframe>


feedback
You can leave feedback to Bambuser Crew via this form.