Difference between revisions of "URL Parameters"

From MSX - Wiki
Jump to navigation Jump to search
 
(30 intermediate revisions by the same user not shown)
Line 47: Line 47:
 
* <code>1</code>: Delayed busy indicator (default for most platforms)
 
* <code>1</code>: Delayed busy indicator (default for most platforms)
 
* <code>2</code>: Instant busy indicator
 
* <code>2</code>: Instant busy indicator
 +
|-
 +
| <code>caption</code> || <code>number</code> ||
 +
<code>caption=0</code><br/>
 +
<code>caption=1</code><br/>
 +
<code>caption=2</code><br/>
 +
||
 +
Sets the caption settings (visibility of the options/menu caption that is indicated in the lower right corner of the content screen).
 +
 +
* <code>0</code>: Off (options/menu caption is hidden)
 +
* <code>1</code>: Visible if available (options/menu caption is visible if the menu button is available)
 +
* <code>2</code>: Always visible (default for most platforms)
 +
* <code>3</code>: Always visible (will be set automatically if the value was <code>1</code> and the menu button was pressed)
 
|-
 
|-
 
| <code>center</code> || <code>number</code> ||
 
| <code>center</code> || <code>number</code> ||
Line 59: Line 71:
 
| <code>dictionary</code> || <code>string</code> ||
 
| <code>dictionary</code> || <code>string</code> ||
 
<code>dictionary=http://msx.benzac.de/dic/en.json</code><br/>
 
<code>dictionary=http://msx.benzac.de/dic/en.json</code><br/>
 +
<code>dictionary=none</code><br/>
 +
<code>dictionary=custom</code><br/>
 
||
 
||
−
Sets the dictionary. This parameter is designed for testing purposes. For final usage, please set the dictionary as link in the menu or content data.
+
Sets the dictionary. This parameter is designed for testing purposes or special use cases.
 +
If this parameter is to <code>none</code>, no dictionary will be used (even if the startup data contains one or a custom dictionary is set).
 +
If this parameter is to <code>custom</code>, the custom dictionary will be used in preference (even if a <code>start</code> parameter is set).
 +
For final usage, please set the URL as <code>dictionary</code> property in the menu or content data or use the <code>dictionary:{URL}</code> action.
 
For more information, please see [[Dictionary Structure]].
 
For more information, please see [[Dictionary Structure]].
 
|-
 
|-
Line 92: Line 109:
 
<code>init=0</code><br/>
 
<code>init=0</code><br/>
 
<code>init=1</code><br/>
 
<code>init=1</code><br/>
 +
<code>init=2</code><br/>
 
||
 
||
 
Sets the init value.
 
Sets the init value.
Line 97: Line 115:
 
* <code>0</code>: Default (default for most platforms)
 
* <code>0</code>: Default (default for most platforms)
 
* <code>1</code>: Ignore stored content state
 
* <code>1</code>: Ignore stored content state
 +
* <code>2</code>: Enforce use of stored content state (by default, the stored content state is not used if a start parameter is set)
 
|-
 
|-
 
| <code>input</code> || <code>number</code> ||
 
| <code>input</code> || <code>number</code> ||
Line 103: Line 122:
 
<code>input=2</code><br/>
 
<code>input=2</code><br/>
 
<code>input=3</code><br/>
 
<code>input=3</code><br/>
 +
<code>input=4</code><br/>
 
||
 
||
 
Sets the input settings.
 
Sets the input settings.
Line 110: Line 130:
 
* <code>2</code>: Click & Swipe
 
* <code>2</code>: Click & Swipe
 
* <code>3</code>: Drag & Drop (default for most platforms)
 
* <code>3</code>: Drag & Drop (default for most platforms)
 +
* <code>4</code>: Move & Execute
 
|-
 
|-
 
| <code>layout</code> || <code>number</code>{{pipe}}<code>string</code> ||
 
| <code>layout</code> || <code>number</code>{{pipe}}<code>string</code> ||
Line 137: Line 158:
 
* <code>auto</code>: Auto detect (with resize adjustment)
 
* <code>auto</code>: Auto detect (with resize adjustment)
 
* <code>detect</code>: Auto detect (without resize adjustment)
 
* <code>detect</code>: Auto detect (without resize adjustment)
 +
|-
 +
| <code>leave</code> || <code>number</code> ||
 +
<code>leave=0</code><br/>
 +
<code>leave=1</code><br/>
 +
||
 +
Sets the leave function.
 +
The leave function performs a web history back on execution and can be used if the Media Station X application is opened from another application (or from the local Media Station X application).
 +
 +
* <code>0</code>: Off (leave function is hidden)
 +
* <code>1</code>: On (leave function is visible)
 
|-
 
|-
 
| <code>platform</code> || <code>string</code> ||
 
| <code>platform</code> || <code>string</code> ||
Line 143: Line 174:
 
<code>platform=samsung</code><br/>
 
<code>platform=samsung</code><br/>
 
<code>platform=lg</code><br/>
 
<code>platform=lg</code><br/>
 +
<code>platform=netcast</code><br/>
 
<code>platform=panasonic</code><br/>
 
<code>platform=panasonic</code><br/>
 
<code>platform=chromecast</code><br/>
 
<code>platform=chromecast</code><br/>
Line 152: Line 184:
 
<code>platform=uwp</code><br/>
 
<code>platform=uwp</code><br/>
 
<code>platform=mac</code><br/>
 
<code>platform=mac</code><br/>
 +
<code>platform=win</code><br/>
 
||
 
||
 
Sets the platform identifier (usually this is not set by parameter, because each platform has its own index file).
 
Sets the platform identifier (usually this is not set by parameter, because each platform has its own index file).
Line 160: Line 193:
 
<code>remote=2</code><br/>
 
<code>remote=2</code><br/>
 
<code>remote=3</code><br/>
 
<code>remote=3</code><br/>
 +
<code>remote=4</code><br/>
 
||
 
||
 
Sets the remote settings.
 
Sets the remote settings.
Line 166: Line 200:
 
* <code>1</code>: Minimalistic (default for most platforms)
 
* <code>1</code>: Minimalistic (default for most platforms)
 
* <code>2</code>: Navigation Frame
 
* <code>2</code>: Navigation Frame
−
* <code>3</code>: Complex
+
* <code>3</code>: Corner Controls
 +
* <code>4</code>: Complex
 
|-
 
|-
 
| <code>playback</code> || <code>number</code> ||
 
| <code>playback</code> || <code>number</code> ||
 
<code>playback=0</code><br/>
 
<code>playback=0</code><br/>
 
<code>playback=1</code><br/>
 
<code>playback=1</code><br/>
 +
<code>playback=2</code><br/>
 +
<code>playback=3</code><br/>
 
||
 
||
 
Sets the playback mode.
 
Sets the playback mode.
  
−
* <code>0</code>: Foreground only (video/audio pauses when the application goes to sleep)
+
* <code>0</code>: Stop (video/audio stops when the application goes to sleep)
−
* <code>1</code>: Foreground & Background (video/audio continues to play when the application goes to sleep; default for most platforms)
+
* <code>1</code>: Pause only (video/audio pauses when the application goes to sleep and stays in that state when the application wakes up)
 +
* <code>2</code>: Pause/Play (video/audio pauses when the application goes to sleep and continues to play when the application wakes up)
 +
* <code>3</code>: Keep playing (video/audio continues to play when the application goes to sleep or the system controls the behavior; default for most platforms)
 +
|-
 +
| <code>pointer</code> || <code>number</code> ||
 +
<code>pointer=0</code><br/>
 +
<code>pointer=1</code><br/>
 +
<code>pointer=2</code><br/>
 +
<code>pointer=3</code><br/>
 +
<code>pointer=4</code><br/>
 +
<code>pointer=5</code><br/>
 +
||
 +
Sets the pointer mode.
 +
 
 +
* <code>0</code>: Off (no mouse and touch events are handled)
 +
* <code>1</code>: Mouse (only mouse events are handled)
 +
* <code>2</code>: Touch (only touch events are handled)
 +
* <code>3</code>: Merge (mouse and touch events are handled together)
 +
* <code>4</code>: Switch (either mouse or touch events are handled, whichever is detected first; default for most platforms)
 +
* <code>5</code>: Combi (only passive mouse, but all touch events are handled)
 
|-
 
|-
 
| <code>scale</code> || <code>string</code> ||
 
| <code>scale</code> || <code>string</code> ||
Line 191: Line 247:
 
* <code>{NUMBER}</code>: Set scale factor to specific number (not fixed)
 
* <code>{NUMBER}</code>: Set scale factor to specific number (not fixed)
 
* <code>fix:{NUMBER}</code>: Set scale factor to specific number (fixed)
 
* <code>fix:{NUMBER}</code>: Set scale factor to specific number (fixed)
 +
|-
 +
| <code>secure</code> || <code>number</code> ||
 +
<code>secure=0</code><br/>
 +
<code>secure=1</code><br/>
 +
<code>secure=2</code><br/>
 +
<code>secure=3</code><br/>
 +
<code>secure=4</code><br/>
 +
||
 +
Sets the secure settings (protocol updates from <code>http://</code> to <code>https://</code>).
 +
 +
* <code>0</code>: Update JSON files and plugins in a secure context and never update media files (default for most platforms)
 +
* <code>1</code>: Update JSON files, plugins, and media files in a secure context
 +
* <code>2</code>: Force update of JSON files and plugins and never update media files
 +
* <code>3</code>: Force update of media files and update JSON files and plugins in a secure context
 +
* <code>4</code>: Force update of JSON files, plugins, and media files
 
|-
 
|-
 
| <code>speed</code> || <code>number</code> ||
 
| <code>speed</code> || <code>number</code> ||
Line 202: Line 273:
 
* <code>0</code>: Off (speed button is always disabled)
 
* <code>0</code>: Off (speed button is always disabled)
 
* <code>1</code>: Video only (speed button is only enabled for videos)
 
* <code>1</code>: Video only (speed button is only enabled for videos)
−
* <code>2</code>: Audio only (speed button is only enabled for audio files)
+
* <code>2</code>: Audio only (speed button is only enabled for audios)
 
* <code>3</code>: Video & Audio (speed button is always enabled; default for most platforms)
 
* <code>3</code>: Video & Audio (speed button is always enabled; default for most platforms)
 
|-
 
|-
Line 221: Line 292:
 
Sets the suspend mode.
 
Sets the suspend mode.
  
−
* <code>0</code>: Off  
+
* <code>0</code>: Off (application will never suspend/resume)
−
* <code>1</code>: Visibility handler
+
* <code>1</code>: Visibility handler (document visibility is checked to suspend/resume the application)
−
* <code>2</code>: System handler (default for most platforms)
+
* <code>2</code>: System handler (system events are checked to suspend/resume the application; default for most platforms)
 
|-
 
|-
 
| <code>t</code> || <code>number</code> ||
 
| <code>t</code> || <code>number</code> ||
Line 251: Line 322:
 
* <code>1</code>: On (default for most platforms)
 
* <code>1</code>: On (default for most platforms)
 
* <code>2</code>: Mute only (volume function is visible, but can only be used to toggle the muted state)
 
* <code>2</code>: Mute only (volume function is visible, but can only be used to toggle the muted state)
 +
|-
 +
| <code>welcome</code> || <code>string</code> ||
 +
<code>welcome=menu:user:http://sc.msx.benzac.de/msx/service.php</code><br/>
 +
<code>welcome=menu:user:http://sc.msx.benzac.de/msx/service.php&gt;index:2</code><br/>
 +
<code>welcome=menu:user:http://sc.msx.benzac.de/msx/service.php&gt;index:2&gt;index:4</code><br/>
 +
<code>welcome=menu:user:http://sc.msx.benzac.de/msx/service.php&gt;index:2&gt;index:4&gt;execute</code><br/>
 +
||
 +
Sets the welcome pages that are used if no start parameter is set. The focus separator <code>&gt;</code> can be used to focus (and execute) an item on load.
 +
For more information, please see [[Focus Separator]].
 +
 +
'''Note: This parameter will override the welcome pages in the application settings, however, it will not disable the function to setup the sart parameter (and to setup welcome pages via the <code>welcome</code> property).'''
 
|-
 
|-
 
| <code>zoom</code> || <code>string</code> ||
 
| <code>zoom</code> || <code>string</code> ||

Latest revision as of 19:19, 8 October 2024

These parameters are only relevant for the web version of Media Station X (i.e. when using the URL http://msx.benzac.de or https://msx.benzac.de) and can be used to override some application settings with fixed values and to set some platform-specific functions.

Note: If you set some application settings via these parameters, the corresponding settings in the application are disabled. For example, if you set the start parameter, the start parameter in the application settings is disabled.

Parameter syntax of URL parameters
Parameter Type Example Description
animate number

animate=0
animate=1
animate=2

Sets the animation settings.

  • 0: Off
  • 1: JS
  • 2: CSS (default for most platforms)
back number

back=0
back=1

Sets the back function.

  • 0: Off (use back key only; default for most platforms)
  • 1: On (use web history)
background number

background=0
background=1

Sets the background function.

  • 0: Off (transparant)
  • 1: On (opaque; default for most platforms)
busy number

busy=0
busy=1
busy=2

Sets the busy function (for data and video requests).

  • 0: Off (no busy indicator)
  • 1: Delayed busy indicator (default for most platforms)
  • 2: Instant busy indicator
caption number

caption=0
caption=1
caption=2

Sets the caption settings (visibility of the options/menu caption that is indicated in the lower right corner of the content screen).

  • 0: Off (options/menu caption is hidden)
  • 1: Visible if available (options/menu caption is visible if the menu button is available)
  • 2: Always visible (default for most platforms)
  • 3: Always visible (will be set automatically if the value was 1 and the menu button was pressed)
center number

center=0
center=1

Sets the center function.

  • 0: Off (UI is aligned at the top left)
  • 1: On (UI is aligned in the center; default for most platforms)
dictionary string

dictionary=http://msx.benzac.de/dic/en.json
dictionary=none
dictionary=custom

Sets the dictionary. This parameter is designed for testing purposes or special use cases. If this parameter is to none, no dictionary will be used (even if the startup data contains one or a custom dictionary is set). If this parameter is to custom, the custom dictionary will be used in preference (even if a start parameter is set). For final usage, please set the URL as dictionary property in the menu or content data or use the dictionary:{URL} action. For more information, please see Dictionary Structure.

exit number

exit=0
exit=1
exit=2
exit=3
exit=4

Sets the exit function.

  • 0: Off (exit function is hidden)
  • 1: Platform-specific (default for most platforms)
  • 2: Perform web history back
  • 3: Perform web history start
  • 4: Perform window close
fullscreen number

fullscreen=0
fullscreen=1
fullscreen=2

Sets the fullscreen function.

  • 0: Off (fullscreen is not available)
  • 1: On (fullscreen is always active and cannot be changed; default for most platforms)
  • 2: Toggle (fullscreen can be toggled)
init number

init=0
init=1
init=2

Sets the init value.

  • 0: Default (default for most platforms)
  • 1: Ignore stored content state
  • 2: Enforce use of stored content state (by default, the stored content state is not used if a start parameter is set)
input number

input=0
input=1
input=2
input=3
input=4

Sets the input settings.

  • 0: Off
  • 1: Remote Only
  • 2: Click & Swipe
  • 3: Drag & Drop (default for most platforms)
  • 4: Move & Execute
layout number|string

layout=0.5
layout=0.75
layout=1
layout=1.5
layout=3
layout=6
layout=360p
layout=540p
layout=720p
layout=1080p
layout=2160p
layout=4320p
layout=auto
layout=detect

Sets the layout settings.

  • 0.5|360p: 360p
  • 0.75|540p|sd: 540p
  • 1|720p|hd: 720p
  • 1.5|1080p|shd: 1080p
  • 3|2160p|uhd|4k: 2160p
  • 6|4320p|8k: 4320p
  • auto: Auto detect (with resize adjustment)
  • detect: Auto detect (without resize adjustment)
leave number

leave=0
leave=1

Sets the leave function. The leave function performs a web history back on execution and can be used if the Media Station X application is opened from another application (or from the local Media Station X application).

  • 0: Off (leave function is hidden)
  • 1: On (leave function is visible)
platform string

platform=default
platform=tizen
platform=samsung
platform=lg
platform=netcast
platform=panasonic
platform=chromecast
platform=ios
platform=android
platform=firetv
platform=hbbtv
platform=hbbtvop
platform=uwp
platform=mac
platform=win

Sets the platform identifier (usually this is not set by parameter, because each platform has its own index file).

remote number

remote=0
remote=1
remote=2
remote=3
remote=4

Sets the remote settings.

  • 0: Off
  • 1: Minimalistic (default for most platforms)
  • 2: Navigation Frame
  • 3: Corner Controls
  • 4: Complex
playback number

playback=0
playback=1
playback=2
playback=3

Sets the playback mode.

  • 0: Stop (video/audio stops when the application goes to sleep)
  • 1: Pause only (video/audio pauses when the application goes to sleep and stays in that state when the application wakes up)
  • 2: Pause/Play (video/audio pauses when the application goes to sleep and continues to play when the application wakes up)
  • 3: Keep playing (video/audio continues to play when the application goes to sleep or the system controls the behavior; default for most platforms)
pointer number

pointer=0
pointer=1
pointer=2
pointer=3
pointer=4
pointer=5

Sets the pointer mode.

  • 0: Off (no mouse and touch events are handled)
  • 1: Mouse (only mouse events are handled)
  • 2: Touch (only touch events are handled)
  • 3: Merge (mouse and touch events are handled together)
  • 4: Switch (either mouse or touch events are handled, whichever is detected first; default for most platforms)
  • 5: Combi (only passive mouse, but all touch events are handled)
scale string

scale=default
scale=auto
scale=device
scale=0.75
scale=fix:0.75

Sets the scale settings (viewport settings).

  • default: No scaling (default for most platforms)
  • auto: Auto detect (with resize adjustment)
  • device: Set scale factor to device width (not fixed)
  • {NUMBER}: Set scale factor to specific number (not fixed)
  • fix:{NUMBER}: Set scale factor to specific number (fixed)
secure number

secure=0
secure=1
secure=2
secure=3
secure=4

Sets the secure settings (protocol updates from http:// to https://).

  • 0: Update JSON files and plugins in a secure context and never update media files (default for most platforms)
  • 1: Update JSON files, plugins, and media files in a secure context
  • 2: Force update of JSON files and plugins and never update media files
  • 3: Force update of media files and update JSON files and plugins in a secure context
  • 4: Force update of JSON files, plugins, and media files
speed number

speed=0
speed=1
speed=2
speed=3

Sets the playback speed function.

  • 0: Off (speed button is always disabled)
  • 1: Video only (speed button is only enabled for videos)
  • 2: Audio only (speed button is only enabled for audios)
  • 3: Video & Audio (speed button is always enabled; default for most platforms)
start string

start=menu:user:http://sc.msx.benzac.de/msx/service.php
start=menu:user:http://sc.msx.benzac.de/msx/service.php>index:2
start=menu:user:http://sc.msx.benzac.de/msx/service.php>index:2>index:4
start=menu:user:http://sc.msx.benzac.de/msx/service.php>index:2>index:4>execute

Sets the start parameter. The focus separator > can be used to focus (and execute) an item on load. For more information, please see Focus Separator.

suspend number

suspend=0
suspend=1
suspend=2

Sets the suspend mode.

  • 0: Off (application will never suspend/resume)
  • 1: Visibility handler (document visibility is checked to suspend/resume the application)
  • 2: System handler (system events are checked to suspend/resume the application; default for most platforms)
t number

t=1542793102320

Sets the current timestamp (difference to the start timestamp must be less than 1 second to skip the splash screen).

transform number

transform=0
transform=1
transform=2

Sets the transformation settings.

  • 0: Off
  • 1: 2D (default for most platforms)
  • 2: 3D
volume number

volume=0
volume=1
volume=2

Sets the volume function.

  • 0: Off (volume function is hidden)
  • 1: On (default for most platforms)
  • 2: Mute only (volume function is visible, but can only be used to toggle the muted state)
welcome string

welcome=menu:user:http://sc.msx.benzac.de/msx/service.php
welcome=menu:user:http://sc.msx.benzac.de/msx/service.php>index:2
welcome=menu:user:http://sc.msx.benzac.de/msx/service.php>index:2>index:4
welcome=menu:user:http://sc.msx.benzac.de/msx/service.php>index:2>index:4>execute

Sets the welcome pages that are used if no start parameter is set. The focus separator > can be used to focus (and execute) an item on load. For more information, please see Focus Separator.

Note: This parameter will override the welcome pages in the application settings, however, it will not disable the function to setup the sart parameter (and to setup welcome pages via the welcome property).

zoom string

zoom=default
zoom=auto
zoom=0.75

Sets the zoom settings.

  • default: No zooming (default for most platforms)
  • auto: Auto detect (with resize adjustment)
  • {NUMBER}: Set zoom factor to specific number
Retrieved from "https://msx.benzac.de/wiki/index.php?title=URL_Parameters&oldid=3573"