@shijiu/jsview-vue 2.2.426-test.0 → 2.3.151-test.0

package/utils/JsViewPlugin/JsvPlayer/AckEventDefine.ts

@@ -0,0 +1,82 @@
+export class AckEventDefine {
+    // Category
+    static CATEGORY_JSC: number = 1;
+    static CATEGORY_VIEW: number = 2;
+    static CATEGORY_EXCEPTION: number = 3;
+
+    // Type of jsc
+    // Content lifeCycle: event格式:
+    // {
+    //      "act": string类型，当前动作，
+    //      		JsContext重载启动时(reload动作，或者loadUrl动作, 以及closeView时): "reset"
+    //				js启动过程事件: 按顺序
+    //					"systemJsLoaded": 系统js加载完成
+    //					"engineJsRead": Engine Js 完成下载
+    //					"engineJsLoaded": Engine Js 完成eval
+    //					"mainJsRead": Main Js 完成下载
+    //					"mainJsLoaded": Main Js 完成 eval
+    //					"appJsStart": 开始运行框架的主入口处理
+    //      "contextId": int类型，发生事件对应的context id，当url切换或者reload时，contentId会发生变化
+    // }
+    static TYPE_JS_CONTEXT_LIFECYCLE: number = 1;
+
+    // Content permission: event格式:
+    // {
+    //      "contextId": int类型，发生事件对应的context id，当url切换或者reload时，contentId会发生变化
+    //      "authDone": int类型  是否完成校验, 0: 还未进行校验,  1: 已完成校验
+    // ================== 授权做完后的信息 ====================
+    // success(bool): 当次授权校验是否通过
+    // showAlert(bool): APP界面右下角展示未授权提示，满足下面条件之一时会展示
+    //                  1. app运行的main.js是未进行签名(签名参考src/appConfig/中的描述)的，提示"npm start 调试模式"
+    //                  2. 仅在在线授权服务器无法达到, 并且达到允许次数时生效(每日累计1次, 最多累计30天), 提示"抢先版内核"
+    //                  3. 远程授权api返回结果为未授权时
+    //                  4. 本地有授权文件，但授权文件不合法或者过期
+    // errorCount(int): 在线授权api访问失败(网络不通)的累计次数, api访问到并拿到结果后清0
+    // checkType(int): 授权的校验方式, 1: 调试模式, 2: 本地文件校验的方式, 3: 在线校验方式
+    // customDescribe: 授权的描述, 许可范围等描述
+    // errorCode: 授权失败的错误码
+    //     -1: apk签名不匹配(仅离线校验时)
+    //     -2: js的app name未登记
+    //     -3: js的app签名和app name登记信息不匹配
+    //     -4: permission.js文件过期
+    //     -5: core版本不匹配
+    //     -6: 分支名不匹配
+    //     -7: 在线鉴权时未通过的统一错误码(后台详细错误码搭建中...)
+    //     -8: 页面为npm start的调试模式(开发人员调试时才会出现此状态)
+    //     -101: 本地permission.js文件格式错误
+    //     -102: permission.js文件授权信息中core版本无法正确解析为数字错误
+    //     -103: permission.js文件授权信息中的日期格式错误
+    //     -105: 在线鉴权api请求失败错误
+    // playerMaxVer(int): 播放器授权的最高版本(0000 00000) 前4位为渠道号，后5位为版本号
+    // }
+    static TYPE_JS_CONTEXT_PERMISSION: number = 2;
+
+    // Type of view
+    // Shared view layout: event格式:
+    // {
+    //      "x": int类型，对应view更新到了x位置,
+    //      "y": int类型，对应view更新到了y位置,
+    //      "width": int类型，对应view宽度更新后的值,
+    //      "height": int类型，对应view高度更新后的值,
+    //      "mat4": native指针类型, view的位置信息的matrix,
+    //      "visible": int类型, view是否可见,(0:不可见, 1:可见)
+    //      "order": int类型, 本NativeSharedView的相对图层
+    //      "dw": int类型，Design map width，用于换算x,y,width,height
+    // }
+    static TYPE_SHARED_VIEW_LAYOUT: number = 1;
+
+    // app view aspect ratio change: event格式:
+    // {
+    //      "width": int类型，横轴比例，对应"16/9"中的16,
+    //      "height": int类型，纵轴比例，对应"16/9"中的9,
+    // }
+    static TYPE_APP_ASPECT_RATIO_CHANGE: number = 2;
+
+    // Type of exception
+    // Unhandled exit action: event格式:
+    // {
+    //      "reason": string类型，触发离开动作的触发器，例如: "backKey",
+    //      "comment": string类型, 当BackKey场景, 为"keyDown"和"keyUp"
+    // }
+    static TYPE_EXCEPTION_UNHANDLED_EXIT_ACTION: number = 1;
+}

package/utils/JsViewPlugin/JsvPlayer/BrowserJsvPlayer.vue

@@ -1,7 +1,9 @@
 <script>
 import { Forge } from "@shijiu/jsview/dom/jsv-forge-define";
+import { AckEventDefine } from "./AckEventDefine.ts";
 import playerExMethods from "./JsvMediaBrowserInterface.js";
 import { shallowRef } from "vue";
+import { JsvNativeSharedDiv } from "jsview";
 
 let logDebug = console.log;
 
@@ -276,14 +278,16 @@ export default {
      */
     corner: { type: Number, default: 0 },
   },
-  components: {},
+  components: {
+    JsvNativeSharedDiv,
+  },
   watch: {
     active(newValue) {
-      console.log("LudlDebug active newValue: " + newValue);
+      console.log("active newValue: " + newValue);
       if (this.video) {
         if (newValue) {
           this.registerEvent();
-          this.video.setHoleID(this.holeId);
+          // this.video.setHoleID?.(this.holeId);
           this.holeStyle = {
             left: 0,
             top: 0,
@@ -332,8 +336,7 @@ export default {
     return {
       video: null,
       holeId: "",
-      jsvMainView: shallowRef(null),
-      innerViewId: shallowRef(-1),
+      positionAckFunc: null,
     };
   },
 
@@ -370,8 +373,35 @@ export default {
     if (!this.video) {
       // 创建PC版本的video标签
       this.video = window.originDocument.createElement("video");
+      this.video.style.position = "absolute";
+      this.video.style.zIndex = -100;
       this._extendsApi(this.video);
-      this.video.style.borderRadius = this.corner + "px";
+
+      const appElement = window.originDocument.getElementById("app");
+      document.body.insertBefore(this.video, appElement);
+
+      // 跟踪视频显示位置
+      let _this = this;
+      this.positionAckFunc = (event_json) => {
+        // 跟踪JsvNativeShared的位置变化
+        let new_pos = JSON.parse(event_json);
+        this.video.style.left =
+          window.JsvCoreApi.WasmExt.measurePosition(new_pos.x) + "px";
+        this.video.style.top =
+          window.JsvCoreApi.WasmExt.measurePosition(new_pos.y) + "px";
+
+        this.video.style.width =
+          window.JsvCoreApi.WasmExt.measurePosition(new_pos.width) + "px";
+        this.video.style.height =
+          window.JsvCoreApi.WasmExt.measurePosition(new_pos.height) + "px";
+      };
+
+      window.JsvCoreApi.WasmExt.listenerToAckEvent(
+        AckEventDefine.CATEGORY_VIEW,
+        AckEventDefine.TYPE_SHARED_VIEW_LAYOUT,
+        this.holeId,
+        this.positionAckFunc
+      );
     } else {
       this.video.setRef();
       first_create = false;
@@ -421,24 +451,20 @@ export default {
         }
       }
 
-      // 创建挂载的VideoView
-      this.jsvMainView = new Forge.VideoView(this.video, null);
-      this.innerViewId = Forge.sViewStore.add(
-        new Forge.ViewInfo(this.jsvMainView)
-      );
-
       this.onRef?.(this.video);
     }
   },
 
   unmounted() {
     if (this.video != null) {
-      // 清理View管理缓存
-      if (this.innerViewId !== -1) {
-        Forge.sViewStore.remove(this.innerViewId);
-        this.innerViewId = -1;
-        this.jsvMainView = null;
+      // 清理video标签
+      document.body.removeChild(this.video);
+
+      // 解除NativeSharedDiv对应的位置监听
+      if (this.positionAckFunc != null) {
+        window.JsvCoreApi.WasmExt.recycleAckListener(this.positionAckFunc);
       }
+
       this.onRef?.(null);
     }
   },
@@ -467,7 +493,7 @@ export default {
         this.video.addEventListener("canplaythrough", this.onCanPlayThrough);
         this.video.addEventListener("progress", this.onProgress);
         this.video.addEventListener("loadedmetadata", this.onLoadedMetaData);
-        this.video.addEventListener("load", this.onLoad);
+        this.video.addEventListener("loadeddata", this.onLoad);
         this.video.addEventListener("durationchange", this.onDurationChange);
         this.video.addEventListener("seeking", this.onSeeking);
         this.video.addEventListener("seeked", this.onSeeked);
@@ -495,23 +521,15 @@ export default {
 </script>
 
 <template>
-  <div
+  <jsv-native-shared-div
     :style="{
       ...holeStyle,
-      backgroundColor: 'rgba(0,0,0,1)',
-      borderRadius: corner,
+      left: this.style.left,
+      top: this.style.top,
     }"
-  >
-    <div
-      :style="{
-        left: holeStyle.left,
-        top: holeStyle.top,
-        width: holeStyle.width,
-        height: holeStyle.height,
-      }"
-      :data-jsv-vw-innerview="innerViewId"
-    />
-  </div>
+    :getId="getHoleId"
+    :corner="corner"
+  />
 </template>
 
 <style scoped></style>

package/utils/JsViewVueTools/FeatureActive.ts

@@ -53,7 +53,8 @@ function JsvUseFeature(from: String, comp_name: String) {
         return;
     }
 
-    console.error(`Error: ${comp_name}(from ${from}) is not activated, need JsvActiveFeature(JsvFeatureNames.${comp_name}) in boot`);
+    // 未激活简易提示, need JsvActiveFeature(JsvFeatureNames.${ comp_name }) in boot`);
+    console.log(`LOG: ${comp_name}(from ${from}) is not activated`);
 }
 
 // 备用接口: 防止未授权组件被错误激活引起的崩溃和水印显示

package/utils/JsViewVueTools/ForgeHandles.ts

@@ -1,11 +1,13 @@
 let handles: {
     TextureManager: any,
     RootView: any,
-    RootActivity: any
+    RootActivity: any,
+    sRenderBridge: any
 } = {
     TextureManager: null,
     RootView: null,
-    RootActivity: null
+    RootActivity: null,
+    sRenderBridge: null
 }
 
 const jsvCode = (window as any).JsvCode;
@@ -13,6 +15,7 @@ jsvCode.ForgeHandles.listenToReady(() => {
     handles.TextureManager = jsvCode.ForgeHandles.TextureManager;
     handles.RootView = jsvCode.ForgeHandles.RootView;
     handles.RootActivity = jsvCode.ForgeHandles.RootActivity;
+    handles.sRenderBridge = jsvCode.ForgeHandles.sRenderBridge;
 })
 
 export default handles;

package/utils/JsViewVueTools/JsvRuntimeBridge.js

@@ -14,9 +14,9 @@ function direct_call(name, ...args) {
     } else {
         let func = null;
         if (window.jJsvRuntimeBridge && typeof window.jJsvRuntimeBridge[name] === "function") {
-            func = window.jJsvRuntimeBridge[name];
+            func = window.jJsvRuntimeBridge[name].bind(window.jJsvRuntimeBridge);
         } else if (window.jContentShellJBridge && typeof window.jContentShellJBridge[name] === "function") {
-            func = window.jContentShellJBridge[name];
+            func = window.jContentShellJBridge[name].bind(window.jContentShellJBridge);
         }
         direct_call_map[name] = func;
         if (func) {
@@ -112,6 +112,31 @@ function openWindow(url, startup_image, startup_video, startup_duration, add_his
     return window.jJsvRuntimeBridge.openWindow(url, JSON.stringify(setting))
 }
 
+/**
+ * 打开另外一个小程序
+ * @param {string} url 小程序url
+ * @param {string} startup_image 启动图url
+ * @param {string} startup_video 启动视频url
+ * @param {int} startup_duration 启动图时长，默认0
+ * @param {int} add_history 是否添加历史，0不添加，1添加
+ * @returns {Promise} 
+ */
+function openApp(url, startup_image, startup_video, startup_duration, add_history) {
+    let setting = {};
+    if (startup_image !== null && startup_image !== "")
+        setting.startupImage = startup_image;
+
+    if (startup_video !== null && startup_video !== "") {
+        setting.startupVideo = startup_video;
+    }
+
+    setting.startupDuration = startup_duration;
+    setting.addHistory = (add_history ? 1 : 0); // 兼容true/false传值
+
+    // direct_call("openWindow", url, JSON.stringify(setting));
+    return window.jJsvRuntimeBridge.openApp(url, JSON.stringify(setting))
+}
+
 /**
  * 用新的进程打开另外一个小程序
  * @param {string} url 小程序url
@@ -136,6 +161,30 @@ function startUrlInNewTab(url, startup_image, startup_video, startup_duration, a
     return window.jJsvRuntimeBridge.startUrlInNewTab(url, JSON.stringify(setting))
 }
 
+/**
+ * 用新的进程打开另外一个小程序
+ * @param {string} url 小程序url
+ * @param {string} startup_image 启动图url
+ * @param {string} startup_video 启动视频url
+ * @param {int} startup_duration 启动图时长，默认0
+ * @param {int} add_history 是否添加历史，0不添加，1添加
+ * @returns {Promise} 
+ */
+function openAppInNewTab(url, startup_image, startup_video, startup_duration, add_history) {
+    let setting = {};
+    if (startup_image !== null && startup_image !== "")
+        setting.startupImage = startup_image;
+
+    if (startup_video !== null && startup_video !== "") {
+        setting.startupVideo = startup_video;
+    }
+
+    setting.startupDuration = startup_duration;
+    setting.addHistory = (add_history ? 1 : 0); // 兼容true/false传值
+
+    return window.jJsvRuntimeBridge.openAppInNewTab(url, JSON.stringify(setting))
+}
+
 /**
  * 用于给上一个小程序返回结果，通常与startUrlInNewTab和openWindow配合使用
  * @param {string} data 返回给上一个小程序的结果
@@ -202,9 +251,10 @@ function getInstalledApps() {
  * @param {string} uri Uri方式启动
  * @param {Array} flags 数组，用于intent.addFlags
  * @param {Array} param JSON格式数组，数组元素是 object ，object中的内容用于intent.putExtra
+ * @param {Array} category string数组，用于intent.addCategory
  *
  */
-function startNativeApp(package_name, activity, action, uri, flags, param) {
+function startNativeApp(package_name, activity, action, uri, flags, param, category) {
     var obj = {};
     if (package_name !== null && package_name !== "")
         obj.packageName = package_name;
@@ -224,9 +274,52 @@ function startNativeApp(package_name, activity, action, uri, flags, param) {
     if (param !== null && param.length > 0)
         obj.param = param;
 
+    if (category!==null && category.length > 0)
+        obj.category = category
+
     direct_call("startNativeApp", JSON.stringify(obj));
 }
 
+/**
+ * 启动安卓APP
+ * @param {string} package_name 包名
+ * @param {string} activity Activity方式启动
+ * @param {string} action Action方式启动
+ * @param {string} uri Uri方式启动
+ * @param {Array} flags 数组，用于intent.addFlags
+ * @param {Array} param JSON格式数组，数组元素是 object ，object中的内容用于intent.putExtra
+ * @param {Array} category string数组，用于intent.addCategory
+ *
+ */
+function openNativeApp(package_name, activity, action, uri, flags, param, category) {
+    var obj = {};
+    if (package_name !== null && package_name !== "")
+        obj.packageName = package_name;
+
+    if (activity !== null && activity !== "")
+        obj.activity = activity;
+
+    if (action !== null && action !== "")
+        obj.action = action;
+
+    if (uri !== null && uri !== "")
+        obj.uri = uri;
+
+    if (flags !== null && flags.length > 0)
+        obj.flags = flags;
+
+    if (param !== null && param.length > 0)
+        obj.param = param;
+
+    if (category!==null && category.length > 0)
+        obj.category = category
+
+
+    // return window.jJsvRuntimeBridge.openNativeApp(JSON.stringify(obj));
+    return direct_call("openNativeApp", JSON.stringify(obj));
+}
+
+
 /**
  * 发送安卓广播
  * @param {string} package_name 包名
@@ -600,6 +693,14 @@ function providerUpdate(uri, contentValue, selection, selectionArgs) {
     return direct_call("providerUpdate", uri, contentValue ? JSON.stringify(contentValue) : null, selection, selectionArgs ? JSON.stringify(selectionArgs) : null)
 }
 
+/**
+ * 
+ * @returns 设备开机时长
+ */
+function getBootTime(){
+    return direct_call("getBootTime")
+}
+
 
 // 显示声明，可以提高执行速度和利用上编辑器的成员名提示功能
 const bridge = {
@@ -609,7 +710,9 @@ const bridge = {
     getDeviceUUID,
     getAndroidId,
     openWindow,
+    openApp,
     startUrlInNewTab,
+    openAppInNewTab,
     onWindowResult,
     reloadWindow,
     closePage,
@@ -617,6 +720,7 @@ const bridge = {
     getSystemProperty,
     getInstalledApps,
     startNativeApp,
+    openNativeApp,
     sendNativeBroadcast,
     startService,
     getDeviceInfo,
@@ -645,7 +749,8 @@ const bridge = {
     providerQuery,
     providerInsert,
     providerDelete,
-    providerUpdate
+    providerUpdate,
+    getBootTime
 };
 
 export {

package/utils/JsViewVueTools/JsvTextTools.ts

@@ -24,7 +24,9 @@ declare interface FontStyleDefine {
  * @return {int} 文字宽度
  **/
 const getTextWidth = (text: string, style: FontStyleDefine) => {
-  let forgeRef = Forge;
+  if (text && typeof text != "string") {
+    text = "" + text; // 规避text为非字符串导致接口调用错误的问题
+  }
   return Forge.TextUtils.GetTextWidth(text, style);
 };
 

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

@@ -1,5 +1,29 @@
 import * as Constants from "./CommandList"
 
+/**
+ * PathStrokeSetting
+ * 描边样式设定
+ * lineWidth: 描边线宽
+ * color: 描边颜色
+ * dash: 描边虚线样式，例如[10, 5]表示10px实线，5px虚线，交替出现
+ * phase: 描边虚线样式起始位置，例如0表示从虚线开始位置开始绘制
+ */
+interface PathStrokeSetting {
+    lineWidth: Number,
+    color: String,
+    dash?: Array<Number>,
+    phase?: Number
+}
+
+function pathStrokeSettingToJson(setting: PathStrokeSetting): Object {
+    return {
+        "lineWidth": setting.lineWidth,
+        "clr": setting.color,
+        "dash": setting.dash,
+        "phase": setting.phase
+    }
+}
+
 class DrawingPath {
     protected drawCommandsRefs: Array<Object> = [];
     protected finishedDraw: boolean = false; // 控制stroke和fill只能调用一次
@@ -16,6 +40,19 @@ class DrawingPath {
      * @param {String} color 颜色设定，例如rgba(red:0~255, green:0~255, blue:0~255, alpla:0~1.0), 或则 #AARRGGBB
      */
     public stroke(lineWidth: Number, color: String) {
+        this.strokeWithSetting({
+            lineWidth: lineWidth,
+            color: color,
+        });
+    }
+
+    /**
+     * strokeWithSetting
+     * 绘制边框，并设置描边样式
+     * 
+     * @param {PathStrokeSetting} setting 描边样式设定
+     */
+    public strokeWithSetting(setting: PathStrokeSetting) {
         if (this.finishedDraw) {
             console.error("Error: path can only draw once");
             return;
@@ -24,8 +61,7 @@ class DrawingPath {
         this.drawCommandsRefs.push({
             "cmd": Constants.CMD_PREPARE_PAINT,
             "type": "stroke",
-            "lineWidth": lineWidth,
-            "clr": color
+            ...pathStrokeSettingToJson(setting)
         });
         this.onFinishDraw(); // 调用继承类的完成处理执行绘制
         this.finishedDraw = true;

package/utils/JsViewVueTools/JsvTextureStore/CapturedTexture/CapturedTexture.ts

@@ -6,18 +6,19 @@ export type CapturedCallback = (
   textureAccessName: string,
   autoRecycleSet: boolean,
   width: number,
-  height: number) => void;
+  height: number,
+  isCannceled: boolean) => void;
 
 export class CapturedTexture extends TextureBase {
-  private _AutoRecycle: boolean;
   private _Callback: CapturedCallback | null;
   private _CaptureDiv: any;
   private _Canceled: boolean = false;
-
+  private _PostProcessParams: any = null;
   constructor(
     captureDiv: any,
     callback: CapturedCallback,
-    autoRecycle: boolean) {
+    autoRecycle: boolean,
+    postProcessParams: any = null) {
     super(null);
 
     // 激活引擎的功能支持
@@ -25,12 +26,14 @@ export class CapturedTexture extends TextureBase {
 
     this._CaptureDiv = captureDiv;
     this._Callback = callback;
-    this._AutoRecycle = autoRecycle;
+    this.autoRecycle = autoRecycle;
+    this._PostProcessParams = postProcessParams;
   }
 
   // 清理对Callback和div的引用，防止泄露
   cancel() {
     if (!this._Canceled) {
+      this._Callback?.("", this.autoRecycle, 0, 0, true);
       this._Callback = null;
       this._CaptureDiv = null;
       this._Canceled = true;
@@ -47,18 +50,18 @@ export class CapturedTexture extends TextureBase {
           return;
         }
 
-        // 处理自动回收
-        if (!this._AutoRecycle) {
-          this.addToStore(); // 用TextureStore来跟进引用状态
-        }
+        //由于自动回收是三帧后回收, 所以需要先添加到store
+        this.addToStore();
 
         // 回调
         this._Callback?.(
           this.getStoreName(),
-          this._AutoRecycle,
+          this.autoRecycle,
           resultObj.width as number,
-          resultObj.height as number);
-      }
+          resultObj.height as number,
+          false);
+      },
+      this._PostProcessParams
     );
     return '';
   }

package/utils/JsViewVueTools/JsvTextureStore/DominantColor/GetDominantColor.ts

@@ -0,0 +1,36 @@
+import ForgeHandles from "../../../JsViewVueTools/ForgeHandles";
+/**
+ * 使用ForgeTexture获取图片的dominant color, 注意, 此方法会hold住texture资源, 需要保证组件unmount时调用释放处理
+ * @param src 图片的src
+ * @param cbk 回调函数, 参数: info
+ * @returns 用于cancel的句柄，当cancel时，会清理对div和Callback的引用
+ */
+export function getDominantColorByForgeTexture(
+  src: string,
+  cbk: (i: any) => void
+) {
+  if (!src) {
+    console.warn("getDominantColorByForgeTexture: src is empty");
+    return () => {};
+  }
+  const setting = { src };
+  let texture = (ForgeHandles.TextureManager as any).GetImageProcessTexture(
+    JSON.stringify(setting)
+  );
+  let canceled = false;
+  const callback = (info: any) => {
+    if (canceled) {
+      return;
+    }
+    cbk(info.extra);
+    texture?.RequestToUnload();
+    texture = null;
+  };
+  texture.DisableAutoRecycle();
+  texture.RegisterLoadImageCallback(src, callback, null);
+  return () => {
+    canceled = true;
+    texture?.RequestToUnload();
+    texture = null;
+  };
+}

package/utils/JsViewVueTools/JsvTextureStore/JsvTextureStore.ts

@@ -19,6 +19,7 @@
 import CanvasTexture from "./CanvasTexture/CanvasTexture";
 import { CapturedTexture, CapturedCallback } from "./CapturedTexture/CapturedTexture";
 import sStore from "./Store";
+import { getDominantColorByForgeTexture } from "./DominantColor/GetDominantColor";
 
 let sJsvTextureConst = {
     LEFT: 1,
@@ -38,7 +39,7 @@ let sTextureStoreApi = {
      * @param {String|null} baseName 可选, 访问名的前缀信息
      * @return {CanvasTexture}
      */
-    canvasTexture: (width: Number, height: Number, baseName: String | null): CanvasTexture => {
+    canvasTexture: (width: Number, height: Number, baseName: String | null = null): CanvasTexture => {
         return new CanvasTexture(width, height, baseName);
     },
 
@@ -65,14 +66,16 @@ let sTextureStoreApi = {
                                     不需要主动调用deleteTexture释放.
                                     false: 此场景在callback收到资源名后, 需要使用完毕后调用 deleteTexture 手动释放
                                     在手动释放之前，可以赋给其他div/img来复用 
+     * @param {any} postProcessParams 可选, 截图处理的参数
      * @return {CapturedTexture} 用于cancel的句柄，当cancel时，会清理对div和Callback的引用
      */
     capture2Texture: (
         captureDiv: any,
         callback: CapturedCallback,
-        autoRecycle: boolean = true): CapturedTexture => {
+        autoRecycle: boolean = true,
+        postProcessParams: any = null): CapturedTexture => {
 
-        let texture = new CapturedTexture(captureDiv, callback, autoRecycle);
+        let texture = new CapturedTexture(captureDiv, callback, autoRecycle, postProcessParams);
         texture.commit();
 
         return texture;
@@ -91,8 +94,26 @@ let sTextureStoreApi = {
             textureRef.recycle();
         }
     },
+
+    /**
+     * getDominantColor
+     * 获取图片的 dominant color
+     * 
+     * @param src 图片的src
+     * @param callback 回调函数, 参数: info
+     * @return 用于cancel的句柄，当cancel时，会清理对div和Callback的引用
+     */
+    getDominantColor: (src: string, callback: (info: any) => void) => {
+        return getDominantColorByForgeTexture(src, (i: any) => {
+            callback(i);
+        });
+    }
 }
 
+export enum CaptureProcessType {
+    Blur = 1,
+  }
+
 export {
     sTextureStoreApi as JsvTextureStoreApi,
     sJsvTextureConst as JsvTextureConst,