@galacean/engine-core 1.6.12 → 1.6.13

package/dist/module.js

@@ -36905,22 +36905,32 @@ var cacheDir = new Vector3();
 }(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();
@@ -36928,27 +36938,14 @@ var cacheDir = new Vector3();
         }
         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.
@@ -36956,7 +36953,7 @@ AudioManager._isResuming = false;
     _inherits(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());
@@ -36966,21 +36963,37 @@ AudioManager._isResuming = false;
     /**
    * 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;
@@ -36991,6 +37004,7 @@ AudioManager._isResuming = false;
     /**
    * Pauses playing the clip.
    */ _proto.pause = function pause() {
+        this._pendingPlay = false;
         if (this._isPlaying) {
             this._clearSourceNode();
             this._pausedTime = AudioManager.getContext().currentTime;
@@ -37024,6 +37038,13 @@ AudioManager._isResuming = false;
     _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();
@@ -37041,11 +37062,6 @@ AudioManager._isResuming = false;
         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(AudioSource, [
         {
             key: "clip",
@@ -37154,6 +37170,9 @@ AudioManager._isResuming = false;
 __decorate([
     ignoreClone
 ], AudioSource.prototype, "_isPlaying", void 0);
+__decorate([
+    ignoreClone
+], AudioSource.prototype, "_pendingPlay", void 0);
 __decorate([
     assignmentClone
 ], AudioSource.prototype, "_clip", void 0);