@shijiu/jsview-vue 2.2.35 → 2.2.128

package/utils/JsViewVueTools/ConstSymbol.ts

@@ -0,0 +1,3 @@
+
+export const VERTICAL: Symbol = Symbol("vertical");
+export const HORIZONTAL: Symbol = Symbol("horizontal");

package/utils/JsViewVueTools/ForgeConstDefine.ts

@@ -0,0 +1,11 @@
+export namespace ForgeConst {
+    export namespace DragFlags {
+        export const TOUCH_RECV_CLICK_BIT: number = 0b1;
+        export const TOUCH_RECV_LONGPRESS_BIT: number = 0b10;
+        export const TOUCH_RECV_MOVE_BIT: number = 0b100;
+        export const TOUCH_RECV_FLING_BIT: number = 0b100000;
+        export const TOUCH_RECV_FIRST_START: number = 0b1000;
+        export const TOUCH_RECV_LAST_END: number = 0b10000;
+        export const DRAG_ANY: number = 0xFFFFFF;
+    }
+}

package/utils/JsViewVueTools/JsvRuntimeBridge.js

@@ -1,5 +1,3 @@
-/* eslint-disable no-prototype-builtins */
-
 let feature_supports = null;
 
 let direct_call_map = {};
@@ -25,7 +23,7 @@ function direct_call(name, ...args) {
     return null;
 }
 
-/*!
+/**
  * 获取当前集成JsView的APP目前支持的扩展功能列表
  *
  * @returns {string} 功能列表，以逗号隔开，包含:
@@ -40,7 +38,7 @@ function getExtFeatureSupports() {
     return feature_supports;
 }
 
-/*!
+/**
  * 获取设备mac地址，优先获取有线mac，无则获取wifi mac
  * @returns {string} mac address
  *
@@ -49,7 +47,7 @@ function getMac(){
     return direct_call("getMac");
 }
 
-/*!
+/**
  * 获取设备有线mac地址
  * @returns {string} mac address
  *
@@ -58,7 +56,7 @@ function getWireMac(){
     return direct_call("getWireMac");
 }
 
-/*!
+/**
  * 获取设备wifi mac地址
  * @returns {string} mac address
  *
@@ -67,7 +65,7 @@ function getWifiMac(){
     return direct_call("getWifiMac");
 }
 
-/*!
+/**
  * 获取设备UUID
  * @returns {string} UUID
  *
@@ -76,7 +74,7 @@ function getDeviceUUID(){
     return direct_call("getDeviceUUID");
 }
 
-/*!
+/**
  * 获取设备Android ID
  * @returns {string} Android ID
  *
@@ -85,31 +83,87 @@ function getAndroidId(){
     return direct_call("getAndroidId");
 }
 
-/*!
+/**
  * 打开另外一个小程序
  * @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 openWindow(url, startup_image, startup_video, startup_duration, add_history){
     let setting = {};
-    if(typeof startup_image !== undefined && startup_image !== null && startup_image !== "")
+    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.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 startUrlInNewTab(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.startUrlInNewTab(url, JSON.stringify(setting))
+}
+
+/**
+ * 用于给上一个小程序返回结果，通常与startUrlInNewTab和openWindow配合使用
+ * @param {string} data 返回给上一个小程序的结果
+ */
+function onWindowResult(data){
+    direct_call("onWindowResult",data)
+}
+
+/**
+ * 重新加载一个小程序覆盖当前小程序
+ * @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添加
+ */
+function reloadWindow(url, startup_image, startup_video, startup_duration, add_history){
+    let setting = {};
+    if(startup_image !== null && startup_image !== "")
         setting.startupImage = startup_image;
 
-    if(typeof startup_video !== undefined && startup_video !== null && startup_video !== ""){
+    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.reloadWindow(url, JSON.stringify(setting))
 }
 
-/*!
+/**
  * 关闭当前小程序
  *
  */
@@ -117,9 +171,9 @@ function closePage(){
     direct_call("closePage");
 }
 
-/*!
- * 获取设备UUID
- * @param {string} key 属性名称
+/**
+ * 获取系统属性
+ * @param {string} key 属性名称，比如：ro.product.model。
  * @returns {string} 属性值
  *
  */
@@ -127,7 +181,7 @@ function getSystemProperty(key){
     return direct_call("getSystemProperty", key);
 }
 
-/*!
+/**
  * 获取已安装应用列表
  * @returns {string} 应用列表，JSON结构的数组
  *
@@ -136,39 +190,49 @@ function getInstalledApps(){
     return direct_call("getInstalledApps");
 }
 
-/*!
+/**
  * 启动安卓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格式数组，用于intent.putExtra
+ * @param {Array} param JSON格式数组，数组元素是 object ，object中的内容用于intent.putExtra
  *
  */
 function startNativeApp(package_name, activity, action, uri, flags, param){
     var obj = {};
-    if(typeof package_name != undefined && package_name !== null && package_name !== "")
+    if(package_name !== null && package_name !== "")
         obj.packageName = package_name;
 
-    if(typeof activity != undefined && activity !== null && activity !== "")
+    if(activity !== null && activity !== "")
         obj.activity = activity;
 
-    if(typeof action != undefined && action !== null && action !== "")
+    if(action !== null && action !== "")
         obj.action = action;
 
-    if(typeof uri != undefined && uri !== null && uri !== "")
+    if(uri !== null && uri !== "")
         obj.uri = uri;
 
-    if(typeof flags != undefined && flags !== null && flags.length > 0)
+    if(flags !== null && flags.length > 0)
         obj.flags = flags;
 
-    if(typeof param != undefined && param !== null && param.length > 0)
+    if(param !== null && param.length > 0)
         obj.param = param;
 
     direct_call("startNativeApp", JSON.stringify(obj));
 }
 
+/**
+ * 发送安卓广播
+ * @param {string} package_name 包名
+ * @param {string} broadcast 广播类名，比如“com.qcode.MyBroadcastReceiver”，用于intent.setComponent()
+ * @param {string} action 对应 intent.setAction()
+ * @param {string} uri 对应intent.setData()
+ * @param {Array} flags 数组，用于intent.addFlags
+ * @param {Array} param JSON格式数组，数组元素是 object ，object中的内容用于intent.putExtra
+ *
+ */
 function sendNativeBroadcast(package_name, broadcast, action, uri, flags, param){
 
     var obj = {};
@@ -192,7 +256,41 @@ function sendNativeBroadcast(package_name, broadcast, action, uri, flags, param)
     direct_call("sendNativeBroadcast", JSON.stringify(obj));
 }
 
-/*!
+/**
+ * 启动Android 服务
+ * @param {string} package_name 包名
+ * @param {string} services 服务类名，比如“com.qcode.MyService”，用于intent.setComponent()
+ * @param {string} action 对应 intent.setAction()
+ * @param {string} uri 对应intent.setData()
+ * @param {Array} flags 数组，用于intent.addFlags
+ * @param {Array} param JSON格式数组，数组元素是 object ，object中的内容用于intent.putExtra
+ * @param {boolean} is_foreground 是否使用startForegroundService
+ *
+ */
+function startService(package_name, services, action, uri, flags, param,is_foreground){
+
+    var obj = {};
+    if(typeof package_name != undefined && package_name !== null && package_name !== "")
+        obj.packageName = package_name;
+
+    if(typeof services != undefined && services !== null && services !== "")
+        obj.services = services;
+
+    if(typeof action != undefined && action !== null && action !== "")
+        obj.action = action;
+
+    if(typeof uri != undefined && uri !== null && uri !== "")
+        obj.uri = uri;
+
+    if(typeof flags != undefined && flags !== null && flags.length > 0)
+        obj.flags = flags;
+
+    if(typeof param != undefined && param !== null && param.length > 0)
+        obj.param = param;
+    direct_call("startServices", JSON.stringify(obj),is_foreground);
+}
+
+/**
  * 获取设备信息
  * @returns {string} 终端设备信息，JSON数据结构
  *
@@ -201,7 +299,7 @@ function getDeviceInfo() {
     return direct_call("getDeviceInfo");
 }
 
-/*!
+/**
  * 获取自己的app信息
  * @returns 
  */
@@ -209,7 +307,7 @@ function getAppInfo(){
     return direct_call("getAppInfo");
 }
 
-/*!
+/**
  * 页面加载成功后调用去除启动图
  *
  */
@@ -224,7 +322,7 @@ function notifyPageLoaded() {
     direct_call("notifyPageLoaded");
 }
 
-/*!
+/**
  * 是否支持收藏功能
  * @returns {boolean} true支持，false不支持
  *
@@ -237,7 +335,7 @@ function hasFavouriteFunction(){
     return false;
 }
 
-/*!
+/**
  * 获取启动内核版本和引擎
  * @returns {Object} 包含
  *      COREVERSIONRANGE: 启动时设定的内核版本范围
@@ -252,7 +350,7 @@ function getStartParams() {
     }
 }
 
-/*!
+/**
  * 添加收藏
  * @param {string} url 收藏的url
  * @param {function} callback  执行接口回调, 处理可能被用户否决
@@ -273,7 +371,7 @@ function addFavourite(url, callback) {
     }
 }
 
-/*!
+/**
  * 更新收藏
  * @param {string} url 收藏的url
  * @param {function} callback  执行接口回调, 处理可能被用户否决
@@ -294,7 +392,7 @@ function updateFavourite(url, callback) {
     }
 }
 
-/*!
+/**
  * 删除指定收藏
  * @param {string} app_name app name 唯一标识
  * @param {function} callback  执行接口回调, 处理可能被用户否决
@@ -315,7 +413,7 @@ function removeFavourite(app_name, callback) {
     }
 }
 
-/*!
+/**
  * 获取指定收藏
  * @param {string} app_name app name 唯一标识
  */
@@ -326,7 +424,7 @@ function getFavourite(app_name) {
     return null;
 }
 
-/*!
+/**
  * 获取所有收藏
  *
  */
@@ -337,7 +435,7 @@ function getFavouriteAll() {
     return null;
 }
 
-/*!
+/**
  * 浮窗控制接口，设置从本浮窗界面进行预热的二级浮窗的启动默认尺寸(若不设置则为全屏)
  * @param {string} mode    全屏模式还是需要Resize的模式。取值范围: "full" 或者 "mini"
  *                         设置成 "mini" 模式后，启动后的界面内需要调用popupResizePosition来调整尺寸才能可见
@@ -346,7 +444,7 @@ function setPopupInitSize(mode) {
     direct_call("setPopupInitSize", mode);
 }
 
-/*!
+/**
  * 浮窗控制接口，设置浮窗显示区域，以相对定位的方式调整弹出框的位置(弹出框弹出后先以尺寸1x1的方式展现)
  * @param {string} align    横纵对齐方式，有left, right, bottom, top, center可选择
  *                          例如: 右下角"right bottom", 居中"center center"
@@ -359,7 +457,7 @@ function popupResizePosition(align, max_width, max_height, aspect) {
     direct_call("popupResizePosition", align, max_width, max_height, aspect);
 }
 
-/*!
+/**
  * 浮窗系统认为自己准备好后，调用此接口，获取设备的焦点。若不调用的话，默认浮窗系统捕获的焦点
  */
 function popupGainFocus() {
@@ -370,7 +468,7 @@ function popupDiscardFocus(){
     direct_call("popupGainFocus");
 }
 
-/*!
+/**
  * 页面预热接口，预热页面将会将以一个新的FrameLayout(内含JsView)的方式加载一个新的应用
  * 但这个应用在warmLoadView之前，不会创建texture/surface的实际描画资源，也不会加载图片
  * 仅加载所有JS代码，并正常走完所有启动逻辑(包括描画逻辑)，但不会走setTimeout对应的延时逻辑，也不会显示
@@ -380,7 +478,7 @@ function popupDiscardFocus(){
  * 【特别注意】warmUp起来的view，在warmLoadView调用之前，若启动者JsView关闭的话，此View应该在
  *  View管理模块被清理掉，以防泄露，但在warmLoadView完成后，就不需要进行关联清理，请管理模块务必保证此机制。
  * [参数]
- *      int mode  预热模式，1:全预热，2:半预热
+ *      int mode  预热模式，1:全预热,目前只支持1
  *      String app_url  要预热的app_url，当半预热时，可以为null
  * [返回值]
  *      int: 为view_refer_id值，预热后的View的ID，用于后续的warmLoadView和closeWarmView使用
@@ -399,20 +497,20 @@ function warmUpView(mode, app_url) {
     return direct_call("warmUpView", mode, app_url);
 }
 
-/*!
+/**
  * 将warmUpView后的View展示出来
- * 若warmUpView中app_url不为null，进行了全预热，则本调用的app_url可以为null
  * 当warmUpView中设置了app_url时，仍可以新的app_url调整history hash(#)部分进行子页面切换
  *
  * @param {number} view_refer_id warmUpView调用后返回来的View ID
- * @param {string} app_url      界面的应用地址，支持?(search)和#(hash)字段
+ * @param {string} app_url     无意义，请传固定值 null
  * @param {boolean} add_history 启动的界面是否进访问历史列表
+ * @returns {Promise} 可用于监听新的小程序返回的结果
  */
 function warmLoadView(view_refer_id, app_url, add_history) {
     direct_call("warmLoadView", view_refer_id, app_url, !!add_history);
 }
 
-/*!
+/**
  * 关闭warmUp后未进行warmLoad的View，释放资源
  * @param {number} view_refer_id warmUpView调用后返回来的View ID
  */
@@ -420,7 +518,7 @@ function closeWarmedView(view_refer_id) {
     direct_call("closeWarmedView", view_refer_id);
 }
 
-/*!
+/**
  * 触发预下载内核
  * @param {string} core_version 带branch(主分支版本不带此信息)和版本信息的内核版本, 
  *                              例如: 1021265_release_build_xxx
@@ -430,20 +528,37 @@ function preDownloadSdk(core_version){
     return direct_call("preDownloadSdk", core_version);
 }
 
-//! 显示声明，可以提高执行速度和利用上编辑器的成员名提示功能
-export const jJsvRuntimeBridge = {
+function getNetworkTypeStatusImmediate(){
+    return direct_call("getNetworkTypeStatusImmediate");
+}
+
+function registerNetStateListener(callback){
+    return direct_call("registerNetStateListener", callback);
+}
+
+function unRegisterNetStateListener(callback){
+    return direct_call("unRegisterNetStateListener", callback);
+}
+
+
+// 显示声明，可以提高执行速度和利用上编辑器的成员名提示功能
+const bridge = {
     getMac,
     getWireMac,
     getWifiMac,
     getDeviceUUID,
     getAndroidId,
     openWindow,
+    startUrlInNewTab,
+    onWindowResult,
+    reloadWindow,
     closePage,
     getStartParams,
     getSystemProperty,
     getInstalledApps,
     startNativeApp,
     sendNativeBroadcast,
+    startService,
     getDeviceInfo,
     getAppInfo,
     notifyPageLoadDone,
@@ -461,5 +576,12 @@ export const jJsvRuntimeBridge = {
     warmUpView,
     warmLoadView,
     closeWarmedView,
-    preDownloadSdk
-};
+    preDownloadSdk,
+    getNetworkTypeStatusImmediate,
+    registerNetStateListener,
+    unRegisterNetStateListener
+};
+
+export {
+    bridge as jJsvRuntimeBridge
+};

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

@@ -0,0 +1,62 @@
+import ForgeHandles from "../../../JsViewVueTools/ForgeHandles";
+import { TextureBase } from "../Texture"
+
+export type CapturedCallback = (
+  textureAccessName: string,
+  autoRecycleSet: boolean,
+  width: number,
+  height: number) => void;
+
+export class CapturedTexture extends TextureBase {
+  private _AutoRecycle: boolean;
+  private _Callback: CapturedCallback | null;
+  private _CaptureDiv: any;
+  private _Canceled: boolean = false;
+
+  constructor(
+    captureDiv: any,
+    callback: CapturedCallback,
+    autoRecycle: boolean) {
+    super(null);
+
+    this._CaptureDiv = captureDiv;
+    this._Callback = callback;
+    this._AutoRecycle = autoRecycle;
+  }
+
+  // 清理对Callback和div的引用，防止泄露
+  cancel() {
+    if (!this._Canceled) {
+      this._Callback = null;
+      this._CaptureDiv = null;
+      this._Canceled = true;
+    }
+  }
+
+  override commit(): String {
+    this.textureRef = (ForgeHandles.TextureManager as any).GetCapturedTexture();
+    this._CaptureDiv.jsvGetProxyView(true).Capture2Texture(this.textureRef,
+      (result: string) => {
+        let resultObj: any = JSON.parse(result);
+
+        if (this._Canceled) {
+          return;
+        }
+
+        // 处理自动回收
+        if (!this._AutoRecycle) {
+          this.textureRef.DisableAutoRecycle(); // 取消自动清理
+          this.addToStore(); // 用TextureStore来跟进引用状态
+        }
+
+        // 回调
+        this._Callback?.(
+          this.getStoreName(),
+          this._AutoRecycle,
+          resultObj.width as number,
+          resultObj.height as number);
+      }
+    );
+    return '';
+  }
+}

package/utils/JsViewVueTools/JsvTextureStore/JsvTextureStore.ts

@@ -16,6 +16,7 @@
  */
 
 import CanvasTexture from "./CanvasTexture/CanvasTexture";
+import { CapturedTexture, CapturedCallback } from "./CapturedTexture/CapturedTexture";
 import sStore from "./Store";
 
 let sJsvTextureConst = {
@@ -29,30 +30,63 @@ let sTextureStoreApi: Object = {
     /**
      * canvasTexture
      * 创建CanvasTexture句柄，执行commit()后, 获取访问名(访问名规则: 输入参数 baseName + 分配id)
-     * 可以在 img.src 或者 div.backgroundImage 通过 "texturestore://访问名"
+     * 可以在 img.src 或者 div.backgroundImage 通过 "texturestore://访问名" 来使用
      * 
      * @param {int} width  此Canvas画布的宽度
      * @param {int} height  此Canvas画布的高度
      * @param {String|null} baseName 可选, 访问名的前缀信息
      * @return {CanvasTexture}
      */
-    canvasTexture: (width: Number, height: Number, baseName: String | null): Object => {
+    canvasTexture: (width: Number, height: Number, baseName: String | null): CanvasTexture => {
         return new CanvasTexture(width, height, baseName);
     },
 
+    /**
+     * capture2Texture
+     * 对给定div做截图并生成一个Texture, 在回调函数中返回此Texture的访问名,
+     * 此访问名可以在 img.src 或者 div.backgroundImage 通过 "texturestore://访问名" 来使用
+     * 注意: PC模拟环境下，无法截取运动物体的中间状态，但盒子端可以正常截取
+     * 
+     * 关于 autoRecycle:
+     *   true(默认值): 收到callback的访问名后，请立即设置给使用的地方，若此宏任务结束(其触发的所有微任务全完成后)时，
+     *                若资源未被div和img使用，则会自动回收，回收后此访问名对应内容为黑屏
+     *   false: 截图资源永久存在，可被反复使用，直到 JsvTextureStoreApi.deleteTexture(访问名) 进行清理
+     * 
+     * @param {DivVueRef} captureDiv  要截图的div
+     * @param {CapturedCallback} callback  完成截屏后的回调, 函数参数:
+     *                                     (textureAccessName: string,  // 访问名
+     *                                      autoRecycleSet: boolean,    // 通知是否为自动删除(和入参时一致)
+     *                                      width: number,              // 截取div的宽
+     *                                      height: number) => void     // 截取div的高
+     * @param {boolean} autoRecycle 可选, 是否当无div/img引用时会自动释放
+     *                              为true的场景在callback收到资源名后, 需要使用完毕后调用 deleteTexture 手动释放
+     *                              在手动释放之前，可以赋给其他div/img来复用 
+     * @return {CapturedTexture} 用于cancel的句柄，当cancel时，会清理对div和Callback的引用
+     */
+    capture2Texture: (
+        captureDiv: any,
+        callback: CapturedCallback,
+        autoRecycle: boolean = true): CapturedTexture => {
+
+        let texture = new CapturedTexture(captureDiv, callback, autoRecycle);
+        texture.commit();
+
+        return texture;
+    },
+
     /**
      * deleteTexture
-     * 删除commit后的texture
+     * 删除访问名对应的texture资源
      * 
-     * @param {String} storeName 此Texture的应用名称, 是canvasTexture.commit()后的返回值
+     * @param {String} accessName 此Texture的访问名，访问名来自: CanvasTexture.commit 或 capture2Texture 的回调
      */
-    deleteTexture: (storeName: String) => {
-        let textureRef = sStore.getFromStore(storeName);
+    deleteTexture: (accessName: String) => {
+        let textureRef = sStore.getFromStore(accessName);
         if (textureRef) {
             // 释放native端的texture实体
             textureRef.recycle();
         }
-    }
+    },
 }
 
 export {

package/utils/JsViewVueTools/JsvTextureStore/Texture.ts

@@ -12,10 +12,14 @@ export class TextureBase {
     }
 
     protected addToStore() {
-        this.storeName = `${this.baseName}-${this.textureRef?.GetTextureId()}`;
+        this.storeName = this.getStoreName();
         sStore.addToStore(this.storeName, this);
     }
 
+    protected getStoreName() {
+        return `${this.baseName}-${this.textureRef?.GetTextureId()}`;
+    }
+
     /**
      * commit
      * 完成绘制设置，出发制作目标texture
@@ -27,6 +31,16 @@ export class TextureBase {
         return this.storeName;
     }
 
+    /**
+     * getTextureRef
+     * 内部接口，获取内联的Forge.ImageTexture的句柄
+     * 
+     * @return {String} BaseName-textureId 格式的名字，用于 jsvtexturestore:// 的访问链接
+     */
+    public getTextureRef(): any {
+        return this.textureRef;
+    }
+
     public recycle() {
         // 释放native端的texture实体
         let textureRef = sStore.removeFromStore(this.storeName);

package/utils/JsViewVueTools/index.js

@@ -24,3 +24,5 @@ export * from "./JsvPerformance.ts"
 export * from "./JsvTextureStore/JsvTextureStore.ts"
 export * from "./JsvTextureDefines.ts"
 export * from "./JsvFederationTools.ts"
+export * from "./ConstSymbol.ts"
+export * from "./ForgeConstDefine.ts"