Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Cloud Video
    • Overview
    • Control
    • Troubleshooting
    • Browser autoplay policy
      • Overview
      • IFrame
      • iOS
        • Getting started
        • Player initialization parameters
        • Player methods
        • Player state
        • Player events
  • Access management
  • Pricing policy
  • Audit Trails events
  • Release notes

In this article:

  • Connecting a player on your page
  • Initializing a player
  • Player controls
  • Player state
  • Player events
  1. Video Player
  2. SDK
  3. JavaScript
  4. Getting started

Getting Started with the video player SDK for JavaScript

Written by
Yandex Cloud
Updated at November 28, 2025
  • Connecting a player on your page
  • Initializing a player
  • Player controls
  • Player state
  • Player events

You can integrate a video player with content from Cloud Video into your JavaScript project using the Cloud Video Player SDK for JavaScript.

Connecting a player on your pageConnecting a player on your page

To connect a player to a page, add the following code to it:

<script src="https://runtime.video.cloud.yandex.net/player/js/player-sdk.js"></script>

Initializing a playerInitializing a player

To initialize a player, add the following code to the page:

var player = Ya.playerSdk.init({
    /** @type {(string|HTMLElement)} where the player will be created */
    element: 'video-player',
    /** @type {string} playable content link */
    source: 'https://runtime.video.cloud.yandex.net/player/...',
    /** @type {boolean} autoplay when loading content */
    autoplay: false
});

Where:

  • https://runtime.video.cloud.yandex.net/player/...: Link to playable content, e.g., https://runtime.video.cloud.yandex.net/player/video/vplvmyqsxi7dlwndvb4y. For more information, see these sections:
    • Getting an embed code or link to a video
    • Getting an embed code or link to a broadcast
    • Getting an embed code or link to a playlist

For more information on initializing a player, see the following sections:

  • Player initialization parameters
  • Interface: PlayerSdkInitConfig API reference
  • Interface: PlayerSdkSourceParams API reference

Player controlsPlayer controls

For information on player control methods, see the following sections:

  • Player methods
  • Interface: PlayerSdkApi API reference

Player statePlayer state

For information about an object containing player state parameters, see the following sections:

  • Player state
  • Interface: PlayerSdkState API reference

Player eventsPlayer events

For information about player events, see the following sections:

  • Player events
  • Interface: PlayerSdkEventHandlers API reference

Was the article helpful?

Previous
iOS
Next
Player initialization parameters
© 2025 Direct Cursus Technology L.L.C.