RDS Metadata - Revision history

Camille at 10:58, 14 February 2024

2024-02-14T10:58:49Z

Camille at 10:28, 15 June 2023

2023-06-15T10:28:41Z

Marcel at 17:08, 23 February 2021

2021-02-23T17:08:52Z

Camille: Created page with "RDS Metada works now as in Streaming Extension (Serveur v4). `Metadata source kind` can be: * `File/URL`: In this case, use the Source field to set the..."

2020-10-26T13:56:03Z

Created page with "RDS Metada works now as in Streaming Extension (Serveur v4). <code>Metadata source kind</code> can be: * <code>File/URL</code>: In this case, use the Source field to set the..."

New page

RDS Metada works now as in Streaming Extension (Serveur v4).

<code>Metadata source kind</code> can be:

* <code>File/URL</code>: In this case, use the Source field to set the file path or the URL. You may use User/Password and poll time for ftp and http URLs.
* <code>TCP Server</code>: will listen on the port set in "Source Port". It can optionally be bind to an IP, if the PC has multiple IP. This uses the PC/Admin IP, not the board.

Then, you need to select a parser.

Parsers are scripts in the [https://www.lua.org/ LUA language]. This is well documented on the Web.

The easier is to use XML. The script support to use [[wikipedia:XPath|XPath]] for XML parsing. This is also well documented on the Web and very flexible.

You need to put scripts in(see [[Files directories]]):

* Windows: <code>C:\ProgramData\SOUND4\Server\Data\metaparsers</code>
* Linux: <code>/opt/sound4/Data/rdsmetaparsers</code>
* Standalone: <code>\\rdsmetadataparser\</code>

A script called "MyParser.lua" should appear after in the "Metadata parsers" list as "MyParser".

For instance, to parse this XML file:<syntaxhighlight lang="xml">
<live>
<radio_id>Oldies Network</radio_id>
<current_song>
<Startime>17:53:14</Startime>
<artist><![CDATA[THE CHRISTIANS]]></artist>
<title><![CDATA[WHATS IN A WORD]]></title>
<duration>00:04:49</duration>
<cover_url>http://www.allcdcovers.com/image_system/images/f/4/f4efd22a515abcace470f093c26633fd.jpg</cover_url>
<categorie>G</categorie>
</current_song>
</live>
</syntaxhighlight>The MyParser.lua can be written like this:<syntaxhighlight lang="lua">
UseXmlParser()

function OnXMLParsed()
local artist=XPath('//current_song/artist/text()')
local title=XPath('//current_song/title/text()')
meta:Add("title", title)
meta:Add("artist", artist)
end
</syntaxhighlight>This script means:

<code>UseXmlParser()</code> ''Set the script in XML mode parsing''
<code>function OnXMLParsed()</code> ''Function called when XML has been parsed''

<code>local artist=XPath('//current_song/artist/text()')</code> ''Create a variable artist, using XPath to extract the artist content that is in <whatever><current_song><artist>name</...''

<code>local title=XPath('//current_song/title/text()')</code> ''Create a variable title, using XPath to extract the title content that is in <whatever><current_song><title>name</...''
<code>meta:Add("title", title)</code> ''Set the metadata field title to the value we got''

<code>meta:Add("artist", artist)</code> ''Set the metadata field artist to the value we got''

<code>end</code> ''End of function''

You can then use the metadata values in all Dynamic fields with <code>{artist}</code> and <code>{title}</code>.

For instance, set Dynamic RT: "RT Use Dynamic" = Yes, Mode= User and set "Dynamic RT"="<code>Now playing {title} by {artist}</code>"

← Older revision		Revision as of 10:58, 14 February 2024
Line 63:		Line 63:
	<br />		<br />
	[[Category:RDS]]		[[Category:RDS]]
		+	[[Category:Metadata]]

@@ Line 1: / Line 1: @@
-RDS Metada works now as in Streaming Extension (Serveur v4).
+RDS Metada works now as in Streaming Extension (Serveur v4). See [[Metadata_Scripts]].
 <code>Metadata source kind</code> can be:
@@ Line 18: / Line 18: @@
 *Standalone: <code>\\rdsmetadataparser\</code>
-A script called "MyParser.lua" should appear after in the "Metadata parsers" list as "MyParser".
+A script called "MyParser.lua" should appear after in the "Metadata parsers" listed as "MyParser".
 For instance, to parse this XML file:<syntaxhighlight lang="xml">
@@ Line 44: / Line 44: @@
 <code>UseXmlParser()</code> ''Set the script in XML mode parsing''
 <code>function OnXMLParsed()</code> ''Function called when XML has been parsed''
@@ Line 49: / Line 50: @@
 <code>local title=XPath('//current_song/title/text()')</code> ''Create a variable title, using XPath to extract the title content that is in <whatever><current_song><title>name</...''
 <code>meta:Add("title", title)</code> ''Set the metadata field title to the value we got''
@@ Line 58: / Line 60: @@
 For instance, set Dynamic RT: "RT Use Dynamic" = Yes, Mode= User and set "Dynamic RT"="<code>Now playing {title} by {artist}</code>"
 [[Category:RDS]]

@@ Line 3: / Line 3: @@
 <code>Metadata source kind</code> can be:
-* <code>File/URL</code>: In this case, use the Source field to set the file path or the URL. You may use User/Password and poll time for ftp and http URLs.
+*<code>File/URL</code>: In this case, use the Source field to set the file path or the URL. You may use User/Password and poll time for ftp and http URLs.
-* <code>TCP Server</code>: will listen on the port set in "Source Port". It can optionally be bind to an IP, if the PC has multiple IP. This uses the PC/Admin IP, not the board.
+*<code>TCP Server</code>: will listen on the port set in "Source Port". It can optionally be bind to an IP, if the PC has multiple IP. This uses the PC/Admin IP, not the board.
 Then, you need to select a parser.
@@ Line 14: / Line 14: @@
 You need to put scripts in(see [[Files directories]]):
-* Windows: <code>C:\ProgramData\SOUND4\Server\Data\metaparsers</code>
+*Windows: <code>C:\ProgramData\SOUND4\Server\Data\metaparsers</code>
-* Linux: <code>/opt/sound4/Data/rdsmetaparsers</code>
+*Linux: <code>/opt/sound4/Data/rdsmetaparsers</code>
-* Standalone: <code>\\rdsmetadataparser\</code>
+*Standalone: <code>\\rdsmetadataparser\</code>
 A script called "MyParser.lua" should appear after in the "Metadata parsers" list as "MyParser".
@@ Line 58: / Line 58: @@
 For instance, set Dynamic RT: "RT Use Dynamic" = Yes, Mode= User and set "Dynamic RT"="<code>Now playing {title} by {artist}</code>"

RDS Metadata - Revision history

Camille at 10:58, 14 February 2024

Camille at 10:28, 15 June 2023

Marcel at 17:08, 23 February 2021

Camille: Created page with "RDS Metada works now as in Streaming Extension (Serveur v4). Metadata source kind can be: * File/URL: In this case, use the Source field to set the..."

Camille: Created page with "RDS Metada works now as in Streaming Extension (Serveur v4). `Metadata source kind` can be: * `File/URL`: In this case, use the Source field to set the..."