@shijiu/jsview-vue 2.3.151-test.0 → 2.3.728-alpha.0

package/utils/JsViewPlugin/JsvPlayer/index-0.9.js

@@ -1,23 +1,35 @@
-//! 考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
+//考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
 import { default as JsvPlayer }  from "./JsvPlayer.vue";
-import { globalLoadJsvPlayerPlugin as initPlugin } from "./JsvMedia.js"
-import { globalPreLoadJsvPlayerPlugin as preLoadPlugin } from "./JsvMedia.js"
-import { getJsvPlayerCapabilitySet as getCapabilitySet } from "./JsvMedia.js"
-import { setJsvPlayerDebugMode as setDebugMode } from "./JsvMedia.js"
-import { getJsvPlayerRunningNum as getRunningPlayerNum } from "./JsvMedia.js"
-import { globalLoadSetOperator as setOperator } from "./JsvMedia.js"
-import {default as BrowserPlayer} from "./BrowserJsvPlayer-0.9.vue"
-let _JsvPlayer = JsvPlayer;
+import { globalLoadJsvPlayerPlugin as initPlugin } from "./JsvPlayer.vue"
+import { globalPreLoadJsvPlayerPlugin as preLoadPlugin } from "./JsvPlayer.vue"
+import { getJsvPlayerCapabilitySet as getCapabilitySet } from "./JsvPlayer.vue"
+import { setJsvPlayerDebugMode as setDebugMode } from "./JsvPlayer.vue"
+import { getJsvPlayerRunningNum as getRunningPlayerNum } from "./JsvPlayer.vue"
+import { globalLoadSetOperator as setOperator } from "./JsvPlayer.vue"
+import { setProbeMulticastChannelID as setProbeMulticastChannelID } from "./JsvPlayer.vue"
+import { setProbeMulticastUrl as setProbeMulticastUrl } from "./JsvPlayer.vue"
+import { registerStreamChangedListener as registerStreamChangedListener } from "./JsvPlayer.vue"
+import {default as BrowserPlayer} from "./JsvPlayerBrowser-0.9.vue"
+import { setMobileEventParam as setMobileEventParam } from "./JsvPlayer.vue"
+import { setStbID as setStbID } from "./JsvPlayer.vue"
+import {setGlobalEventListener as setGlobalEventListener} from "./JsvPlayer.vue"
 
+let _JsvPlayer = JsvPlayer;
 let globalLoadJsvPlayerPlugin = initPlugin;
 let globalPreLoadJsvPlayerPlugin = preLoadPlugin;
 let getJsvPlayerCapabilitySet = getCapabilitySet;
 let setJsvPlayerDebugMode = setDebugMode;
 let getJsvPlayerRunningNum = getRunningPlayerNum;
 let globalLoadSetOperator = setOperator;
+let globalJsvPlayerProbeMulticastChannelID = setProbeMulticastChannelID;
+let globalJsvPlayerProbeMulticastUrl = setProbeMulticastUrl;
+let globalJsvPlayerRegisterStreamChangedListener = registerStreamChangedListener;
+let setJsvPlayerMobileEventParam = setMobileEventParam;
+let setJsvPlayerStbID = setStbID;
+let SetJsvPlayerGlobalEventListener = setGlobalEventListener;
 
 if (window.jsvIsBrowserDebug) {
-    // const BrowserPlayer =  await import("./BrowserJsvPlayer.vue");
+    // const BrowserPlayer =  await import("./JsvPlayerBrowser.vue");
     // 浏览器版本
     _JsvPlayer = BrowserPlayer;
 
@@ -47,6 +59,30 @@ if (window.jsvIsBrowserDebug) {
     globalLoadSetOperator = (operator)=>{
         console.log("operator is "+operator);
     }
+
+    globalJsvPlayerProbeMulticastChannelID = (mixNo)=>{
+        console.log("mixNo is "+mixNo);
+    }
+
+    globalJsvPlayerProbeMulticastUrl = (url)=>{
+        console.log("url is "+url);
+    }
+
+    globalJsvPlayerRegisterStreamChangedListener = (listener)=>{
+        console.log("listener is "+listener);
+    }
+
+    setJsvPlayerMobileEventParam = (param)=>{
+        console.log("param: "+param);
+    }
+
+    setJsvPlayerStbID = (stbid)=>{
+        console.log("param: "+stbid);
+    }
+
+    SetJsvPlayerGlobalEventListener = (listener)=>{
+        console.log("SetJsvPlayerGlobalEventListener");
+    }
 }
 
 export {
@@ -57,4 +93,10 @@ export {
     setJsvPlayerDebugMode, //设置调试模式，可以查看帧率等信息
     getJsvPlayerRunningNum, //获取正在运行的播放器个数
     globalLoadSetOperator,// 设置运营商
+    globalJsvPlayerProbeMulticastChannelID, //设置组播网络连通性探测频道号
+    globalJsvPlayerProbeMulticastUrl, //设置组播网络连通性探测url
+    globalJsvPlayerRegisterStreamChangedListener, //注册视频流重试时的全局事件通知
+    setJsvPlayerMobileEventParam,//设置移动探针相关参数
+    setJsvPlayerStbID,//设置机顶盒stbid
+    SetJsvPlayerGlobalEventListener,//设置全局事件监听
 }

package/utils/JsViewPlugin/JsvPlayer/index.js

@@ -1,22 +1,41 @@
-//! 考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
+//考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
 import { default as JsvPlayer }  from "./JsvPlayer.vue";
-import { globalLoadJsvPlayerPlugin as initPlugin } from "./JsvMedia.js"
-import { globalPreLoadJsvPlayerPlugin as preLoadPlugin } from "./JsvMedia.js"
-import { getJsvPlayerCapabilitySet as getCapabilitySet } from "./JsvMedia.js"
-import { setJsvPlayerDebugMode as setDebugMode } from "./JsvMedia.js"
-import { getJsvPlayerRunningNum as getRunningPlayerNum } from "./JsvMedia.js"
-import { globalLoadSetOperator as setOperator } from "./JsvMedia.js"
-let _JsvPlayer = JsvPlayer;
+import { globalLoadJsvPlayerPlugin as initPlugin } from "./JsvPlayer.vue"
+import { globalPreLoadJsvPlayerPlugin as preLoadPlugin } from "./JsvPlayer.vue"
+import { getJsvPlayerCapabilitySet as getCapabilitySet } from "./JsvPlayer.vue"
+import { setJsvPlayerDebugMode as setDebugMode } from "./JsvPlayer.vue"
+import { getJsvPlayerRunningNum as getRunningPlayerNum } from "./JsvPlayer.vue"
+import { globalLoadSetOperator as setOperator } from "./JsvPlayer.vue"
+import { setProbeMulticastChannelID as setProbeMulticastChannelID } from "./JsvPlayer.vue"
+import { setProbeMulticastUrl as setProbeMulticastUrl } from "./JsvPlayer.vue"
+import { registerStreamChangedListener as registerStreamChangedListener } from "./JsvPlayer.vue"
+import { setMobileEventParam as setMobileEventParam } from "./JsvPlayer.vue"
+import { setStbID as setStbID } from "./JsvPlayer.vue"
+import {setGlobalEventListener as setGlobalEventListener} from "./JsvPlayer.vue"
 
+let _JsvPlayer = JsvPlayer;
 let globalLoadJsvPlayerPlugin = initPlugin;
 let globalPreLoadJsvPlayerPlugin = preLoadPlugin;
 let getJsvPlayerCapabilitySet = getCapabilitySet;
 let setJsvPlayerDebugMode = setDebugMode;
 let getJsvPlayerRunningNum = getRunningPlayerNum;
 let globalLoadSetOperator = setOperator;
+let globalJsvPlayerProbeMulticastChannelID = setProbeMulticastChannelID;
+let globalJsvPlayerProbeMulticastUrl = setProbeMulticastUrl;
+let globalJsvPlayerRegisterStreamChangedListener = registerStreamChangedListener;
+let setJsvPlayerMobileEventParam = setMobileEventParam;
+let setJsvPlayerStbID = setStbID;
+let SetJsvPlayerGlobalEventListener = setGlobalEventListener;
 
 if (window.jsvIsBrowserDebug) {
-    const BrowserPlayer =  await import("./BrowserJsvPlayer.vue");
+    let BrowserPlayer = null;
+    if(window.JsvCoreApi?.Platform == "pc-wasm"){
+        console.log("pc-wasm")
+        BrowserPlayer =  await import("./JsvPlayerBrowser-wasm.vue");
+    }else{
+        console.log("no pc-wasm")
+        BrowserPlayer =  await import("./JsvPlayerBrowser.vue");
+    }
     // 浏览器版本
     _JsvPlayer = BrowserPlayer.default;
 
@@ -46,6 +65,30 @@ if (window.jsvIsBrowserDebug) {
     globalLoadSetOperator = (operator)=>{
         console.log("operator is "+operator);
     }
+
+    globalJsvPlayerProbeMulticastChannelID = (mixNo)=>{
+        console.log("mixNo is "+mixNo);
+    }
+
+    globalJsvPlayerProbeMulticastUrl = (url)=>{
+        console.log("url is "+url);
+    }
+
+    globalJsvPlayerRegisterStreamChangedListener = (listener)=>{
+
+    }
+
+    setJsvPlayerMobileEventParam = (param)=>{
+        console.log("param: "+param);
+    }
+
+    setJsvPlayerStbID = (stbid)=>{
+        console.log("param: "+stbid);
+    }
+
+    SetJsvPlayerGlobalEventListener = (listener)=>{
+        console.log("SetJsvPlayerGlobalEventListener");
+    }
 }
 
 export {
@@ -56,4 +99,10 @@ export {
     setJsvPlayerDebugMode, //设置调试模式，可以查看帧率等信息
     getJsvPlayerRunningNum, //获取正在运行的播放器个数
     globalLoadSetOperator,// 设置运营商
+    globalJsvPlayerProbeMulticastChannelID, //设置组播网络连通性探测频道号
+    globalJsvPlayerProbeMulticastUrl, //设置组播网络连通性探测url
+    globalJsvPlayerRegisterStreamChangedListener, //注册视频流重试时的全局事件通知
+    setJsvPlayerMobileEventParam,//设置移动探针相关参数
+    setJsvPlayerStbID,//设置机顶盒stbid
+    SetJsvPlayerGlobalEventListener,//设置全局事件监听
 }

package/utils/JsViewPlugin/JsvPlayer/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "jsvplayer",
+  "version": "2.7.4-master.1",
+  "branch": "master",
+  "description": "Jsview player plugin",
+  "main": "index.js",
+  "author": "qiancheng.li"
+}

package/utils/JsViewVueTools/BlobApi.ts

@@ -0,0 +1,55 @@
+/**
+ * BlobApi
+ *
+ * 说明:
+ * - 提供与浏览器 URL.createObjectURL / URL.revokeObjectURL 对齐的接口。
+ * 使用场景
+ * 1. blob内容是图片并且希望在JsView体系的div或者img元素中展示时使用。
+ * 2. 希望获得PC模拟环境和android环境同样的Blob展示和上传需求时
+ * 
+ * 特别说明: 在PC模拟环境中, 第三方库仅在PC上进行Blob展示时, 不用改造，
+ *    使用原URL.createObjectURL / URL.revokeObjectURL即可
+ *    例如m3u8视频转blob播放的第三方库
+ * 
+ */
+
+/**
+ * createObjectURL
+ * 为 Blob 对象创建临时 URL。
+ *
+ */
+async function createObjectURL(blob: Blob): Promise<string> {
+  // 兼容PC模拟环境下 jsvCreateObjectURL 是异步的情况
+  return await (URL as any).jsvCreateObjectURL(blob);
+}
+
+/**
+ * createObjectURLSync
+ * 为 Blob 对象创建临时 URL。为在android设备上的同步接口
+ *
+ */
+function createObjectURLSync(blob: Blob): undefined | string {
+  if ((window as any).JsvCoreApi.ProcessType == "wasm") {
+    console.warn("createObjectURLSync: wasm环境不支持同步创建ObjectURL");
+    return undefined;
+  }
+  return (URL as any).jsvCreateObjectURL(blob);
+}
+
+/**
+ * revokeObjectURL
+ * 释放由 createObjectURL 创建的临时 URL。
+ *
+ */
+function revokeObjectURL(url: string): void {
+  return (URL as any).jsvRevokeObjectURL(url);
+}
+
+let sBlobApi = {
+  createObjectURLSync,
+  createObjectURL,
+  revokeObjectURL,
+}
+
+export default sBlobApi;
+

package/utils/JsViewVueTools/FeatureActive.ts

@@ -17,6 +17,9 @@ namespace FeatureNames {
 
     // 'Capture2Texture': div拷屏
     export const Capture2Texture: String = "Capture2Texture";
+
+    export const MouseHover: String = "MouseHover";
+
 }
 
 // 激活内核中的模块

package/utils/JsViewVueTools/ForgeHandles.ts

@@ -1,3 +1,6 @@
+// ForgeHandles的所有内容仅在 node_modules/@shijiu/jsview-vue 库中使用, 
+// 非公开API, 有版本升级后被调整的可能, 不要在应用层的项目中直接使用
+
 let handles: {
     TextureManager: any,
     RootView: any,

package/utils/JsViewVueTools/JsvInteractionMode.js

@@ -0,0 +1,16 @@
+import { ref } from "vue";
+
+export const KEY_MODE = 1;
+export const TOUCH_MODE = 2;
+export const JsvInteractionMode = ref(KEY_MODE);
+
+let JsvTouchModeSwitcherCount = 0;
+export const jsvTouchModeSwitcherCreate = () => {
+  JsvTouchModeSwitcherCount++;
+};
+export const jsvTouchModeSwitcherDestroy = () => {
+  JsvTouchModeSwitcherCount--;
+};
+export const hasJsvTouchModeSwitcher = () => {
+  return JsvTouchModeSwitcherCount > 0;
+};

package/utils/JsViewVueTools/JsvPreDownloader.ts

@@ -32,14 +32,14 @@ interface infoObject {
 }
 
 const TAG = "JSvPreDownload";
-let isNullNumber: number = 0;
-let workNumber: number = 0;
 abstract class JsvPreDownloaderBase {
   public download(url: string | Array<DownloadListItem>, netSetting: string = "", isImage: boolean = false) {
     return new Promise((resolve, reject) => {
       if (typeof url === "string") {
         this.downloadInner(url, netSetting, isImage).then(resolve, reject);
       } else if (Array.isArray(url) && url.length > 0) {
+        let isNullNumber: number = 0;
+        let workNumber: number = 0;
         const downloadResult = new Array(url.length);
         const check = () => {
           let allDone = false;

package/utils/JsViewVueTools/JsvRuntimeBridge.js

@@ -119,9 +119,9 @@ function openWindow(url, startup_image, startup_video, startup_duration, add_his
  * @param {string} startup_video 启动视频url
  * @param {int} startup_duration 启动图时长，默认0
  * @param {int} add_history 是否添加历史，0不添加，1添加
- * @returns {Promise} 
+ * @returns {Promise} 比openWindow返回信息更丰富, 可获取启动者的更多返回信息
  */
-function openApp(url, startup_image, startup_video, startup_duration, add_history) {
+function openMiniApp(url, startup_image, startup_video, startup_duration, add_history) {
     let setting = {};
     if (startup_image !== null && startup_image !== "")
         setting.startupImage = startup_image;
@@ -134,7 +134,7 @@ function openApp(url, startup_image, startup_video, startup_duration, add_histor
     setting.addHistory = (add_history ? 1 : 0); // 兼容true/false传值
 
     // direct_call("openWindow", url, JSON.stringify(setting));
-    return window.jJsvRuntimeBridge.openApp(url, JSON.stringify(setting))
+    return window.jJsvRuntimeBridge.openMiniApp(url, JSON.stringify(setting))
 }
 
 /**
@@ -256,25 +256,25 @@ function getInstalledApps() {
  */
 function startNativeApp(package_name, activity, action, uri, flags, param, category) {
     var obj = {};
-    if (package_name !== null && package_name !== "")
+    if (package_name && package_name !== "")
         obj.packageName = package_name;
 
-    if (activity !== null && activity !== "")
+    if (activity && activity !== "")
         obj.activity = activity;
 
-    if (action !== null && action !== "")
+    if (action  && action !== "")
         obj.action = action;
 
-    if (uri !== null && uri !== "")
+    if (uri  && uri !== "")
         obj.uri = uri;
 
-    if (flags !== null && flags.length > 0)
+    if (flags && flags.length > 0)
         obj.flags = flags;
 
-    if (param !== null && param.length > 0)
+    if (param && param.length > 0)
         obj.param = param;
 
-    if (category!==null && category.length > 0)
+    if (category && category.length > 0)
         obj.category = category
 
     direct_call("startNativeApp", JSON.stringify(obj));
@@ -293,25 +293,25 @@ function startNativeApp(package_name, activity, action, uri, flags, param, categ
  */
 function openNativeApp(package_name, activity, action, uri, flags, param, category) {
     var obj = {};
-    if (package_name !== null && package_name !== "")
+    if (package_name && package_name !== "")
         obj.packageName = package_name;
 
-    if (activity !== null && activity !== "")
+    if (activity && activity !== "")
         obj.activity = activity;
 
-    if (action !== null && action !== "")
+    if (action && action !== "")
         obj.action = action;
 
-    if (uri !== null && uri !== "")
+    if (uri && uri !== "")
         obj.uri = uri;
 
-    if (flags !== null && flags.length > 0)
+    if (flags && flags.length > 0)
         obj.flags = flags;
 
-    if (param !== null && param.length > 0)
+    if (param && param.length > 0)
         obj.param = param;
 
-    if (category!==null && category.length > 0)
+    if (category && category.length > 0)
         obj.category = category
 
 
@@ -404,6 +404,19 @@ function getAppInfo() {
     return direct_call("getAppInfo");
 }
 
+/**
+ * 通知JsView页面可见性准备好, 主要用于JsView界面从不可见到可见切换时,
+ * 避免JsView的未绘制的黑屏被看见, 一般会在android层用张图来进行遮盖, 然后通过此接口来通知拿掉遮盖
+ * @returns 
+ */
+function notifyVisibleReady() {
+    // 触发一次swap, 并在绘制完成后再回调, 以保证绘制界面完整
+    window.JsvCoreApi.AddSwappedOnceListener(()=>{
+        direct_call("notifyVisibleReady");
+    });
+    window.Forge.sRenderBridge.RequestSwap();
+}
+
 /**
  * 页面加载成功后调用去除启动图
  *
@@ -414,7 +427,7 @@ function notifyPageLoadDone() {
 
 function notifyPageLoaded() {
     // 激活JsView的按键优化处理逻辑
-    window.JsvCoreApi.enableReceivingUserInput?.();
+    window.JsvCoreApi.notifyPageLoaded?.();
 
     direct_call("notifyPageLoaded");
 }
@@ -701,6 +714,13 @@ function getBootTime(){
     return direct_call("getBootTime")
 }
 
+/**
+ * reload页面并尝试下一个备份启动地址
+ */
+function tryNextBackupIntent() {
+    direct_call("tryNextBackupIntent");
+}
+
 
 // 显示声明，可以提高执行速度和利用上编辑器的成员名提示功能
 const bridge = {
@@ -710,7 +730,7 @@ const bridge = {
     getDeviceUUID,
     getAndroidId,
     openWindow,
-    openApp,
+    openMiniApp,
     startUrlInNewTab,
     openAppInNewTab,
     onWindowResult,
@@ -725,6 +745,7 @@ const bridge = {
     startService,
     getDeviceInfo,
     getAppInfo,
+    notifyVisibleReady,
     notifyPageLoadDone,
     notifyPageLoaded,
     hasFavouriteFunction,

package/utils/JsViewVueTools/JsvTextTools.ts

@@ -58,6 +58,13 @@ const getOneLineTextDrawWidth = (text: string, style: FontStyleDefine) => {
   return Forge.TextUtils.GetOneLineTextDrawWidth(text, style);
 }
 
+const breakLines = (text: string, style: FontStyleDefine, width: number) => {
+  if (text && typeof text != "string") {
+    text = "" + text; // 规避text为非字符串导致接口调用错误的问题
+  }
+  return Forge.TextUtils.BreakLines(text, style, width);
+}
+
 const isRtl = (str: string) => {
   //arabic
   for (let i = 0; i < str.length; i++) {
@@ -152,7 +159,8 @@ const TextTools = {
   isRtl,
   getCursorPosition,
   getCursorPositionCached,
-  recycleCursorPositionCache
+  recycleCursorPositionCache,
+  breakLines
 }
 
 export { getTextWidth, TextTools };

package/utils/JsViewVueTools/JsvTextureStore/BitPalette/BitPalette.ts

@@ -0,0 +1,180 @@
+import ForgeHandles from "../../../JsViewVueTools/ForgeHandles";
+
+
+const enum BitPaletteCommand {
+    Cmd_GetDomainColorSync = 1003,  // 同步，return StringPtr
+    Cmd_SubMapBlob,                 // 异步，回调 jse::Function
+    Cmd_SubMapTextureSync,          // 同步，return StringPtr
+    Cmd_ToStoreTmpBufferSync          // 同步，return buffer id
+}
+
+class BitPaletteCtrl {
+    private _texture: any = null;
+    private _recycled: boolean = false;
+
+    constructor(texture: any) {
+        this._texture = texture;
+    }
+
+    /**
+     * 获取图片的主色调（dominant color），返回一个 Promise，可与 async/await 配合使用。<br>
+     * 使用方式示例：
+     * 
+     * 异步/Promise方式：
+     *   let colorStrJson = await bitPalette.Ctrl.getDomainColorSync();
+     *   if (colorStrJson) {
+     *     let colorsList = JSON.parse(colorStrJson);
+     *     // colorsList 是主色调数组
+     *   }
+     * 
+     */
+    getDomainColorSync(): Promise<any> {
+        let _this = this;
+        return new Promise<any>(async (resolve, reject) => {
+            // 用await关联, 让doCommand的reject时自动触发本Promise的reject
+            await _this.doCommand(BitPaletteCommand.Cmd_GetDomainColorSync, {}, (result: any) => {
+                if (_this._recycled) {
+                    reject();
+                    return;
+                }
+                resolve(result);
+            });
+        });
+    }
+
+    toBlob() : Promise<Blob | null> {
+        let bufferId = ForgeHandles.sRenderBridge.GenStoreBufferId();
+        // 返回一个Promise，同时支持callback
+        let _this = this;
+        return new Promise<Blob | null>(async (resolve, reject) => {
+            // 用await关联, 让doCommand的reject时自动触发本Promise的reject
+            await _this.doCommand(BitPaletteCommand.Cmd_ToStoreTmpBufferSync, {bufId:bufferId}, async () => {
+                if (_this._recycled) {
+                    reject();
+                    return;
+                }
+                let newBlob: Blob = await (Blob as any).jsvCreateFromForge(bufferId);
+                resolve(newBlob);
+            });
+        });
+    }
+
+    // 不是对外接口
+    private doCommand(command: BitPaletteCommand, params: object, callback: ((result: any) => void) | undefined) {
+        // 用asyncPromise来支持 await 语法, 也可以直接用callback
+        let asyncPromise = new Promise((resolve, reject) => {
+            this._texture.doCommand(command, params? JSON.stringify(params) : "{}", (result: any) => {
+                if (this._recycled) {
+                    reject();
+                    return;
+                }
+
+                callback?.(result); // 先回调callback, 再resolve
+                resolve(result);
+            });
+        });
+        return asyncPromise;
+    }
+
+    markRecycled() {
+        this._recycled = true;
+    }
+}
+
+/*
+    ------------------------------------------------------------
+    BitPalette使用最佳实践, Ctrl属性在ready后才能使用
+
+    1. 使用callback方案
+    let hdl = new BitPalette(src, () => {
+        console.log("ready by callback");
+        hdl.Ctrl.doCommand(cmd_id, {...}, (result) => {
+            console.log("result:", result);
+        });
+    });
+
+    2. 使用Promise方案
+    let hdl = new BitPalette(src);
+    try {
+        await hdl.Ready;
+    } catch (error) {
+        console.error("canceled");
+    }
+    let result = await hdl.Ctrl.doCommand(cmd_id, {...});
+
+    3. 使用完毕要释放资源时
+    hdl.recycle();  // 此处理可以在callback之前或者之后都可以, 在callback之前相当于cancel
+
+    ------------------------------------------------------------
+    BitPalette的命令行处理:
+    1. 使用callback方案
+    hdl.Ctrl.doCommand(cmd_id, {...}, (result) => {
+        console.log("result:", result);
+    });
+
+    2. 使用Promise方案(同步或者异步都如此调用)
+    let result = await hdl.Ctrl.doCommand(cmd_id, {...});
+ */
+
+export class BitPalette {
+    private _recycled: boolean = false;
+    private _readyReject: any = null;
+    private _texture: any = null;
+
+    public Ctrl: BitPaletteCtrl | null = null;
+    public Ready: Promise<BitPalette> | null = null;
+
+    constructor(src: string, callback?: () => void) {
+        const setting = { src };
+        this._texture = (ForgeHandles.TextureManager as any).GetImageProcessTexture(
+            JSON.stringify(setting)
+        );
+        // 关掉自动卸载, 靠主动的 RequestToUnload 来卸载
+        this._texture.DisableAutoRecycle();
+
+        // 声明 ready 以支持 await 语法
+        let _this = this;
+        this.Ready = new Promise((resolve, reject) => {
+            this._readyReject = reject;
+            this._texture.RegisterLoadImageCallback(src, () => {
+                if (this._recycled) {
+                    return;
+                }
+
+                // 完成ready后取消readyReject处理
+                this._readyReject = null;
+
+                // 构建 controller 以支持后续的 doCommand 调用
+                this.Ctrl = new BitPaletteCtrl(this._texture);
+
+                callback?.();
+                resolve(_this);
+            });
+        });
+    }
+
+    recycle() {
+        if (this._recycled) {
+            return;
+        }
+        this._recycled = true;
+
+        // 进行promise的reject处理, 保证ready的reject不被遗漏
+        this._readyReject?.();
+        this._readyReject = null;
+        
+        // 释放texture资源
+        this._texture?.RequestToUnload();
+        this._texture = null;
+
+        // 让Ctrl处于recycle状态, 规避异步回调
+        this.Ctrl?.markRecycled();
+    }
+
+    static CommandType = {
+        GetDomainColorSync: BitPaletteCommand.Cmd_GetDomainColorSync,
+        SubMapBlob: BitPaletteCommand.Cmd_SubMapBlob,
+        SubMapTextureSync: BitPaletteCommand.Cmd_SubMapTextureSync,
+        ToStoreTmpBuffer: BitPaletteCommand.Cmd_ToStoreTmpBufferSync,
+    }
+}

package/utils/JsViewVueTools/JsvTextureStore/CanvasTexture/CommandList.ts

@@ -23,3 +23,4 @@ export const PATH_CMD_MOVE_TO = 30;
 export const PATH_CMD_LINE_TO = 31;
 export const PATH_CMD_ARC_TO = 32;
 export const PATH_CMD_CLOSE = 33;
+export const PATH_CUBIC_TO = 34;