v1.1.5

v1.1.5

Author: ranpeng

changelog.md

@@ -1,10 +1,29 @@
+### [1.1.5](https://github.com/tencentyun/cloudgame-js-sdk/releases/tag/v1.1.5)@2022.06.23
+
+**新增**
+
+- 新增接口返回是否当前运行手游方案 getIsMobileGame
+- 新增 cmd+v/ctrl+v 获取剪切板内容发送至云端输入框
+
+**变更**
+
+- 新增旋转事件通知 TCGSDK:VideoOrientation
+- 重连默认开启
+- 取消对部分老接口的兼容 onConnectSucc/onConnectFailed/onWebrtcStatChange/onInputStatusChanged/onCursorShowStatChanged，替换成新回调
+- 同端口重复创建 customDatachannel，返回已创建信息
+
+**修复**
+
+- 修复由于重连导致多次事件绑定的 bug
+- 由于旋转导致的摇杆位置偏移 bug
+
 ### [1.1.4](https://github.com/tencentyun/cloudgame-js-sdk/releases/tag/v1.1.4)@2022.05.16
 
 **新增**
 
 - 新增init 参数 camera，用于摄像头上行推流
 - 新增 getUserMedia 方法，返回 getUserMedia 的 MediaStream
-- 新增虚拟键盘差价
+- 新增虚拟键盘插件
 
 **变更**
 

dist/tcg-sdk/index.d.ts

@@ -439,9 +439,9 @@ export interface InitConfig extends InitConfigBase {
    */
   mount: string;
   /**
-   * 用户的腾讯云 APPID
+   * @deprecated 用户的腾讯云 APPID
    */
-  appid: number;
+  appid?: number;
   /**
    * 是否开启本地麦克风，默认值为 false
    */
@@ -484,15 +484,15 @@ export interface InitConfig extends InitConfigBase {
    */
   keepLastFrame?: boolean;
   /**
-   * 是否自动重连，默认值：false
+   * 是否自动重连，默认值：true，会在弱网，或帧率持续掉 0所导致的断连时，主动重连
    */
   reconnect?: boolean;
   /**
    * 是否显示加载中画面，默认值: true
    */
   showLoading?: boolean;
   /**
-   * 加载中的文字提示内容，默认值：'正在启动云游戏'
+   * 加载中的文字提示内容，默认值：'正在启动云渲染'
    */
   loadingText?: string;
   /**
@@ -519,10 +519,6 @@ export interface InitConfig extends InitConfigBase {
    * 初始化完毕的回调，触发此回调之后才能调用后面的 API
    */
   onInitSuccess?: (response: OnInitSuccessResponse) => void;
-  /**
-   * 连接成功回调，调用 start 接口成功后才会触发(老版本)
-   */
-  onConnectSucc?: (response: OnConnectSuccessResponse) => void;
   /**
    * 连接成功回调，调用 start 接口成功后才会触发
    */
@@ -531,10 +527,6 @@ export interface InitConfig extends InitConfigBase {
    * 连接失败回调，调用 start 接口成功后才会触发
    */
   onConnectFail?: (response: OnConnectFailedResponse) => void;
-  /**
-   * 连接失败回调，调用 start 接口成功后才会触发
-   */
-  onConnectFailed?: (response: OnConnectFailedResponse) => void;
   /**
    * webrtc 状态回调，调用 start 接口成功后才会触发，设置这个回调后，如果 webrtc 请求返回错误
    */
@@ -543,10 +535,6 @@ export interface InitConfig extends InitConfigBase {
    * webrtc 状态回调，调用 start 接口成功后才会触发，设置这个回调后，如果 webrtc 请求返回错误
    */
   onWebrtcStatusChange?: (response: OnWebrtcStatusChangeResponse) => void;
-  /**
-   * webrtc 状态回调，调用 start 接口成功后才会触发，设置这个回调后，如果 webrtc 请求返回错误
-   */
-  onWebrtcStatChange?: (response: ServerSideDescription) => void;
   /**
    * 断开/被踢触发此回调，调用 start 接口成功后才会触发
    */
@@ -571,10 +559,6 @@ export interface InitConfig extends InitConfigBase {
    * 游戏保存存档回调
    */
   onSaveGameArchive?: (response: OnSaveGameArchiveResponse) => void;
-  /**
-   * 云端输入状态改变，有点击事件的时候都会触发，需要判断新旧状态(老版本)
-   */
-  onInputStatusChanged?: (oldStatus: boolean, newStatus: boolean) => void;
   /**
    * 云端输入状态改变，有点击事件的时候都会触发，需要判断新旧状态
    */
@@ -583,10 +567,6 @@ export interface InitConfig extends InitConfigBase {
    * 手柄连接/断开事件回调
    */
   onGamepadConnectChange?: (response: OnGamepadConnectChangeResponse) => void;
-  /**
-   * 云端鼠标显示/隐藏，只在变化的时候回调(老版本)
-   */
-  onCursorShowStatChanged?: (oldStatus: boolean, newStatus: boolean) => void;
   /**
    * 云端鼠标显示/隐藏，只在变化的时候回调
    */
@@ -670,7 +650,7 @@ interface RawEventData {
 }
 
 export declare interface CloudGamingWebSDKStatic {
-  // -------------- 云游戏生命周期相关接口 ------------
+  // -------------- 云渲染生命周期相关接口 ------------
   init(config?: InitConfig): void;
   /**
    * 获取初始化参数
@@ -681,12 +661,12 @@ export declare interface CloudGamingWebSDKStatic {
    */
   getClientSession(): string;
   /**
-   * 启动云游戏
+   * 启动云渲染
    * @param serverSession 调用云API接口createSession 后返回的 serverSession
    */
   start(serverSession: string): void;
   /**
-   * 立即停止云游戏
+   * 立即停止云渲染
    */
   destroy(params: { message?: string; code?: number }): void;
   /**
@@ -767,6 +747,10 @@ export declare interface CloudGamingWebSDKStatic {
    * 获取用户开启的摄像头或麦克风 stream
    */
   getUserMedia(): MediaStream;
+  /**
+   * 获取是否为手游方案
+   */
+  getIsMobileGame(): boolean;
   /**
    * 重新调整video 位置
    */
@@ -780,13 +764,13 @@ export declare interface CloudGamingWebSDKStatic {
       KEY_MENU = 139
       KEY_HOME = 172
    * @param key 
-   * @param down 是否是按下状态(就想正常打字，通常是down/up组合)
+   * @param down 是否是按下状态(就像正常打字，通常是down/up组合)
    */
   sendKeyboardEvent({ key, down }: { key: number; down: boolean }): void;
   /**
    * 发送鼠标事件
    * @param param type: MouseEvent
-   * @param down 是否是按下状态(就想正常打字，通常是down/up组合)
+   * @param down 是否是按下状态(就像正常鼠标点击，通常是down/up组合)
    */
   sendMouseEvent({ type, down }: { type: MouseEvent; down: boolean }): void;
   /**
@@ -860,7 +844,7 @@ export declare interface CloudGamingWebSDKStatic {
    */
   resetRemoteCapsLock(): void;
   /**
-   * 设置云游戏页面中鼠标默认图片。
+   * 设置云渲染页面中鼠标默认图片。
    * @param url 鼠标图片
    */
   setDefaultCursorImage(url: string): void;
@@ -916,7 +900,7 @@ export declare interface CloudGamingWebSDKStatic {
    */
   getVideoVolume(): number;
   /**
-   * 设置云游戏页面的背景图。
+   * 设置云渲染页面的背景图。
    * 注意，这里设置的是前端container 的背景图，不是云端的背景图，云端背景图通过createSession 设置
    * @param url 背景图片
    */

dist/tcg-sdk/index.js

@@ -1,4 +1,4 @@
-# 云游戏插件项目
+# 云渲染插件项目
 
 包含[虚拟摇杆](./joystick/) 和 [虚拟键盘](./keyboard/)，详细接口描述可查看对应声明文件
 

plugin/README.md

@@ -1,4 +1,4 @@
-# 云游戏插件项目 - 摇杆
+# 云渲染插件项目 - 摇杆
 
 接口描述见[申明文件（joystick.d.ts）](./joystick.d.ts)
 

plugin/index.js

@@ -26,7 +26,7 @@ export interface CreateConfig {
    */
   lockY?: boolean;
   /**
-   * 两种摇杆样式 wasd/上下左右, 默认值 `dpad_updown`
+   * 两种摇杆样式 wasd/上下左右, 默认值 `dpad_wasd`
    */
   type?: 'dpad_wasd' | 'dpad_updown';
   /**

plugin/joystick/README.md

@@ -1,4 +1,4 @@
-# 云游戏插件项目 - 虚拟键盘
+# 云渲染插件项目 - 虚拟键盘
 
 接口描述见[申明文件（keyboard.d.ts）](./keyboard.d.ts)