Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

Video player SDK for IFrame

Written by
Updated at February 17, 2025

You can embed a video player with content from Cloud Video to an HTML page using the video player SDK for IFrame.

Add an iframe container to the page code:

<iframe
    frameborder="0"
    scrolling="no"
    allowfullscreen
    allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
    src="https://runtime.video.cloud.yandex.net/player/...?autoplay=1&mute=1"
></iframe>

Where https://runtime.video.cloud.yandex.net/player/... is a link to playable content, e.g., https://runtime.video.cloud.yandex.net/player/video/vplvmyqsxi7dlwndvb4y. For more information, see Getting an embed code or link to a video and Getting an embed code or link to a broadcast.

The embed code contains an iframe container that shows the player with the specified video.

You can also set up video size and the player startup options.

Setting up video size

To specify video size, set the following parameters in the iframe tag: height for height and width for width.

Example:

<iframe width="560" height="315" 
  frameborder="0"
    scrolling="no"
    allowfullscreen
    allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
    src="https://runtime.video.cloud.yandex.net/player/..."
></iframe>

To adjust the video to the container width, change the embed code as follows:

<div style="min-width: 100%">
  <div style="position: relative; padding-bottom: 56.25%; height: 0;">
    <iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
        frameborder="0"
        scrolling="no"
        allowfullscreen
        allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
        src="https://runtime.video.cloud.yandex.net/player/...?autoplay=1&mute=true"
    ></iframe>
  </div>
</div>

Setting up the player startup options

Customize your player appearance and video playback using special parameters.

Add parameter=value pairs separated by & to the embed code URL after ?:

https://runtime.video.cloud.yandex.net/player/...?{param1=value1}&...&{paramN=valueN}

You can see the list of parameters and their possible values in the table below. If you do not specify the parameters, the player will start with default parameters.

Parameter:

Description:

allow_muted

Auto video playback in mute mode at startup:

  • false: Muted autoplay not allowed.
  • true: Muted autoplay allowed.

The allow_muted parameter has priority over autoplay. If allow_muted=false, autoplay will take place only if it is possible with sound.

autoplay

Auto video playback at startup:

  • 0: Auto playback off.
  • 1: Auto playback on.

The default value is 0.

For the autoplay option to work correctly in all browsers, use the autoplay=1 parameter together with mute=1.

t

Time (in seconds) you want to start playback at.

The values range from 0 to video duration inclusive, e.g., t=30 (start playback at 30 seconds in).

If you do not specify this parameter, your video will play from the beginning, and live stream, from the current moment.

hidden

With this parameter, you can hide the player's interface elements. All of them are shown by default.

List of interface elements
  • *: All interface elements.
  • contextMenu: Context menu.
  • fullscreen: Full screen toggle button.
  • live: Go back to live button.
  • mobileSeekButtons: Rewind and fast forward buttons in the mobile interface.
  • play: Interface element displaying the Play, Pause, and Repeat buttons. It turns off play or pause when clicking the player.
  • playbackRate: Playback rate.
  • poster: Poster.
  • preloader: Load indicator.
  • settings: Settings button.
  • startScreen: Start screen.
  • startScreenPlay: Play button on start screen.
  • subtitlesToggle: Subtitles toggle button.
  • timeline: Timeline. Disables rewinding and fast forwarding from the keyboard or by touching the sensor screen.
  • timelinePreview: Preview on the timeline.
  • time: Current playback time.
  • title: Video title.
  • sound: Mute button.
  • volumeSlider: Volume slider.

To hide several interface elements, provide a string of comma-separated values, e.g., hidden=startScreenPlay,play.

lang

Player interface language.

List of languages
  • ru: Russian
  • en: English
  • be: Belarusian
  • id: Indonesian
  • kk: Kazakh
  • tr: Turkish
  • tt: Tatar
  • uk: Ukrainian
  • uz: Uzbek

If you do not specify the parameters or provide an unsupported value, the player interface language will be based on user data.

loop

Playback looping:

  • false: Playback looping off.
  • true: Playback looping on.

The default value is false.

mute

Mute at startup:

  • false: Sound on.
  • true: Sound off.

The default value is false.

object_fit

Scale the thumbnail to fit the screen size when loading a video:

  • contain: Keep the original thumbnail aspect ratio, no cropping.
  • cover: Resize the thumbnail to fill the entire frame by changing its aspect ratio or cropping.

The default value is cover.

play_on_visible

Stopping playback if the player leaves the visible area and starting playback if the player is in it. The parameter affects both video content and ads. It can take the following values:

  • false: Video is played back if the player leaves the visible area.
  • true: Video is not played back if the player leaves the visible area.
  • Player visibility ratio sufficient for playback. Specify this value as a decimal fraction with a period (.) for a delimiter.

The default value is false. When set to true, the visibility ratio is 0.5.

Note

When set to play_on_visible=true, the autoplay parameter is ignored. The parameter only works in browsers that can accurately calculate player visibility.

preload

Video preload:

  • false: Video preload off.
  • true: Video preload on.

The default value is false.

When set to autoplay=1, the preload parameter is ignored.

volume

Volume at startup.

The values range from 0 to 1 inclusive, e.g., volume=0.5.

If set to mute=1, the parameter is ignored.

Example

This example shows the video autoplay in muted mode:

<iframe
    frameborder="0"
    scrolling="no"
    allowfullscreen
    allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
    src="https://runtime.video.cloud.yandex.net/player/video/vplvmyqsxi7dlwndvb4y?autoplay=1&mute=true"
></iframe>
Previous
Overview
Next
iOS