@galacean/engine 1.6.12 → 1.6.13

package/dist/browser.js

@@ -41517,22 +41517,32 @@
         return AudioClip;
     }(ReferResource);
     /**
-     * @internal
-     * Audio Manager.
+     * Audio Manager for managing global audio context and settings.
      */ var AudioManager = /*#__PURE__*/ function() {
         function AudioManager() {}
-        AudioManager.getContext = function getContext() {
+        /**
+       * Resume the audio context.
+       * @remarks On iOS Safari, calling this within a user gesture (e.g., click/touch event handler) can pre-unlock audio and reduce playback delay.
+       * @returns A promise that resolves when the audio context is resumed
+       */ AudioManager.resume = function resume() {
+            var _AudioManager;
+            var __resumePromise;
+            return (__resumePromise = (_AudioManager = AudioManager)._resumePromise) != null ? __resumePromise : _AudioManager._resumePromise = AudioManager._context.resume().finally(function() {
+                AudioManager._resumePromise = null;
+            });
+        };
+        /**
+       * @internal
+       */ AudioManager.getContext = function getContext() {
             var context = AudioManager._context;
             if (!context) {
                 AudioManager._context = context = new window.AudioContext();
-                // Safari can't resume audio context without element interaction
-                document.addEventListener("pointerdown", AudioManager._tryResume, true);
-                document.addEventListener("touchend", AudioManager._tryResume, true);
-                document.addEventListener("touchstart", AudioManager._tryResume, true);
             }
             return context;
         };
-        AudioManager.getGainNode = function getGainNode() {
+        /**
+       * @internal
+       */ AudioManager.getGainNode = function getGainNode() {
             var gainNode = AudioManager._gainNode;
             if (!AudioManager._gainNode) {
                 AudioManager._gainNode = gainNode = AudioManager.getContext().createGain();
@@ -41540,34 +41550,21 @@
             }
             return gainNode;
         };
-        AudioManager.isAudioContextRunning = function isAudioContextRunning() {
-            if (AudioManager.getContext().state !== "running") {
-                console.warn("The AudioContext is not running and requires user interaction, such as a click or touch.");
-                return false;
-            }
-            return true;
-        };
-        AudioManager._tryResume = function _tryResume() {
-            if (AudioManager._context.state !== "running") {
-                if (AudioManager._isResuming) {
-                    return;
-                }
-                AudioManager._isResuming = true;
-                AudioManager._context.resume().then(function() {
-                    AudioManager._isResuming = false;
-                });
-            }
+        /**
+       * @internal
+       */ AudioManager.isAudioContextRunning = function isAudioContextRunning() {
+            return AudioManager.getContext().state === "running";
         };
         return AudioManager;
     }();
-    AudioManager._isResuming = false;
+    AudioManager._resumePromise = null;
     /**
      * Audio Source Component.
      */ var AudioSource = /*#__PURE__*/ function(Component) {
         _inherits$2(AudioSource, Component);
         function AudioSource(entity) {
             var _this;
-            _this = Component.call(this, entity) || this, /** If set to true, the audio component automatically begins to play on startup. */ _this.playOnEnabled = true, _this._isPlaying = false, _this._sourceNode = null, _this._pausedTime = -1, _this._playTime = -1, _this._volume = 1, _this._lastVolume = 1, _this._playbackRate = 1, _this._loop = false;
+            _this = Component.call(this, entity) || this, /** If set to true, the audio component automatically begins to play on startup. */ _this.playOnEnabled = true, _this._isPlaying = false, _this._pendingPlay = false, _this._sourceNode = null, _this._pausedTime = -1, _this._playTime = -1, _this._volume = 1, _this._lastVolume = 1, _this._playbackRate = 1, _this._loop = false;
             _this._onPlayEnd = _this._onPlayEnd.bind(_this);
             _this._gainNode = AudioManager.getContext().createGain();
             _this._gainNode.connect(AudioManager.getGainNode());
@@ -41577,21 +41574,37 @@
         /**
        * Play the clip.
        */ _proto.play = function play() {
-            if (!this._canPlay()) {
+            var _this = this;
+            var _this__clip;
+            if (!((_this__clip = this._clip) == null ? void 0 : _this__clip._getAudioSource())) {
                 return;
             }
-            if (this._isPlaying) {
+            if (this._isPlaying || this._pendingPlay) {
                 return;
             }
-            var startTime = this._pausedTime > 0 ? this._pausedTime - this._playTime : 0;
-            this._initSourceNode(startTime);
-            this._playTime = AudioManager.getContext().currentTime - startTime;
-            this._pausedTime = -1;
-            this._isPlaying = true;
+            if (AudioManager.isAudioContextRunning()) {
+                this._startPlayback();
+            } else {
+                // iOS Safari requires resume() to be called within the same user gesture callback that triggers playback.
+                // Document-level events won't work - must call resume() directly here in play().
+                this._pendingPlay = true;
+                AudioManager.resume().then(function() {
+                    _this._pendingPlay = false;
+                    // Check if still valid to play after async resume
+                    if (_this._destroyed || !_this.enabled || !_this._clip) {
+                        return;
+                    }
+                    _this._startPlayback();
+                }, function(e) {
+                    _this._pendingPlay = false;
+                    console.warn("AudioContext resume failed:", e);
+                });
+            }
         };
         /**
        * Stops playing the clip.
        */ _proto.stop = function stop() {
+            this._pendingPlay = false;
             if (this._isPlaying) {
                 this._clearSourceNode();
                 this._isPlaying = false;
@@ -41602,6 +41615,7 @@
         /**
        * Pauses playing the clip.
        */ _proto.pause = function pause() {
+            this._pendingPlay = false;
             if (this._isPlaying) {
                 this._clearSourceNode();
                 this._pausedTime = AudioManager.getContext().currentTime;
@@ -41635,6 +41649,13 @@
         _proto._onPlayEnd = function _onPlayEnd() {
             this.stop();
         };
+        _proto._startPlayback = function _startPlayback() {
+            var startTime = this._pausedTime > 0 ? this._pausedTime - this._playTime : 0;
+            this._initSourceNode(startTime);
+            this._playTime = AudioManager.getContext().currentTime - startTime;
+            this._pausedTime = -1;
+            this._isPlaying = true;
+        };
         _proto._initSourceNode = function _initSourceNode(startTime) {
             var context = AudioManager.getContext();
             var sourceNode = context.createBufferSource();
@@ -41652,11 +41673,6 @@
             this._sourceNode.onended = null;
             this._sourceNode = null;
         };
-        _proto._canPlay = function _canPlay() {
-            var _this__clip;
-            var isValidClip = ((_this__clip = this._clip) == null ? void 0 : _this__clip._getAudioSource()) ? true : false;
-            return isValidClip && AudioManager.isAudioContextRunning();
-        };
         _create_class$2(AudioSource, [
             {
                 key: "clip",
@@ -41765,6 +41781,9 @@
     __decorate$1([
         ignoreClone
     ], AudioSource.prototype, "_isPlaying", void 0);
+    __decorate$1([
+        ignoreClone
+    ], AudioSource.prototype, "_pendingPlay", void 0);
     __decorate$1([
         assignmentClone
     ], AudioSource.prototype, "_clip", void 0);
@@ -50904,6 +50923,7 @@
                 // @ts-ignore
                 resourceManager._request(url, requestConfig).then(function(arrayBuffer) {
                     var audioClip = new AudioClip(resourceManager.engine);
+                    // @ts-ignore
                     AudioManager.getContext().decodeAudioData(arrayBuffer).then(function(result) {
                         // @ts-ignore
                         audioClip._setAudioSource(result);
@@ -51682,7 +51702,7 @@
     ], EXT_texture_webp);
 
     //@ts-ignore
-    var version = "1.6.12";
+    var version = "1.6.13";
     console.log("Galacean Engine Version: " + version);
     for(var key in CoreObjects){
         Loader.registerClass(key, CoreObjects[key]);