tunein radio action (#470)

* Ignore VSCode launch files, macos folder cache files

* tunein radio action

* Update readme for tunein action

Author: sseiber

.gitignore

@@ -13,3 +13,10 @@ obj/
 *.crt
 *.pfx
 *.key
+
+# VS
+.vscode
+.vscode/launch.json
+
+# Ignore Mac DS_Store files
+.DS_Store

README.md

@@ -755,6 +755,17 @@ Your Pandora credentials need to be added to the settings.json file
   ```
 
 
+Tunein
+----------------------
+Given a station id this will play the streaming broadcast via the tunein service. You can find tunein station ids via services like [radiotime](http://opml.radiotime.com/)
+
+The following endpoint is available:
+
+```
+/RoomName/tunein/play/{station id}
+```
+ 
+
 Music Search and Play
 ----------------------
 Perform a search for a song, artist, album or station and begin playing. Supports Apple Music, Spotify, Deezer, Deezer Elite, and your local Music Library. 

lib/actions/tunein.js

@@ -0,0 +1,32 @@
+'use strict';
+
+function getTuneInMetadata(uri, serviceType) {
+  return `<DIDL-Lite xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:upnp="urn:schemas-upnp-org:metadata-1-0/upnp/"
+        xmlns:r="urn:schemas-rinconnetworks-com:metadata-1-0/" xmlns="urn:schemas-upnp-org:metadata-1-0/DIDL-Lite/">
+        <item id="F00092020s${uri}" parentID="L" restricted="true"><dc:title>tunein</dc:title><upnp:class>object.item.audioItem.audioBroadcast</upnp:class>
+        <desc id="cdudn" nameSpace="urn:schemas-rinconnetworks-com:metadata-1-0/">SA_RINCON${serviceType}_</desc></item></DIDL-Lite>`;
+}
+
+function tuneIn(player, values) {
+  const action = values[0];
+  const tuneInUri = values[1];
+  const encodedTuneInUri = encodeURIComponent(tuneInUri);
+  const sid = player.system.getServiceId('TuneIn');
+  const metadata = getTuneInMetadata(encodedTuneInUri, player.system.getServiceType('TuneIn'));
+  const uri = `x-sonosapi-stream:s${encodedTuneInUri}?sid=${sid}&flags=8224&sn=0`;
+
+  if (!tuneInUri) {
+    return Promise.reject('Expected TuneIn station id');
+  }
+
+  if (action == 'play') {
+    return player.coordinator.setAVTransport(uri, metadata)
+      .then(() => player.coordinator.play());
+  }
+
+  return Promise.reject('TuneIn only handles the {play} action');
+}
+
+module.exports = function (api) {
+  api.registerAction('tunein', tuneIn);
+}