@realsee/vreo 2.6.2 → 2.6.4-alpha.2

package/lib/PlayController/createHTMLAudioElement.js

@@ -1,5 +1,6 @@
 import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
-import _regeneratorRuntime from "@babel/runtime/regenerator";
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i.return) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
 var BLANK_AUDIO = '' + 'data:audio/mpeg;base64,' + '//uQxAAAAAAAAAAAAAAAAAAAAAAASW5mbwAAAA8AAAADAAAGhgBVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVVVWqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqr///////////' + '////////////////////////////////8AAAA5TEFNRTMuOThyAc0AAAAAAAAAABSAJAiqQgAAg' + 'AAABobxtI73AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' + 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' + 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' + 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' + 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA//uQxAACFEII9ACZ/sJZwWEoEb8w/////N//////Jcxj' + 'Hjf+7/v/H2PzCCFAiDtGeyBCIx7bJJ1mmEEMy6g8mm2c8nrGABB4h2Mkmn//4z/73u773R5qHHu' + '/j/w7Kxkzh5lWRWdsifCkNAnY9Zc1HvDAhjhSHdFkHFzLmabt/AQxSg2wwzLhHIJOBnAWwVY4zr' + 'hIYhhc2kvhYDfQ4hDi2Gmh5KyFn8EcGIrHAngNgIwVIEMf5bzbAiTRoAD///8z/KVhkkWEle6IX' + '+d/z4fvH3BShK1e5kmjkCMoxVmXhd4ROlTKo3iipasvTilY21q19ta30/v/0/idPX1v8PNxJL6r' + 'amnOVsdvMv2akO0iSYIzdJFirtzWXCZicS9vHqvSKyqm5XJBdqBwPxyfJdykhWTZ0G0ZyTZGpLK' + 'xsNwwoRhsx3tZfhwmeOBVISm3impAC/IT/8hP/EKEM1KMdVdVKM2rHV4x7HVXZvbVVKN/qq8CiV' + '9VL9jjH/6l6qf7MBCjZmOqsAibjcP+qqqv0oxqpa/NVW286hPo1nz2L/h8+jXt//uSxCmDU2IK/' + 'ECN98KKtE5IYzNoCfbw+u9i5r8PoadUMFPKqWL4LK3T/LCraMSHGkW4bpLXR/E6LlHOVQxmslKV' + 'J8IULktMN06N0FKCpHCoYsjC4F+Z0NVqdNFoGSTjSiyjzLdnZ2fNqTi2eHKONONKLMPMKLONKLM' + 'PQRJGlFxZRoKcJFAYEeIFiRQkUWUeYfef//Ko04soswso40UJAgMw8wosososy0EalnZyjQUGBR' + 'QGIFggOWUacWUeYmuadrZziQKKEgQsQLAhQkUJAgMQDghltLO1onp0cpkNInSFMqlYeSEJ5AHsq' + 'FdOwy1DA2sRmRJKxdKRfLhfLw5BzUxBTUUzLjk4LjJVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVUxBTUUzLjk4LjJVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVVVf/7ksRRA8AAAaQAAAAgAAA0gAAABFVVVVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV' + 'VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVU=';
 export function createHTMLAudioElement() {
   var ndAudio = document.querySelector('#vreo-playController-audio');
@@ -14,19 +15,14 @@ export function createHTMLAudioElement() {
   audio.src = BLANK_AUDIO;
 
   // 触发一次播放
-  Promise.resolve( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
-    return _regeneratorRuntime.wrap(function _callee$(_context) {
-      while (1) {
-        switch (_context.prev = _context.next) {
-          case 0:
-            _context.next = 2;
-            return audio.play();
-          case 2:
-            return _context.abrupt("return", _context.sent);
-          case 3:
-          case "end":
-            return _context.stop();
-        }
+  Promise.resolve(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          _context.n = 1;
+          return audio.play();
+        case 1:
+          return _context.a(2, _context.v);
       }
     }, _callee);
   })));

package/lib/PlayController/index.js

@@ -1,27 +1,25 @@
 import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import _classCallCheck from "@babel/runtime/helpers/esm/classCallCheck";
 import _createClass from "@babel/runtime/helpers/esm/createClass";
-import _assertThisInitialized from "@babel/runtime/helpers/esm/assertThisInitialized";
-import _inherits from "@babel/runtime/helpers/esm/inherits";
 import _possibleConstructorReturn from "@babel/runtime/helpers/esm/possibleConstructorReturn";
 import _getPrototypeOf from "@babel/runtime/helpers/esm/getPrototypeOf";
+import _inherits from "@babel/runtime/helpers/esm/inherits";
 import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
-import _regeneratorRuntime from "@babel/runtime/regenerator";
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
-function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i.return) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
 import { Subscribe } from '@realsee/five';
 import { requestAnimationFrameInterval } from "../shared-utils/animationFrame/index.js";
 import { createHTMLAudioElement } from "./createHTMLAudioElement.js";
 var closures = {};
 export var PlayController = /*#__PURE__*/function (_Subscribe) {
-  _inherits(PlayController, _Subscribe);
-  var _super = _createSuper(PlayController);
   function PlayController() {
     var _this;
     var config = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
     _classCallCheck(this, PlayController);
-    _this = _super.call(this);
-    _defineProperty(_assertThisInitialized(_this), "config", {});
+    _this = _callSuper(this, PlayController);
+    _defineProperty(_this, "config", {});
     if (!config.audio) {
       config.audio = createHTMLAudioElement();
     }
@@ -65,7 +63,8 @@ export var PlayController = /*#__PURE__*/function (_Subscribe) {
   /**
    * 载入数据
    */
-  _createClass(PlayController, [{
+  _inherits(PlayController, _Subscribe);
+  return _createClass(PlayController, [{
     key: "paused",
     get: function get() {
       return this.audioInstance.paused;
@@ -104,40 +103,35 @@ export var PlayController = /*#__PURE__*/function (_Subscribe) {
     }
   }, {
     key: "load",
-    value: function () {
-      var _load = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(vreoUnit) {
+    value: (function () {
+      var _load = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(vreoUnit) {
         var _this3 = this;
-        return _regeneratorRuntime.wrap(function _callee$(_context) {
-          while (1) {
-            switch (_context.prev = _context.next) {
-              case 0:
-                this.vreoUnit = vreoUnit;
-                _context.next = 3;
-                return this.pause();
-              case 3:
-                _context.next = 5;
-                return new Promise(function (resolve, reject) {
-                  if (vreoUnit.video.url === _this3.audioInstance.src) {
-                    return resolve(true);
-                  }
-                  _this3.audioInstance.src = vreoUnit.video.url;
-                  var canplaythrough = function canplaythrough() {
-                    resolve(true);
-                    _this3.audioInstance.removeEventListener('canplaythrough', canplaythrough);
-                  };
-                  var error = function error(err) {
-                    reject(err);
-                    _this3.audioInstance.removeEventListener('error', error);
-                  };
-                  _this3.audioInstance.addEventListener('canplaythrough', canplaythrough);
-                  _this3.audioInstance.addEventListener('error', error);
-                });
-              case 5:
-                return _context.abrupt("return", _context.sent);
-              case 6:
-              case "end":
-                return _context.stop();
-            }
+        return _regenerator().w(function (_context) {
+          while (1) switch (_context.n) {
+            case 0:
+              this.vreoUnit = vreoUnit;
+              _context.n = 1;
+              return this.pause();
+            case 1:
+              _context.n = 2;
+              return new Promise(function (resolve, reject) {
+                if (vreoUnit.video.url === _this3.audioInstance.src) {
+                  return resolve(true);
+                }
+                _this3.audioInstance.src = vreoUnit.video.url;
+                var _canplaythrough = function canplaythrough() {
+                  resolve(true);
+                  _this3.audioInstance.removeEventListener('canplaythrough', _canplaythrough);
+                };
+                var _error = function error(err) {
+                  reject(err);
+                  _this3.audioInstance.removeEventListener('error', _error);
+                };
+                _this3.audioInstance.addEventListener('canplaythrough', _canplaythrough);
+                _this3.audioInstance.addEventListener('error', _error);
+              });
+            case 2:
+              return _context.a(2, _context.v);
           }
         }, _callee, this);
       }));
@@ -149,19 +143,17 @@ export var PlayController = /*#__PURE__*/function (_Subscribe) {
     /**
      * 播放
      */
+    )
   }, {
     key: "play",
-    value: function () {
-      var _play = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2() {
-        return _regeneratorRuntime.wrap(function _callee2$(_context2) {
-          while (1) {
-            switch (_context2.prev = _context2.next) {
-              case 0:
-                closures.playPromise = this.audioInstance.play();
-              case 1:
-              case "end":
-                return _context2.stop();
-            }
+    value: (function () {
+      var _play = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2() {
+        return _regenerator().w(function (_context2) {
+          while (1) switch (_context2.n) {
+            case 0:
+              closures.playPromise = this.audioInstance.play();
+            case 1:
+              return _context2.a(2);
           }
         }, _callee2, this);
       }));
@@ -173,26 +165,24 @@ export var PlayController = /*#__PURE__*/function (_Subscribe) {
     /**
      * 暂停
      */
+    )
   }, {
     key: "pause",
-    value: function () {
-      var _pause = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3() {
-        return _regeneratorRuntime.wrap(function _callee3$(_context3) {
-          while (1) {
-            switch (_context3.prev = _context3.next) {
-              case 0:
-                if (!closures.playPromise) {
-                  _context3.next = 3;
-                  break;
-                }
-                _context3.next = 3;
-                return closures.playPromise;
-              case 3:
-                this.audioInstance.pause();
-              case 4:
-              case "end":
-                return _context3.stop();
-            }
+    value: (function () {
+      var _pause = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
+        return _regenerator().w(function (_context3) {
+          while (1) switch (_context3.n) {
+            case 0:
+              if (!closures.playPromise) {
+                _context3.n = 1;
+                break;
+              }
+              _context3.n = 1;
+              return closures.playPromise;
+            case 1:
+              this.audioInstance.pause();
+            case 2:
+              return _context3.a(2);
           }
         }, _callee3, this);
       }));
@@ -207,6 +197,7 @@ export var PlayController = /*#__PURE__*/function (_Subscribe) {
      * 
      * @deprecated **慎重执行**
      */
+    )
   }, {
     key: "dispose",
     value: function dispose() {
@@ -219,5 +210,4 @@ export var PlayController = /*#__PURE__*/function (_Subscribe) {
       }
     }
   }]);
-  return PlayController;
 }(Subscribe);

package/lib/Player/App.js

@@ -36,9 +36,9 @@ var AppView = observer(function (_ref) {
         return;
       }
       if (controller.playing) {
-        controller.setPlaying(false);
+        controller.audioFocus.cancel('paused');
       } else {
-        controller.setPlaying(true);
+        if (controller.audioFocus.acquire('user')) controller.setPlaying(true);
       }
     },
     options: ((_controller$configs3 = controller.configs) === null || _controller$configs3 === void 0 ? void 0 : _controller$configs3.videoAgentMeshOptions) || {}

package/lib/Player/AudioFocus.d.ts

@@ -0,0 +1,36 @@
+export type AudioIntent = 'user' | 'auto';
+export type AudioStopReason = 'preempted' | 'paused' | 'closed' | 'replaced' | 'disposed';
+export interface AudioLease {
+    readonly signal: AbortSignal;
+    isCurrent(): boolean;
+    release(): void;
+}
+export interface AudioSource {
+    acquire(intent: AudioIntent): AudioLease | null;
+    cancel(reason: AudioStopReason): void;
+    dispose(): void;
+}
+export interface AudioFocusHost {
+    register(options: {
+        label: string;
+        stop(reason: AudioStopReason): void;
+    }): AudioSource;
+}
+/** One narration owns the outer lease; member tracks never compete with it. */
+export declare class NarrationAudioFocus {
+    private onStop;
+    private disposed;
+    private source?;
+    private lease?;
+    private task?;
+    private members;
+    constructor(host: AudioFocusHost | undefined, onStop: () => void);
+    get active(): boolean;
+    capture(): () => boolean;
+    acquire(intent: AudioIntent): boolean;
+    add(stop: (reason: AudioStopReason) => void): () => void;
+    stop(reason: AudioStopReason): void;
+    cancel(reason: AudioStopReason): void;
+    dispose(): void;
+    readonly host: AudioFocusHost;
+}

package/lib/Player/AudioFocus.js

@@ -0,0 +1,139 @@
+import _toConsumableArray from "@babel/runtime/helpers/esm/toConsumableArray";
+import _classCallCheck from "@babel/runtime/helpers/esm/classCallCheck";
+import _createClass from "@babel/runtime/helpers/esm/createClass";
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
+/** One narration owns the outer lease; member tracks never compete with it. */
+export var NarrationAudioFocus = /*#__PURE__*/function () {
+  function NarrationAudioFocus(host, onStop) {
+    var _this = this;
+    _classCallCheck(this, NarrationAudioFocus);
+    _defineProperty(this, "disposed", false);
+    _defineProperty(this, "members", new Set());
+    _defineProperty(this, "host", {
+      register: function register(_ref) {
+        var stop = _ref.stop;
+        var disposed = false;
+        var child;
+        var cancel = function cancel(reason) {
+          var _child;
+          (_child = child) === null || _child === void 0 || _child.abort();
+          child = undefined;
+          stop(reason);
+        };
+        var remove = _this.add(cancel);
+        return {
+          acquire: function acquire() {
+            var _child2;
+            if (disposed || !_this.active) return null;
+            (_child2 = child) === null || _child2 === void 0 || _child2.abort();
+            var current = child = new AbortController();
+            var valid = _this.capture();
+            return {
+              signal: current.signal,
+              isCurrent: function isCurrent() {
+                return valid() && child === current && !current.signal.aborted;
+              },
+              release: function release() {
+                if (child === current) {
+                  current.abort();
+                  child = undefined;
+                }
+              }
+            };
+          },
+          cancel: cancel,
+          dispose: function dispose() {
+            if (disposed) return;
+            disposed = true;
+            cancel('disposed');
+            remove();
+          }
+        };
+      }
+    });
+    this.onStop = onStop;
+    this.source = host === null || host === void 0 ? void 0 : host.register({
+      label: 'vreo',
+      stop: function stop(reason) {
+        return _this.stop(reason);
+      }
+    });
+  }
+  return _createClass(NarrationAudioFocus, [{
+    key: "active",
+    get: function get() {
+      var _this$lease;
+      return !!this.task && !this.task.signal.aborted && (!this.source || !!((_this$lease = this.lease) !== null && _this$lease !== void 0 && _this$lease.isCurrent()));
+    }
+  }, {
+    key: "capture",
+    value: function capture() {
+      var _this2 = this;
+      var task = this.task;
+      return function () {
+        return !!task && task === _this2.task && _this2.active;
+      };
+    }
+  }, {
+    key: "acquire",
+    value: function acquire(intent) {
+      var _this$source;
+      if (this.disposed) return false;
+      if (this.active) return true;
+      var lease = (_this$source = this.source) === null || _this$source === void 0 ? void 0 : _this$source.acquire(intent);
+      if (this.source && !lease) return false;
+      this.lease = lease !== null && lease !== void 0 ? lease : undefined;
+      this.task = new AbortController();
+      return true;
+    }
+  }, {
+    key: "add",
+    value: function add(stop) {
+      var _this3 = this;
+      this.members.add(stop);
+      return function () {
+        _this3.members.delete(stop);
+      };
+    }
+  }, {
+    key: "stop",
+    value: function stop(reason) {
+      var _this$task;
+      (_this$task = this.task) === null || _this$task === void 0 || _this$task.abort();
+      this.task = undefined;
+      var errors = [];
+      try {
+        this.onStop();
+      } catch (error) {
+        errors.push(error);
+      }
+      for (var _i = 0, _arr = _toConsumableArray(this.members); _i < _arr.length; _i++) {
+        var _stop = _arr[_i];
+        try {
+          _stop(reason);
+        } catch (error) {
+          errors.push(error);
+        }
+      }
+      if (errors.length) throw errors[0];
+    }
+  }, {
+    key: "cancel",
+    value: function cancel(reason) {
+      var _this$source2;
+      this.stop(reason);
+      (_this$source2 = this.source) === null || _this$source2 === void 0 || _this$source2.cancel(reason);
+      this.lease = undefined;
+    }
+  }, {
+    key: "dispose",
+    value: function dispose() {
+      var _this$source3;
+      if (this.disposed) return;
+      this.disposed = true;
+      this.cancel('disposed');
+      (_this$source3 = this.source) === null || _this$source3 === void 0 || _this$source3.dispose();
+      this.members.clear();
+    }
+  }]);
+}();

package/lib/Player/Controller.d.ts

@@ -1,3 +1,4 @@
+import { NarrationAudioFocus } from './AudioFocus';
 import { Five, Subscribe } from '@realsee/five';
 import * as React from 'react';
 import { VreoKeyframe, VreoKeyframeEnum, VreoKeyframeEvent, VreoUnit, VreoVideo } from '../typings/VreoUnit';
@@ -45,6 +46,11 @@ export declare class Controller extends Subscribe<VreoKeyframeEvent> {
     waveAppearance: WaveAppearance | null;
     appearance: Appearance;
     avatar: VreoVideo['avatar'];
+    /**
+     * 是否正在等待背景音乐加载
+     * 当此状态为 true 时，播放流程会暂停，等待音频加载完成
+     */
+    waitingForBgMusic: boolean;
     visible: boolean;
     /**
      * 获取当前播放媒体的类型
@@ -92,6 +98,11 @@ export declare class Controller extends Subscribe<VreoKeyframeEvent> {
      * @param ended - 是否已结束
      */
     setEnded(ended: boolean): void;
+    /**
+     * 设置是否正在等待背景音乐加载
+     * @param waiting - 是否正在等待
+     */
+    setWaitingForBgMusic(waiting: boolean): void;
     /**
      * 设置播放器外观
      * @param appearance - 外观配置对象
@@ -112,6 +123,10 @@ export declare class Controller extends Subscribe<VreoKeyframeEvent> {
      * @param params.container - DOM 容器元素
      * @param params.configs - 播放器配置
      */
+    private resumeGeneration;
+    private resuming;
+    private disposers;
+    readonly audioFocus: NarrationAudioFocus;
     constructor({ five, container, configs }: {
         five: Five;
         container: Element;
@@ -144,6 +159,7 @@ export declare class Controller extends Subscribe<VreoKeyframeEvent> {
      * @param callback - 关键帧触发时的回调函数
      */
     requestAnimationFrameLoop(callback: (type: VreoKeyframeEnum, keyframe: VreoKeyframe, currentTime: number) => void): void;
+    private resumeMedia;
     /**
      * 开始运行播放器逻辑循环
      *