The HTML5 <video> element is a standard way to embed video content in Web applications. You can use the <video> element to stream video files on a Samsung Smart TV. The <video> element inherits all the properties and methods of the HTMLMediaElement interface.
Samsung TVs support a variety of standard video formats. For more information on the supported formats, see the Media Specifications.
Implementing a Video Player
To create a video player using HTML5:
Create a <video> element, and add attributes and properties.
You can create the element in HTML or in JavaScript:
The following are some basic properties for the JavaScript <video> element. You can also use the HTML attributes as properties. For more information, see the HTMLMediaElement Properties.
audioTracks: Lists the audio tracks contained in the element.
buffered: Returns the time ranges that the video player has buffered.
currentTime: Indicates the current playback position, in seconds.
duration: Indicates the length of the media, in seconds.
ended: Indicates whether the media has finished playing.
paused: Indicates whether the media playback is paused.
volume: Indicates the audio volume, where 0.0 is silent and 1.0 is loudest.
NoteSetting a black background for the player is recommended.
Define event listeners.
For more information on the available events, see Media events.
addTextTrack(): Add a text track, such as subtitles, to the video player.
canPlayType(): Determine whether the specified media type can be played.
load(): Reset the video player and restart media playback. This method can be useful for releasing resources after any src attribute and <source> element descendants have been removed.
pause(): Pause media playback. If playback is already paused, this method has no effect.
play(): Begin media playback.
To move to a specific time in the media, set the currentTime property. The currentTime property sets or returns the current playback position, in seconds. When you set this property, the playback jumps to the specified position in the video.
var videoElement = document.getElementById('video');
/* Move 10 seconds forward */
var seekTime = videoElement.currentTime + 10;
if (seekTime >= 0 && seekTime <= videoElement.duration) {
videoElement.currentTime = seekTime;
}
/* Move 10 seconds back */
var seekTime = videoElement.currentTime - 10;
if (seekTime >= 0 && seekTime <= videoElement.duration) {
videoElement.currentTime = seekTime;
}
/* Move currentTime to 30 seconds */
videoElement.currentTime = 30;
NoteIf the meta data of the media file is loaded, you can move to the specified time position even when the media file is not playing. For more information, see Retrieving Media Information.
To control the playback rate (trick play) of the media, set the playbackRate property as a multiplier for the playback rate.
Positive values for the playbackRate property play the media forwards, while negative values cause the media to play in reverse.
var videoElement = document.getElementById('video');
/* Set to half speed */
var speed = 0.5;
videoElement.playbackRate = speed;
/* Set to double speed */
var speed = 2.0;
videoElement.playbackRate = speed;
Embedding Multiple Video Files
To add multiple videos to a video player, for playing in sequence:
Create a <source> element for each video file you want to add.
NoteTo improve application performance, you can optionally add the type attribute to each <source> element. By indicating the MIME types of the media files using the type attribute, you can immediately skip media in formats that are not supported by the TV.
When the first video has finished playing, start playback for the next video:
var videoElement = document.getElementById('video');
videoElement.addEventListener('ended', function(e) {
var activeSource = document.querySelector('#video source.active');
var nextSource = document.querySelector('#video source.active+source') ||
document.querySelector('#video source:first-child');
// deactivate current source, and activate the next one
activeSource.className = '';
nextSource.className = 'active';
// update the video source and start playback
videoElement.src = nextSource.src;
videoElement.play();
})
Adding Captions and Subtitles
You can use the <track> element to add text captions or subtitles to the video. The caption or subtitle track must be in WebVTT (".vtt") format.
In the HTML code, set the attributes for each text <track> element:
kind: Type of content the track contains
label: Name of the track, to be shown in the video player
srclang: Language of the caption or subtitle file contents
src: URI to the caption or subtitle file
default: Caption or subtitle file to use by default when captioning or subtitling is switched on
The error property returns an instance of the MediaError interface, which returns a numerical code value representing the error state of the media element.
Value
Name
Description
1
MEDIA_ERR_ABORTED
Fetching process aborted by the user
2
MEDIA_ERR_NETWORK
Network error occurred during downloading
3
MEDIA_ERR_DECODE
Error occurred during decoding
4
MEDIA_ERR_SRC_NOT_SUPPORTED
Media format not supported
Table 1. Media error states
var videoElement = document.getElementById('video');
videoElement.addEventListener('error', function() {
/* Video playback failed: show an error message */
switch (videoElement.error.code) {
case 1:
// 'MEDIA_ERR_ABORTED : 1, Media data download is stopped by the user'
break;
case 2:
// 'MEDIA_ERR_NETWORK : 2, Download stopped due to network error'
break;
case 3:
// 'MEDIA_ERR_DECODE : 3, Media data decoding failure'
break;
case 4:
// 'MEDIA_ERR_SRC_NOT_SUPPORTED : 4, Format not supported'
break;
}
}, false);
Manage Your Cookies
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
.samsungdeveloperconference.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
LinkedIn
.ads.linkedin.com, .linkedin.com
Advertising Cookies
These cookies gather information about your browser habits. They remember that
you've visited our website and share this information with other organizations such
as advertisers.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Preferences Submitted
You have successfully updated your cookie preferences.