Difference between revisions of "MRSS Feeds"

From MSX - Wiki
Jump to navigation Jump to search
 
(36 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
It is possible to load MRSS feeds via a special interaction plugin. The plugin can be used with version '''0.1.145''' or higher.  
+
It is possible to load MRSS feeds via a special interaction plugin. The plugin can be used with version '''0.1.146''' or higher.  
  
 
== Usage ==
 
== Usage ==
Line 6: Line 6:
 
* <code>content:request:interaction:{MRSS_URL}@http://msx.benzac.de/interaction/mrss.html</code>
 
* <code>content:request:interaction:{MRSS_URL}@http://msx.benzac.de/interaction/mrss.html</code>
  
−
Optionally, a banner image or color can be set. The area of the banner is 1328x320 (WxH) pixels at layout resolution 720p (1992x480 at 1080p). The banner image is sized to fill the entire width (by keeping the ratio) and is positioned at the top. Please see following action syntax examples.
+
Optionally, a banner and/or background image can be set. The area of the banner is 1328x296 (WxH) pixels at layout resolution 720p (1992x444 at 1080p). The banner image is sized to fill the entire width (by keeping the ratio) and is positioned in the center. The area of the background is 1280x720 (WxH) pixels at layout resolution 720p (1920x1080 at 1080p). The background image is stretched to fill the entire size. Additionally, it is possible to set a plugin URL to customize the playback of video/audio items (e.g. to integrate ads and/or tracking). The plugin URL can contain the keywords <code>{URL}</code>, <code>{TYPE}</code>, and <code>{GUID}</code>, which are replaced with the corresponding item values. Last but not least, it is possible to set a dictionary URL to adapt the plugin user interface to the MRSS feed language. Please see following action syntax examples.
  
 
* <code>content:request:interaction:{MRSS_URL}|{BANNER_URL}@http://msx.benzac.de/interaction/mrss.html</code>
 
* <code>content:request:interaction:{MRSS_URL}|{BANNER_URL}@http://msx.benzac.de/interaction/mrss.html</code>
−
* <code>content:request:interaction:{MRSS_URL}|color:{BANNER_COLOR}@http://msx.benzac.de/interaction/mrss.html</code>
+
* <code>content:request:interaction:{MRSS_URL}|{BANNER_URL}|{BACKGROUND_URL}@http://msx.benzac.de/interaction/mrss.html</code>
 +
* <code>content:request:interaction:{MRSS_URL}|{BANNER_URL}|{BACKGROUND_URL}|{PLUGIN_URL}@http://msx.benzac.de/interaction/mrss.html</code>
 +
* <code>content:request:interaction:{MRSS_URL}|{BANNER_URL}|{BACKGROUND_URL}|{PLUGIN_URL}|{DICTIONARY_URL}@http://msx.benzac.de/interaction/mrss.html</code>
 +
* <code>content:request:interaction:{MRSS_URL}||{BACKGROUND_URL}@http://msx.benzac.de/interaction/mrss.html</code>
 +
* <code>content:request:interaction:{MRSS_URL}|||{PLUGIN_URL}@http://msx.benzac.de/interaction/mrss.html</code>
 +
* <code>content:request:interaction:{MRSS_URL}||||{DICTIONARY_URL}@http://msx.benzac.de/interaction/mrss.html</code>
  
−
There is also a service that allows you to launch the Media Station X app directly with an MRSS feed. Please see following action syntax examples.
+
If you would like to use the plugin as reference to implement your own plugin, please have a look at this implementation script: http://msx.benzac.de/interaction/js/mrss.js.
  
−
* <code>https://msx.benzac.de/?start=content:https://msx.benzac.de/services/mrss.php?url={MRSS_URL}&banner={BANNER_URL}</code>
+
There is also a launcher service that allows you to launch the Media Station X application directly with an MRSS feed: https://msx.benzac.de/info/mrss.html.
−
* <code>https://msx.benzac.de/?start=content:https://msx.benzac.de/services/mrss.php?url={MRSS_URL}&banner=color:{BANNER_COLOR}</code>
 
  
−
'''Note: It is recommended to encode all URL parameters to ensure that they are evaluated correctly. Please note that the <code>{MRSS_URL}</code> needs to be double encoded as it is a URL parameter (<code>url</code>) within a URL parameter (<code>start</code>).'''
+
== Example ==
 +
Please note that this example also shows an usage example of the [[Ad Plugin]] and [[IMA Plugin]].
  
−
If you would like to use the plugin as reference to implement your own plugin, please have a look at this implementation script: http://msx.benzac.de/interaction/js/mrss.js.
+
'''Note: The ad plugins will only work properly if ad blockers are disabled.'''
  
−
== Example ==
 
 
=== Screenshot ===
 
=== Screenshot ===
 
[[File:mrss.png|thumb|640px|none|Example Screenshot (MRSS Examples)]]
 
[[File:mrss.png|thumb|640px|none|Example Screenshot (MRSS Examples)]]
Line 30: Line 34:
 
     "menu": [{
 
     "menu": [{
 
             "icon": "rss-feed",
 
             "icon": "rss-feed",
−
             "label": "Example Channel",
+
             "label": "Example Channel 1",
−
             "data": "request:interaction:http://msx.benzac.de/info/data/mrss/example.xml|https://picsum.photos/1992/480@http://msx.benzac.de/interaction/mrss.html"
+
            "extensionLabel": "Banner 1",
 +
            "data": "request:interaction:http://msx.benzac.de/info/data/mrss/example.xml|http://msx.benzac.de/media/banner.png|http://msx.benzac.de/media/banner_background.png@http://msx.benzac.de/interaction/mrss.html"
 +
        }, {
 +
            "icon": "rss-feed",
 +
            "label": "Example Channel 2",
 +
            "extensionLabel": "Banner 2",
 +
             "data": "request:interaction:http://msx.benzac.de/info/data/mrss/example.xml|https://picsum.photos/1992/444@http://msx.benzac.de/interaction/mrss.html"
 +
        }, {
 +
            "icon": "rss-feed",
 +
            "label": "Example Channel 3",
 +
            "extensionLabel": "Ad Plugin",
 +
            "data": "request:interaction:http://msx.benzac.de/info/data/mrss/example.xml|||http://msx.benzac.de/plugins/ad.html?url={URL}&type={TYPE}&guid={GUID}@http://msx.benzac.de/interaction/mrss.html"
 +
        }, {
 +
            "icon": "rss-feed",
 +
            "label": "Example Channel 4",
 +
            "extensionLabel": "IMA Plugin",
 +
            "data": "request:interaction:http://msx.benzac.de/info/data/mrss/example.xml|||http://msx.benzac.de/plugins/ima.html?url={URL}&ad=https%3A%2F%2Fpubads.g.doubleclick.net%2Fgampad%2Fads%3Fiu%3D%2F21775744923%2Fexternal%2Fsingle_ad_samples%26sz%3D640x480%26cust_params%3Dsample_ct%253Dlinear%26ciu_szs%3D300x250%252C728x90%26gdfp_req%3D1%26output%3Dvast%26unviewed_position_start%3D1%26env%3Dvp%26impl%3Ds%26correlator%3D@http://msx.benzac.de/interaction/mrss.html"
 
         }]
 
         }]
 
}
 
}

Latest revision as of 13:02, 10 January 2024

It is possible to load MRSS feeds via a special interaction plugin. The plugin can be used with version 0.1.146 or higher.

Usage[edit]

The plugin must be loaded with an MRSS feed URL. Please see following action syntax example.

Optionally, a banner and/or background image can be set. The area of the banner is 1328x296 (WxH) pixels at layout resolution 720p (1992x444 at 1080p). The banner image is sized to fill the entire width (by keeping the ratio) and is positioned in the center. The area of the background is 1280x720 (WxH) pixels at layout resolution 720p (1920x1080 at 1080p). The background image is stretched to fill the entire size. Additionally, it is possible to set a plugin URL to customize the playback of video/audio items (e.g. to integrate ads and/or tracking). The plugin URL can contain the keywords {URL}, {TYPE}, and {GUID}, which are replaced with the corresponding item values. Last but not least, it is possible to set a dictionary URL to adapt the plugin user interface to the MRSS feed language. Please see following action syntax examples.

If you would like to use the plugin as reference to implement your own plugin, please have a look at this implementation script: http://msx.benzac.de/interaction/js/mrss.js.

There is also a launcher service that allows you to launch the Media Station X application directly with an MRSS feed: https://msx.benzac.de/info/mrss.html.

Example[edit]

Please note that this example also shows an usage example of the Ad Plugin and IMA Plugin.

Note: The ad plugins will only work properly if ad blockers are disabled.

Screenshot[edit]

Example Screenshot (MRSS Examples)

Code[edit]

{
    "headline": "MRSS Examples",
    "menu": [{
            "icon": "rss-feed",
            "label": "Example Channel 1",
            "extensionLabel": "Banner 1",
            "data": "request:interaction:http://msx.benzac.de/info/data/mrss/example.xml|http://msx.benzac.de/media/banner.png|http://msx.benzac.de/media/banner_background.png@http://msx.benzac.de/interaction/mrss.html"
        }, {
            "icon": "rss-feed",
            "label": "Example Channel 2",
            "extensionLabel": "Banner 2",
            "data": "request:interaction:http://msx.benzac.de/info/data/mrss/example.xml|https://picsum.photos/1992/444@http://msx.benzac.de/interaction/mrss.html"
        }, {
            "icon": "rss-feed",
            "label": "Example Channel 3",
            "extensionLabel": "Ad Plugin",
            "data": "request:interaction:http://msx.benzac.de/info/data/mrss/example.xml|||http://msx.benzac.de/plugins/ad.html?url={URL}&type={TYPE}&guid={GUID}@http://msx.benzac.de/interaction/mrss.html"
        }, {
            "icon": "rss-feed",
            "label": "Example Channel 4",
            "extensionLabel": "IMA Plugin",
            "data": "request:interaction:http://msx.benzac.de/info/data/mrss/example.xml|||http://msx.benzac.de/plugins/ima.html?url={URL}&ad=https%3A%2F%2Fpubads.g.doubleclick.net%2Fgampad%2Fads%3Fiu%3D%2F21775744923%2Fexternal%2Fsingle_ad_samples%26sz%3D640x480%26cust_params%3Dsample_ct%253Dlinear%26ciu_szs%3D300x250%252C728x90%26gdfp_req%3D1%26output%3Dvast%26unviewed_position_start%3D1%26env%3Dvp%26impl%3Ds%26correlator%3D@http://msx.benzac.de/interaction/mrss.html"
        }]
}

Demo[edit]

Retrieved from "https://msx.benzac.de/wiki/index.php?title=MRSS_Feeds&oldid=3167"