Video playback using the HTML video element supports external subtitles in WebVTT format. For more information, see Adding Captions and Subtitles.

The AVPlay API supports both internal and external subtitles in a variety of formats. For information on configuring subtitle tracks with the AVPlay API, see Subtitles.

Yes. For implementation information, see Using Video Elements.

Alternatively, you can also implement video playback using the AVPlay API.

For information about implementing media playback with the AVPlay API, see Using AVPlay. The AVPlay API allows you to play media content with features not supported in HTML5, such as adaptive streaming, additional subtitle formats, and 4K 8K UHD video.

When implementing multitasking, if you use the AVPlay API to play media content, do not call the pause() and play() methods when the application is hidden and resumed. Instead, call the suspend() method to save the playback state, and the restore() method to restore it:

document.addEventListener('visibilitychange', function() {
 if (document.hidden) {
 // Behavior when the application is hidden
 webapis.avplay.suspend();
 } else {
 // Behavior when the application is resumed
 webapis.avplay.restore();
 }
});

For more information, see Multitasking.

Yes, you can implement multiple audio tracks and multiple subtitle tracks using the AVPlay API.

If you are not using the AVPlay API, you can implement multiple subtitle tracks for an HTML5 video element. For more information, see Adding Captions and Subtitles.

No. A video element and an AVPlay instance cannot play content simultaneously.

To check whether the TV supports 4K UHD resolution, use the isUdPanelSupported() method of the ProductInfo API.

To retrieve the current playback time, use the getCurrentTime() method. It returns the playback time in milliseconds.

You can specify whether a video is displayed in fullscreen mode, letterbox mode, or the video's aspect ratio, using the setDisplayMethod() method of the AVPlay API.

No. The AVPlay API plays the video content as delivered. It does not support rotating or mirroring the video image.

No. Subtitle visibility can be controlled from within the application, but closed captioning must be enabled or disabled in the TV settings. If the media content has both closed captioning and subtitles, you can prompt the user to open the TV settings and disable captioning, or you can avoid implementing software subtitles.
The hotel TVs, however, provide the caption handling methods like getMenuValue() and setMenuValue() with CAPTION_ONOFF_KEY. Refer to the TvInfo API.

No, switching the TV audio mode is not supported by the API. The user must select the audio mode from the TV menu.

Yes, the autoplay and loop attributes for the HTML video element are supported on Samsung Smart TVs.

No, the getVideoPlaybackQuality() method of the HTMLVideoElement interface is not supported.

No. Although allowing the user to jump backwards improves the user experience, it is not a required feature. When you submit the application for publishing, if it does not support backwards jump, make sure to mention it in your application UI description file.

To implement launching another application, you need the other application's application ID. Since application IDs are confidential, you can only launch other applications that you have developed.

However, if the streaming service you want to use, such as YouTube, has an HTML embedding functionality, you can use it in your application to stream content from that service.

Make sure the video format is supported by the TV. For information on video format support, see Media Specifications. Implement checks to ensure that the video format is supported before you attempt playback.

To handle AVPlay errors, implement the onerror() event handler, which returns the error code. For more information and error code definitions, see the AVPlay API.

Make sure the application is setting the correct subtitle track. To retrieve the list of tracks in a media stream:

var trackInfo = webapis.avplay.getTotalTrackInfo();
var text = 'type of track info: ' + typeof trackInfo + '';
text += 'length: ' + trackInfo.length + '';
for (var i = 0; i trackInfo.length; i++) {
 text += 'index: ' + trackInfo[i].index + '';
 text += 'type: ' + trackInfo[i].type + '';
 text += 'extra_info: ' + trackInfo[i].extra_info + '';
}

For more information on selecting a subtitle track, see Switching Subtitle Tracks.

Make sure you have set the appropriate display area for the content, using the setDisplayRect() method. For more information, see Using AVPlay.

If the media is 4K UHD content, you must also check that the TV supports it and 4K 8K UHD video.

Captioning text is rendered with fixed-width (monospace) fonts, which can appear wider than variable-width (proportional) fonts.

Closed captions are shown only when focus is on the TV broadcast window. To show closed captions in a PiP window, you must move focus to it.

The seekTo() method of the AVPlay API cannot be used to move to the video start time (0 milliseconds) or end time. To move to the beginning of a video, you can stop and restart the video, or move to a position close to the beginning, such as 1000 milliseconds.

The connection failed error occurs when the AVPlay instance is unable to access the media content. Make sure the URL is correct, the media server is accessible, and the connection uses the appropriate security settings and certificates.

When the media has multiple audio tracks, you must use the setSelectTrack() method to define the audio track to play. The method must be called when the AVPlay instance is in the playing state.

Yes. The setVolume() method of the TVAudioControl API does not show the TV's built-in volume UI. You must implement your own volume UI.

Poor network connectivity can cause media to load slowly. To inform the user that content is still loading, implement a loading screen.