@galacean/effects-plugin-multimedia 2.8.0-alpha.5 → 2.8.0

package/dist/index.js

@@ -3,7 +3,7 @@
  * Description: Galacean Effects player multimedia plugin
  * Author: Ant Group CO., Ltd.
  * Contributors: 云垣
- * Version: v2.8.0-alpha.5
+ * Version: v2.8.0
  */
 
 'use strict';
@@ -269,7 +269,13 @@ var multimediaErrorDisplayMessageMap = {
     2000: "音视频自动播放权限未开启"
 };
 
-function processMultimedia(media, type, options) {
+/**
+ * 处理多媒体资源加载
+ * @param media - 多媒体资源数组
+ * @param type - 多媒体类型（视频或音频）
+ * @param options - 场景加载选项
+ * @returns 加载完成的多媒体资源数组
+ */ function processMultimedia(media, type, options) {
     return _processMultimedia.apply(this, arguments);
 }
 function _processMultimedia() {
@@ -279,11 +285,13 @@ function _processMultimedia() {
             renderLevel = options.renderLevel;
             jobs = media.map(function(medium) {
                 if (EFFECTS.passRenderLevel(medium.renderLevel, renderLevel)) {
-                    var url = new URL(medium.url, location.href).href;
                     if (type === EFFECTS.spec.MultimediaType.video) {
+                        var videoURL = getVideoUrl(medium, options);
+                        var url = new URL(videoURL, location.href).href;
                         return EFFECTS.loadVideo(url);
                     } else if (type === EFFECTS.spec.MultimediaType.audio) {
-                        return loadAudio(url);
+                        var url1 = new URL(medium.url, location.href).href;
+                        return loadAudio(url1);
                     }
                 }
                 throw new Error("Invalid " + type + " source: " + JSON.stringify(media) + ".");
@@ -298,6 +306,7 @@ function _processMultimedia() {
 }
 /**
  * 判断音视频浏览器是否允许播放
+ * @throws {MultimediaError} 当浏览器不允许自动播放时抛出错误
  */ function checkAutoplayPermission() {
     return _checkAutoplayPermission.apply(this, arguments);
 }
@@ -344,7 +353,9 @@ function _checkAutoplayPermission() {
 }
 /**
  * 异步加载一个音频文件
- * @param url - 音频文件的 URL 或 MediaProvider 对象
+ * @param url - 音频文件的 URL
+ * @returns 返回 AudioBuffer（如果支持 AudioContext）或 HTMLAudioElement
+ * @throws {Error} 当音频加载失败时抛出错误
  */ function loadAudio(url) {
     return _loadAudio.apply(this, arguments);
 }
@@ -416,7 +427,9 @@ function _loadAudio() {
     });
     return _loadAudio.apply(this, arguments);
 }
-var MultimediaError = /*#__PURE__*/ function(Error1) {
+/**
+ * 多媒体错误类
+ */ var MultimediaError = /*#__PURE__*/ function(Error1) {
     _inherits(MultimediaError, Error1);
     function MultimediaError(code, message) {
         var _this;
@@ -430,6 +443,63 @@ var MultimediaError = /*#__PURE__*/ function(Error1) {
     }
     return MultimediaError;
 }(_wrap_native_super(Error));
+/**
+ * 检查浏览器是否支持播放指定的 HEVC 编解码器
+ * @param codec - HEVC 编解码器
+ * @returns 如果浏览器可能或确定支持该编解码器，则返回 true，否则返回 false
+ */ function canPlayHevcCodec(codec) {
+    var video = document.createElement("video");
+    var contentType = 'video/mp4; codecs="' + codec + '"';
+    var result = video.canPlayType(contentType);
+    return result === "probably" || result === "maybe";
+}
+/**
+ * 将编解码器字符串解析为 HEVC 视频编解码器枚举值
+ * @param codec - 编解码器字符串（可以是枚举值或枚举名称）
+ * @returns 对应的 HEVC 视频编解码器枚举值，如果无效则返回 undefined
+ */ function parseCodec(codec) {
+    // 传入的是完整的枚举值
+    if (isCodecValue(codec)) {
+        return codec;
+    }
+    // 传入的是枚举名称
+    if (isCodecKey(codec)) {
+        return EFFECTS.spec.HevcVideoCodec[codec];
+    }
+    return undefined;
+}
+/**
+ * 检查给定字符串是否为有效的 HEVC 枚举值
+ * @param codec - 待检查的字符串
+ * @returns 如果是有效的枚举值则返回 true
+ */ function isCodecValue(codec) {
+    return Object.keys(EFFECTS.spec.HevcVideoCodec).some(function(key) {
+        return EFFECTS.spec.HevcVideoCodec[key] === codec;
+    });
+}
+/**
+ * 检查给定字符串是否为有效的 HEVC 枚举键名
+ * @param codec - 待检查的字符串
+ * @returns 如果是有效的枚举键名则返回 true
+ */ function isCodecKey(codec) {
+    return codec in EFFECTS.spec.HevcVideoCodec;
+}
+/**
+ * 获取视频 URL，根据配置和浏览器能力选择最优的视频源
+ * @param medium - 媒体资源对象
+ * @param options - 场景加载选项
+ * @returns 最优的视频 URL（优先返回 HEVC 格式，如果支持的话）
+ */ function getVideoUrl(medium, options) {
+    if (!options.useHevcVideo) {
+        return medium.url;
+    }
+    var hevc = medium.hevc;
+    if (!(hevc == null ? void 0 : hevc.url) || !(hevc == null ? void 0 : hevc.codec)) {
+        return medium.url;
+    }
+    var codec = parseCodec(hevc.codec);
+    return codec && canPlayHevcCodec(codec) ? hevc.url : medium.url;
+}
 
 /**
  * 视频加载插件
@@ -1142,7 +1212,7 @@ exports.AudioComponent = __decorate([
 
 /**
  * 插件版本号
- */ var version = "2.8.0-alpha.5";
+ */ var version = "2.8.0";
 EFFECTS.registerPlugin("video", VideoLoader);
 EFFECTS.registerPlugin("audio", AudioLoader);
 EFFECTS.logger.info("Plugin multimedia version: " + version + ".");
@@ -1152,10 +1222,12 @@ if (version !== EFFECTS__namespace.version) {
 
 exports.AudioPlayer = AudioPlayer;
 exports.MultimediaError = MultimediaError;
+exports.canPlayHevcCodec = canPlayHevcCodec;
 exports.checkAutoplayPermission = checkAutoplayPermission;
 exports.loadAudio = loadAudio;
 exports.multimediaErrorDisplayMessageMap = multimediaErrorDisplayMessageMap;
 exports.multimediaErrorMessageMap = multimediaErrorMessageMap;
+exports.parseCodec = parseCodec;
 exports.processMultimedia = processMultimedia;
 exports.version = version;
 //# sourceMappingURL=index.js.map