trtc-electron-sdk 10.3.404-beta.1 → 10.3.404-beta.2

package/liteav/Renderer/types.d.ts

@@ -1,5 +1,5 @@
 import { TRTCVideoFillMode } from "../trtc_define";
-export declare type TFrameData = {
+export type TFrameData = {
     data: Uint8Array | ArrayBuffer;
     width: number;
     height: number;
@@ -7,7 +7,7 @@ export declare type TFrameData = {
     rotation: number;
     isNeedRotate: boolean;
 };
-export declare type TCanvasImageSourceStyleOptions = {
+export type TCanvasImageSourceStyleOptions = {
     contentWidth: number;
     contentHeight: number;
     containerWidth: number;

package/liteav/trtc.d.ts

@@ -1568,6 +1568,28 @@ declare class TRTCCloud extends EventEmitter {
      * @note 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeScreen 时生效，即分享屏幕时生效
      */
     removeAllExcludedShareWindow(): void;
+    /**
+     * 8.16 将指定窗口加入屏幕分享的包含列表中（该接口仅支持桌面系统）
+     *
+     * @param {String} win - 希望被分享出去的窗口（Windows 平台下为窗口句柄： HWND）
+     * - 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     * - 您在 startScreenCapture 之前和之后调用均可。
+     * - 通过该方法添加到包含列表中的窗口，会在退出房间后被 SDK 自动清除。
+     */
+    addIncludedShareWindow(win: string): void;
+    /**
+     * 8.17 将指定窗口从屏幕分享的包含列表中移除（该接口仅支持桌面系统）
+     *
+     * @param {String} win - 希望被分享出去的窗口（Mac 平台: 窗口 ID；Windows 平台： HWND）
+     * - 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     */
+    removeIncludedShareWindow(win: string): void;
+    /**
+     * 8.18 将全部窗口从屏幕分享的包含列表中移除（该接口仅支持桌面系统）
+     *
+     * @note 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     */
+    removeAllIncludedShareWindow(): void;
     /**
      * @private
      * 9.5 设置本地视频自定义渲染（Electron 平台下不可用）

package/liteav/trtc.js

@@ -1084,7 +1084,7 @@ class TRTCCloud extends events_1.EventEmitter {
      */
     handleOnScreenCaptureStarted() {
         this.isScreenCapturing = true;
-        // 只有在 Buffer 为 null 时才新建，否则只能在 handleVideoSizeChange 事件中重新申请 Buffer         
+        // 只有在 Buffer 为 null 时才新建，否则只能在 handleVideoSizeChange 事件中重新申请 Buffer
         if (!screenVideoBuffer.buffer) {
             screenVideoBuffer.userId = '';
             screenVideoBuffer.streamType = this.screenCaptureStreamType;
@@ -1663,7 +1663,7 @@ class TRTCCloud extends events_1.EventEmitter {
                 this._initRender(key, view);
             }
             // view 为 null 时，可能启动了自定义渲染，所以 Buffer 还是要创建，否则自定义渲染就拿不到数据；
-            // view 非 null 时，当然必须创建 Buffer 
+            // view 非 null 时，当然必须创建 Buffer
             // 只有在 Buffer 为 null 时才新建，否则只能在 handleVideoSizeChange 事件中重新申请 Buffer
             if (!localVideoBuffer.buffer) {
                 localVideoBuffer.streamType = trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig;
@@ -1742,7 +1742,7 @@ class TRTCCloud extends events_1.EventEmitter {
                 this._initRender(key, view);
             }
             // view 为 null 时，可能启动了自定义渲染，所以 Buffer 还是要创建，否则自定义渲染就拿不到数据；
-            // view 非 null 时，当然必须创建 Buffer 
+            // view 非 null 时，当然必须创建 Buffer
             const videoBufferInfo = {
                 userId: userId,
                 buffer: (0, util_1.allocBuffer)(DEFAULT_VIDEO_WIDTH * DEFAULT_VIDEO_HEIGHT * this.pixelLength, userId, streamType),
@@ -2847,6 +2847,42 @@ class TRTCCloud extends events_1.EventEmitter {
     removeAllExcludedShareWindow() {
         this.rtcCloud.removeAllExcludedShareWindow();
     }
+    /**
+     * 8.16 将指定窗口加入屏幕分享的包含列表中（该接口仅支持桌面系统）
+     *
+     * @param {String} win - 希望被分享出去的窗口（Windows 平台下为窗口句柄： HWND）
+     * - 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     * - 您在 startScreenCapture 之前和之后调用均可。
+     * - 通过该方法添加到包含列表中的窗口，会在退出房间后被 SDK 自动清除。
+     */
+    addIncludedShareWindow(win) {
+        if (isNaN(+win)) {
+            console.error('trtc:addIncludedShareWindow, win: ' + win + 'is not invalid!');
+            return;
+        }
+        this.rtcCloud.addIncludedShareWindow(win);
+    }
+    /**
+     * 8.17 将指定窗口从屏幕分享的包含列表中移除（该接口仅支持桌面系统）
+     *
+     * @param {String} win - 希望被分享出去的窗口（Mac 平台: 窗口 ID；Windows 平台： HWND）
+     * - 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     */
+    removeIncludedShareWindow(win) {
+        if (isNaN(+win)) {
+            console.error('trtc:removeIncludedShareWindow, win: ' + win + 'is not invalid!');
+            return;
+        }
+        this.rtcCloud.removeIncludedShareWindow(win);
+    }
+    /**
+     * 8.18 将全部窗口从屏幕分享的包含列表中移除（该接口仅支持桌面系统）
+     *
+     * @note 该方法只有在 TRTCScreenCaptureSourceInfo 中的 type 指定为 TRTCScreenCaptureSourceTypeWindow 时生效，即分享窗口内容时，额外包含指定窗口的功能才生效。
+     */
+    removeAllIncludedShareWindow() {
+        this.rtcCloud.removeAllIncludedShareWindow();
+    }
     /////////////////////////////////////////////////////////////////////////////////
     //
     //                      （九）自定义采集和渲染

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trtc-electron-sdk",
-  "version": "10.3.404-beta.1",
+  "version": "10.3.404-beta.2",
   "description": "trtc electron sdk",
   "main": "./liteav/trtc.js",
   "types": "./liteav/trtc.d.ts",