@umicat/three-sdk 0.14.0 → 0.15.0

package/dist/GameAudio.js

@@ -230,6 +230,19 @@ export class GameAudio {
         const ctx = this.ctx;
         if (this.muted)
             return;
+        // The music may still be waiting for a gesture even though the context is
+        // not. `start()` is the only other place that starts it, and it early-exits
+        // when the context is ALREADY running — which is what happens in a
+        // cross-origin iframe, where the context comes up running and the first
+        // `play()` therefore never takes the unlock path. Measured: a game
+        // embedded that way had a live context, decoded buffers, working effects
+        // and no music at all, because `startMusic()` had never been reached.
+        //
+        // `play()` is the right place for the second attempt: it is called from
+        // inside a real gesture (a button, a move), which is exactly the
+        // permission an element needs, and `startMusic` is idempotent.
+        if (this.ready && this.musicName && !this.musicEl)
+            this.startMusic();
         if (!this.ready || !ctx || !this.master) {
             // Not "drop it": this is the unlocking gesture, and the sound it asked
             // for is the one the player is waiting to hear. `start()` plays it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umicat/three-sdk",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Three.js runtime for Umicat games: the scene3d design format, its loader with physics, a kinematic character controller, and the Umicat platform via @umicat/platform-sdk.",
   "type": "module",
   "main": "dist/index.js",