Embedding the player
Choose one of the options below to add the player to your website. A basic iframe works for most websites. Use the IFrame API or a library for your framework when you need to control playback from code.
Choose an embedding option
| Option | When to use it |
|---|---|
| Simple iframe embed | You need to add a video quickly without JavaScript |
| IFrame API | You need play and pause controls, events, playlists, CTA, or analytics |
| Web Components | You prefer a declarative HTML element (@experimental) |
With a simple iframe embed, you copy the code from the dashboard and add it to your page. You can configure player behavior with URL parameters .
With the IFrame API, you create a player from JavaScript and control playback, events, quality, subtitles, and DRM. You can use the loader with TypeScript types or automatically connect an existing iframe.
The Web Component provides the <kinescope-iframe-player> element. This feature is experimental, so its API may change.
If you use React, Vue, Angular, or React Native, see the ready-to-use wrappers in Libraries .
More in this section
- Creating a player
Create Kinescope Player instances with the IFrame API factory. Configure CreateOptions, subscribe to factory events, and manage player initialization.
- Controlling the player
Control Kinescope Player through the IFrame Player API. Use playback, playlist, CTA, advertising, DRM, settings, and lifecycle events in your code safely.