Extended Properties

From MSX - Wiki
Jump to navigation Jump to search

These properties can be used for special use cases and are only valid for version 0.1.111+. 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 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.

Parameter Syntax[edit]

Property syntax of extended properties
Property Value Example Dynamic Description
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

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"

Yes

Focuses a player button (if player is loaded).

button:content:action {ACTION}

"button:content:action": "info:Custom content action executed."

No

Sets up a custom content action (replacement for the player button in the lower left corner). By default, the action player:content is executed.

Note: To use this property, the button:content:icon property must also be set, otherwise this property is ignored. 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:load {LOAD_MODE}

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

No

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

image:action {ACTION}

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

No

Sets up a custom slideshow image action (replacement for the default slideshow image action). By default, the action slider:labels:play_pause 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"

No

Sets up an additional slideshow image extension label (displayed in the slideshow labels).

image:trigger {ACTION}

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

No

Sets up a slideshow image trigger.

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.

label:duration {LABEL}

"label:duration": "Custom duration label"
"label:duration": "default"

Yes

Sets up the player duration label (overrides the default duration value of the video/audio player with a custom value).

label:extension {LABEL}

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

Yes

Sets up an additional player extension label.

label:position {LABEL}

"label:position": "Custom position label"
"label:position": "default"

Yes

Sets up the player position label (overrides the default position value of the video/audio player with a custom value).

progress:color {COLOR}

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

Yes

Sets up the player progress color.

progress:marker:enable {BOOLEAN_VALUE}

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

Yes

Enables/Disables the player progress marker.

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

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).