Difference between revisions of "Tizen Player"
Line 57: | Line 57: | ||
|- | |- | ||
| <code>tizen:track:audio</code> || <code>{TRACK_INDEX}</code> || <code>"tizen:track:audio": "1"</code> || <code>setSelectTrack("AUDIO", {TRACK_INDEX});</code> || '''Yes''' || data-sort-value=128|'''0.1.128''' | | <code>tizen:track:audio</code> || <code>{TRACK_INDEX}</code> || <code>"tizen:track:audio": "1"</code> || <code>setSelectTrack("AUDIO", {TRACK_INDEX});</code> || '''Yes''' || data-sort-value=128|'''0.1.128''' | ||
− | | Selects an audio track. Please see <code>AVPlay</code> API for more information. | + | | Selects an audio track by indicating the index. Please see <code>AVPlay</code> API for more information. |
|- | |- | ||
| <code>tizen:track:text</code> || <code>{TRACK_INDEX}</code> || <code>"tizen:track:text": "1"</code> || <code>setSelectTrack("TEXT", {TRACK_INDEX});</code> || '''Yes''' || data-sort-value=128|'''0.1.128''' | | <code>tizen:track:text</code> || <code>{TRACK_INDEX}</code> || <code>"tizen:track:text": "1"</code> || <code>setSelectTrack("TEXT", {TRACK_INDEX});</code> || '''Yes''' || data-sort-value=128|'''0.1.128''' | ||
− | | Selects a text track. Please see <code>AVPlay</code> API for more information. | + | | Selects a text track by indicating the index. Please see <code>AVPlay</code> API for more information. |
|} | |} |
Revision as of 17:17, 10 February 2021
The Tizen player is the default player for Samsung TVs (2016+ models) that uses the Media Station X version 0.1.128 or higher. It works like a plugin and can be configured via the extended properties of a content item. Please see Extended Properties for more information. Additionally, you can interact with it using the player:commit
actions. Please see Internal Actions for more information. Some extended properties are dynamic and can be changed via an action at runtime.
Some extended properties are mapped to a corresponding Tizen (i.e. AVPlay
) function. For more information, please visit: https://developer.samsung.com/smarttv/develop/api-references/samsung-product-api-references/avplay-api.html
Note: All properties are reset if a new video/audio is played.
Syntax[edit]
Property | Value | Example | Tizen Function | Dynamic | Since Version | Description |
---|---|---|---|---|---|---|
tizen:buffer:size |
{SECONDS} |
"tizen:buffer:size": "10" |
setBufferingParam("PLAYER_BUFFER_FOR_PLAY", "PLAYER_BUFFER_SIZE_IN_SECOND", {SECONDS}); setBufferingParam("PLAYER_BUFFER_FOR_RESUME", "PLAYER_BUFFER_SIZE_IN_SECOND", {SECONDS}); |
No | 0.1.128 | Sets up the initial and resume buffer size in seconds. The default buffer size is "10" . Please see AVPlay API for possible values.
|
tizen:buffer:size:init |
{SECONDS} |
"tizen:buffer:size:init": "10" |
setBufferingParam("PLAYER_BUFFER_FOR_PLAY", "PLAYER_BUFFER_SIZE_IN_SECOND", {SECONDS}); |
No | 0.1.128 | Sets up the initial buffer size in seconds. The default buffer size is "10" . Please see AVPlay API for possible values.
|
tizen:buffer:size:resume |
{SECONDS} |
"tizen:buffer:size:resume": "10" |
setBufferingParam("PLAYER_BUFFER_FOR_RESUME", "PLAYER_BUFFER_SIZE_IN_SECOND", {SECONDS}); |
No | 0.1.128 | Sets up the resume buffer size in seconds. The default buffer size is "10" . Please see AVPlay API for possible values.
|
tizen:buffer:timeout |
{SECONDS} |
"tizen:buffer:timeout": "20" |
setTimeoutForBuffering({SECONDS}); |
Yes | 0.1.128 | Sets up the buffer timeout in seconds. The default buffer timeout is "20" . Please see AVPlay API for possible values.
|
tizen:custom:duration |
{SECONDS} |
"tizen:custom:duration": "60" |
n/a | Yes | 0.1.128 | Sets up a custom duration in seconds. If a custom duration is set, only that duration is displayed during playback. It can be used for live data to disable the progress feature. The duration "-1" re-enables the progress feature.
|
tizen:custom:position |
{SECONDS} |
"tizen:custom:position": "0" |
n/a | Yes | 0.1.128 | Sets up a custom position in seconds. If a custom position is set, only that position is displayed during playback and it is not possible to seek to another position (instead a custom:tizen:seek event is triggered). It can be used for live data to disable the seek feature. The position "-1" re-enables the seek feature.
|
tizen:custom:state |
{VIDEO_STATE} |
"tizen:custom:position": "2" |
n/a | Yes | 0.1.128 | Sets up a custom state. If a custom state is set, only that state is displayed during playback and it is not possible to change it (instead a custom:tizen:play or custom:tizen:pause event is triggered). It can be used for live data to disable the play/pause feature.
|
tizen:display:area |
{REL_X},{REL_Y},{REL_W},{REL_H} |
"tizen:display:area": "0,0,1,1" "tizen:display:area": "0.125,0,0.75,1" "tizen:display:area": "0,0.119,1,0.762" |
setDisplayRect({ABS_X}, {ABS_Y}, {ABS_W}, {ABS_H}); |
Yes | 0.1.128 | Sets up the display area with relative coordinates. The default area is "0,0,1,1" , which fills the entire screen. Please see AVPlay API for possible values.
Note: If this property is set, the property |
tizen:display:mode |
{DISPLAY_MODE} |
"tizen:display:mode": "PLAYER_DISPLAY_MODE_LETTER_BOX" "tizen:display:mode": "PLAYER_DISPLAY_MODE_FULL_SCREEN" "tizen:display:mode": "PLAYER_DISPLAY_MODE_AUTO_ASPECT_RATIO" |
setDisplayMethod({DISPLAY_MODE}); |
Yes | 0.1.128 | Sets up the display mode. The default mode is "PLAYER_DISPLAY_MODE_LETTER_BOX" , which fills the entire screen (by keeping the video aspect ratio). Please see AVPlay API for possible values.
Note: If this property is set, the property |
tizen:ready |
{ACTION} |
"tizen:ready": "info:Tizen player ready." |
n/a | Yes | 0.1.128 | Sets up an action that is executed if the player is ready (i.e. the internal state is "READY" ). Please see AVPlay API for more information.
|
tizen:start |
{ACTION} |
"tizen:start": "info:Tizen player started." |
n/a | Yes | 0.1.128 | Sets up an action that is executed if the player is started (i.e. the internal state is "PLAYING" or "PAUSED" ). Please see AVPlay API for more information.
|
tizen:stream:{STREAM_TYPE} |
{STREAM_VALUE} |
"tizen:stream:PREBUFFER_MODE": "5000" "tizen:stream:ADAPTIVE_INFO": "FIXED_MAX_RESOLUTION=7680X4320" "tizen:stream:ADAPTIVE_INFO": "BITRATES=5000~10000|STARTBITRATE=HIGHEST|SKIPBITRATE=LOWEST" |
setStreamingProperty({STREAM_TYPE}, {STREAM_VALUE}); |
No | 0.1.128 | Sets up a stream specific property. Please see AVPlay API for possible values.
|
tizen:track:audio |
{TRACK_INDEX} |
"tizen:track:audio": "1" |
setSelectTrack("AUDIO", {TRACK_INDEX}); |
Yes | 0.1.128 | Selects an audio track by indicating the index. Please see AVPlay API for more information.
|
tizen:track:text |
{TRACK_INDEX} |
"tizen:track:text": "1" |
setSelectTrack("TEXT", {TRACK_INDEX}); |
Yes | 0.1.128 | Selects a text track by indicating the index. Please see AVPlay API for more information.
|