Player changelog
v2.202.0
Improvements
- When the video links in an embed have expired, the player reloads the embed once with fresh links instead of showing the error screen. JavaScript and IFrame API embeds, and playback that has already started, are never reloaded.
- When a video fails to load because of the network, the error screen suggests checking the internet connection or turning off the VPN.
- On mobile devices, the player keeps trying to load the video longer on an unstable network.
Bug Fixes
- Fixed playback in Safari and on iOS: when the browser cannot play the video with its own player, the player tries another playback method before it shows the error screen. Protected videos never switch.
- Fixed playback on Android devices that do not support the video format: the player no longer tries a method that does not work there and goes straight to the fallback.
- Fixed AirPlay: the button no longer disappears after the playback method changes.
- Fixed the error screen during a live stream: when the stream briefly reconnects, the player waits up to 20 seconds and continues.
- Fixed waiting for a live stream to start: the error screen no longer interrupts it.
- Fixed the watermark in embeds in Safari and on iOS/iPadOS before version 17: the text from the embed parameters is shown instead of the placeholder.
v2.201.0
Improvements
- When a JavaScript embed loads, one connection attempt waits 15 seconds by default. If that is not enough, set
attemptTimeoutfor a single attempt. The overall wait stays 30 seconds by default.
v2.200.2
Bug Fixes
- Fixed endless loading when an ad or the intro video does not load: the main video starts after a few seconds.
v2.200.1
Bug Fixes
- Fixed controls on the intro video: play, volume, progress, and fullscreen stay visible even when the player’s controls are hidden. Annotations, the frame screenshot, and the transcript are not shown on the intro. After the intro, the player returns to its own settings. Regular ads still follow the player settings.
- Fixed the volume of a background video: sound turned on during the intro does not stay, and the video plays muted again after the intro.
- Fixed the size of ads and the intro video: they fill the player’s current size even when the size changed before they started.
v2.200.0
Improvements
- An intro video can play before the main video. It is labelled “Intro video”, not “Ad”, and can be skipped right away, after a few seconds, or not at all, as set for the video. A link button may appear next to it: it opens in a new tab, and clicking the video itself opens nothing.
- When the intro video fails to load or does not start in time, the player goes straight to the main video.
Bug Fixes
- Fixed the Skip button in ads: when an ad can be skipped right away, the button appears right away, and pressing it always ends the ad.
- Fixed the volume after an ad: sound the viewer turned on, turned off, or changed during the ad no longer reverts to the previous level.
- Fixed picture-in-picture during ads: the main video no longer moves to the separate window. The mode is unavailable until the ad ends.
v2.199.4
Improvements
- When the browser cannot play an HLS stream, the player tries another playback method once, then the regular video file, before it shows the error screen. Protected videos never switch to the regular file.
Bug Fixes
- Fixed video startup in Vivo Browser: since v2.199.3 the video could fail to start.
- Fixed switching the playback method mid-video: playback continues from the same position and the video is not loaded again on the next play.
v2.199.3
Bug Fixes
- Fixed startup in Chrome 80–84: the player no longer crashes when it opens.
- Fixed startup in Yandex Browser: the player no longer crashes when the browser reports fonts but cannot check that they have loaded.
- Fixed embedding when the page denies the player access to itself: the player no longer crashes and still follows the size of its box.
- Fixed the seek preview: when there is no storyboard, the player no longer crashes and shows the time.
- Fixed HLS startup in Chrome on Android and in Chrome that presents itself as an iPhone: the video is no longer rejected at the start. Safari on a computer and real iPhones and iPads start as before.
- A browser that presents itself as an iPhone on iOS 17.1 or newer but cannot play video shows a calm screen without a retry button instead of the general error. Real iPhones and iPads are unchanged.
- Fixed reloading the video on replay and quality change: in some browsers the player aborted the reload itself.
- Fixed the return to the poster after pressing play: the player waits 12 seconds for a slow start, not 5. If play has not been pressed, the wait is still 15 seconds.
- At the end of a video, an empty call to action with no title is no longer shown: the regular screen with a replay button appears instead.
v2.199.2
Bug Fixes
- Fixed the error screen when starting a protected video on Android devices where Widevine hardware protection is faulty: the video starts in software mode. Quality may be lower in this case.
- Fixed playback start of protected videos on Realme phones with Android 11.
- Fixed protected video being captured in screenshots and screen recordings in Chrome on macOS while a player menu is open.
- Fixed the player context menu not closing on a click outside it.
v2.199.1
Improvements
- On devices where protected playback does not work (for example, some Huawei and Honor phones), a message suggesting to open the video on another device appears instead of the general error screen. The screen has no retry button, since retrying does not help on such a device.
v2.199.0
Bug Fixes
- Fixed repeat views of a video fragment: it starts from the beginning of the fragment again and no longer hangs on endless loading. Watching a fragment also no longer changes where the full video resumes.
- Fixed embeds with a set start time or fragment length: when the selected range has nothing to play, the player shows the whole video instead of an error screen.
- Fixed endless loading when resuming from a saved position: if that position is past the end of the video, playback starts from the beginning, and if there is no data at that point, it starts from the nearest moment after it.
v2.198.3
Improvements
- When an embed fails to load, a message with a “Retry” button appears instead of blank space, and the video can be started without reloading the page.
Bug Fixes
- Fixed embeds that did not load at all: the player could stay blank forever when a check request to it was blocked by a browser extension or the network.
- Fixed the space key: it pauses again after any other key has been pressed. Previously only a page reload brought it back.
- Fixed hold-to-speed-up with the space key: the speed returns to normal once the key is released, even if the progress bar was focused at that moment.
- Fixed keyboard control after hold-to-speed-up: the shortcuts keep working. Previously they stopped responding until you clicked the player with the mouse.
v2.198.2
Improvements
- When the browser does not allow the sound to be turned on, the player shows the “Play sound” button instead of playing silently.
Bug Fixes
- Fixed the sound when a stalled video starts: pressing play now starts the video with sound right away. Previously the video started silently and the sound could only be turned on in fullscreen.
v2.198.1
Bug Fixes
- Fixed a stalled start: pressing play starts the video and no longer pauses it right away. A press that is not the play button does not start the video.
- Fixed the return to the poster when playback never starts. The player could stay on an endless loading spinner; the poster with the play button now comes back in that case too, including when the tab was hidden or the player was covered at that moment.
- If the player muted itself to get playback started, sound comes back once the video is playing. Sound the viewer turned off stays off.
v2.198.0
Improvements
- When playback never starts, the player no longer stays on an endless loading spinner: it returns to the poster with the play button, and the next tap starts the video. This is most common on iPhone and iPad with video preview autoplay turned off.
Bug Fixes
- Fixed the control bar on phones and tablets: while paused, it no longer disappears after you tap its buttons.
- Fixed screen reader announcements: after hold-to-speed-up and after catching up to a live stream the player no longer announces extra speed changes, and muting or unmuting is announced as a state rather than as the button label.
v2.197.2
Bug Fixes
- Fixed keyboard focus: from the error screen and other overlays that cannot be closed, Tab returns to the page. Overlays that can be closed still keep focus inside.
- Fixed the control bar: after keyboard use it no longer stays on screen. Moving the pointer or clicking hides it again after a few seconds.
- Fixed keyboard seeking: Home, End, and the arrow keys on the progress bar no longer scroll the page around the player.
- Fixed screen reader announcements: playback is announced as a status, not as the play button label. Seeking, holding Space, and the automatic speed change while catching up to a live stream no longer repeat extra messages.
- Fixed the error screen: the screen reader names the copy-error-ID button and the options button.
- Restored two Russian lead-form labels: the document link again says «Обработка данных», and the button that opens the form again says «Начать».
v2.197.0
Improvements
- Improved accessibility: screen readers name the controls and announce playback, volume, subtitles, quality, and speed; the progress bar is read as time; keyboard volume and menus work more clearly, and the control bar stays visible while focus is inside the player.
- Updated and refined the player’s interface translations.
Bug Fixes
- Fixed keyboard shortcuts: they no longer fire while you type in a field inside the player.
v2.196.5
Bug Fixes
- Fixed embed corner rounding: the player again uses the radius set by the embed.
- Fixed the error screen: content is centered in the player again.
v2.196.4
Bug Fixes
- Fixed iframe player embeds: a successful create no longer leaves an unhandled promise error in the host page console.
v2.196.3
Bug Fixes
- Fixed audio track switching in Safari: the sound changes, and the picture is not interrupted.
- Fixed in-player chat: the panel slides out again when you open it.
v2.196.2
Bug Fixes
- Fixed bookmarks: the button and icon color again come from the player theme.
- Fixed annotation cards: the hover outline stays inside the rounded card.
v2.196.1
Bug Fixes
- Fixed bookmarks: when the control bar is hidden they no longer intercept clicks on the video.
- Fixed annotation cards with a video poster: the image shows again.
- Fixed chat replay in embeds: if the chat iframe mounts after the player, messages sync with the recording again.
v2.196.0
Improvements
- Updated the player’s internal UI libraries.
v2.195.3
Bug Fixes
- Fixed DRM screenshot protection: progress-bar animation and the settings menu no longer let a system screenshot capture the frame.
v2.195.2
Bug Fixes
- Fixed screenshot protection on DRM videos with rounded corners: a system screenshot no longer shows the frame.
- Fixed subtitle search: if the track is already loaded, the player does not download it again.
v2.195.1
Bug Fixes
- Fixed the progress bar: it no longer stutters in Firefox, jumps back on unpause in Chrome, or freezes on start and after seeking in Safari.
- Fixed a freeze on Safari and iOS: the player recovers from a decode failure and continues playback, or shows an error if recovery fails.
v2.195.0
Improvements
- When the browser or device cannot play the video, the player shows a calm screen without a useless reload.
- Devices with a revoked DRM certificate now see the unsupported-browser screen.
- Watermark protection is stronger: the mark cannot be swapped via the API after start, and casual removal in developer tools does not drop it.
- Numeric watermark text is accepted without an error.
Bug Fixes
- An interrupted live stream no longer shows an error screen: the player waits for the broadcast to recover.
- Failures in Picture-in-Picture, fullscreen, and similar browser APIs no longer stop playback.
v2.194.0
Improvements
- Player UI fonts are now loaded from the CDN.
Bug Fixes
- Fixed view statistics when switching videos: events are no longer attributed to the wrong video.
- Fixed video loading: if a video is unavailable, the player shows an error instead of waiting indefinitely.
v2.193.0
Improvements
- Improved playback of videos with long segments (screen recordings and similar content): the player buffers more reliably and is less likely to get stuck on loading.
- Added audio track switching during AirPlay.
Bug Fixes
- Fixed waiting for a live stream that has not started yet or was temporarily stopped: the player waits for the source instead of showing a network error.
- Fixed false playback errors when starting video in Chromium-based browsers.
v2.160.1
⚠ BREAKING CHANGES
IFrame Player API- If a watermark is enabled in the dashboard but watermark text is not provided when creating the player, the player throws an error. Watermark text must be set when creating the player.
IFrame Regular- If a watermark is enabled in the dashboard but watermark text is not provided in the
watermarkURL parameter, the player throws an error.
- If a watermark is enabled in the dashboard but watermark text is not provided in the
v2.156.0
⚠ BREAKING CHANGES
IFrame Player API- The structure of
playlist[].ctachanged; see player parameters.
- The structure of
v2.150.0
⚠ BREAKING CHANGES
IFrame Player API- Parameter
theme.subtitles.textSizewas renamed totextScale. See player parameters. - Undocumented parameter
behavior.textTrack.rollupwas removed. See player parameters.
- Parameter
v2.139.1
⚠ BREAKING CHANGES
IFrame Player API- The
Eventsproperty on the player factory was removed. Use the Events property on the player control object instead.
- The
v2.121.0
⚠ BREAKING CHANGES
IFrame Player APITo prevent changing or removing the watermark via the iframe
srcattribute, watermark parameters must be set after player creation with setOptions.Example:
playerFactory.create(params).then(function (player) { player.setOptions({ui: {watermark: {text: 'watermark'}}}); });
v2.115.0
⚠ BREAKING CHANGES
IFrame Player API- Default value for
ui.watermark.modechanged torandom. See player parameters.
- Default value for
v2.106.0
⚠ BREAKING CHANGES
IFrame Player APIPlayer event
AutoQualityChangedwas removed. UseQualityChangedinstead. See player event handlers.Player method
getCurrentVideoQualityis deprecated and will be removed. UsegetVideoQualityinstead. See player methods.Factory property
PlayerEventis deprecated and will be removed. UseEventsinstead. See factory properties.
v2.101.0
⚠ BREAKING CHANGES
IFrame Regular- Parameter
watermarkis ignored unless watermark functionality is enabled in the dashboard. See embed parameters.
- Parameter
v2.48.0
⚠ BREAKING CHANGES
IFrame Regular- Parameter
headerwas removed. See embed parameters.
- Parameter
IFrame Player API- Parameter
ui.openChaptersOnLoadwas removed. See player parameters.
- Parameter
v2.36.0
⚠ BREAKING CHANGES
IFrame Regular- Parameter
headerwas replaced withtitle. Existing embeds withheaderstill work for a while; new embeds should usetitle. See embed parameters.
- Parameter
IFrame Player API- Parameter
ui.openChaptersOnLoadis deprecated and will be removed. See player parameters.
- Parameter
v2.27.0
⚠ BREAKING CHANGES
IFrame Player API- Player creation parameters
filesandactionsmoved intoPlaylistItemOptionsof theplaylistparameter. See player creation.
- Player creation parameters