@volcengine/veplayer 2.4.2-rc.4 → 2.4.3-rc.1

package/esm/veplayer.vod.development.js

@@ -1307,7 +1307,7 @@ var VERSION_REG = {
   android: /(Android)\s([\d.]+)/,
   ios: /(Version)\/([\d.]+)/
 };
-var H264_MIMETYPES = ["avc1.42E01E, mp4a.40.2", "avc1.58A01E, mp4a.40.2", "avc1.4D401E, mp4a.40.2", "avc1.64001E, mp4a.40.2", "avc1.42E01E", "mp4v.20.8", "avc1.42E01E, mp4a.40.2", "avc1.58A01E, mp4a.40.2", "avc1.4D401E, mp4a.40.2", "avc1.64001E, mp4a.40.2", "mp4v.20.8, mp4a.40.2", "mp4v.20.240, mp4a.40.2"];
+var H264_MIMETYPES = ["avc1.42E01E, mp4a.40.2", "avc1.58A01E, mp4a.40.2", "avc1.4D401E, mp4a.40.2", "avc1.64001E, mp4a.40.2", "avc1.42E01E", "mp4v.20.8", "mp4v.20.8, mp4a.40.2", "mp4v.20.240, mp4a.40.2"];
 var sniffer = {
   get device() {
     var r = sniffer.os;
@@ -1452,7 +1452,7 @@ var sniffer = {
     }
   }
 };
-var version = "3.0.19-rc.0";
+var version = "3.0.20-rc.6";
 var ERROR_TYPE_MAP = {
   1: "media",
   2: "media",
@@ -2422,8 +2422,7 @@ function hook(hookName, handler) {
     }
     if (this.__hooks && this.__hooks[hookName]) {
       try {
-        var _this$__hooks$hookNam;
-        var preRet = (_this$__hooks$hookNam = this.__hooks[hookName]).call.apply(_this$__hooks$hookNam, [this, this].concat(Array.prototype.slice.call(arguments)));
+        var preRet = runHooks(this, hookName, handler);
         if (preRet) {
           if (preRet.then) {
             preRet.then(function(isContinue) {
@@ -2448,6 +2447,19 @@ function hook(hookName, handler) {
     }
   }.bind(this);
 }
+function findHookIndex(hookName, handler) {
+  var __hooks = this.__hooks;
+  if (!__hooks || !Array.isArray(__hooks[hookName])) {
+    return -1;
+  }
+  var hookHandlers = __hooks[hookName];
+  for (var i = 0; i < hookHandlers.length; i++) {
+    if (hookHandlers[i] === handler) {
+      return i;
+    }
+  }
+  return -1;
+}
 function useHooks(hookName, handler) {
   var __hooks = this.__hooks;
   if (!__hooks) {
@@ -2457,7 +2469,12 @@ function useHooks(hookName, handler) {
     console.warn("has no supported hook which name [".concat(hookName, "]"));
     return false;
   }
-  __hooks && (__hooks[hookName] = handler);
+  if (!Array.isArray(__hooks[hookName])) {
+    __hooks[hookName] = [];
+  }
+  if (findHookIndex.call(this, hookName, handler) === -1) {
+    __hooks[hookName].push(handler);
+  }
   return true;
 }
 function removeHooks(hookName, handler) {
@@ -2465,6 +2482,13 @@ function removeHooks(hookName, handler) {
   if (!__hooks) {
     return;
   }
+  if (Array.isArray(__hooks[hookName])) {
+    var hooks = __hooks[hookName];
+    var index = findHookIndex.call(this, hookName, handler);
+    if (index !== -1) {
+      hooks.splice(index, 1);
+    }
+  }
   delete __hooks[hookName];
 }
 function usePluginHooks(pluginName) {
@@ -2512,18 +2536,30 @@ function runHooks(obj, hookName, handler) {
   for (var _len5 = arguments.length, args = new Array(_len5 > 3 ? _len5 - 3 : 0), _key5 = 3; _key5 < _len5; _key5++) {
     args[_key5 - 3] = arguments[_key5];
   }
-  if (obj.__hooks && obj.__hooks[hookName]) {
-    var _obj$__hooks$hookName;
-    var ret = (_obj$__hooks$hookName = obj.__hooks[hookName]).call.apply(_obj$__hooks$hookName, [obj, obj].concat(args));
-    if (ret && ret.then) {
-      ret.then(function(data) {
-        return data === false ? null : handler.call.apply(handler, [obj, obj].concat(args));
-      }).catch(function(e) {
-        console.warn("[runHooks]".concat(hookName, " reject"), e.message);
-      });
-    } else if (ret !== false) {
-      return handler.call.apply(handler, [obj, obj].concat(args));
-    }
+  if (obj.__hooks && Array.isArray(obj.__hooks[hookName])) {
+    var hooks = obj.__hooks[hookName];
+    var index = -1;
+    var runHooksRecursive = function runHooksRecursive2(obj2, hookName2, handler2) {
+      for (var _len6 = arguments.length, args2 = new Array(_len6 > 3 ? _len6 - 3 : 0), _key6 = 3; _key6 < _len6; _key6++) {
+        args2[_key6 - 3] = arguments[_key6];
+      }
+      index++;
+      if (hooks.length === 0 || index === hooks.length) {
+        return handler2.call.apply(handler2, [obj2, obj2].concat(args2));
+      }
+      var hook2 = hooks[index];
+      var ret = hook2.call.apply(hook2, [obj2, obj2].concat(args2));
+      if (ret && ret.then) {
+        return ret.then(function(data) {
+          return data === false ? null : runHooksRecursive2.apply(void 0, [obj2, hookName2, handler2].concat(args2));
+        }).catch(function(e) {
+          console.warn("[runHooks]".concat(hookName2, " reject"), e.message);
+        });
+      } else if (ret !== false) {
+        return runHooksRecursive2.apply(void 0, [obj2, hookName2, handler2].concat(args2));
+      }
+    };
+    return runHooksRecursive.apply(void 0, [obj, hookName, handler].concat(args));
   } else {
     return handler.call.apply(handler, [obj, obj].concat(args));
   }
@@ -2767,6 +2803,18 @@ var BasePlugin = /* @__PURE__ */ function() {
         }
       }
     }
+  }, {
+    key: "defineMethod",
+    value: function defineMethod(Obj, map) {
+      for (var key in map) {
+        if (Object.prototype.hasOwnProperty.call(map, key) && typeof map[key] === "function") {
+          Object.defineProperty(Obj, key, {
+            configurable: true,
+            value: map[key]
+          });
+        }
+      }
+    }
   }, {
     key: "defaultConfig",
     get: function get() {
@@ -3412,7 +3460,7 @@ var ResizeObserver = /* @__PURE__ */ function() {
       if (!this.observer) {
         return;
       }
-      this.observer && this.observer.observe(target);
+      this.observer.observe(target);
       var _pid = target.getAttribute(PLATER_ID);
       var __handlers = this.__handlers;
       var index = -1;
@@ -3441,16 +3489,17 @@ var ResizeObserver = /* @__PURE__ */ function() {
         }
       });
       try {
-        this.observer && this.observer.unobserve(target);
+        var _this$observer;
+        (_this$observer = this.observer) === null || _this$observer === void 0 ? void 0 : _this$observer.unobserve(target);
       } catch (e) {
       }
-      this.observer && this.observer.unobserve(target);
       i > -1 && this.__handlers.splice(i, 1);
     }
   }, {
     key: "destroyObserver",
     value: function destroyObserver() {
-      this.observer && this.observer.disconnect();
+      var _this$observer2;
+      (_this$observer2 = this.observer) === null || _this$observer2 === void 0 ? void 0 : _this$observer2.disconnect();
       this.observer = null;
       this.__handlers = null;
     }
@@ -3482,7 +3531,8 @@ function addObserver(target, handler) {
   return resizeObserver;
 }
 function unObserver(target, handler) {
-  resizeObserver.unObserver(target, handler);
+  var _resizeObserver;
+  (_resizeObserver = resizeObserver) === null || _resizeObserver === void 0 ? void 0 : _resizeObserver.unObserver(target, handler);
 }
 var pluginsManager = {
   pluginGroup: {},
@@ -4480,10 +4530,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       }
       var _this$config = _this.config, autoplay2 = _this$config.autoplay, defaultPlaybackRate = _this$config.defaultPlaybackRate;
       XG_DEBUG.logInfo("player", "canPlayFunc, startTime", _this.__startTime);
-      if (_this.__startTime > 0 && _this.duration > 0) {
-        _this.currentTime = _this.__startTime > _this.duration ? _this.duration : _this.__startTime;
-        _this.__startTime = -1;
-      }
+      _this._seekToStartTime();
       _this.playbackRate = defaultPlaybackRate;
       (autoplay2 || _this._useAutoplay) && _this.mediaPlay();
       _this.off(CANPLAY, _this.canPlayFunc);
@@ -4573,6 +4620,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     _this.waitTimer = null;
     _this.handleSource = true;
     _this._state = STATES.INITIAL;
+    _this.isAd = false;
     _this.isError = false;
     _this._hasStart = false;
     _this.isSeeking = false;
@@ -4957,7 +5005,8 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       _pConfig.position && (options.position = _pConfig.position);
       var position = options.position ? options.position : options.config && options.config.position || PLUFGIN.defaultConfig && PLUFGIN.defaultConfig.position;
       if (!options.root && typeof position === "string" && position.indexOf("controls") > -1) {
-        return this.controls && this.controls.registerPlugin(PLUFGIN, options, PLUFGIN.pluginName);
+        var _this$controls;
+        return (_this$controls = this.controls) === null || _this$controls === void 0 ? void 0 : _this$controls.registerPlugin(PLUFGIN, options, PLUFGIN.pluginName);
       }
       if (!options.root) {
         options.root = this._getRootByPosition(position);
@@ -5105,10 +5154,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
           reject(e);
         };
         var _canplay = function _canplay2() {
-          if (_this9.duration > 0 && _this9.__startTime > 0) {
-            _this9.currentTime = _this9.__startTime;
-            _this9.__startTime = -1;
-          }
+          _this9._seekToStartTime();
           if (isPaused) {
             _this9.pause();
           }
@@ -5729,11 +5775,17 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
   }, {
     key: "onLoadeddata",
     value: function onLoadeddata() {
+      var _this22 = this;
       this.isError = false;
       this.isSeeking = false;
-      if (this.__startTime > 0 && this.duration > 0) {
-        this.currentTime = this.__startTime;
-        this.__startTime = -1;
+      if (this.__startTime > 0) {
+        if (this.duration > 0) {
+          this._seekToStartTime();
+        } else {
+          this.once(DURATION_CHANGE, function() {
+            _this22._seekToStartTime();
+          });
+        }
       }
     }
   }, {
@@ -5802,27 +5854,27 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
   }, {
     key: "onWaiting",
     value: function onWaiting() {
-      var _this22 = this;
+      var _this23 = this;
       if (this.waitTimer) {
         util.clearTimeout(this, this.waitTimer);
       }
       this.updateAcc("waiting");
       this.waitTimer = util.setTimeout(this, function() {
-        _this22.addClass(STATE_CLASS.LOADING);
-        _this22.emit(LOADING);
-        util.clearTimeout(_this22, _this22.waitTimer);
-        _this22.waitTimer = null;
+        _this23.addClass(STATE_CLASS.LOADING);
+        _this23.emit(LOADING);
+        util.clearTimeout(_this23, _this23.waitTimer);
+        _this23.waitTimer = null;
       }, this.config.minWaitDelay);
     }
   }, {
     key: "onPlaying",
     value: function onPlaying() {
-      var _this23 = this;
+      var _this24 = this;
       this.isError = false;
       var NO_START = STATE_CLASS.NO_START, PAUSED = STATE_CLASS.PAUSED, ENDED2 = STATE_CLASS.ENDED, ERROR2 = STATE_CLASS.ERROR, REPLAY2 = STATE_CLASS.REPLAY, LOADING2 = STATE_CLASS.LOADING;
       var clsList = [NO_START, PAUSED, ENDED2, ERROR2, REPLAY2, LOADING2];
       clsList.forEach(function(cls) {
-        _this23.removeClass(cls);
+        _this24.removeClass(cls);
       });
       if (!this._accPlayed.t && !this.paused && !this.ended) {
         this._accPlayed.t = (/* @__PURE__ */ new Date()).getTime();
@@ -5983,14 +6035,14 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
   }, {
     key: "setConfig",
     value: function setConfig(config) {
-      var _this24 = this;
+      var _this25 = this;
       if (!config) {
         return;
       }
       Object.keys(config).map(function(key) {
         if (key !== "plugins") {
-          _this24.config[key] = config[key];
-          var plugin = _this24.plugins[key.toLowerCase()];
+          _this25.config[key] = config[key];
+          var plugin = _this25.plugins[key.toLowerCase()];
           if (plugin && util.typeOf(plugin.setConfig) === "Function") {
             plugin.setConfig(config[key]);
           }
@@ -6000,20 +6052,20 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
   }, {
     key: "playNext",
     value: function playNext(config) {
-      var _this25 = this;
+      var _this26 = this;
       this.resetState();
       this.setConfig(config);
       this._currentTime = 0;
       this._duration = 0;
       runHooks(this, "playnext", function() {
-        _this25.start();
-        _this25.emit(PLAYNEXT, config);
+        _this26.start();
+        _this26.emit(PLAYNEXT, config);
       });
     }
   }, {
     key: "resize",
     value: function resize() {
-      var _this26 = this;
+      var _this27 = this;
       if (!this.media) {
         return;
       }
@@ -6053,7 +6105,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       }
       if (!this.fullscreen && !this.cssfullscreen) {
         Object.keys(_style).forEach(function(key) {
-          _this26.root.style[key] = _style[key];
+          _this27.root.style[key] = _style[key];
         });
       }
       if (videoFillMode === "fillHeight" && fit < videoFit || videoFillMode === "fillWidth" && fit > videoFit) {
@@ -6095,6 +6147,14 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
         url
       };
     }
+  }, {
+    key: "_seekToStartTime",
+    value: function _seekToStartTime() {
+      if (this.__startTime > 0 && this.duration > 0) {
+        this.currentTime = this.__startTime > this.duration ? this.duration : this.__startTime;
+        this.__startTime = -1;
+      }
+    }
   }, {
     key: "state",
     get: function get() {
@@ -6145,15 +6205,15 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       return this.config.definition.list || [];
     },
     set: function set(list) {
-      var _this27 = this;
+      var _this28 = this;
       var definition = this.config.definition;
       var curDef = null;
       var targetDef = null;
       definition.list = list;
       this.emit("resourceReady", list);
       list.forEach(function(item) {
-        var _this27$curDefinition;
-        if (((_this27$curDefinition = _this27.curDefinition) === null || _this27$curDefinition === void 0 ? void 0 : _this27$curDefinition.definition) === item.definition) {
+        var _this28$curDefinition;
+        if (((_this28$curDefinition = _this28.curDefinition) === null || _this28$curDefinition === void 0 ? void 0 : _this28$curDefinition.definition) === item.definition) {
           curDef = item;
         }
         if (definition.defaultDefinition === item.definition) {
@@ -6890,7 +6950,7 @@ var Start = /* @__PURE__ */ function(_Plugin) {
       var className = _this.config.mode === "auto" ? "auto-hide" : "hide";
       util.addClass(_this.root, className);
       _this.autoPlayStart = true;
-      _this.onPlayPause("play");
+      _this.toggleTo("play");
     });
     _this.autoPlayStart = false;
     return _this;
@@ -6898,9 +6958,19 @@ var Start = /* @__PURE__ */ function(_Plugin) {
   _createClass(Start2, [{
     key: "afterCreate",
     value: function afterCreate() {
+      var playerConfig = this.playerConfig;
+      this.initIcons();
+      this.listenEvents();
+      this.bindClickEvents();
+      if (!playerConfig.autoplay) {
+        this.show();
+      }
+    }
+  }, {
+    key: "listenEvents",
+    value: function listenEvents() {
       var _this2 = this;
       var player = this.player, playerConfig = this.playerConfig;
-      this.initIcons();
       this.once(READY, function() {
         if (playerConfig) {
           if (playerConfig.lang && playerConfig.lang === "en") {
@@ -6911,9 +6981,6 @@ var Start = /* @__PURE__ */ function(_Plugin) {
         }
       });
       this.on(AUTOPLAY_STARTED, this.onAutoplayStart);
-      if (!playerConfig.autoplay) {
-        this.show();
-      }
       this.on(AUTOPLAY_PREVENTED, function() {
         var className = _this2.config.mode === "auto" ? "auto-hide" : "hide";
         _this2.setAttr("data-state", "play");
@@ -6921,20 +6988,25 @@ var Start = /* @__PURE__ */ function(_Plugin) {
         _this2.show();
       });
       this.on(PLAY, function() {
-        _this2.onPlayPause("play");
+        _this2.toggleTo("play");
       });
       this.on(PAUSE, function() {
-        _this2.onPlayPause("pause");
+        _this2.toggleTo("pause");
       });
       this.on(RESET, function() {
         _this2.onPlayerReset();
       });
+    }
+  }, {
+    key: "bindClickEvents",
+    value: function bindClickEvents() {
+      var _this3 = this;
       this.clickHandler = this.hook("startClick", this.switchPausePlay, {
         pre: function pre(e) {
           e.cancelable && e.preventDefault();
           e.stopPropagation();
-          var paused = _this2.player.paused;
-          _this2.emitUserAction(e, "switch_play_pause", {
+          var paused = _this3.player.paused;
+          _this3.emitUserAction(e, "switch_play_pause", {
             props: "paused",
             from: paused,
             to: !paused
@@ -6996,17 +7068,17 @@ var Start = /* @__PURE__ */ function(_Plugin) {
   }, {
     key: "animate",
     value: function animate(endShow) {
-      var _this3 = this;
+      var _this4 = this;
       this._animateId = addAnimate("pauseplay", 400, {
         start: function start() {
-          util.addClass(_this3.root, "interact");
-          _this3.show();
-          _this3.switchStatus(true);
+          util.addClass(_this4.root, "interact");
+          _this4.show();
+          _this4.switchStatus(true);
         },
         end: function end() {
-          util.removeClass(_this3.root, "interact");
-          !endShow && _this3.hide();
-          _this3._animateId = null;
+          util.removeClass(_this4.root, "interact");
+          !endShow && _this4.hide();
+          _this4._animateId = null;
         }
       });
     }
@@ -7036,6 +7108,11 @@ var Start = /* @__PURE__ */ function(_Plugin) {
   }, {
     key: "onPlayPause",
     value: function onPlayPause(status) {
+      this.toggleTo(status);
+    }
+  }, {
+    key: "toggleTo",
+    value: function toggleTo(status) {
       var config = this.config, player = this.player;
       if (!player || player.state < STATES.RUNNING || !this.autoPlayStart) {
         return;
@@ -8411,7 +8488,7 @@ var MobilePlugin = /* @__PURE__ */ function(_Plugin) {
       }
       this.on(DURATION_CHANGE, function() {
         var player2 = _this2.player, config2 = _this2.config;
-        if (player2.duration * 1e3 < config2.moveDuration) {
+        if (player2.duration > 0 && player2.duration * 1e3 < config2.moveDuration) {
           config2.moveDuration = player2.duration * 1e3;
         }
       });
@@ -8725,10 +8802,13 @@ var MobilePlugin = /* @__PURE__ */ function(_Plugin) {
   }, {
     key: "updateBrightness",
     value: function updateBrightness(percent) {
+      var pos = this.pos, config = this.config, xgMask = this.xgMask;
+      if (!config.darkness) {
+        return;
+      }
       if (this.player.rotateDeg) {
         percent = -percent;
       }
-      var pos = this.pos, config = this.config, xgMask = this.xgMask;
       var light = pos.light + 0.8 * percent;
       light = light > config.maxDarkness ? config.maxDarkness : light < 0 ? 0 : light;
       if (xgMask) {
@@ -8789,12 +8869,12 @@ var MobilePlugin = /* @__PURE__ */ function(_Plugin) {
   }, {
     key: "disableGesture",
     value: function disableGesture() {
-      this.config.disableGesture = false;
+      this.config.disableGesture = true;
     }
   }, {
     key: "enableGesture",
     value: function enableGesture() {
-      this.config.disableGesture = true;
+      this.config.disableGesture = false;
     }
   }, {
     key: "destroy",
@@ -9366,29 +9446,56 @@ var Play$1 = /* @__PURE__ */ function(_IconPlugin) {
   _inherits(Play2, _IconPlugin);
   var _super = _createSuper(Play2);
   function Play2() {
+    var _this;
     _classCallCheck(this, Play2);
-    return _super.apply(this, arguments);
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    _this = _super.call.apply(_super, [this].concat(args));
+    _defineProperty(_assertThisInitialized(_this), "btnClick", function(e) {
+      e.preventDefault();
+      e.stopPropagation();
+      var _assertThisInitialize = _assertThisInitialized(_this), player = _assertThisInitialize.player;
+      _this.emitUserAction(e, "switch_play_pause", {
+        prop: "paused",
+        from: player.paused,
+        to: !player.paused
+      });
+      if (player.ended) {
+        player.replay();
+      } else if (player.paused) {
+        player.play();
+        _this.animate(false);
+      } else {
+        player.pause();
+        _this.animate(true);
+      }
+      return false;
+    });
+    return _this;
   }
   _createClass(Play2, [{
     key: "afterCreate",
     value: function afterCreate() {
-      var _this = this;
       _get(_getPrototypeOf(Play2.prototype), "afterCreate", this).call(this);
-      var player = this.player, config = this.config;
+      var config = this.config;
       if (config.disable) {
         return;
       }
       this.initIcons();
-      this.btnClick = this.btnClick.bind(this);
       this.bind(["touchend", "click"], this.btnClick);
-      this.on([PAUSE, ERROR, EMPTIED], function() {
-        _this.animate(player.paused);
-      });
-      this.on(PLAY, function() {
-        _this.animate(player.paused);
-      });
+      this.listenEvents();
       this.animate(true);
     }
+  }, {
+    key: "listenEvents",
+    value: function listenEvents() {
+      var _this2 = this;
+      var player = this.player;
+      this.on([PLAY, PAUSE, ERROR, EMPTIED], function() {
+        _this2.animate(player.paused);
+      });
+    }
   }, {
     key: "registerIcons",
     value: function registerIcons() {
@@ -9403,28 +9510,6 @@ var Play$1 = /* @__PURE__ */ function(_IconPlugin) {
         }
       };
     }
-  }, {
-    key: "btnClick",
-    value: function btnClick(e) {
-      e.preventDefault();
-      e.stopPropagation();
-      var player = this.player;
-      this.emitUserAction(e, "switch_play_pause", {
-        prop: "paused",
-        from: player.paused,
-        to: !player.paused
-      });
-      if (player.ended) {
-        player.replay();
-      } else if (player.paused) {
-        player.play();
-        this.animate(false);
-      } else {
-        player.pause();
-        this.animate(true);
-      }
-      return false;
-    }
   }, {
     key: "initIcons",
     value: function initIcons() {
@@ -11467,10 +11552,10 @@ class OptionsIcon extends Plugin {
     const { controls } = this.player;
     const { listType } = this.config;
     if (isActive) {
-      listType && MODAL_TYPES.includes(listType) ? controls.blur() : controls.focus();
+      listType && MODAL_TYPES.includes(listType) ? controls == null ? void 0 : controls.blur() : controls == null ? void 0 : controls.focus();
       this.optionsList && this.optionsList.show();
     } else {
-      listType && MODAL_TYPES.includes(listType) ? controls.focus() : controls.focusAwhile();
+      listType && MODAL_TYPES.includes(listType) ? controls == null ? void 0 : controls.focus() : controls == null ? void 0 : controls.focusAwhile();
       this.optionsList && this.optionsList.hide();
     }
     this._isActive = isActive;
@@ -13580,7 +13665,7 @@ class VePlayerBase {
    * @returns
    */
   get playerVersion() {
-    return "2.4.2-rc.4";
+    return "2.4.3-rc.1";
   }
   /** {zh}
    * @brief 获取当前播放视频的清晰度唯一标识（definition）。