larksr_websdk 3.2.323 → 3.2.326

package/dist/doc/member_variables.md

@@ -0,0 +1,385 @@
+# LarkSR 对象成员变量
+
+LarkSR 对象成员变量,注意以下划线开头的变量为内部使用私有变量或只读成员变量，不建议修改直接使用。
+
+> 以下代码中 larksr 为创建好的 LarkSR 对象实例。省略创建过程。
+
+```javascript
+let larksr;
+
+...// create code.
+```
+
+## 视频组件
+
+1. `videoComponent` 视频组件
+
+```javascript
+// 获取播放的 <video /> 视频元素
+larksr.videoComponent.getVideo();
+// 播放视频，async 方法播放失败抛出异常
+larksr.videoComponent.playVideo();
+// 停止视频播放
+larksr.videoComponent.stopVideo();
+// 播放视频声音，取消静音播放
+larksr.videoComponent.sountPlayout();
+// 截取一帧，返回 base64，并抛出截图成功事件
+larksr.videoComponent.captrueFrame(data);
+```
+
+2. `videoElement`  html `video` 视频元素本身
+
+```javascript
+larksr.videoElement;
+```
+
+3. 控制显示元素
+
+```javascript
+// 是否显示移动端触摸点
+larksr.isEnableTouchPoint = false;
+// 是否显示载入画面时底部文字
+larksr.isEnableLoadingStateBar = false;
+```
+
+```javascript
+// 设置缩放模式
+larksr.scaleMode = ScaleMode.CONTAIN_APP;
+```
+
+4. 虚拟鼠标和触摸点
+
+```javascript
+/**
+ * 虚拟鼠标的当前位置,相对于整体容器
+ */
+larksr.virtualCursorPosition
+/**
+ * 虚拟鼠标的当前位置,内部缩放容器，与实际显示虚拟鼠标 CSS 样式相同
+ */
+larksr.virtualCursorPositionRaw
+```
+
+例：
+
+下面示例代码使用 react 演示点击一个按钮，同步一个外层的元素和虚拟鼠标的位置
+
+```javascript
+// ....
+// 省略 react 创建代码
+export default class App extends React.Component {
+    private state: any = {
+        pointPosition: {
+            x: 0,
+            y: 0,
+        }
+    };
+    // ....
+    // 此处省略 larksr 创建过程等其他代码
+    render() {
+        return (
+            <div>
+                // ...
+                // 省略其他元素
+                <div style={{
+                        zIndex: 1000,
+                        position: 'absolute', 
+                        left: this.state.pointPosition.x, 
+                        top: this.state.pointPosition.y,
+                        backgroundColor: "red",
+                        width: 50,
+                        height: 50,
+                        borderRadius: "50%"
+                    }}>
+                </div>
+                <button style={{pointerEvents: "all"}} 
+                    onClick={()=>{
+                        // 获取虚拟鼠标的位置
+                        console.log("touch point", this.larksr.virtualCursorPosition);
+                        // 同步虚拟鼠标的位置
+                        this.setState({
+                            pointPosition: this.larksr.virtualCursorPosition,
+                        })
+                    }}
+                    >
+                    touchPoint
+                </button>
+            </div>
+        )
+    }
+}
+```
+
+## 配置参数
+
+```javascript
+// `config` IAppliParams传入的 ILarkSRConfig 对象
+larksr.config;
+//  `params` 构造函数中传入的 IAppliParams 对象
+larksr.params;
+```
+
+## 用户模式
+
+```javascript
+// `playerModeType` 当前的玩家模式;
+larksr.playerModeType;
+// `userType` 当前用户类型;
+larksr.userType;
+// 当前是否是交互模式，交互默认即可以操作的模式
+larksr.isInteractiveMode;
+// 是否是观看者模式
+larksr.isObMode;
+```
+
+## 当前 app 的状态
+
+```javascript
+larksr.appState;
+```
+
+具体状态值如下:
+
+```javascript
+export enum APP_STATE {
+    BEFORE_CREATE = 0,
+    INITED,
+    WEBSOCKET_CHANNEL_OPEN,
+    LOGIN_SUCCESS,
+    RTC_CONNECTED,
+    MEDIA_LOADED,
+    MEDIA_PLAED,
+    RTC_RETRY,
+    APP_RETRY,
+    BEFORE_DESTORY,
+    WEBSOCKET_CLOSED,
+    RTC_CLOSED,
+    DESTROYED,
+}
+```
+
+```javascript
+// 云端画面是否准备好，准备好后才可以发送输入事件
+larksr.remoteScreenReady
+```
+
+## 当前的屏幕状态
+
+```javascript
+// 通知视口改变或者需要重新计算显示属性
+larksr.screenState.resize();
+// 当前云端 APP 的大小
+larksr.screenState.appSize;
+// 当前云端 APP 的鼠标状态
+larksr.screenState.appMouseMode;
+// 当前渲染容器的大小
+larksr.screenState.viewPort;
+// 强制横屏模式
+larksr.screenState.screenOrientation;
+// 缩放模式
+larksr.screenState.scaleMode;
+// 是否全屏状态
+larksr.screenState.isFullScreen;
+// 是否锁定鼠标状态
+larksr.screenState.isLockMouse;
+// 云端应用的鼠标样式
+larksr.screenState.cursorStyle;
+// 初始化鼠标模式
+larksr.screenState.initCursorMode;
+// 是否是手机模式
+larksr.screenState.isMobile;
+// 是否渲染本地鼠标
+larksr.screenState.isLocalRenderMouse;
+// 是否锁定鼠标
+larksr.screenState.isLockMosue;
+```
+
+## 操作类实例
+
+```javascript
+// 开始监听,默认情况下自动开始
+larksr.op.startListening();
+// 结束监听输入事件.
+larksr.op.stopListenling();
+// 开启或关闭鼠标输入事件
+larksr.op.setMouseEnable(enable: boolean);
+// 开启或关闭键盘输入事件
+larksr.op.setKeyboardEnable(enable: boolean);
+// 开启或关闭手柄输入事件
+larksr.op.setGamepadEnable(enable: boolean);
+// 开启或关闭触摸屏幕输入事件
+larksr.op.setTouchEnable(enable: boolean);
+```
+
+### 操作类中的 keyboardhandler
+
+```javascript
+// 设置键盘事件默认拦截浏览器默认行为。
+// 在 preventKeys 中的将拦截，如果数组设置为空则全部不拦截
+// 默认拦截 F1 F5 F12
+larksr.op.keyboardHandler.preventKeys = [["F1", "F5", "F12"]];
+```
+
+### 操作类中的 gestureHandler
+
+gestureHandler 处理将移动端触摸事件对应为鼠标事件的过程。
+
+#### 调节触摸事件触发参数
+
+```javascript
+// 触摸事件在对应为鼠标事件中，提供的鼠标相对移动的速度。
+// 即 rx = （pxNew-pxOld） * relativeMouseMoveSpeed
+//    ry = （pyNew-pyOld）* relativeMouseMoveSpeed
+// 可能会影响使用相对移动（rawInput）判断的云端应用的效果
+larksr.op.gestureHandler.relativeMouseMoveSpeed = 2;
+// 触摸模拟为鼠标事件时，模拟点击的判断范围。
+// 实际的鼠标事件点击时一般不会移动，而触摸操作基本上一定会触发移动事件
+// 如果要模拟PC上的击事件，比如单击或双击，在鼠标按下和抬起之间不应再插入鼠标移动
+// 当触发移动事件时，超出该判断范围才发送移动事件。
+// 注意，修改该值可能会导致云端应用上判断单击或双击失败，如果云端应用不包含类似操作基本影响不大
+larksr.op.gestureHandler.tapLimitRadius = 20;
+// 在该时间范围下将尝试发送单机按下事件，修改该值可能会导致单机事件的触发成功率
+larksr.op.gestureHandler.tapLimitTimeout = 100;
+```
+
+#### 拦截触摸事件回调
+
+可以通过拦截触摸事件回调的方式，设置具体的触摸事件和鼠标事件的对应关系。
+
+> 通过 larksr.op.gestureHandler.gestureCallback 设置回调函数
+> 下面例子中的 GESTURE_TYPE 为 SDK 导出的手势事件类型，如果用 amd 方式引入的 SDK，所有导出类型均在 larksr_websdk 全局对象下。
+> 如果是使用其他方式引入 SDK，如 improt 方式导入 `import { GESTURE_TYPE } from 'larksr_websdk'`
+> 以下示例代码忽略 larksr 创建等过程
+
+```javascript
+// 参数 event 有如下字段
+// event : {
+//      type: GESTURE_TYPE; 手势事件的类型
+//      x: number;          转换为云端的坐标 x
+//      y: number;          转换为云端的坐标 y
+//      rx: number;         转换为云端的坐标 rx
+//      ry: number;         转换为云端的坐标 ry
+//      edge: boolean;      是否到触摸边缘
+//      rawEvent: any;      未转换为云端坐标的触摸事件
+//    }
+// 
+larksr.op.gestureHandler.gestureCallback = (event) => {
+    console.log(event);
+    const p = event;
+    switch (event.type) {
+    // 单只触摸开始移动鼠标到当前位置
+    case GESTURE_TYPE.SINGLE_FINGER_TOUCH_START:
+        larksr.mouseMove(p.x, p.y, p.rx, p.ry);
+        break;
+    // 单指单击 -》左键单击
+    case GESTURE_TYPE.SINGLE_FINGER_TAP:
+        larksr.mouseTap(p.x, p.y, CloudLark.MouseKey.LEFT);
+        break;
+    // 单指按下 -》 移动鼠标, 按下鼠标
+    case GESTURE_TYPE.SINGLE_FINGER_TAP_DOWN:
+        // move mouse first
+        larksr.mouseMove(p.x, p.y, p.rx, p.ry);
+        // sync tap down
+        larksr.mouseDown(p.x, p.y, CloudLark.MouseKey.LEFT);
+        break;
+    // 单指抬起 -》 移动鼠标， 抬起鼠标
+    case GESTURE_TYPE.SINGLE_FINGER_TAP_UP:
+        // move mouse first
+        larksr.moseMove(p.x, p.y, p.rx, p.ry);
+        // sync tap down
+        larksr.mouseUp(p.x, p.y, CloudLark.MouseKey.LEFT);
+        break;
+    // 单指滑动 -》 移动鼠标
+    case GESTURE_TYPE.SINGLE_FINGER_SWIPE:
+        larksr.moseMove(p.x, p.y, p.rx, p.ry);
+        break;
+    // 单指开始滑动 -》 鼠标左键按下
+    case GESTURE_TYPE.SINGLE_FINGER_SWIPE_START:
+        // sync tap down
+        larksr.mouseDown(p.x, p.y, CloudLark.MouseKey.LEFT);
+        break;
+    // 单指滑动结束 -》 鼠标左键抬起
+    case GESTURE_TYPE.SINGLE_FINGER_SWIPE_END:
+        larksr.mouseUp(p.x, p.y, CloudLark.MouseKey.LEFT);
+        break;
+    // 双指单击 -》 鼠标右键单击
+    case GESTURE_TYPE.DOUBLE_FINGER_TAP:
+        larksr.mouseTap(p.x, p.y, CloudLark.MouseKey.RIGHT);
+        break;
+    // 双指按下 -》 移动鼠标
+    case GESTURE_TYPE.DOUBLE_FINGER_TAP_DOWN:
+        // move mouse first
+        larksr.moseMove(p.x, p.y, p.rx, p.ry);
+        // 抬起所有
+        // sync tap down
+        larksr.mouseDown(p.x, p.y, CloudLark.MouseKey.RIGHT);
+        break;
+    case GESTURE_TYPE.DOUBLE_FINGER_TAP_UP:
+        // move mouse first
+        larksr.moseMove(p.x, p.y, p.rx, p.ry);
+        // sync tap up
+        larksr.mouseUp(p.x, p.y, CloudLark.MouseKey.RIGHT);
+        break;
+    // 双指移动 -》 滚动滚轮
+    case GESTURE_TYPE.DOUBLE_FINGER_SWIPE:
+        // move mouse mid
+        // this.$emitMouseWheel(p.x, p.y, e.motion.y);
+        larksr.moseMove(p.x, p.y, p.rx, p.ry);
+        break;
+    case GESTURE_TYPE.DOUBLE_FINGER_EXPAND: 
+        // windows 消息 deltaY 上是 +120 下是 -120
+                // 双指扩展向外滑动
+                // 滚轮向下移动
+        // move mouse mid
+        larksr.mouseWheel(p.x, p.y, 120);
+        break;
+    case GESTURE_TYPE.DOUBLE_FINGER_SHRINK:
+        // windows 消息 deltaY 上是 +120 下是 -120
+                // 双指向内滑动
+                // 滚轮向上移动
+        larksr.mouseWheel(p.x, p.y,  -120);
+        break;
+    case GESTURE_TYPE.DOUBLE_FINGER_SWIPE_END:
+        // sync tap up
+        larksr.mouseUp(p.x, p.y, CloudLark.MouseKey.RIGHT);
+        break;
+    // 三指单击 -》 鼠标中键单击
+    case GESTURE_TYPE.TRIPLE_FINGER_TAP:
+        larksr.mouseTap(p.x, p.y, CloudLark.MouseKey.MIDDLE);
+        break;
+    // 三指滑动 -》 移动鼠标
+    case GESTURE_TYPE.TRIPLE_FINGER_SWIPE:
+        larksr.mouseMove(p.x, p.y, p.rx, p.ry);
+        break;
+    // 三指滑动按下 -》 鼠标中键按下
+    case GESTURE_TYPE.TRIPLE_FINGER_SWIPE_START:
+        larksr.mouseMove(p.x, p.y, p.rx, p.ry);
+        //
+        larksr.mouseDown(p.x, p.y, CloudLark.MouseKey.MIDDLE);
+        break;
+    // 三指滑动按下 -》 鼠标中键抬起
+    case GESTURE_TYPE.TRIPLE_FINGER_SWIPE_END:
+        // sync tap up
+        larksr.mouseUp(p.x, p.y, CloudLark.MouseKey.MIDDLE);
+        break;
+    // 所有手指抬起
+    case GESTURE_TYPE.RELEASE:
+        break;
+    default:
+        break;
+    }
+};
+```
+
+## 全屏锁屏
+
+```javascript
+// 进入全屏模式
+larksr.fullScreen.launchFullScreen();
+// 退出全屏模式
+larksr.fullScreen.exitFullscreen();
+// 锁定鼠标
+larksr.lockPointer.lockPointer();
+// 释放鼠标
+larksr.lockPointer.exitPointerLock();
+```

package/dist/doc/sdkid_encryption.md

@@ -0,0 +1,40 @@
+# SDK ID 加密配置
+
+使用 larksr SDK 首先需要从平行云商务 business@pingxingyun.com 或者在 https://www.pingxingyun.com/console 获取 SDK 授权码（注意不是服务器端的授权码）。
+
+通过 larksr config 传入 `authCode` 或者通过 larksr.initSDKAuthCode('您的SDKID') 方法设置授权码。
+
+为保护 SDK ID 的安全性，可以从服务端 3.2.3.0 开始可以对 SDK ID 进行加密配置。
+
+配置 SDK 加密：
+
+1. 首先在 larkxr 平台后台登陆，找到系统设定->接入管理->SDKID密钥管理生成 SDK ID 加密 KEY
+
+2. 对 SDK ID 进行加密
+
+以下 java 代码为例:
+
+```java
+public static void main(String[] args) {
+    /**
+    * @param res   被加密的原生字符串
+    * @param key  16位字符作为加密的key
+    */
+    try {
+        String res = "被加密的原生字符串";
+        String key = "16位字符作为加密的key";
+        String ALGORITHM = "AES";
+        String CHARSET = "UTF-8";
+        SecretKeySpec sks = new SecretKeySpec(key.getBytes(CHARSET), ALGORITHM);
+        Cipher cipher = Cipher.getInstance(ALGORITHM);
+        cipher.init(cipher.ENCRYPT_MODE, sks);
+        byte[] result = cipher.doFinal(res.getBytes());
+        // BASE64Encoder encoder = new BASE64Encoder();      //java8
+        Base64.Encoder encoder = Base64.getEncoder(); //java9+
+        System.out.println(encoder.encodeToString(result));
+    }catch (Exception e){
+    }
+}
+```
+
+3. 获取到加密好的字符串传入 lark 配置中即可。

package/dist/doc/update.md

@@ -0,0 +1,266 @@
+# 更新
+
+## V3.2.30
+
+> V3.2.30 仅支持服务端 [V3.2.3.1](https://www.pingxingyun.com/devCenter.html) 以上版本。
+> [老版本 SDK Demo 下载](https://github.com/pingxingyun/lark_sr_websdk_demos/releases/tag/V3.2.10)
+
+1. [添加像素流送支持](https://docs.unrealengine.com/4.27/zh-CN/SharingAndReleasing/PixelStreaming/PixelStreamingIntro/)。
+2. 完善安全性, 添加 SDK ID 加密配置。
+3. 移除 CreateLarkSRClientFromePXYHost，CreateLarkSRClientFromeAPI, CreateLarkSRClientFromeUrl 函数。直接使用 `new LarkSR(config: ILarkSRConfig)` 方式创建对象。
+
+## V3.2.33
+
+1. 添加智能语音相关接口支持
+
+LarkSR 对象添加:
+
+```typescript
+/**
+ * 开始智能语音对话文本输入
+ * 应在只能语音为开始状态下开始输入
+ * @param text 输入的文本
+ * @returns 返回对话 ID
+ */
+public aiDmTextInput(text: string) {
+/**
+ * 开始智能语音对话语音输入，自动请求录音权限
+ * 应在只能语音为开始状态下开始输入
+ * @returns 成功返回对话id，失败返回异常
+ */
+public startAiDmVoiceInput() {
+
+/**
+ * 停止智能语音输入，通知语音引擎当前用户输入对话结束
+ * @returns 返回当前对话的id
+ */
+public stopAiDmVoiceInput() {
+```
+
+LarkSR 添加如下事件:
+
+```typescript
+larksr.on('aivoicestatus', (e) => {
+    // 智能语音服务状态
+});
+
+larksr.on('aivoiceasrresult', (e) => {
+    // 智能语音转文字识别结果
+});
+
+larksr.on('aivoicedmresult', (e) => {
+    // 智能语音对话结果
+});
+```
+
+## V3.2.37
+
+```typescript
+/**
+ * 设置是否强制横屏显示内容.
+ * handelRootElementSize 必须设置为 true 才有作用。
+ * 要注意强制横屏模式下网页的坐标系xy和视觉上相反，如果通过外部输入 input 事件。要注意调整
+ * @param force 是否强制横屏
+ */
+setMobileForceLandScape(force: boolean): void;
+```
+
+## V3.2.311
+
+新增麦克风输入接口。客户端打开后云端应用可直接通过读取声卡上的麦克风接收到音频。
+
+> 该功能匹配的服务端版本最低为 V3.2.51
+> 使用该功能要注意在后台应用管理中开启音频输入功能
+> 注意要在连接成功之后打开媒体设备。即 `mediaPlayed` 之后调用才有效
+
+```typescript
+/**
+ * 打开一个音频设备，要注意浏览器限制在 https 或者 localhost 下才能打开音频
+ * @param deviceId 音频设备id，如果不传将打开默认设备。@see getConnectedAudioinputDevices
+ * @returns
+ */
+openAudio(deviceId?: string);
+/**
+ * 关闭当前的音频设备
+ * @returns
+ */
+closeAudio(): boolean | undefined;
+/**
+ * 返回已连接的音频设备列表，设备列表中的设备的 deviceId 可用来打开某个音频设备
+ * @returns
+ */
+getConnectedAudioinputDevices(): Promise<MediaDeviceInfo[] | undefined>;
+/**
+ * 设置当前已开启的音频track是否启用状态
+ * @param enable 是否启用
+ * @returns
+ */
+setAudioEnable(enable: boolean): void | undefined;
+```
+
+larksr 配置项新增自动打开麦克风配置,在`new LarkSR({ ... 此处省略其他配置 ... audioInputAutoStart: true})` 时传入，
+
+> 手动传入的 `audioInputAutoStart` 优先级高于后台配置
+
+```javascript
+/**
+* 当启用音频输入功能，是否自动连入音频设备。
+* 默认关闭。
+* 需要注意默认打开的是系统中默认的音频设备。
+*/
+audioInputAutoStart?: boolean;
+```
+
+## V3.2.319
+
+新增视频输入接口。客户端打开后云端应用可直接通过读取服务端的摄像头读取视频数据。
+
+> 该功能匹配的服务端版本最低为 V3.2.61
+> 使用该功能要注意在后台应用管理中开启视频输入功能
+> 注意要在连接成功之后打开媒体设备。即 `mediaPlayed` 之后调用才有效
+
+```typescript
+/**
+ * 打开一个视频设备，要注意浏览器限制在 https 或者 localhost 下才能打开视频
+ * @param audio boolean 是否同时开启音频
+ * @param cameraId 视频设备id，如果不传将打开默认设备。@see getConnectedVideoinputDevices
+ * @returns Promise
+ */
+openVideo(audio?: boolean, cameraId?: string);
+/**
+ * 打开默认媒体设备，要注意浏览器限制在 https 或者 localhost 下
+ * 如果需要指定特殊的媒体设备请单独使用 @see openAudio @see openVideo
+ * @param video 是否包含视频
+ * @param audio 是否包含音频
+ * @returns Promise
+ */
+openDefaultMedia(video?: boolean, audio?: boolean)>;
+/**
+ * 返回已连接的视频设备
+ * @returns Promise<MediaDeviceInfo[]>
+ */
+getConnectedVideoinputDevices();
+/**
+ * 设置当前已开启的视频track是否启用状态
+ * @param enable 是否启用
+ * @returns void
+ */
+setVideoEnable(enable: boolean);
+```
+
+larksr 配置项新增自动打开视频输入配置,在`new LarkSR({ ... 此处省略其他配置 ... videoInputAutoStart: true})` 时传入
+
+> 手动传入的 `videoInputAutoStart` 优先级高于后台配置
+
+```javascript
+/**
+ * 当启用视频输入功能，是否自动连入视频设备。
+ * 默认关闭。
+ * 需要注意默认打开的是系统中默认的视频设备。
+ */
+videoInputAutoStart?: boolean;
+```
+
+## V3.2.321
+
+larksr 配置项新增默认放大手势和鼠标滚轮对应关系和是否使用触摸屏模式,在`new LarkSR({ ... 此处省略其他配置 ... mouseZoomDirection: 0， touchOperateMode: "mouse"})` 时传入
+
+> 手动传入的配置优先级高于后台配置
+
+```javascript
+/**
+ * mouseZoomDirection
+ * 用于移动端捏合缩放操作与应用鼠标缩放的对应关系
+ * 1:鼠标滚轮向上为放大，
+ * 0:鼠标滚轮向下为放大(default)
+ */
+mouseZoomDirection?: number;
+/**
+ * 触摸指令模式，对应后台应用管理->应用编辑->移动端高级设置->触摸指令模式 优先级高于后台配置
+ * 触摸指令，移动端的触摸指令对应为云端的触屏还是鼠标
+ * 'touchScreen' | 'mouse'
+ */
+touchOperateMode?: 'touchScreen' | 'mouse';
+```
+
+captrueFrame 方法会将截图和通过返回值带出来
+
+```javascript
+/**
+ * 采集一帧图像
+ * @params data: any 抛出采集事件时抛出的附加data，比如采集的时间戳
+ * @return { data: any, base64: base64string } 返回传入的 data 和采集的 base64 字符串
+ */
+captrueFrame(data: any)
+```
+
+新增销毁方法，要注意，销毁之后 larksr 对象不再可用
+
+```javascript
+/**
+ * 从DOM种删除渲染组件，注意删除渲染组件之后将无法再次进入应用，所有状态将失效,不可恢复，只能重新new LarkSR
+ */
+destroy(): void;
+```
+
+添加操作类中的 keyboardhandler 开放访问，可用配置拦截哪些按键的默认行为
+
+```javascript
+// 设置键盘事件默认拦截浏览器默认行为。
+// 在 preventKeys 中的将拦截，如果数组设置为空则全部不拦截
+// 默认拦截 F1 F5 F12
+larksr.op.keyboardHandler.preventKeys = [["F1", "F5", "F12"]];
+```
+
+操作类中添加 gestureHandler 公开访问,gestureHandler 处理将移动端触摸事件对应为鼠标事件的过程。
+
+可用通过 gestureHandler 调节触摸事件触发参数
+
+```javascript
+// 触摸事件在对应为鼠标事件中，提供的鼠标相对移动的速度。
+// 即 rx = （pxNew-pxOld） * relativeMouseMoveSpeed
+//    ry = （pyNew-pyOld）* relativeMouseMoveSpeed
+// 可能会影响使用相对移动（rawInput）判断的云端应用的效果
+larksr.op.gestureHandler.relativeMouseMoveSpeed = 2;
+// 触摸模拟为鼠标事件时，模拟点击的判断范围。
+// 实际的鼠标事件点击时一般不会移动，而触摸操作基本上一定会触发移动事件
+// 如果要模拟PC上的击事件，比如单击或双击，在鼠标按下和抬起之间不应再插入鼠标移动
+// 当触发移动事件时，超出该判断范围才发送移动事件。
+// 注意，修改该值可能会导致云端应用上判断单击或双击失败，如果云端应用不包含类似操作基本影响不大
+larksr.op.gestureHandler.tapLimitRadius = 20;
+// 在该时间范围下将尝试发送单机按下事件，修改该值可能会导致单机事件的触发成功率
+larksr.op.gestureHandler.tapLimitTimeout = 100;
+```
+
+可用通过 gestureHandler 拦截触摸事件回调, 通过 `larksr.op.gestureHandler` 设置回调函数
+
+## V3.2.322
+
+1. 修复某些情况下后台设置的 LOGO 会闪一下默认 LOGO 的问题
+2. 添加 `larksr.virtualCursorPosition` 和 `larksr.virtualCursorPositionRaw` (省略 larksr 对象创建代码) 获取当前虚拟鼠标或者触摸点的位置。
+
+## V3.2.324
+
+1. 修复 iOS 屏幕高度判断问题
+2. 添加获取应用列表接口 `API.GetAppliList(server: string, params: any);`
+3. 添加获取区域列表接口 `API.RegionList(server: string, params: any);`
+4. 添加获取后台配置UI接口 `larksr.getTouchCtrMapping()`
+5. 添加  `RTMP_STREAM_STATE  = "rtmpstreamstate"` 事件，返回云端直播推流事件
+6. 添加 `RTMP_STREAM_ERROR = "rtmpstreamerror"` 事件，返回云端直播推流错误
+7. 添加 `larksr.StartCloudLiveStreaming(params)` 接口，启动云端直播推流功能
+8. 添加 `larksr.StopLiveStreaming()` 接口，关闭云端直播推流功能.
+
+## V3.2.326
+
+1. 截图接口 `captrueFrame(data: any, option?: { width: number; height: number;})` 添加 option 参数，可以设置截图的宽高
+2. 添加 onlyHandleRootElementTransform 参数 `new LarkSR({ ... 此处省略其他配置 ... onlyHandleRootElementTransform: 0})`
+
+```javascript
+/**
+* 是否只设置根的组件的旋转。只当 handleRootElementSize 为 true 时有效。设置根组件的旋转用于 mobileForceLandscape 模式。
+* 默认为false，此时 SDK 会设置根组件的宽高,margin 0,padding 0
+* 为true并且handleRootElementSize也为true时，只设置根组件的旋转属性，用于强制横屏模式以及强制横屏竖屏的切换。
+* 要注意onlyHandleRootElementTransform开启成功时，要保证根节点的元素大小并且当根节点变化时应调用 resize 方法通知更新根节点的大小。
+*/
+onlyHandleRootElementTransform?: boolean;
+```