Difference between revisions of "Extended Properties"

From MSX - Wiki
Jump to navigation Jump to search
 
(118 intermediate revisions by the same user not shown)
Line 1: Line 1:
These properties can be used for special use cases and are only valid for version '''0.1.140+'''. Please ensure that you are using the correct version, because the syntax in previous versions can be different. Each property is a key-value pair of type <code>string</code> and can be set in the <code>properties</code> property of a [[Content Item Object]]. The dynamic properties can also be set via an action at runtime. For more information, please see [[Internal Actions]].
+
These properties can be used for special use cases and are only valid for version '''0.1.58+'''. Each property is a key-value pair of type <code>string</code> and can be set in the <code>properties</code> property of a [[Content Item Object]]. The dynamic properties can also be set via an action at runtime. For more information, please see [[Internal Actions]].
  
 
'''Note: It is also possible to set values of type <code>boolean</code> or <code>number</code> as non-<code>string</code> values (e.g. <code>"true"</code> → <code>true</code> or <code>"123"</code> → <code>123</code>).'''
 
'''Note: It is also possible to set values of type <code>boolean</code> or <code>number</code> as non-<code>string</code> values (e.g. <code>"true"</code> → <code>true</code> or <code>"123"</code> → <code>123</code>).'''
Line 7: Line 7:
 
|+ Property syntax of extended properties
 
|+ Property syntax of extended properties
 
|-
 
|-
! Property !! Value !! Example !! Dynamic !! class="unsortable" | Description  
+
! Property !! Value !! Example !! Dynamic !! Since Version !! class="unsortable" | Description  
|-
+
|-v
 
| <code>button:{BUTTON_ID}:action</code> || <code>{ACTION}</code> ||
 
| <code>button:{BUTTON_ID}:action</code> || <code>{ACTION}</code> ||
 
<code>"button:content:action": "info:Custom content action executed."</code><br/>
 
<code>"button:content:action": "info:Custom content action executed."</code><br/>
Line 18: Line 18:
 
<code>"button:next:action": "info:Custom next action executed."</code><br/>
 
<code>"button:next:action": "info:Custom next action executed."</code><br/>
 
<code>"button:speed:action": "info:Custom speed action executed."</code><br/>
 
<code>"button:speed:action": "info:Custom speed action executed."</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
Sets up a custom player button action (all buttons except the eject button are supported). By default, the following actions are executed.
+
Sets up a custom player button action (all buttons except the eject button are supported). Please see [[Internal Actions]] for possible values. By default, the following actions are executed.
  
 
* <code>content</code>: <code>player:content</code>
 
* <code>content</code>: <code>player:content</code>
Line 30: Line 30:
 
* <code>speed</code>: <code>player:speed</code>
 
* <code>speed</code>: <code>player:speed</code>
  
'''Note: To use this property, the corresponding <code>button:{BUTTON_ID}:icon</code> property must also be set, otherwise this property is ignored. For property actions, it is not possible to provide an action-related <code>data</code> property. If you want to execute a property data action, please use the <code>execute:fetch:{URL}</code> action, alternatively.'''
+
'''Note: To use this property, the corresponding <code>button:{BUTTON_ID}:icon</code> property must also be set, otherwise this property is ignored. If you set the action to <code>"default"</code>, the default action is used. For property actions, it is not possible to provide an action-related <code>data</code> property. If you want to execute a property data action, please use the <code>execute:fetch:{URL}</code> action, alternatively.'''
 
|-
 
|-
 
| <code>button:{BUTTON_ID}:display</code> || <code>{BOOLEAN_VALUE}</code> ||
 
| <code>button:{BUTTON_ID}:display</code> || <code>{BOOLEAN_VALUE}</code> ||
Line 41: Line 41:
 
<code>"button:next:display": "true"</code><br/>
 
<code>"button:next:display": "true"</code><br/>
 
<code>"button:speed:display": "true"</code><br/>
 
<code>"button:speed:display": "true"</code><br/>
|| No ||
+
|| No || data-sort-value=130|'''0.1.130''' ||
 
Shows/Hides a player button (all buttons except the eject button are supported).
 
Shows/Hides a player button (all buttons except the eject button are supported).
 
|-
 
|-
Line 53: Line 53:
 
<code>"button:next:enable": "true"</code><br/>
 
<code>"button:next:enable": "true"</code><br/>
 
<code>"button:speed:enable": "true"</code><br/>
 
<code>"button:speed:enable": "true"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
 
Enables/Disables a player button (all buttons except the eject button are supported).
 
Enables/Disables a player button (all buttons except the eject button are supported).
 
|-
 
|-
Line 66: Line 66:
 
<code>"button:speed:focus": "true"</code><br/>
 
<code>"button:speed:focus": "true"</code><br/>
 
<code>"button:eject:focus": "true"</code><br/>
 
<code>"button:eject:focus": "true"</code><br/>
|| '''Yes''' ||
+
<code>"button:none:focus": "true"</code><br/>
Focuses a player button (if player is loaded).
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
 +
Focuses a player button (if the player is loaded). If the button <code>none</code> is used, no button is focused (i.e. the last selected button is retained) if the player is loaded via an execution event.
 +
 
 +
'''Note: By default, the button <code>play_pause</code> is focused if the player is loaded via an execution event (e.g. if the OK key is pressed while the video/audio is in foreground).'''
 
|-
 
|-
 
| <code>button:{BUTTON_ID}:icon</code> || <code>{ICON}</code> ||
 
| <code>button:{BUTTON_ID}:icon</code> || <code>{ICON}</code> ||
Line 74: Line 77:
 
<code>"button:prev:icon": "skip-previous"</code><br/>
 
<code>"button:prev:icon": "skip-previous"</code><br/>
 
<code>"button:rewind:icon": "fast-rewind"</code><br/>
 
<code>"button:rewind:icon": "fast-rewind"</code><br/>
<code>"button:play_pause:icon": "play-arrow"</code><br/>
+
<code>"button:play_pause:icon": "play-arrow{{pipe}}pause"</code><br/>
 
<code>"button:forward:icon": "fast-forward"</code><br/>
 
<code>"button:forward:icon": "fast-forward"</code><br/>
 
<code>"button:next:icon": "skip-next"</code><br/>
 
<code>"button:next:icon": "skip-next"</code><br/>
 
<code>"button:speed:icon": "slow-motion-video"</code><br/>
 
<code>"button:speed:icon": "slow-motion-video"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
Sets up a custom player button icon (all buttons except the eject button are supported). By default, the following icons are used.
+
Sets up a custom player button icon (all buttons except the eject button are supported). Please see [[Icons]] for possible values. By default, the following icons are used.
  
 
* <code>content</code>: <code>pageview</code> <big>{{icon|pageview}}</big>
 
* <code>content</code>: <code>pageview</code> <big>{{icon|pageview}}</big>
Line 90: Line 93:
 
* <code>speed</code>: <code>slow-motion-video</code> <big>{{icon|slow-motion-video}}</big>
 
* <code>speed</code>: <code>slow-motion-video</code> <big>{{icon|slow-motion-video}}</big>
  
'''Note: To use this property, the corresponding <code>button:{BUTTON_ID}:action</code> property must also be set, otherwise this property is ignored. If you set the icon to <code>"default"</code>, the default icon is used.'''
+
'''Note: To use this property, the corresponding <code>button:{BUTTON_ID}:action</code> property must also be set, otherwise this property is ignored. If you set the icon to <code>"default"</code>, the default icon is used. For the <code>play_pause</code> button, you can also set two icons by using the separator <code>{{pipe}}</code> (e.g. <code>"play-arrow{{pipe}}pause"</code>).'''
 
|-
 
|-
 
| <code>button:{BUTTON_ID}:key</code> || <code>{KEY}</code> ||
 
| <code>button:{BUTTON_ID}:key</code> || <code>{KEY}</code> ||
Line 102: Line 105:
 
<code>"button:speed:key": "8"</code><br/>
 
<code>"button:speed:key": "8"</code><br/>
 
<code>"button:eject:key": "9"</code><br/>
 
<code>"button:eject:key": "9"</code><br/>
|| No ||
+
|| '''Yes''' || data-sort-value=132|'''0.1.132''' ||
Sets up a player button shortcut key.
+
Sets up a player button shortcut key. Please see [[Key Property]] for possible values.
 +
|-
 +
| <code>control:action</code> || <code>{ACTION}</code> ||
 +
<code>"control:action": "info:Custom player control action executed."</code><br/>
 +
|| '''Yes''' || data-sort-value=140|'''0.1.140''' ||
 +
Sets up a custom player control action (replacement for the action that is executed if the OK key is pressed while the video/audio is in foreground). Please see [[Internal Actions]] for possible values. By default, the action <code>player:default</code> is executed.
 +
 
 +
'''Note: For property actions, it is not possible to provide an action-related <code>data</code> property. If you want to execute a property data action, please use the <code>execute:fetch:{URL}</code> action, alternatively.'''
 +
|-
 +
| <code>control:dim</code> || <code>{BOOLEAN_VALUE}</code> ||
 +
<code>"control:dim": "true"</code><br/>
 +
<code>"control:dim": "false"</code><br/>
 +
|| No || data-sort-value=148|'''0.1.148''' ||
 +
Indicates if the application background should be dimmed when this video is playing. By default, the application background is dimmed to provide a better user experince for videos on devices that do not have a 16:9 screen ratio (by setting the gray background to black). However, if this video is a plugin that displays images or renders objects, this property can be set to <code>"false"</code> to keep the gray background.
 +
 
 +
'''Note: This property only affects mobile and desktop devices, because all current TV devices have a 16:9 screen ratio. Please also note that this property only has an effect if zoom or scale settings are used.'''
 
|-
 
|-
 
| <code>control:load</code> || <code>{LOAD_MODE}</code> ||
 
| <code>control:load</code> || <code>{LOAD_MODE}</code> ||
 
<code>"control:load": "default"</code><br/>
 
<code>"control:load": "default"</code><br/>
 
<code>"control:load": "silent"</code><br/>
 
<code>"control:load": "silent"</code><br/>
|| No ||
+
|| No || data-sort-value=111|'''0.1.111''' ||
Sets up the player control load mode. If the mode is set to <code>"silent"</code>, the player is not shown if the video/audio file is loaded in auto mode (e.g. if the action <code>player:auto:next</code> is executed).
+
Sets up the player control load mode. If the mode is set to <code>"silent"</code>, the player is not shown if the video/audio is loaded in auto mode (e.g. if the action <code>player:auto:next</code> is executed).
 +
|-
 +
| <code>control:retune</code> || <code>{RETUNE_MODE}</code> ||
 +
<code>"control:retune": "default"</code><br/>
 +
<code>"control:retune": "retain"</code><br/>
 +
<code>"control:retune": "play"</code><br/>
 +
<code>"control:retune": "restart"</code><br/>
 +
|| No || data-sort-value=145|'''0.1.145''' ||
 +
Sets up the player control retune mode. If the mode is set to <code>"retain"</code>, <code>"play"</code>, or <code>"restart"</code> and the (resolved) video/audio URL matches the active one, the active video/audio URL is reused. In case of <code>"retain"</code>, the active video/audio play/pause state is retained. In case of <code>"play"</code>, the active video/audio is played again (if it was paused). In case of <code>"restart"</code>, the active video/audio is restarted. By default, the active video/audio URL is never reused and the new URL is retuned. If the active video/audio has already been ended, this property is ignored.
 +
 
 +
'''Note: Please note that if the active video/audio URL is reused (in contrast to the <code>control:reuse</code> property), all extended properties of the video/audio data (e.g. <code>"control:type"</code>, <code>"progress:type"</code>, <code>"trigger:{TRIGGER_KEY}"</code>, etc.) are applied. Additionally, all properties that were set at runtime are cleared.'''
 +
|-
 +
| <code>control:return</code> || <code>{RETURN_MODE}</code> ||
 +
<code>"control:return": "default"</code><br/>
 +
<code>"control:return": "silent"</code><br/>
 +
|| No || data-sort-value=140|'''0.1.140''' ||
 +
Sets up the player control return mode. If the mode is set to <code>"silent"</code>, the player is not shown if returning from a content page.
 +
|-
 +
| <code>control:reuse</code> || <code>{REUSE_MODE}</code> ||
 +
<code>"control:reuse": "default"</code><br/>
 +
<code>"control:reuse": "retain"</code><br/>
 +
<code>"control:reuse": "play"</code><br/>
 +
<code>"control:reuse": "restart"</code><br/>
 +
|| No || data-sort-value=142|'''0.1.142''' ||
 +
Sets up the player control reuse mode. If the mode is set to <code>"retain"</code>, <code>"play"</code>, or <code>"restart"</code> and the video/audio base data matches the active one (i.e. <code>id</code>, <code>index</code>, <code>number</code>, <code>type</code>, <code>url</code>, <code>label</code>, <code>background</code> etc. are the same), the active video/audio data is reused. In case of <code>"retain"</code>, the active video/audio play/pause state is retained. In case of <code>"play"</code>, the active video/audio is played again (if it was paused). In case of <code>"restart"</code>, the active video/audio is restarted. By default, the active video/audio data is never reused and the new data is applied and the video/audio is retuned. If the active video/audio has already been ended, this property is ignored.
 +
 
 +
'''Note: Please note that if the active video/audio data is reused (in contrast to the <code>control:retune</code> property), all extended properties of the new data (e.g. <code>"control:type"</code>, <code>"progress:type"</code>, <code>"trigger:{TRIGGER_KEY}"</code>, etc.) are ignored, because the active ones are reused. Additionally, all properties that were set at runtime are retained.'''
 +
|-
 +
| <code>control:transparent</code> || <code>{BOOLEAN_VALUE}</code> ||
 +
<code>"control:transparent": "true"</code><br/>
 +
<code>"control:transparent": "false"</code><br/>
 +
|| No || data-sort-value=142|'''0.1.142''' ||
 +
Indicates if a corresponding content background can be transparent when this video/audio is active. By default, the content background is set to a semi-transparent gray to darken the underlying video/audio and make the content more visible. If this video/audio is suitable for transparent mode (e.g. dark atmospheric background videos), this property can be set to <code>"true"</code>.
 +
 
 +
'''Note: To use this property, the <code>transparent</code> property of the corresponding content must be set to <code>2</code>, otherwise this property is ignored.'''
 
|-
 
|-
 
| <code>control:type</code> || <code>{CONTROL_TYPE}</code> ||
 
| <code>control:type</code> || <code>{CONTROL_TYPE}</code> ||
 
<code>"control:type": "default"</code><br/>
 
<code>"control:type": "default"</code><br/>
 
<code>"control:type": "extended"</code><br/>
 
<code>"control:type": "extended"</code><br/>
|| No ||
+
|| No || data-sort-value=130|'''0.1.130''' ||
Sets up the player control type. If the type is set to <code>"extended"</code>, the player is displayed in fullscreen mode, it will not disappear in pause mode, and it is possible to use the <code>info:text</code> and <code>info:image</code> properties.
+
Sets up the player control type. If the type is set to <code>"extended"</code>, the player is displayed in fullscreen mode, it will not disappear in pause mode, and it is possible to use the <code>info:headline</code>, <code>info:text</code>, <code>info:image</code>, and <code>progress:display</code> properties.
 
|-
 
|-
 
| <code>image:action</code> || <code>{ACTION}</code> ||
 
| <code>image:action</code> || <code>{ACTION}</code> ||
 
<code>"image:action": "info:Custom image action executed."</code><br/>
 
<code>"image:action": "info:Custom image action executed."</code><br/>
|| No ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
Sets up a custom slideshow image action (replacement for the default slideshow image action). By default, the action <code>slider:labels:play_pause</code> is executed.
+
Sets up a custom slideshow image action (replacement for the default slideshow image action). Please see [[Internal Actions]] for possible values. By default, the action <code>slider:default</code> is executed.
  
 
'''Note: For property actions, it is not possible to provide an action-related <code>data</code> property. If you want to execute a property data action, please use the <code>execute:fetch:{URL}</code> action, alternatively.'''
 
'''Note: For property actions, it is not possible to provide an action-related <code>data</code> property. If you want to execute a property data action, please use the <code>execute:fetch:{URL}</code> action, alternatively.'''
Line 126: Line 178:
 
| <code>image:extension</code> || <code>{LABEL}</code> ||
 
| <code>image:extension</code> || <code>{LABEL}</code> ||
 
<code>"image:extension": "Custom image extension label"</code><br/>
 
<code>"image:extension": "Custom image extension label"</code><br/>
|| No ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
 
Sets up an additional slideshow image extension label (displayed in the slideshow labels).
 
Sets up an additional slideshow image extension label (displayed in the slideshow labels).
 
This property supports [[Inline Expressions]].
 
This property supports [[Inline Expressions]].
 +
|-
 +
| <code>image:icon</code> || <code>{ICON}</code> ||
 +
<code>"image:icon": "info"</code><br/>
 +
|| '''Yes''' || data-sort-value=145|'''0.1.145''' ||
 +
Sets up a custom slideshow image icon (displayed in the slideshow labels on the left side).  Please see [[Icons]] for possible values. This icon should be used to give a hint of the custom slideshow image action. If this property is set to <code>"slider:options"</code>, the icon of the selected image options item is used (unless the default item is selected).
 +
 +
'''Note: To use this property, the <code>image:action</code> property must also be set, otherwise this property is ignored.'''
 +
|-
 +
| <code>image:options</code> || <code>{BOOLEAN_VALUE}</code> ||
 +
<code>"image:options": "true"</code><br/>
 +
<code>"image:options": "false"</code><br/>
 +
|| No || data-sort-value=145|'''0.1.145''' ||
 +
Activates/Deactives slideshow image options (e.g. to rotate the current slideshow image). The availability of image options for the current image is indicated in the slideshow labels on the right side. By default, slideshow image options are deactivated.
 +
 +
'''Note: If slideshow image options are activated, you can also use the remote control buttons <code>REWIND</code> and <code>FORWARD</code> to rotate the image to left and right.'''
 +
|-
 +
| <code>image:rotation:trigger</code> || <code>{ACTION}</code> ||
 +
<code>"image:rotation:trigger": "info:Image has been rotated."</code><br/>
 +
|| No || data-sort-value=145|'''0.1.145''' ||
 +
Sets up a slideshow image rotation trigger. Please see [[Internal Actions]] for possible values.
 +
 +
'''Note: For property actions, it is not possible to provide an action-related <code>data</code> property. If you want to execute a property data action, please use the <code>execute:fetch:{URL}</code> action, alternatively.'''
 +
|-
 +
| <code>image:rotation:value</code> || <code>{ROTATION_VALUE}</code> ||
 +
<code>"image:rotation:value": "-270"</code><br/>
 +
<code>"image:rotation:value": "-180"</code><br/>
 +
<code>"image:rotation:value": "-90"</code><br/>
 +
<code>"image:rotation:value": "0"</code><br/>
 +
<code>"image:rotation:value": "90"</code><br/>
 +
<code>"image:rotation:value": "180"</code><br/>
 +
<code>"image:rotation:value": "270"</code><br/>
 +
|| '''Yes''' || data-sort-value=145|'''0.1.145''' ||
 +
Sets up a slideshow image rotation value in degrees.
 +
 +
'''Note: The rotation value must be divisible by 90, otherwise <code>"0"</code> is used.'''
 
|-
 
|-
 
| <code>image:trigger</code> || <code>{ACTION}</code> ||
 
| <code>image:trigger</code> || <code>{ACTION}</code> ||
 
<code>"image:trigger": "info:Image is visible."</code><br/>
 
<code>"image:trigger": "info:Image is visible."</code><br/>
|| No ||
+
|| No || data-sort-value=111|'''0.1.111''' ||
Sets up a slideshow image trigger.
+
Sets up a slideshow image trigger. Please see [[Internal Actions]] for possible values.
  
 
'''Note: For property actions, it is not possible to provide an action-related <code>data</code> property. If you want to execute a property data action, please use the <code>execute:fetch:{URL}</code> action, alternatively.'''
 
'''Note: For property actions, it is not possible to provide an action-related <code>data</code> property. If you want to execute a property data action, please use the <code>execute:fetch:{URL}</code> action, alternatively.'''
 +
|-
 +
| <code>info:headline</code> || <code>{HEADLINE}</code> ||
 +
<code>"info:headline": "Additional video/audio information headline"</code><br/>
 +
<code>"info:headline": "default"</code><br/>
 +
|| '''Yes''' || data-sort-value=154|'''0.1.154''' ||
 +
Sets up a player info headline.
 +
This property supports [[Inline Expressions]].
 +
 +
'''Note: To use this property, the <code>conrtol:type</code> property must be set to <code>"extended"</code>, otherwise this property is ignored.'''
 
|-
 
|-
 
| <code>info:image</code> || <code>{URL}</code> ||
 
| <code>info:image</code> || <code>{URL}</code> ||
 
<code>"info:image": "http://msx.benzac.de/img/icon.png"</code><br/>
 
<code>"info:image": "http://msx.benzac.de/img/icon.png"</code><br/>
 
<code>"info:image": "default"</code><br/>
 
<code>"info:image": "default"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=130|'''0.1.130''' ||
Sets up a player info image. The area of the image is 128x416 (WxH) pixels at layout resolution 720p (192x624 at 1080p). The image is sized to fill the entire width (by keeping the ratio) and is positioned at the top.
+
Sets up a player info image. Please see property <code>"info:size"</code> for the size of the area.
 +
 
 +
'''Note: To use this property, the <code>conrtol:type</code> property must be set to <code>"extended"</code>, otherwise this property is ignored.'''
 +
|-
 +
| <code>info:overlay</code> || <code>{OVERLAY}</code> ||
 +
<code>"info:overlay": "full"</code><br/>
 +
<code>"info:overlay": "default"</code><br/>
 +
|| '''Yes''' || data-sort-value=146|'''0.1.146''' ||
 +
Sets up the player info overlay. By default, only the top and bottom edges have an overlay. If you want to show a lot of text (i.e. by using the <code>info:text</code> property), it is recommended to use the <code>"full"</code> overlay.
 +
 
 +
'''Note: To use this property, the <code>conrtol:type</code> property must be set to <code>"extended"</code>, otherwise this property is ignored.'''
 +
|-
 +
| <code>info:round</code> || <code>{BOOLEAN_VALUE}</code> ||
 +
<code>"image:round": "true"</code><br/>
 +
<code>"image:round": "false"</code><br/>
 +
|| '''Yes''' || data-sort-value=156|'''0.1.156''' ||
 +
Enables/Disables rounded corners of the info image if the rounded style is used. By default, the info image corners are rounded for this style. Disabling rounded corners can be useful when using transparent logos that use some corners.
 +
 
 +
'''Note: To use this property, the <code>conrtol:type</code> property must be set to <code>"extended"</code>, otherwise this property is ignored.'''
 +
|-
 +
| <code>info:size</code> || <code>{SIZE}</code> ||
 +
<code>"info:size": "small"</code><br/>
 +
<code>"info:size": "medium"</code><br/>
 +
<code>"info:size": "large"</code><br/>
 +
<code>"info:size": "extra-large"</code><br/>
 +
<code>"info:size": "default"</code><br/>
 +
|| '''Yes''' || data-sort-value=146|'''0.1.146''' ||
 +
Sets up the size of the player info image area. By default, the size is set to <code>"medium"</code>.
 +
 
 +
* <code>"small"</code>: The area of the image is 64x416 (WxH) pixels at layout resolution 720p (96x624 at 1080p).
 +
* <code>"medium"</code>: The area of the image is 128x416 (WxH) pixels at layout resolution 720p (192x624 at 1080p).
 +
* <code>"large"</code>: The area of the image is 256x416 (WxH) pixels at layout resolution 720p (384x624 at 1080p).
 +
* <code>"extra-large"</code>: The area of the image is 512x416 (WxH) pixels at layout resolution 720p (768x624 at 1080p).
 +
 
 +
The image is sized to fill the entire width (by keeping the ratio) and is positioned at the top.
  
 
'''Note: To use this property, the <code>conrtol:type</code> property must be set to <code>"extended"</code>, otherwise this property is ignored.'''
 
'''Note: To use this property, the <code>conrtol:type</code> property must be set to <code>"extended"</code>, otherwise this property is ignored.'''
 
|-
 
|-
 
| <code>info:text</code> || <code>{TEXT}</code> ||
 
| <code>info:text</code> || <code>{TEXT}</code> ||
<code>"info:text": "Additional video/audio information."</code><br/>
+
<code>"info:text": "Additional video/audio information text."</code><br/>
 
<code>"info:text": "default"</code><br/>
 
<code>"info:text": "default"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=130|'''0.1.130''' ||
 
Sets up a player info text.
 
Sets up a player info text.
 
This property supports [[Inline Expressions]].
 
This property supports [[Inline Expressions]].
Line 158: Line 288:
 
<code>"label:duration": "Custom duration label ({VALUE})"</code><br/>
 
<code>"label:duration": "Custom duration label ({VALUE})"</code><br/>
 
<code>"label:duration": "default"</code><br/>
 
<code>"label:duration": "default"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
 
Sets up the player duration label (overrides the default duration value of the video/audio player with a custom value). If the custom value contains the <code>{VALUE}</code> keyword, it is replaced with the default value.
 
Sets up the player duration label (overrides the default duration value of the video/audio player with a custom value). If the custom value contains the <code>{VALUE}</code> keyword, it is replaced with the default value.
 
This property supports [[Inline Expressions]].
 
This property supports [[Inline Expressions]].
Line 165: Line 295:
 
<code>"label:extension": "{ico:live-tv}"</code><br/>
 
<code>"label:extension": "{ico:live-tv}"</code><br/>
 
<code>"label:extension": "default"</code><br/>
 
<code>"label:extension": "default"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
 
Sets up an additional player extension label.
 
Sets up an additional player extension label.
 
This property supports [[Inline Expressions]] and [[Live Inline Expressions]].
 
This property supports [[Inline Expressions]] and [[Live Inline Expressions]].
Line 173: Line 303:
 
<code>"label:position": "Custom position label ({VALUE})"</code><br/>
 
<code>"label:position": "Custom position label ({VALUE})"</code><br/>
 
<code>"label:position": "default"</code><br/>
 
<code>"label:position": "default"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
 
Sets up the player position label (overrides the default position value of the video/audio player with a custom value). If the custom value contains the <code>{VALUE}</code> keyword, it is replaced with the default value.
 
Sets up the player position label (overrides the default position value of the video/audio player with a custom value). If the custom value contains the <code>{VALUE}</code> keyword, it is replaced with the default value.
 
This property supports [[Inline Expressions]].
 
This property supports [[Inline Expressions]].
Line 181: Line 311:
 
<code>"label:speed": "Custom speed label ({VALUE})"</code><br/>
 
<code>"label:speed": "Custom speed label ({VALUE})"</code><br/>
 
<code>"label:speed": "default"</code><br/>
 
<code>"label:speed": "default"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=130|'''0.1.130''' ||
 
Sets up the player speed label (overrides the default speed value of the video/audio player with a custom value). If the custom value contains the <code>{VALUE}</code> keyword, it is replaced with the default value.
 
Sets up the player speed label (overrides the default speed value of the video/audio player with a custom value). If the custom value contains the <code>{VALUE}</code> keyword, it is replaced with the default value.
 
This property supports [[Inline Expressions]].
 
This property supports [[Inline Expressions]].
Line 188: Line 318:
 
<code>"progress:color": "msx-red"</code><br/>
 
<code>"progress:color": "msx-red"</code><br/>
 
<code>"progress:color": "default"</code><br/>
 
<code>"progress:color": "default"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
Sets up the player progress color.
+
Sets up the player progress color. Please see [[Colors]] for possible values.
 +
|-
 +
| <code>progress:display</code> || <code>{BOOLEAN_VALUE}</code> ||
 +
<code>"progress:display": "true"</code><br/>
 +
<code>"progress:display": "false"</code><br/>
 +
|| No || data-sort-value=161|'''0.1.161''' ||
 +
Shows/Hides the player progress bar. By default, the progress bar is always visible. Hiding the progress bar can be useful for very special plugins that do not display any video or audio, but instead display an animated canvas, for example.
 +
 
 +
'''Note: To use this property, the <code>conrtol:type</code> property must be set to <code>"extended"</code>, otherwise this property is ignored.'''
 +
|-
 +
| <code>progress:duration</code> || <code>{PROGRESS_DURATION}</code> ||
 +
<code>"progress:duration:": "60"</code><br/>
 +
<code>"progress:duration:": "-1"</code><br/>
 +
|| '''Yes''' || data-sort-value=146|'''0.1.146''' ||
 +
Sets up the player progress duration in seconds (overrides the default duration value of the video/audio player with a custom value). The duration <code>-1</code> is default and uses the value of the video/audio player.
 +
 
 +
'''Note: Please note that this duration is only used in the player controls (it is not used for trigger and resume functions, nor for live playback objects).'''
 
|-
 
|-
 
| <code>progress:marker:enable</code> || <code>{BOOLEAN_VALUE}</code> ||
 
| <code>progress:marker:enable</code> || <code>{BOOLEAN_VALUE}</code> ||
 
<code>"progress:marker:enable": "true"</code><br/>
 
<code>"progress:marker:enable": "true"</code><br/>
 
<code>"progress:marker:enable": "false"</code><br/>
 
<code>"progress:marker:enable": "false"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
 
Enables/Disables the player progress marker.
 
Enables/Disables the player progress marker.
 +
 +
'''Note: If the <code>conrtol:type</code> property is set to <code>"extended"</code> and the <code>progress:display</code> property is set to <code>"false"</code>, this property is ignored.'''
 +
|-
 +
| <code>progress:position</code> || <code>{PROGRESS_POSITION}</code> ||
 +
<code>"progress:position:": "0"</code><br/>
 +
<code>"progress:position:": "-1"</code><br/>
 +
|| '''Yes''' || data-sort-value=146|'''0.1.146''' ||
 +
Sets up the player progress position (overrides the default position value of the video/audio player with a custom value). The position <code>-1</code> is default and uses the value of the video/audio player.
 +
 +
'''Note: Please note that this position is only used in the player controls (it is not used for trigger and resume functions, nor for live playback objects).'''
 
|-
 
|-
 
| <code>progress:type</code> || <code>{PROGRESS_TYPE}</code> ||
 
| <code>progress:type</code> || <code>{PROGRESS_TYPE}</code> ||
Line 221: Line 377:
 
<code>"progress:type": "fix:Fix progress label"</code><br/>
 
<code>"progress:type": "fix:Fix progress label"</code><br/>
 
<code>"progress:type": "default"</code><br/>
 
<code>"progress:type": "default"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
 
Sets up the player progress type (<code>"default"</code> is like <code>"time:hh:mm:ss"</code>). For the type that starts with (or contains) <code>position:</code>, the <code>{POSITION}</code> part is automatically replaced with the corresponding position value. For the type that starts with (or contains) <code>number:</code>, the <code>{NUMBER}</code> part is automatically replaced with the corresponding number value (which is the incremented position value).
 
Sets up the player progress type (<code>"default"</code> is like <code>"time:hh:mm:ss"</code>). For the type that starts with (or contains) <code>position:</code>, the <code>{POSITION}</code> part is automatically replaced with the corresponding position value. For the type that starts with (or contains) <code>number:</code>, the <code>{NUMBER}</code> part is automatically replaced with the corresponding number value (which is the incremented position value).
 +
|-
 +
| <code>resume:context</code> || <code>{RESUME_CONTEXT}</code> ||
 +
<code>"resume:context": "custom_resume_context"</code><br/>
 +
|| No || data-sort-value=153|'''0.1.153''' ||
 +
Sets up a resume context for the corresponding resume key. The context can be used to clear multiple resume keys at once (e.g. for a specific service or series).
 +
 +
'''Note: To use this property, the <code>resume:key</code> property must also be set, otherwise this property is ignored. The context is stored as hash code on the local device to the corresponding resume key.'''
 
|-
 
|-
 
| <code>resume:key</code> || <code>{RESUME_KEY}</code> ||
 
| <code>resume:key</code> || <code>{RESUME_KEY}</code> ||
Line 228: Line 391:
 
<code>"resume:key": "url"</code><br/>
 
<code>"resume:key": "url"</code><br/>
 
<code>"resume:key": "custom_resume_key"</code><br/>
 
<code>"resume:key": "custom_resume_key"</code><br/>
|| No ||
+
|| No || data-sort-value=111|'''0.1.111''' ||
 
Sets up a resume key to store/restore the content position. If the key is set to <code>"id"</code>, the corresponding content item ID is used as key. If the key is set to <code>"url"</code>, the corresponding content video/audio URL is used as key. In all other cases, the key is used as is.
 
Sets up a resume key to store/restore the content position. If the key is set to <code>"id"</code>, the corresponding content item ID is used as key. If the key is set to <code>"url"</code>, the corresponding content video/audio URL is used as key. In all other cases, the key is used as is.
  
Line 236: Line 399:
 
<code>"resume:position": "10"</code><br/>
 
<code>"resume:position": "10"</code><br/>
 
<code>"resume:position": "10%"</code><br/>
 
<code>"resume:position": "10%"</code><br/>
|| '''Yes''' ||
+
<code>"resume:position": "none"</code><br/>
Sets up a fix resume position in seconds or percentage to start the content from there.
+
|| '''Yes''' || data-sort-value=111|'''0.1.111''' ||
 +
Sets up a fix resume position in seconds or percentage to start the content from there. If the resume position is set to <code>"none"</code>, no resuming is performed.
 
|-
 
|-
 
| <code>trigger:{TRIGGER_KEY}</code> || <code>{ACTION}</code> ||
 
| <code>trigger:{TRIGGER_KEY}</code> || <code>{ACTION}</code> ||
Line 243: Line 407:
 
<code>"trigger:ready": "info:Video ready."</code><br/>
 
<code>"trigger:ready": "info:Video ready."</code><br/>
 
<code>"trigger:start": "info:Video started."</code><br/>
 
<code>"trigger:start": "info:Video started."</code><br/>
 +
<code>"trigger:ending": "info:Video is ending (video is playing and 10 seconds or less are remaining)."</code><br/>
 
<code>"trigger:end": "info:Video ended."</code><br/>
 
<code>"trigger:end": "info:Video ended."</code><br/>
 
<code>"trigger:complete": "info:Video completed."</code><br/>
 
<code>"trigger:complete": "info:Video completed."</code><br/>
Line 248: Line 413:
 
<code>"trigger:10%": "info:10% of video passed."</code><br/>
 
<code>"trigger:10%": "info:10% of video passed."</code><br/>
 
<code>"trigger:10t": "info:10 ticks of video passed."</code><br/>
 
<code>"trigger:10t": "info:10 ticks of video passed."</code><br/>
 +
<code>"trigger:-10": "info:Last 10 seconds of video passed."</code><br/>
 
<code>"trigger:20": "shot:info:20 seconds of video passed (shot)."</code><br/>
 
<code>"trigger:20": "shot:info:20 seconds of video passed (shot)."</code><br/>
 
<code>"trigger:20%": "shot:info:20% of video passed (shot)."</code><br/>
 
<code>"trigger:20%": "shot:info:20% of video passed (shot)."</code><br/>
 
<code>"trigger:20t": "shot:info:20 ticks of video passed (shot)."</code><br/>
 
<code>"trigger:20t": "shot:info:20 ticks of video passed (shot)."</code><br/>
 +
<code>"trigger:-20": "shot:info:Last 20 seconds of video passed (shot)".</code><br/>
 
<code>"trigger:quartile1": "info:First quartile of video entered."</code><br/>
 
<code>"trigger:quartile1": "info:First quartile of video entered."</code><br/>
 
<code>"trigger:quartile2": "info:Second quartile of video entered."</code><br/>
 
<code>"trigger:quartile2": "info:Second quartile of video entered."</code><br/>
Line 267: Line 434:
 
<code>"trigger:background": "info:Video moved to background."</code><br/>
 
<code>"trigger:background": "info:Video moved to background."</code><br/>
 
<code>"trigger:back" ":info:Video back executed."</code><br/>
 
<code>"trigger:back" ":info:Video back executed."</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=58|'''0.1.58''' ||
Sets up a video/audio trigger.
+
Sets up a video/audio trigger. Please see [[Internal Actions]] for possible values.
  
 
'''Note: For trigger key <code>complete</code>, the action <code>player:auto:next</code> is automatically set (please use trigger key <code>end</code> if you want to keep the default complete action). For property actions, it is not possible to provide an action-related <code>data</code> property. If you want to execute a property data action, please use the <code>execute:fetch:{URL}</code> action, alternatively.'''
 
'''Note: For trigger key <code>complete</code>, the action <code>player:auto:next</code> is automatically set (please use trigger key <code>end</code> if you want to keep the default complete action). For property actions, it is not possible to provide an action-related <code>data</code> property. If you want to execute a property data action, please use the <code>execute:fetch:{URL}</code> action, alternatively.'''
Line 274: Line 441:
 
| <code>video:duration</code> || <code>{VIDEO_DURATION}</code> ||
 
| <code>video:duration</code> || <code>{VIDEO_DURATION}</code> ||
 
<code>"video:duration:": "60"</code><br/>
 
<code>"video:duration:": "60"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=128|'''0.1.128''' ||
Sets up a custom video duration in seconds. If a custom duration is set, only that duration is displayed during playback. It can be used for live data or ads to disable/override the progress feature. The duration <code>-1</code> is default and enables the display feature.
+
Sets up a custom video duration in seconds. If a custom duration is set, only that duration is displayed (and used for trigger and resume functions, as well as live playback objects) during playback. It can be used for live data or ads to disable/override the progress feature. The duration <code>-1</code> is default and enables the display feature.
 
|-
 
|-
 
| <code>video:position</code> || <code>{VIDEO_POSITION}</code> ||
 
| <code>video:position</code> || <code>{VIDEO_POSITION}</code> ||
 
<code>"video:position:": "0"</code><br/>
 
<code>"video:position:": "0"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=128|'''0.1.128''' ||
Sets up a custom video 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 <code>custom:video:seek</code> event is triggered). It can be used for live data or ads to disable/override the progress feature. The position <code>-1</code> is default and enables the display and seek feature. The position <code>-2</code> only enables the display feature (it is not possible to seek to another position).
+
Sets up a custom video position in seconds. If a custom position is set, only that position is displayed (and used for trigger and resume functions, as well as live playback objects) during playback and it is not possible to seek to another position (instead a <code>custom:video:seek</code> event is triggered). It can be used for live data or ads to disable/override the progress feature. The position <code>-1</code> is default and enables the display and seek feature. The position <code>-2</code> only enables the display feature (it is not possible to seek to another position).
 
|-
 
|-
 
| <code>video:speed</code> || <code>{VIDEO_SPEED}</code> ||
 
| <code>video:speed</code> || <code>{VIDEO_SPEED}</code> ||
 
<code>"video:speed:": "1"</code><br/>
 
<code>"video:speed:": "1"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=128|'''0.1.128''' ||
 
Sets up a custom video speed. If a custom speed is set, only that speed is displayed during playback and it is not possible to change it (instead a <code>custom:video:speed</code> event is triggered). It can be used for live data or ads to disable/override the speed feature. The speed <code>-1</code> is default and enables the display and change feature. The speed <code>-2</code> only enables the display feature (it is not possible to change it).
 
Sets up a custom video speed. If a custom speed is set, only that speed is displayed during playback and it is not possible to change it (instead a <code>custom:video:speed</code> event is triggered). It can be used for live data or ads to disable/override the speed feature. The speed <code>-1</code> is default and enables the display and change feature. The speed <code>-2</code> only enables the display feature (it is not possible to change it).
  
Line 291: Line 458:
 
| <code>video:state</code> || <code>{VIDEO_STATE}</code> ||
 
| <code>video:state</code> || <code>{VIDEO_STATE}</code> ||
 
<code>"video:state:": "2"</code><br/>
 
<code>"video:state:": "2"</code><br/>
|| '''Yes''' ||
+
|| '''Yes''' || data-sort-value=128|'''0.1.128''' ||
 
Sets up a custom video state. If a custom state is set, only that state is displayed during playback and it is not possible to change it (instead a <code>custom:video:play</code> or <code>custom:video:pause</code> event is triggered). It can be used for live data or ads to disable/override the play/pause feature.
 
Sets up a custom video state. If a custom state is set, only that state is displayed during playback and it is not possible to change it (instead a <code>custom:video:play</code> or <code>custom:video:pause</code> event is triggered). It can be used for live data or ads to disable/override the play/pause feature.
 
* <code>-2</code>: Read-only (only enables the display feature)
 
* <code>-2</code>: Read-only (only enables the display feature)
Line 309: Line 476:
 
<syntaxhighlight lang="json">
 
<syntaxhighlight lang="json">
 
{
 
{
     "type": "pages",
+
     "type": "list",
 
     "headline": "Extended Properties Test",
 
     "headline": "Extended Properties Test",
 
     "template": {
 
     "template": {
Line 402: Line 569:
 
                 "live:channel": "0",
 
                 "live:channel": "0",
 
                 "live:program": "-1"
 
                 "live:program": "-1"
 +
            }
 +
        }, {
 +
            "badge": "Extended",
 +
            "title": "Video 6",
 +
            "titleFooter": "0.1.140+",
 +
            "playerLabel": "Video 6",
 +
            "action": "video:http://msx.benzac.de/media/video6.mp4",
 +
            "properties": {
 +
                "control:type": "extended",
 +
                "control:action": "[player:show:execute|player:pause]",
 +
                "trigger:foreground": "player:auto:play",
 +
                "button:play_pause:icon": "default",
 +
                "button:play_pause:action": "[player:play_pause|player:hide_play]",
 +
                "info:text": "This video shows a quick play/pause function.{br}{ico:msx-white:play-arrow} If you press {txt:msx-white:OK} while the video is in foreground, it is paused.{br}{ico:msx-white:play-arrow} If you return to foreground, it is resumed.{br}"               
 +
            }
 +
        }, {
 +
            "badge": "Extended",
 +
            "title": "Video 7",
 +
            "titleFooter": "0.1.146+",
 +
            "playerLabel": "Video 7",
 +
            "action": "video:http://msx.benzac.de/media/video7.mp4",
 +
            "properties": {
 +
                "control:type": "extended",
 +
                "info:image": "http://msx.benzac.de/media/thumbs/video7.jpg",
 +
                "info:size": "large",
 +
                "info:overlay": "full",             
 +
                "info:text": "This video shows a next video selection when the video is ending (i.e. the video is playing and 10 seconds or less are remaining).",
 +
                "trigger:ending": "content:http://msx.benzac.de/info/xp/data/next_video_test.json",
 +
                "trigger:complete": "[]"
 
             }
 
             }
 
         }]
 
         }]
Line 410: Line 606:
 
* Launch via App: https://msx.benzac.de/?start=content:https://msx.benzac.de/info/xp/data/properties_test.json
 
* Launch via App: https://msx.benzac.de/?start=content:https://msx.benzac.de/info/xp/data/properties_test.json
 
* Launch via Demo Page: https://msx.benzac.de/info/?start=content:https://msx.benzac.de/info/xp/data/properties_test.json
 
* Launch via Demo Page: https://msx.benzac.de/info/?start=content:https://msx.benzac.de/info/xp/data/properties_test.json
 +
 +
== Related Hidden Features ==
 +
* [[Key Property]]
 +
* [[Option Shortcut]]
 +
* [[Image Options]]

Latest revision as of 19:09, 19 November 2024

These properties can be used for special use cases and are only valid for version 0.1.58+. Each property is a key-value pair of type string and can be set in the properties property of a Content Item Object. The dynamic properties can also be set via an action at runtime. For more information, please see Internal Actions.

Note: It is also possible to set values of type boolean or number as non-string values (e.g. "true"true or "123"123).

Syntax[edit]

Property syntax of extended properties
Property Value Example Dynamic Since Version Description
button:{BUTTON_ID}:action {ACTION}

"button:content:action": "info:Custom content action executed."
"button:restart:action": "info:Custom restart action executed."
"button:prev:action": "info:Custom prev action executed."
"button:rewind:action": "info:Custom rewind action executed."
"button:play_pause:action": "info:Custom play/pause action executed."
"button:forward:action": "info:Custom forward action executed."
"button:next:action": "info:Custom next action executed."
"button:speed:action": "info:Custom speed action executed."

Yes 0.1.111

Sets up a custom player button action (all buttons except the eject button are supported). Please see Internal Actions for possible values. By default, the following actions are executed.

  • content: player:content
  • restart: player:restart
  • prev: player:prev
  • rewind: player:rewind
  • play_pause: player:play_pause
  • forward: player:forward
  • next: player:next
  • speed: player:speed

Note: To use this property, the corresponding button:{BUTTON_ID}:icon property must also be set, otherwise this property is ignored. If you set the action to "default", the default action is used. For property actions, it is not possible to provide an action-related data property. If you want to execute a property data action, please use the execute:fetch:{URL} action, alternatively.

button:{BUTTON_ID}:display {BOOLEAN_VALUE}

"button:content:display": "true"
"button:restart:display": "true"
"button:prev:display": "true"
"button:rewind:display": "true"
"button:play_pause:display": "true"
"button:forward:display": "true"
"button:next:display": "true"
"button:speed:display": "true"

No 0.1.130

Shows/Hides a player button (all buttons except the eject button are supported).

button:{BUTTON_ID}:enable {BOOLEAN_VALUE}

"button:content:enable": "true"
"button:restart:enable": "true"
"button:prev:enable": "true"
"button:rewind:enable": "true"
"button:play_pause:enable": "true"
"button:forward:enable": "true"
"button:next:enable": "true"
"button:speed:enable": "true"

Yes 0.1.111

Enables/Disables a player button (all buttons except the eject button are supported).

button:{BUTTON_ID}:focus {BOOLEAN_VALUE}

"button:content:focus": "true"
"button:restart:focus": "true"
"button:prev:focus": "true"
"button:rewind:focus": "true"
"button:play_pause:focus": "true"
"button:forward:focus": "true"
"button:next:focus": "true"
"button:speed:focus": "true"
"button:eject:focus": "true"
"button:none:focus": "true"

Yes 0.1.111

Focuses a player button (if the player is loaded). If the button none is used, no button is focused (i.e. the last selected button is retained) if the player is loaded via an execution event.

Note: By default, the button play_pause is focused if the player is loaded via an execution event (e.g. if the OK key is pressed while the video/audio is in foreground).

button:{BUTTON_ID}:icon {ICON}

"button:content:icon": "pageview"
"button:restart:icon": "replay"
"button:prev:icon": "skip-previous"
"button:rewind:icon": "fast-rewind"
"button:play_pause:icon": "play-arrow|pause"
"button:forward:icon": "fast-forward"
"button:next:icon": "skip-next"
"button:speed:icon": "slow-motion-video"

Yes 0.1.111

Sets up a custom player button icon (all buttons except the eject button are supported). Please see Icons for possible values. By default, the following icons are used.

  • content: pageview
  • restart: replay
  • prev: skip-previous
  • rewind: fast-rewind
  • play_pause: play-arrow|pause |
  • forward: fast-forward
  • next: skip-next
  • speed: slow-motion-video

Note: To use this property, the corresponding button:{BUTTON_ID}:action property must also be set, otherwise this property is ignored. If you set the icon to "default", the default icon is used. For the play_pause button, you can also set two icons by using the separator | (e.g. "play-arrow|pause").

button:{BUTTON_ID}:key {KEY}

"button:content:key": "1"
"button:restart:key": "2"
"button:prev:key": "3"
"button:rewind:key": "4"
"button:play_pause:key": "5"
"button:forward:key": "6"
"button:next:key": "7"
"button:speed:key": "8"
"button:eject:key": "9"

Yes 0.1.132

Sets up a player button shortcut key. Please see Key Property for possible values.

control:action {ACTION}

"control:action": "info:Custom player control action executed."

Yes 0.1.140

Sets up a custom player control action (replacement for the action that is executed if the OK key is pressed while the video/audio is in foreground). Please see Internal Actions for possible values. By default, the action player:default is executed.

Note: For property actions, it is not possible to provide an action-related data property. If you want to execute a property data action, please use the execute:fetch:{URL} action, alternatively.

control:dim {BOOLEAN_VALUE}

"control:dim": "true"
"control:dim": "false"

No 0.1.148

Indicates if the application background should be dimmed when this video is playing. By default, the application background is dimmed to provide a better user experince for videos on devices that do not have a 16:9 screen ratio (by setting the gray background to black). However, if this video is a plugin that displays images or renders objects, this property can be set to "false" to keep the gray background.

Note: This property only affects mobile and desktop devices, because all current TV devices have a 16:9 screen ratio. Please also note that this property only has an effect if zoom or scale settings are used.

control:load {LOAD_MODE}

"control:load": "default"
"control:load": "silent"

No 0.1.111

Sets up the player control load mode. If the mode is set to "silent", the player is not shown if the video/audio is loaded in auto mode (e.g. if the action player:auto:next is executed).

control:retune {RETUNE_MODE}

"control:retune": "default"
"control:retune": "retain"
"control:retune": "play"
"control:retune": "restart"

No 0.1.145

Sets up the player control retune mode. If the mode is set to "retain", "play", or "restart" and the (resolved) video/audio URL matches the active one, the active video/audio URL is reused. In case of "retain", the active video/audio play/pause state is retained. In case of "play", the active video/audio is played again (if it was paused). In case of "restart", the active video/audio is restarted. By default, the active video/audio URL is never reused and the new URL is retuned. If the active video/audio has already been ended, this property is ignored.

Note: Please note that if the active video/audio URL is reused (in contrast to the control:reuse property), all extended properties of the video/audio data (e.g. "control:type", "progress:type", "trigger:{TRIGGER_KEY}", etc.) are applied. Additionally, all properties that were set at runtime are cleared.

control:return {RETURN_MODE}

"control:return": "default"
"control:return": "silent"

No 0.1.140

Sets up the player control return mode. If the mode is set to "silent", the player is not shown if returning from a content page.

control:reuse {REUSE_MODE}

"control:reuse": "default"
"control:reuse": "retain"
"control:reuse": "play"
"control:reuse": "restart"

No 0.1.142

Sets up the player control reuse mode. If the mode is set to "retain", "play", or "restart" and the video/audio base data matches the active one (i.e. id, index, number, type, url, label, background etc. are the same), the active video/audio data is reused. In case of "retain", the active video/audio play/pause state is retained. In case of "play", the active video/audio is played again (if it was paused). In case of "restart", the active video/audio is restarted. By default, the active video/audio data is never reused and the new data is applied and the video/audio is retuned. If the active video/audio has already been ended, this property is ignored.

Note: Please note that if the active video/audio data is reused (in contrast to the control:retune property), all extended properties of the new data (e.g. "control:type", "progress:type", "trigger:{TRIGGER_KEY}", etc.) are ignored, because the active ones are reused. Additionally, all properties that were set at runtime are retained.

control:transparent {BOOLEAN_VALUE}

"control:transparent": "true"
"control:transparent": "false"

No 0.1.142

Indicates if a corresponding content background can be transparent when this video/audio is active. By default, the content background is set to a semi-transparent gray to darken the underlying video/audio and make the content more visible. If this video/audio is suitable for transparent mode (e.g. dark atmospheric background videos), this property can be set to "true".

Note: To use this property, the transparent property of the corresponding content must be set to 2, otherwise this property is ignored.

control:type {CONTROL_TYPE}

"control:type": "default"
"control:type": "extended"

No 0.1.130

Sets up the player control type. If the type is set to "extended", the player is displayed in fullscreen mode, it will not disappear in pause mode, and it is possible to use the info:headline, info:text, info:image, and progress:display properties.

image:action {ACTION}

"image:action": "info:Custom image action executed."

Yes 0.1.111

Sets up a custom slideshow image action (replacement for the default slideshow image action). Please see Internal Actions for possible values. By default, the action slider:default is executed.

Note: For property actions, it is not possible to provide an action-related data property. If you want to execute a property data action, please use the execute:fetch:{URL} action, alternatively.

image:extension {LABEL}

"image:extension": "Custom image extension label"

Yes 0.1.111

Sets up an additional slideshow image extension label (displayed in the slideshow labels). This property supports Inline Expressions.

image:icon {ICON}

"image:icon": "info"

Yes 0.1.145

Sets up a custom slideshow image icon (displayed in the slideshow labels on the left side). Please see Icons for possible values. This icon should be used to give a hint of the custom slideshow image action. If this property is set to "slider:options", the icon of the selected image options item is used (unless the default item is selected).

Note: To use this property, the image:action property must also be set, otherwise this property is ignored.

image:options {BOOLEAN_VALUE}

"image:options": "true"
"image:options": "false"

No 0.1.145

Activates/Deactives slideshow image options (e.g. to rotate the current slideshow image). The availability of image options for the current image is indicated in the slideshow labels on the right side. By default, slideshow image options are deactivated.

Note: If slideshow image options are activated, you can also use the remote control buttons REWIND and FORWARD to rotate the image to left and right.

image:rotation:trigger {ACTION}

"image:rotation:trigger": "info:Image has been rotated."

No 0.1.145

Sets up a slideshow image rotation trigger. Please see Internal Actions for possible values.

Note: For property actions, it is not possible to provide an action-related data property. If you want to execute a property data action, please use the execute:fetch:{URL} action, alternatively.

image:rotation:value {ROTATION_VALUE}

"image:rotation:value": "-270"
"image:rotation:value": "-180"
"image:rotation:value": "-90"
"image:rotation:value": "0"
"image:rotation:value": "90"
"image:rotation:value": "180"
"image:rotation:value": "270"

Yes 0.1.145

Sets up a slideshow image rotation value in degrees.

Note: The rotation value must be divisible by 90, otherwise "0" is used.

image:trigger {ACTION}

"image:trigger": "info:Image is visible."

No 0.1.111

Sets up a slideshow image trigger. Please see Internal Actions for possible values.

Note: For property actions, it is not possible to provide an action-related data property. If you want to execute a property data action, please use the execute:fetch:{URL} action, alternatively.

info:headline {HEADLINE}

"info:headline": "Additional video/audio information headline"
"info:headline": "default"

Yes 0.1.154

Sets up a player info headline. This property supports Inline Expressions.

Note: To use this property, the conrtol:type property must be set to "extended", otherwise this property is ignored.

info:image {URL}

"info:image": "http://msx.benzac.de/img/icon.png"
"info:image": "default"

Yes 0.1.130

Sets up a player info image. Please see property "info:size" for the size of the area.

Note: To use this property, the conrtol:type property must be set to "extended", otherwise this property is ignored.

info:overlay {OVERLAY}

"info:overlay": "full"
"info:overlay": "default"

Yes 0.1.146

Sets up the player info overlay. By default, only the top and bottom edges have an overlay. If you want to show a lot of text (i.e. by using the info:text property), it is recommended to use the "full" overlay.

Note: To use this property, the conrtol:type property must be set to "extended", otherwise this property is ignored.

info:round {BOOLEAN_VALUE}

"image:round": "true"
"image:round": "false"

Yes 0.1.156

Enables/Disables rounded corners of the info image if the rounded style is used. By default, the info image corners are rounded for this style. Disabling rounded corners can be useful when using transparent logos that use some corners.

Note: To use this property, the conrtol:type property must be set to "extended", otherwise this property is ignored.

info:size {SIZE}

"info:size": "small"
"info:size": "medium"
"info:size": "large"
"info:size": "extra-large"
"info:size": "default"

Yes 0.1.146

Sets up the size of the player info image area. By default, the size is set to "medium".

  • "small": The area of the image is 64x416 (WxH) pixels at layout resolution 720p (96x624 at 1080p).
  • "medium": The area of the image is 128x416 (WxH) pixels at layout resolution 720p (192x624 at 1080p).
  • "large": The area of the image is 256x416 (WxH) pixels at layout resolution 720p (384x624 at 1080p).
  • "extra-large": The area of the image is 512x416 (WxH) pixels at layout resolution 720p (768x624 at 1080p).

The image is sized to fill the entire width (by keeping the ratio) and is positioned at the top.

Note: To use this property, the conrtol:type property must be set to "extended", otherwise this property is ignored.

info:text {TEXT}

"info:text": "Additional video/audio information text."
"info:text": "default"

Yes 0.1.130

Sets up a player info text. This property supports Inline Expressions.

Note: To use this property, the conrtol:type property must be set to "extended", otherwise this property is ignored.

label:duration {LABEL}

"label:duration": "Custom duration label"
"label:duration": "Custom duration label ({VALUE})"
"label:duration": "default"

Yes 0.1.111

Sets up the player duration label (overrides the default duration value of the video/audio player with a custom value). If the custom value contains the {VALUE} keyword, it is replaced with the default value. This property supports Inline Expressions.

label:extension {LABEL}

"label:extension": "{ico:live-tv}"
"label:extension": "default"

Yes 0.1.111

Sets up an additional player extension label. This property supports Inline Expressions and Live Inline Expressions.

label:position {LABEL}

"label:position": "Custom position label"
"label:position": "Custom position label ({VALUE})"
"label:position": "default"

Yes 0.1.111

Sets up the player position label (overrides the default position value of the video/audio player with a custom value). If the custom value contains the {VALUE} keyword, it is replaced with the default value. This property supports Inline Expressions.

label:speed {LABEL}

"label:speed": "Custom speed label"
"label:speed": "Custom speed label ({VALUE})"
"label:speed": "default"

Yes 0.1.130

Sets up the player speed label (overrides the default speed value of the video/audio player with a custom value). If the custom value contains the {VALUE} keyword, it is replaced with the default value. This property supports Inline Expressions.

progress:color {COLOR}

"progress:color": "msx-red"
"progress:color": "default"

Yes 0.1.111

Sets up the player progress color. Please see Colors for possible values.

progress:display {BOOLEAN_VALUE}

"progress:display": "true"
"progress:display": "false"

No 0.1.161

Shows/Hides the player progress bar. By default, the progress bar is always visible. Hiding the progress bar can be useful for very special plugins that do not display any video or audio, but instead display an animated canvas, for example.

Note: To use this property, the conrtol:type property must be set to "extended", otherwise this property is ignored.

progress:duration {PROGRESS_DURATION}

"progress:duration:": "60"
"progress:duration:": "-1"

Yes 0.1.146

Sets up the player progress duration in seconds (overrides the default duration value of the video/audio player with a custom value). The duration -1 is default and uses the value of the video/audio player.

Note: Please note that this duration is only used in the player controls (it is not used for trigger and resume functions, nor for live playback objects).

progress:marker:enable {BOOLEAN_VALUE}

"progress:marker:enable": "true"
"progress:marker:enable": "false"

Yes 0.1.111

Enables/Disables the player progress marker.

Note: If the conrtol:type property is set to "extended" and the progress:display property is set to "false", this property is ignored.

progress:position {PROGRESS_POSITION}

"progress:position:": "0"
"progress:position:": "-1"

Yes 0.1.146

Sets up the player progress position (overrides the default position value of the video/audio player with a custom value). The position -1 is default and uses the value of the video/audio player.

Note: Please note that this position is only used in the player controls (it is not used for trigger and resume functions, nor for live playback objects).

progress:type {PROGRESS_TYPE}

"progress:type": "position"
"progress:type": "position:{POSITION} {ico:image}"
"progress:type": "number"
"progress:type": "number:{NUMBER} {ico:image}"
"progress:type": "percentage"
"progress:type": "time:{LIVE_DURATION_FORMAT}"
"progress:type": "text:{LIVE_DURATION_TEXT}"
"progress:type": "reverse:position"
"progress:type": "reverse:position:{POSITION} {ico:image}"
"progress:type": "reverse:number"
"progress:type": "reverse:number:{NUMBER} {ico:image}"
"progress:type": "reverse:percentage"
"progress:type": "reverse:time:{LIVE_DURATION_FORMAT}"
"progress:type": "reverse:text:{LIVE_DURATION_TEXT}"
"progress:type": "difference:position"
"progress:type": "difference:position:{POSITION} {ico:image}"
"progress:type": "difference:number"
"progress:type": "difference:number:{NUMBER} {ico:image}"
"progress:type": "difference:percentage"
"progress:type": "difference:time:{LIVE_DURATION_FORMAT}"
"progress:type": "difference:text:{LIVE_DURATION_TEXT}"
"progress:type": "fix:Fix progress label"
"progress:type": "default"

Yes 0.1.111

Sets up the player progress type ("default" is like "time:hh:mm:ss"). For the type that starts with (or contains) position:, the {POSITION} part is automatically replaced with the corresponding position value. For the type that starts with (or contains) number:, the {NUMBER} part is automatically replaced with the corresponding number value (which is the incremented position value).

resume:context {RESUME_CONTEXT}

"resume:context": "custom_resume_context"

No 0.1.153

Sets up a resume context for the corresponding resume key. The context can be used to clear multiple resume keys at once (e.g. for a specific service or series).

Note: To use this property, the resume:key property must also be set, otherwise this property is ignored. The context is stored as hash code on the local device to the corresponding resume key.

resume:key {RESUME_KEY}

"resume:key": "id"
"resume:key": "url"
"resume:key": "custom_resume_key"

No 0.1.111

Sets up a resume key to store/restore the content position. If the key is set to "id", the corresponding content item ID is used as key. If the key is set to "url", the corresponding content video/audio URL is used as key. In all other cases, the key is used as is.

Note: The key is stored as hash code on the local device. Stored keys can be cleared with the resume:clear actions. If the resume:position property is also set, the content position is only stored.

resume:position {RESUME_POSITION}

"resume:position": "10"
"resume:position": "10%"
"resume:position": "none"

Yes 0.1.111

Sets up a fix resume position in seconds or percentage to start the content from there. If the resume position is set to "none", no resuming is performed.

trigger:{TRIGGER_KEY} {ACTION}

"trigger:load": "info:Video loaded."
"trigger:ready": "info:Video ready."
"trigger:start": "info:Video started."
"trigger:ending": "info:Video is ending (video is playing and 10 seconds or less are remaining)."
"trigger:end": "info:Video ended."
"trigger:complete": "info:Video completed."
"trigger:10": "info:10 seconds of video passed."
"trigger:10%": "info:10% of video passed."
"trigger:10t": "info:10 ticks of video passed."
"trigger:-10": "info:Last 10 seconds of video passed."
"trigger:20": "shot:info:20 seconds of video passed (shot)."
"trigger:20%": "shot:info:20% of video passed (shot)."
"trigger:20t": "shot:info:20 ticks of video passed (shot)."
"trigger:-20": "shot:info:Last 20 seconds of video passed (shot)".
"trigger:quartile1": "info:First quartile of video entered."
"trigger:quartile2": "info:Second quartile of video entered."
"trigger:quartile3": "info:Third quartile of video entered."
"trigger:quartile4": "info:Fourth quartile of video entered."
"trigger:first_quartile": "info:First quartile of video reached."
"trigger:midpoint": "info:Midpoint of video reached."
"trigger:third_quartile": "info:Third quartile of video reached."
"trigger:play": "info:Video is playing."
"trigger:pause": "info:Video paused."
"trigger:stop": "info:Video stopped."
"trigger:active": "info:Video player is visible or video moved to foreground."
"trigger:inactive": "info:Video moved to background."
"trigger:player": "info:Video player is visible."
"trigger:foreground": "info:Video moved to foreground."
"trigger:background": "info:Video moved to background."
"trigger:back" ":info:Video back executed."

Yes 0.1.58

Sets up a video/audio trigger. Please see Internal Actions for possible values.

Note: For trigger key complete, the action player:auto:next is automatically set (please use trigger key end if you want to keep the default complete action). For property actions, it is not possible to provide an action-related data property. If you want to execute a property data action, please use the execute:fetch:{URL} action, alternatively.

video:duration {VIDEO_DURATION}

"video:duration:": "60"

Yes 0.1.128

Sets up a custom video duration in seconds. If a custom duration is set, only that duration is displayed (and used for trigger and resume functions, as well as live playback objects) during playback. It can be used for live data or ads to disable/override the progress feature. The duration -1 is default and enables the display feature.

video:position {VIDEO_POSITION}

"video:position:": "0"

Yes 0.1.128

Sets up a custom video position in seconds. If a custom position is set, only that position is displayed (and used for trigger and resume functions, as well as live playback objects) during playback and it is not possible to seek to another position (instead a custom:video:seek event is triggered). It can be used for live data or ads to disable/override the progress feature. The position -1 is default and enables the display and seek feature. The position -2 only enables the display feature (it is not possible to seek to another position).

video:speed {VIDEO_SPEED}

"video:speed:": "1"

Yes 0.1.128

Sets up a custom video speed. If a custom speed is set, only that speed is displayed during playback and it is not possible to change it (instead a custom:video:speed event is triggered). It can be used for live data or ads to disable/override the speed feature. The speed -1 is default and enables the display and change feature. The speed -2 only enables the display feature (it is not possible to change it).

Note: The actual video speed is not changed. For example, if the custom video speed is set to x0.5, the actual video may still be playing at normal speed.

video:state {VIDEO_STATE}

"video:state:": "2"

Yes 0.1.128

Sets up a custom video 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:video:play or custom:video:pause event is triggered). It can be used for live data or ads to disable/override the play/pause feature.

  • -2: Read-only (only enables the display feature)
  • -1: Clear (default value that enables the display and change feature)
  • 1: Stopped (not supported)
  • 2: Playing
  • 3: Paused

Note: The actual video state is not changed. For example, if the custom video state is paused, the actual video may still be in the playing state.

Example[edit]

Screenshot[edit]

Example Screenshot (Extended Properties)

Code[edit]

{
    "type": "list",
    "headline": "Extended Properties Test",
    "template": {
        "type": "separate",
        "layout": "0,0,2,4",
        "icon": "msx-white-soft:movie",
        "color": "msx-glass"
    },
    "items": [{
            "title": "Video 1",
            "playerLabel": "Video 1",
            "action": "video:http://msx.benzac.de/media/video1.mp4",
            "properties": {
                "button:content:icon": "info",
                "button:content:action": "info:Live info executed.",
                "label:duration": "Live",
                "label:extension": "{ico:msx-red:live-tv}",
                "progress:color": "msx-red",
                "progress:type": "reverse:time:[H:]M:ss"
            }
        }, {
            "title": "Video 2",
            "playerLabel": "Video 2",
            "action": "video:http://msx.benzac.de/media/video2.mp4",
            "properties": {
                "button:content:icon": "info",
                "button:content:action": "info:Ad info executed.",
                "button:forward:enable": "false",
                "button:rewind:enable": "false",
                "button:restart:enable": "false",
                "button:speed:enable": "false",
                "label:extension": "{txt:msx-yellow:Ad}",
                "progress:color": "msx-yellow",
                "progress:type": "text:s",
                "progress:marker:enable": "false"
            }
        }, {
            "title": "Video 3",
            "playerLabel": "Video 3",
            "action": "video:http://msx.benzac.de/media/video4.mp4",
            "properties": {
                "button:content:icon": "info",
                "button:content:action": "info:Video info executed.",
                "label:extension": "{ico:msx-blue:local-play}",
                "progress:color": "msx-blue",
                "progress:type": "percentage",
                "trigger:midpoint": "info:Midpoint of video reached.",
                "trigger:third_quartile": "dialog:none"
            }
        }, {
            "badge": "Extended",
            "title": "Video 4",
            "titleFooter": "0.1.130+",
            "playerLabel": "Video 4",
            "action": "video:http://msx.benzac.de/media/video5.mp4",
            "properties": {
                "button:content:icon": "info",
                "button:content:action": "info:Video info executed.",  
                "button:rewind:icon": "thumb-down",
                "button:rewind:action": "info:Thumb down executed.",  
                "button:forward:icon": "thumb-up",
                "button:forward:action": "info:Thumb up executed.",  
                "button:restart:display": "false",
                "button:speed:display": "false",      
                "label:extension": "{ico:msx-white:ondemand-video} Extended",
                "progress:type": "time:[H:]M:ss",
                "control:type": "extended",
                "info:image": "http://msx.benzac.de/img/icon.png",
                "info:text": "Placeholder for additional video information."
            }
        }, {
            "badge": "Extended",
            "title": "Video 5",
            "titleFooter": "0.1.130+",
            "playerLabel": "Video 5",
            "action": "video:http://msx.benzac.de/media/video3.mp4",
            "properties": {
                "button:content:icon": "info",
                "button:content:action": "panel:request:interaction:program@http://msx.benzac.de/interaction/live.html",  
                "button:restart:display": "false",  
                "button:rewind:display": "false",               
                "button:play_pause:display": "false",
                "button:forward:display": "false",
                "button:speed:display": "false",                  
                "label:extension": "{ico:msx-white:access-time} {now:time:hh:mm:ss}",
                "label:position": "...",
                "label:duration": "...",               
                "control:type": "extended",
                "trigger:load": "interaction:load:http://msx.benzac.de/interaction/live.html",   
                "trigger:complete": "player:auto:restart",
                "info:text": "This video is controlled by an interaction plugin to simulate a live stream.",
                "live:channel": "0",
                "live:program": "-1"
            }
        }, {
            "badge": "Extended",
            "title": "Video 6",
            "titleFooter": "0.1.140+",
            "playerLabel": "Video 6",
            "action": "video:http://msx.benzac.de/media/video6.mp4",
            "properties": {
                "control:type": "extended",
                "control:action": "[player:show:execute|player:pause]",
                "trigger:foreground": "player:auto:play",
                "button:play_pause:icon": "default",
                "button:play_pause:action": "[player:play_pause|player:hide_play]",
                "info:text": "This video shows a quick play/pause function.{br}{ico:msx-white:play-arrow} If you press {txt:msx-white:OK} while the video is in foreground, it is paused.{br}{ico:msx-white:play-arrow} If you return to foreground, it is resumed.{br}"                
            }
        }, {
            "badge": "Extended",
            "title": "Video 7",
            "titleFooter": "0.1.146+",
            "playerLabel": "Video 7",
            "action": "video:http://msx.benzac.de/media/video7.mp4",
            "properties": {
                "control:type": "extended",
                "info:image": "http://msx.benzac.de/media/thumbs/video7.jpg",
                "info:size": "large",
                "info:overlay": "full",              
                "info:text": "This video shows a next video selection when the video is ending (i.e. the video is playing and 10 seconds or less are remaining).",
                "trigger:ending": "content:http://msx.benzac.de/info/xp/data/next_video_test.json",
                "trigger:complete": "[]" 
            }
        }]
}

Demo[edit]

Related Hidden Features[edit]