Actions

All actions are indicated as strings and are used by content items to perform specific tasks (e.g. play a video, start a slideshow, etc.). Some actions use additional data, provided by the corresponding content item.

Base Actions

Syntax	Example	Since Version	Description
video:{URL}	video:http://msx.benzac.de/media/video1.mp4	0.1.0	Plays a video. The {URL} part must be replaced with the video URL.
audio:{URL}	audio:http://msx.benzac.de/media/audio1.mp3	0.1.0	Plays an audio file. The {URL} part must be replaced with the audio URL. This action works in the same way as video:{URL}, except that the video screen is not displayed. Instead, the background screen is displayed. If the corresponding content item provides a background property, it is used, otherwise the next available background property (at higher level) is used.
image:{URL}	image:http://msx.benzac.de/img/bg1.jpg	0.1.0	Shows an image. The {URL} part must be replaced with the image URL.
image:context	image:context	0.1.0	Shows an image by using the current context. The image URL must be provided as image property by the corresponding content item.
link:{URL}	link:http://msx.benzac.de/info/	0.1.0	Opens a link. The {URL} part must be replaced with the link URL.
link:window:{URL}	link:window:http://msx.benzac.de/info/	0.1.0	Opens a link in a separate window or in an external browser. The {URL} part must be replaced with the link URL.
playlist:{URL}	playlist:http://msx.benzac.de/info/data/guide/videos.json	0.1.0	Loads a playlist without a corresponding content page. The {URL} part must be replaced with the playlist URL. The data structure is the same like the Templated Items from the Content API. Please see Content Root Object for more information.
playlist:data	playlist:data	0.1.0	Starts a playlist without a corresponding content page. The playlist data must be provided as data property by the corresponding content item. The data structure is the same like the Templated Items from the Content API. Please see Content Root Object for more information.
slideshow:{URL}	slideshow:http://msx.benzac.de/info/data/guide/images.json	0.1.0	Loads a slideshow without a corresponding content page. The {URL} part must be replaced with the slideshow URL. The data structure is the same like the Templated Items from the Content API. Please see Content Root Object for more information.
slideshow:data	slideshow:data	0.1.0	Starts a slideshow without a corresponding content page. The playlist data must be provided as data property by the corresponding content item. The data structure is the same like the Templated Items from the Content API. Please see Content Root Object for more information.
menu:{URL}	menu:http://msx.benzac.de/info/data/guide/actions.json	0.1.0	Loads a menu. The {URL} part must be replaced with the menu URL. Please see Menu Root Object for the data structure.
menu:data	menu:data	0.1.0	Shows a menu. The menu data must be provided as data property by the corresponding content item. Please see Menu Root Object for the data structure.
content:{URL}	content:http://msx.benzac.de/info/data/guide/videos.json	0.1.0	Loads a content page. The {URL} part must be replaced with the content URL. Please see Content Root Object for the data structure.
content:data	content:data	0.1.0	Shows a content page. The content data must be provided as data property by the corresponding content item. Please see Content Root Object for the data structure.
panel:{URL}	panel:http://msx.benzac.de/info/data/guide/panel.json	0.1.0	Loads a content page in a panel. The {URL} part must be replaced with the content URL. Please see Content Root Object for the data structure.
panel:data	panel:data	0.1.0	Shows a content page in a panel. The content data must be provided as data property by the corresponding content item. Please see Content Root Object for the data structure.
success:{TEXT}	success:This is a success message.	0.1.0	Shows a success message. The {TEXT} part must be replaced with any text. The text supports inline expressions. Please see Inline Expressions for more information.
info:{TEXT}	info:This is an info message.	0.1.0	Shows an info message. The {TEXT} part must be replaced with any text. The text supports inline expressions. Please see Inline Expressions for more information.
warn:{TEXT}	warn:This is a warning message.	0.1.0	Shows a warning message. The {TEXT} part must be replaced with any text. The text supports inline expressions. Please see Inline Expressions for more information.
error:{TEXT}	error:This is an error message.	0.1.0	Shows an error message. The {TEXT} part must be replaced with any text. The text supports inline expressions. Please see Inline Expressions for more information.
focus:{ID}	focus:content_item_id	0.1.0	Sets the focus to a specific item in the current context. The {ID} part must be replaced with an item ID (e.g. the content item ID).
focus:index:{INDEX}	focus:index:0	0.1.0	Sets the focus to a specific item in the current context. The {INDEX} part must be replaced with an item index (e.g. index 0 will set the focus to the first item).
start	start	0.1.30	Sets up a new start parameter. The start parameter data must be provided as data property by the corresponding content item. Please see Start Object for the data structure.
video:plugin:{URL}	video:plugin:http://msx.benzac.de/plugins/template.html	0.1.40	Plays a plugin video. The {URL} part must be replaced with the plugin URL. Please see the YouTube, Vimeo & Co. for plugin examples.
audio:plugin:{URL}	audio:plugin:http://msx.benzac.de/plugins/template.html	0.1.40	Plays a plugin audio file. The {URL} part must be replaced with the plugin URL. This action works in the same way as video:plugin:{URL}, except that the video screen is not displayed. Instead, the background screen is displayed. If the corresponding content item provides a background property, it is used, otherwise the next available background property (at higher level) is used. Please see the YouTube, Vimeo & Co. for plugin examples.

HbbTV Actions

If you use the HbbTV version of Media Station X, you have additional actions available.

Syntax	Example	Since Version	Description
video:broadcast:current	video:broadcast:current	0.1.30	Plays the current broadcast channel.
system:hbbtv:launch:{URL}	system:hbbtv:launch:http://msx.benzac.de/hbbtv.html	0.1.30	Launches a new HbbTV application. The {URL} part must be replaced with an HTML page or an XML AIT URL.

For more information about the HbbTV specification, please visit https://www.hbbtv.org.

Server Actions

It is possible to execute actions on server side. For this feature, you need programming skills, because you need to implement a service for your server. Server actions allow you to provide logins, member areas, parental controls, search queries, and more. All server actions are sent as HTTP POST requests. Parallel server actions are not allowed (only one server action can be running on application side).

Note: The Content-Type header for all HTTP POST requests is set to application/x-www-form-urlencoded (instead of application/json) to ensure CORS support for simple services (by avoiding CORS preflight requests). Please ignore the Content-Type header on your server and handle all incoming data from the Media Station X application as JSON objects. Since version 0.1.90, you can set an accurate: prefix before {URL} to use the accurate headers (e.g. execute:accurate:{URL}, execute:code:accurate:{URL}, execute:user:accurate:{URL}, etc.).

Syntax	Example	Since Version	Description
execute:{URL}	execute:http://msx.benzac.de/services/echo.php	0.1.30	Executes an action on server side and returns an action to be executed (e.g. to show a success/error message). The {URL} part must be replaced with your service URL. If the corresponding content item provides a data property, it is submitted as data property to your service. The returned action must be indicated as action property in the data property of a wrapped response object (i.e. in the response.data.action property). Optionally, an action-related data property (of type object) can also be indicated (i.e. in the response.data.data property). Note: If you return actions like video:{URL} or audio:{URL}, the corresponding content item properties (i.e. playerLabel, background, and properties) must be indicated in the action-related data property (i.e. response.data.data property) in order to be used. Please see Responses for more information.
execute:code:{URL}	execute:code:http://msx.benzac.de/services/echo.php	0.1.30	Executes an action on server side with an entered code and returns an action to be executed (e.g. to show a success/error message). The {URL} part must be replaced with your service URL. If the corresponding content item provides a data property, it is submitted as data property to your service. The code is submitted as code property. If the corresponding content item provides a data property, it can be used to customize the code panel with following properties. headline: The headline of the code panel; Type: string; Default value: "Enter Code" extension: The extension of the code panel; Type: string; Default value: null value: The initial value of the code panel; Type: string; Default value: null placeholder: The placeholder of the code panel; Type: string; Default value: "Code" secret: Indicates if the entered code is secret and not displayed; Type: boolean; Default value: false The returned action must be indicated as action property in the data property of a wrapped response object (i.e. in the response.data.action property). Optionally, an action-related data property (of type object) can also be indicated (i.e. in the response.data.data property). Note: If you return actions like video:{URL} or audio:{URL}, the corresponding content item properties (i.e. playerLabel, background, and properties) must be indicated in the action-related data property (i.e. response.data.data property) in order to be used. Please see Responses for more information.

Extended Actions

These actions are useful when working with server actions (e.g. to perform a reload after login or to update content parts after successfully executing an action).

Syntax	Example	Since Version	Description