node-red-contrib-tts-ultimate 3.1.1 → 3.2.1

package/ttsultimate/ttsultimate.html

@@ -129,9 +129,30 @@
         <label for="node-input-playertype"><i class="fa fa-play"></i> Player</label>
         <select id="node-input-playertype">
             <option value="sonos">Sonos</option>
+            <option value="googlecast">Google Cast (Chromecast / Nest)</option>
+            <option value="dlna">DLNA / UPnP renderer</option>
             <option value="noplayer">No player, only output file name.</option>
         </select>
-    </div>    
+    </div>
+
+    <div id="divCastDlna">
+        <div class="form-row">
+            <label for="node-input-playervolume"><i class="fa fa-volume-up"></i> Volume</label>
+            <input type="text" id="node-input-playervolume" style="width:150px" placeholder="0-100">
+        </div>
+        <div class="form-row" id="playerDiscoverRow">
+            <label for="playerDiscoverList"><i class="fa fa-search"></i> Discover</label>
+            <select id="playerDiscoverList" style="width:250px"><option value="">-- press Discover --</option></select>
+            <a id="playerDiscoverBtn" class="red-ui-button" style="width:auto;"><i class="fa fa-refresh"></i> Discover</a>
+        </div>
+        <div class="form-row">
+            <label for="node-input-playeripaddress"><i class="fa fa-globe"></i> <span id="playeraddresslabel">Device</span></label>
+            <input type="text" id="node-input-playeripaddress" style="width:250px">
+        </div>
+        <div class="form-row">
+            <p id="playeraddresshint" style="margin-left:105px;color:#888;"></p>
+        </div>
+    </div>
 
     <div id="divSonos">
         <div class="form-row">
@@ -150,7 +171,9 @@
             <label for="node-input-sonosipaddress"><i class="fa fa-globe"></i> Main Sonos Player</label>
             <label style="width:200px;" id="node-input-sonosipaddress">Discovering.... wait...</label>
         </div>
-    
+    </div>
+
+    <div id="divAdditionalPlayers">
         <dt><i class="fa fa-code-fork"></i>&nbsp; Additional players</dt>
         <div class="form-row node-input-rule-container-row">
             <ol id="node-input-rule-container"></ol>
@@ -197,6 +220,17 @@
           required: false,
           type: "text"
         },
+        playeripaddress:
+        {
+          value: "",
+          required: false
+        },
+        playervolume:
+        {
+          value: "50",
+          required: false,
+          type: "text"
+        },
         sonoshailing:
         {
           value: "Hailing_Hailing.mp3",
@@ -302,18 +336,91 @@
           node.playertype = "sonos";
           $("#node-input-playertype").val("sonos");
         }
-        if (node.playertype === "sonos") {
-          $("#divSonos").show();
-        } else {
-          $("#divSonos").hide();
+        var playerDiscovered = false; // discover only once per shown section, unless refreshed manually
+
+        // Discovery endpoint used by the per-row "Additional players" list (Sonos / Cast / DLNA).
+        function currentPlayerDiscoveryUrl() {
+          var pt = $("#node-input-playertype").val();
+          if (pt === "googlecast") return 'ttsultimateDiscoverCast';
+          if (pt === "dlna") return 'ttsultimateDiscoverDLNA';
+          return 'sonosgetAllGroups';
         }
 
-        $("#node-input-playertype").change(function () {
-          if ($("#node-input-playertype").val() === "sonos") {
-            $("#divSonos").show();
-          } else {
-            $("#divSonos").hide();
+        // Discovery for the MAIN player address field (Google Cast IP or DLNA description URL).
+        // All endpoints share the { name, host } shape, so a single code path works.
+        function runPlayerDiscovery() {
+          var pt = $("#node-input-playertype").val();
+          var noun = pt === "googlecast" ? "Cast devices" : "renderers";
+          $("#playerDiscoverList").html('<option value="">Discovering... please wait ~4s</option>');
+          $.getJSON(currentPlayerDiscoveryUrl(), function (data) {
+            $("#playerDiscoverList").empty();
+            if (typeof data === "string" || !data || data.length === 0) {
+              $("#playerDiscoverList").append($("<option></option>").attr("value", "").text("No " + noun + " found - type manually below"));
+              return;
+            }
+            $("#playerDiscoverList").append($("<option></option>").attr("value", "").text("-- select a discovered device --"));
+            data.forEach(function (dev) {
+              $("#playerDiscoverList").append($("<option></option>").attr("value", dev.host).text(dev.name + " (" + dev.host + ")"));
+            });
+          }).fail(function () {
+            $("#playerDiscoverList").html('<option value="">Discovery failed - type manually below</option>');
+          });
+        }
+
+        // Picking a discovered device fills the main address field.
+        $("#playerDiscoverList").change(function () {
+          var v = $(this).val();
+          if (v) $("#node-input-playeripaddress").val(v);
+        });
+        $("#playerDiscoverBtn").click(function (e) {
+          e.preventDefault();
+          runPlayerDiscovery();
+        });
+
+        // Re-render the additional players rows so each row re-discovers using the
+        // current player type (Sonos groups vs Cast devices), preserving entered hosts.
+        function rebuildAdditionalPlayers() {
+          try {
+            var items = $("#node-input-rule-container").editableList('items');
+            var saved = [];
+            items.each(function () {
+              var r = $(this);
+              saved.push({ host: r.find(".rowRulePlayerHost").val(), hostVolumeAdjust: r.find(".rowRulePlayerHostAdjustVolume").val() });
+            });
+            $("#node-input-rule-container").editableList('empty');
+            saved.forEach(function (rule, idx) {
+              $("#node-input-rule-container").editableList('addItem', { r: rule, i: idx });
+            });
+          } catch (e) { }
+        }
+
+        function refreshPlayerSections() {
+          var pt = $("#node-input-playertype").val();
+          $("#divSonos").toggle(pt === "sonos");
+          $("#divCastDlna").toggle(pt === "googlecast" || pt === "dlna");
+          $("#playerDiscoverRow").toggle(pt === "googlecast" || pt === "dlna");
+          // Additional players are supported for grouped Sonos and multi-room Google Cast / DLNA.
+          $("#divAdditionalPlayers").toggle(pt === "sonos" || pt === "googlecast" || pt === "dlna");
+          if (pt === "googlecast") {
+            $("#playeraddresslabel").text("Main Chromecast / Nest IP");
+            $("#playeraddresshint").text("IP address of the main Google Cast device, e.g. 192.168.1.50");
+          } else if (pt === "dlna") {
+            $("#playeraddresslabel").text("Renderer description URL");
+            $("#playeraddresshint").text("UPnP device description XML URL, e.g. http://192.168.1.50:1400/desc.xml");
           }
+          // Auto-discover the first time a discoverable section is shown.
+          if ((pt === "googlecast" || pt === "dlna") && !playerDiscovered) {
+            playerDiscovered = true;
+            runPlayerDiscovery();
+          }
+        }
+        refreshPlayerSections();
+
+        $("#node-input-playertype").change(function () {
+          playerDiscovered = false; // force re-discovery for the newly selected type
+          $("#playerDiscoverList").html('<option value="">-- press Discover --</option>');
+          rebuildAdditionalPlayers();
+          refreshPlayerSections();
         });
         // ###########################
 
@@ -614,7 +721,7 @@
           let oAdjustVolume = $('<select/>', { class: "rowRulePlayerHostAdjustVolume", type: "text", style: "width:200px; margin-left: 5px; text-align: left;" }).appendTo(row);
           for (let index = -100; index < 100; index += 5) {
             let sTesto = "";
-            if (index === 0) sTesto = "Same volume as Main Sonos Player";
+            if (index === 0) sTesto = "Same volume as Main Player";
             if (index < 0) sTesto = "Decrease volume by " + Math.abs(index);
             if (index > 0) sTesto = "Increase volume by " + index;
             oAdjustVolume.append($("<option></option>")
@@ -648,8 +755,8 @@
               resizeRule(container);
             });
 
-            $.getJSON('sonosgetAllGroups', (data) => {
-              if (typeof data === "string" && data == "ERRORDISCOVERY") { // 10/04/2020 if error in discovery, fallback to manual IP input
+            $.getJSON(currentPlayerDiscoveryUrl(), (data) => {
+              if ((typeof data === "string" && data == "ERRORDISCOVERY") || !data || data.length === 0) { // 10/04/2020 if error/empty discovery, fallback to manual IP input
                 // Transform the dropdown to a simple input
                 oPlayer.remove();
                 oPlayer = $('<input/>', { class: "rowRulePlayerHost", type: "text", style: "width:200px; margin-left: 5px; text-align: left;" }).appendTo(row);
@@ -719,7 +826,7 @@
 </script>
 
 <script type="text/markdown" data-help-name="ttsultimate">
-<p>This node transforms a text into a speech audio that you can hear natively via SONOS speakers, or save it to a file.</p>
+<p>This node transforms a text into a speech audio that you can hear natively via Sonos speakers, Google Cast devices (Chromecast / Google Nest), generic DLNA/UPnP renderers, or save it to a file.</p>
 
 **General**
 |Property|Description|
@@ -728,12 +835,14 @@
 | Voice | Select your preferred voice. The list depends on the selected TTS engine (Google / ElevenLabs / Voice.ai). Google service without authentication has a limited set of voices. |
 | Hailing | Before the first TTS message of the message queues, the node will play an "hailing" sound. You can select the hailing, upload your own, or totally disable it. |
 | Upload hail | It allows you to upload your own hailing file. |
-| Player | Select the player. If you select not to use a player, the node will output a msg with an array of files, ready to be played by third party nodes. In case you select No player, only output file name, you'll get a message with an additional property filesArray, containing an array of all mp3 files ready to be played with third party nodes. Please see below the OUTPUT MESSAGES FROM THE NODE section. |
+| Player | Select the player: **Sonos**, **Google Cast** (Chromecast / Google Nest), **DLNA / UPnP renderer**, or **No player**. If you select No player, only output file name, the node will output a msg with an additional property filesArray, containing an array of all mp3 files ready to be played by third party nodes. Please see below the OUTPUT MESSAGES FROM THE NODE section. |
 | Volume | Set the preferred TTS volume, from "0" to "100" (can be overridden by passing msg.volume = "40"; to the node). |
-| Unmute | Unmute the main and the addotional players, then restore the previous mute state once finished. (Can be overridden by passing msg.unmute = true; to the node). |
-| Resume | If music was playing prior to TTS messages, the node will try to resume it, but can fail in some cases. Enabla this option to avoid resuming music after TTS message. |
+| Unmute | (Sonos only) Unmute the main and the addotional players, then restore the previous mute state once finished. (Can be overridden by passing msg.unmute = true; to the node). |
+| Resume | (Sonos only) If music was playing prior to TTS messages, the node will try to resume it, but can fail in some cases. Enabla this option to avoid resuming music after TTS message. |
 | Main Sonos Player | Select your Sonos primary player. (It's strongly suggested to set a fixed IP for this player; you can reserve an IP using the DHCP Reservation function of your router/firewall's DHCP Server). It's possibile to group players, so your announcement can be played on all selected players. For this to happen, you need to select your primary coordinator player. All other players will be then controlled by this coordinator. |
-| Additional Players | Here you can add all additional players that will be grouped toghether to the Main Sonos Player coordinator group. You can add a player using the "ADD" button, below the list. For each additional player, you can adjust their volume, based on the Main Sonos Player volume -+100. |
+| Main Chromecast / Nest IP | (Google Cast) IP address of the main Google Cast device (e.g. 192.168.1.50). Press **Discover** to auto-detect the Cast devices on your network and pick one from the list. |
+| Renderer description URL | (DLNA) The full UPnP device description XML URL of the renderer (e.g. http://192.168.1.50:49153/nmrDescription.xml), **not** just the IP. Press **Discover** to auto-detect the DLNA renderers on your network and pick one from the list. |
+| Additional Players | (Sonos / Google Cast / DLNA) Add additional players so your announcement is played on all of them at once. For Sonos they are grouped to the Main Player coordinator; for Google Cast and DLNA the TTS is played on every device in parallel. Use the "ADD" button below the list; for each additional player you can adjust its volume relative to the main volume (-100/+100). |
 
 **Google TTS Engines specific options**
 |Property|Description|
@@ -754,6 +863,17 @@
 
 <br/>
 
+**Players**
+
+| Player | Notes |
+|--|--|
+| Sonos | Native control: grouping, volume, mute/unmute and music resume after the announcement. |
+| Google Cast | Chromecast and Google Nest devices, discovered via mDNS. Set the main device IP and, optionally, additional devices for synchronized multi-room playback. |
+| DLNA / UPnP renderer | Generic UPnP MediaRenderers (smart TVs, AV receivers, etc.), discovered via SSDP. Works with renderers that nest a MediaRenderer sub-device too (e.g. Sonos). Requires the full device description XML URL. |
+| No player | Only generates the mp3 file(s) and outputs their paths in filesArray, to be played by third party nodes. |
+
+For Google Cast and DLNA the device fetches the generated mp3 over HTTP from Node-RED, so the Node-RED host/port (default 1980) must be reachable from the player and on the same subnet (mDNS/SSDP discovery does not cross subnets/VLANs).
+
 ### Inputs
 
 : volume (string) : Set the volume (values between "0" and "100").

package/ttsultimate/ttsultimate.js

@@ -77,6 +77,8 @@ module.exports = function (RED) {
     node.currentMSGbeingSpoken = {}; // Stores the current message being spoken
     node.sonosCoordinatorPreviousVolumeSetByApp = 0; // 05/07/2021 stores the main payer volume set by the sonos app
     node.playertype = config.playertype === undefined ? "sonos" : config.playertype; // 20/09/2021 Player type
+    node.playeripaddress = (config.playeripaddress || "").trim(); // 06/2026 Chromecast/Nest IP or DLNA/UPnP renderer description XML URL
+    node.playervolume = config.playervolume === undefined ? "50" : config.playervolume; // 06/2026 Volume (0-100) for Google Cast / DLNA players
     node.speakingpitch = config.speakingpitch === undefined ? "0" : config.speakingpitch; // 21/09/2021 AudioConfig speakingpitch
     node.speakingrate = config.speakingrate === undefined ? "1" : config.speakingrate; // 21/09/2021 AudioConfig speakingrate
     node.unmuteIfMuted = config.unmuteIfMuted === undefined ? false : config.unmuteIfMuted; // 21/10/2021 Unmute if previiously muted.
@@ -422,7 +424,8 @@ module.exports = function (RED) {
       }
       // 27/11/2019 Start the connection healty check
       node.oTimerSonosConnectionCheck = setTimeout(function () { node.CheckSonosConnection(); }, 5000);
-    } else if (node.playertype === "noplayer") {
+    } else {
+      // 06/2026 noplayer, googlecast and dlna do not use the Sonos connection healthcheck.
       node.msg.connectionerror = false;
     }
 
@@ -530,7 +533,7 @@ module.exports = function (RED) {
       node.server.whoIsUsingTheServer = node.id; // Signal to other ttsultimate node, that i'm using the Sonos device
       try {
 
-        if (node.playertype !== "noplayer") {
+        if (node.playertype === "sonos") {
           // Get the current music queue, if one
           var oCurTrack = null;
           try {
@@ -909,6 +912,49 @@ module.exports = function (RED) {
                 node.setNodeStatus({ fill: 'red', shape: 'dot', text: 'Error ' + msg + " " + error.message });
               }
 
+            } else if (node.playertype === "googlecast" || node.playertype === "dlna") {
+
+              // 06/2026 Google Cast (Chromecast/Nest) and generic DLNA/UPnP renderers.
+              // Both just need the public HTTP URL of the file (same conversion as Sonos).
+              if (!node.sFileToBePlayed.toLowerCase().startsWith("http://") && !node.sFileToBePlayed.toLowerCase().startsWith("https://")) {
+                node.sFileToBePlayed = node.sNoderedURL + "/tts/tts.mp3?f=" + encodeURIComponent(node.sFileToBePlayed);
+              }
+
+              // Volume (0-100): a per-message volume overrides the configured one
+              let volTemp = node.currentMSGbeingSpoken.hasOwnProperty("volume") ? Number(node.currentMSGbeingSpoken.volume) : Number(node.playervolume);
+              if (isNaN(volTemp)) volTemp = 50;
+              if (volTemp < 0) volTemp = 0;
+              if (volTemp > 100) volTemp = 100;
+
+              node.setNodeStatus({ fill: 'green', shape: 'ring', text: 'Play ' + formatAudioSourceTag(audioSource) + msg });
+              try {
+                // Play on the main player + all additional players (reusing the Sonos additional
+                // players list), in parallel for multi-room playback. Works for Cast and DLNA.
+                const playFn = node.playertype === "googlecast" ? playGoogleCastSync : playDLNASync;
+                const targets = [{ host: node.playeripaddress, vol: volTemp }];
+                for (let ci = 0; ci < node.rules.length; ci++) {
+                  const r = node.rules[ci];
+                  if (r && r.host) {
+                    let v = volTemp + Number(r.hostVolumeAdjust || 0);
+                    if (isNaN(v)) v = volTemp;
+                    if (v < 0) v = 0;
+                    if (v > 100) v = 100;
+                    targets.push({ host: r.host, vol: v });
+                  }
+                }
+                const results = await Promise.allSettled(targets.map((t) => playFn(t.host, node.sFileToBePlayed, t.vol)));
+                const failures = results.filter((rr) => rr.status === "rejected");
+                if (failures.length === results.length) {
+                  throw new Error("all " + node.playertype + " targets failed: " + failures.map((f) => f.reason && f.reason.message).join("; "));
+                } else if (failures.length > 0) {
+                  RED.log.warn("ttsultimate: Some " + node.playertype + " targets failed: " + failures.map((f) => f.reason && f.reason.message).join("; "));
+                }
+                node.setNodeStatus({ fill: 'green', shape: 'ring', text: 'End playing ' + msg });
+              } catch (error) {
+                RED.log.error("ttsultimate: Error playing on " + node.playertype + " for " + node.sFileToBePlayed + " " + error.message);
+                node.setNodeStatus({ fill: 'red', shape: 'dot', text: 'Error ' + msg + " " + error.message });
+              }
+
             } else if (node.playertype === "noplayer") {
               // Output only the filename
               if (noPlayerFileArray === undefined || noPlayerFileArray === null) var noPlayerFileArray = [];
@@ -977,17 +1023,15 @@ module.exports = function (RED) {
             node.server.whoIsUsingTheServer = ""; // Signal to other ttsultimate node, that i'm not using the Sonos device anymore
           }, 500)
 
-        } else if (node.playertype === "noplayer") {
-          // End task if no player is selected.
-          // Output the array of files
+        } else {
+          // End task for noplayer, googlecast and dlna.
+          // For "noplayer" also output the array of generated files (undefined for the other types).
           // Signal end playing
-          //let t = setTimeout(() => {
           node.msg.completed = true;
           node.currentMSGbeingSpoken = {};
           node.send([{ passThroughMessage: node.passThroughMessage, payload: node.msg.completed, filesArray: noPlayerFileArray }, null]);
           node.bBusyPlayingQueue = false
           node.server.whoIsUsingTheServer = ""; // Signal to other ttsultimate node, that i'm not using the Sonos device anymore
-          //}, 1000)
         }
 
       } catch (error) {
@@ -1055,9 +1099,11 @@ module.exports = function (RED) {
       // 27/01/2021 Stop whatever in play.
       if (msg.hasOwnProperty("stop") && msg.stop === true) {
         node.flushQueue();
-        try {
-          STOPSync();
-        } catch (error) {
+        if (node.playertype === "sonos") {
+          try {
+            STOPSync().catch(() => { });
+          } catch (error) {
+          }
         }
         node.setNodeStatus({ fill: 'red', shape: 'ring', text: "Forced stop." });
         return;
@@ -1133,7 +1179,7 @@ module.exports = function (RED) {
           // There is already a priority message being spoken, do nothing
           node.setNodeStatus({ fill: 'grey', shape: 'ring', text: 'There is already a priority message being spoken...queuing' });
         } else {
-          if (node.playertype !== 'noplayer') {
+          if (node.playertype === 'sonos') {
             node.SonosClient.stop().then(result => {
               node.bTimeOutPlay = true;
               node.currentMSGbeingSpoken = msg; // Set immediately, otherwise if comes new flow messages, currentMSGbeingSpoken is too old.
@@ -1376,6 +1422,102 @@ module.exports = function (RED) {
       }
     }
 
+    // 06/2026 Google Cast (Chromecast / Google Nest) playback.
+    // Resolves when playback finishes (IDLE after PLAYING) or rejects on error/timeout.
+    function playGoogleCastSync(host, url, volume0to100) {
+      return new Promise((resolve, reject) => {
+        if (!host) { reject(new Error("Google Cast: no device IP address configured")); return; }
+        let CastClient, DefaultMediaReceiver;
+        try {
+          CastClient = require("castv2-client").Client;
+          DefaultMediaReceiver = require("castv2-client").DefaultMediaReceiver;
+        } catch (error) {
+          reject(new Error("castv2-client module not available: " + error.message));
+          return;
+        }
+        const client = new CastClient();
+        let settled = false;
+        const cleanup = () => { try { client.close(); } catch (e) { } };
+        const clearTimers = () => { clearTimeout(timeout); clearTimeout(startTimer); };
+        const fail = (err) => { if (settled) return; settled = true; clearTimers(); cleanup(); reject(err); };
+        const done = () => { if (settled) return; settled = true; clearTimers(); cleanup(); resolve(); };
+        const timeout = setTimeout(() => { fail(new Error("Google Cast: playback timeout")); }, 60000 * 10); // 10 minutes, like Sonos
+        // Fail fast if playback never starts (e.g. wrong IP on an unreachable/black-holed host).
+        const startTimer = setTimeout(() => { fail(new Error("Google Cast: device did not start playing within 45s (check IP/network)")); }, 45000);
+
+        client.on("error", (err) => fail(err));
+        client.connect(host, () => {
+          // Volume is 0..1 on Cast
+          try { client.setVolume({ level: Math.max(0, Math.min(1, volume0to100 / 100)) }, () => { }); } catch (e) { }
+          client.launch(DefaultMediaReceiver, (err, player) => {
+            if (err) { fail(err); return; }
+            let started = false;
+            player.on("status", (status) => {
+              if (!status) return;
+              if (status.playerState === "PLAYING") { started = true; clearTimeout(startTimer); }
+              // IDLE after playback started means the track has finished.
+              if (started && status.playerState === "IDLE") done();
+            });
+            const media = { contentId: url, contentType: "audio/mpeg", streamType: "BUFFERED" };
+            player.load(media, { autoplay: true }, (err2) => {
+              if (err2) fail(err2);
+            });
+          });
+        });
+      });
+    }
+
+    // 06/2026 Generic DLNA / UPnP media renderer playback.
+    // descriptionUrl is the renderer device description XML URL (e.g. http://192.168.1.50:1400/xml/device_description.xml).
+    // Uses a native client that finds the AVTransport/RenderingControl services anywhere in the
+    // device tree (so it also works with renderers that nest a MediaRenderer sub-device, e.g. Sonos).
+    // Resolves when playback finishes (STOPPED after PLAYING) or rejects on error/timeout.
+    function playDLNASync(descriptionUrl, url, volume0to100) {
+      return new Promise((resolve, reject) => {
+        if (!descriptionUrl) { reject(new Error("DLNA: no renderer description URL configured")); return; }
+        let dlnaPlayer;
+        try {
+          dlnaPlayer = require("./lib/dlna-player");
+        } catch (error) {
+          reject(new Error("dlna-player module not available: " + error.message));
+          return;
+        }
+        let settled = false;
+        const clearTimers = () => { clearTimeout(timeout); clearTimeout(startTimer); };
+        const fail = (err) => { if (settled) return; settled = true; clearTimers(); reject(err); };
+        const done = () => { if (settled) return; settled = true; clearTimers(); resolve(); };
+        const timeout = setTimeout(() => { fail(new Error("DLNA: playback timeout")); }, 60000 * 10); // 10 minutes, like Sonos
+        // Fail fast if playback never starts (e.g. wrong/unreachable renderer URL).
+        const startTimer = setTimeout(() => { fail(new Error("DLNA: renderer did not start playing within 45s (check description URL/network)")); }, 45000);
+
+        const player = dlnaPlayer.createPlayer(descriptionUrl);
+
+        (async () => {
+          try {
+            // Best-effort volume first (ignored by renderers without RenderingControl).
+            try { await player.setVolume(volume0to100); } catch (e) { }
+            await player.setAVTransportURI(url, "audio/mpeg");
+            await player.play();
+          } catch (error) {
+            fail(error);
+            return;
+          }
+          // Poll the transport state (UPnP eventing is not implemented by all renderers).
+          let started = false;
+          const poll = async () => {
+            if (settled) return;
+            let state = "";
+            try { state = await player.getTransportState(); } catch (e) { /* transient, keep polling */ }
+            if (settled) return;
+            if (state === "PLAYING" || state === "TRANSITIONING") { started = true; clearTimeout(startTimer); }
+            if (started && (state === "STOPPED" || state === "NO_MEDIA_PRESENT" || state === "PAUSED_PLAYBACK")) { done(); return; }
+            setTimeout(poll, 1000);
+          };
+          setTimeout(poll, 1000);
+        })();
+      });
+    }
+
     // 04/01/2021 hashing filename to avoid issues with long filenames.
     function getFilename(_text, _params) {
       let sTextToBeHashed = _text.concat(JSON.stringify(_params));