trtc-electron-sdk 10.6.403 → 10.6.404-beta.1

package/liteav/trtc.d.ts

@@ -1,8 +1,10 @@
 /// <reference types="node" />
 import { EventEmitter } from 'events';
+import { VodPlayer } from './vod_player';
 import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioEffectParam, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceState, TRTCDeviceType, TRTCLogLevel, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoBufferType, TRTCVideoFillMode, TRTCVideoFrame, TRTCVideoPixelFormat, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, PluginInfo, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType } from './trtc_define';
 export * from './trtc_define';
 export * from './trtc_code';
+export * from './vod_player';
 /**
  * 腾讯云视频通话功能的主要接口类
  *
@@ -42,6 +44,7 @@ declare class TRTCCloud extends EventEmitter {
     private enableRenderFrame;
     private screenCaptureStreamType;
     private isScreenCapturing;
+    private vodPlayers;
     constructor();
     /**
      * 创建 TRTCCloud 对象单例
@@ -239,7 +242,7 @@ declare class TRTCCloud extends EventEmitter {
      * 如果 userId 为 null，表示开始渲染本地采集的摄像头画面，需要您先调用 [startLocalPreview()]{@link TRTCCloud#startLocalPreview} 触发。
      * 如果 userId 不为 null，表示开始渲染远程用户的首帧画面，需要您先调用 [startRemoteView()]{@link TRTCCloud#startRemoteView} 触发。
      *
-     * 注意：只有当您调用 startLocalPreview()、startRemoteView() 或 startRemoteSubStreamView() 之后，才会触发该回调。
+     * 注意：只有当您调用 startLocalPreview() 或 startRemoteView() 之后，才会触发该回调。
      *
      * @event TRTCCallback#onFirstVideoFrame
      * @param {String} userId     - 本地或远程用户 ID，如果 userId == '' 代表本地，userId != '' 代表远程。
@@ -807,13 +810,16 @@ declare class TRTCCloud extends EventEmitter {
      * 2.3 开始向非腾讯云的直播 CDN 转推
      *
      * 该接口跟 startPublishing() 类似，但 startPublishCDNStream() 支持向非腾讯云的直播 CDN 转推。
-     * 使用 startPublishing() 绑定腾讯云直播 CDN 不收取额外的费用。
-     * 使用 startPublishCDNStream() 绑定非腾讯云直播 CDN 需要收取转推费用，且需要通过工单联系我们开通。
+     *
+     * 注意：
+     * - 使用 startPublishing() 绑定腾讯云直播 CDN 不收取额外的费用。
+     * - 使用 startPublishCDNStream() 绑定非腾讯云直播 CDN 需要收取转推费用，且需要通过工单联系我们开通。
      *
      * @param {TRTCPublishCDNParam} param - 转推参数
-     * @param {Number} param.appId - 腾讯云 AppID
-     * @param {Number} param.bizId - 腾讯云直播 bizId
-     * @param {String} param.url   - 旁路转推的 URL
+     * @param {Number} param.appId - 腾讯云直播服务的 AppID
+     * @param {Number} param.bizId - 腾讯云直播服务的 bizid
+     * @param {String} param.url   - 指定该路音视频流在第三方直播服务商的推流地址，推流 URL 必须为 RTMP 格式，必须符合您的目标直播服务商的规范要求，否则目标服务商会拒绝来自 TRTC 后台服务的推流请求。
+     * @param {String} param.streamId - 需要转推的 streamId，默认值：空值。如果不填写，则默认转推调用者的旁路流。
      */
     startPublishCDNStream(param: any): void;
     /**
@@ -1435,12 +1441,10 @@ declare class TRTCCloud extends EventEmitter {
      * - yOffset：水印的坐标，取值范围为0 - 1的浮点数。
      * - fWidthRatio：水印的大小比例，取值范围为0 - 1的浮点数。
      *
-     * 注意：Windows 平台不支持设置水印
-     *
      * @param {TRTCVideoStreamType} streamType - 要设置水印的流类型(TRTCVideoStreamTypeBig、TRTCVideoStreamTypeSub)
-     * @param {ArrayBuffer} srcData - 水印图片源数据（传 null 表示去掉水印）
+     * @param {ArrayBuffer|String} srcData - 水印图片源数据（传 null 表示去掉水印）
      * @param {TRTCWaterMarkSrcType} srcType - 水印图片源数据类型
-     * - TRTCWaterMarkSrcTypeFile  : Electron 平台不支持
+     * - TRTCWaterMarkSrcTypeFile  : 图片文件路径，支持 BMP、GIF、JPEG、PNG、TIFF、Exif、WMF 和 EMF 文件格式
      * - TRTCWaterMarkSrcTypeBGRA32: BGRA32格式内存块
      * - TRTCWaterMarkSrcTypeRGBA32: RGBA32格式内存块
      * @param {Number} nWidth      - 水印图片像素宽度（源数据为文件路径时忽略该参数）
@@ -1449,7 +1453,7 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Number} yOffset     - 水印显示的左上角 y 轴偏移
      * @param {Number} fWidthRatio - 水印显示的宽度占画面宽度比例（水印按该参数等比例缩放显示）
      */
-    setWaterMark(streamType: TRTCVideoStreamType, srcData: ArrayBuffer | null, srcType: TRTCWaterMarkSrcType, nWidth: number, nHeight: number, xOffset: number, yOffset: number, fWidthRatio: number): void;
+    setWaterMark(streamType: TRTCVideoStreamType, srcData: ArrayBuffer | string | null, srcType: TRTCWaterMarkSrcType, nWidth: number, nHeight: number, xOffset: number, yOffset: number, fWidthRatio: number): void;
     /**
      * 8.1 废弃接口： 开始显示远端用户的辅路画面（TRTCVideoStreamTypeSub，一般用于屏幕分享）
      *
@@ -1530,20 +1534,56 @@ declare class TRTCCloud extends EventEmitter {
      * @param {Rect} captureRect    - 指定捕获的区域
      * @param {TRTCScreenCaptureProperty} property  - 指定屏幕分享目标的属性，包括捕获鼠标，高亮捕获窗口等，详情参考TRTCScreenCaptureProperty 定义
      *
-     * 废弃参数使用方法(针对 9.3 以下版本):
-     * @param {TRTCScreenCaptureSourceType} type - 采集源类型
-     * - TRTCScreenCaptureSourceTypeWindow: 该分享目标是某一个Windows窗口
-     * - TRTCScreenCaptureSourceTypeScreen: 该分享目标是整个Windows桌面
-     * - TRTCScreenCaptureSourceTypeCustom: 该分享目标是自定义窗口区域
-     * @param {String} sourceId    - 采集源ID，对于窗口，该字段指示窗口句柄；对于屏幕，该字段指示屏幕ID
-     * @param {String} sourcename  - 采集源名称，UTF8编码
-     * @param {Rect} captureRect - 指定捕获的区域
-     * @param {Number} captureRect.left   - 指定捕获的区域的左坐标
-     * @param {Number} captureRect.top    - 指定捕获的区域的上坐标
-     * @param {Number} captureRect.right  - 指定捕获的区域的右坐标
-     * @param {Number} captureRect.bottom - 指定捕获的区域的下坐标
-     * @param {Boolean} captureMouse    - 指定是否捕获鼠标指针
-     * @param {Boolean} highlightWindow - 指定是否高亮正在共享的窗口，以及当捕获图像被遮挡时高亮遮挡窗口提示用户移走遮挡
+     * @example
+     * // 示例1: 选择要分享的窗口或屏幕
+     * import TRTCCloud, {
+     *  Rect,
+     *  TRTCScreenCaptureProperty
+     * } from 'trtc-electron-sdk';
+     *
+     * const rtcCloud = new TRTCCloud();
+     *
+     * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
+     *
+     * const selectedScreenOrWindow = screenAndWindows[0];
+     *
+     * const selectRect = new Rect(0, 0, 0, 0);
+     *
+     * const captureProperty = new TRTCScreenCaptureProperty(
+     *  true, // enable capture mouse
+     *  true, // enable highlight
+     *  true, // enable high performance
+     *  0, // default highlight color
+     *  0, // default highlight width
+     *  false // disable capture child window
+     * );
+     *
+     * rtcCloud.selectScreenCaptureTarget(
+     *  selectedScreenOrWindow,
+     *  selectRect,
+     *  captureProperty
+     * );
+     *
+     * @example
+     * // 示例2: 选择要分享的窗口或屏幕，废弃的接口调用方式
+     * import TRTCCloud, { Rect } from 'trtc-electron-sdk';
+     *
+     * const rtcCloud = new TRTCCloud();
+     *
+     * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
+     *
+     * const selectedScreenOrWindow = screenAndWindows[0];
+     *
+     * const selectRect = new Rect(0, 0, 0, 0);
+     *
+     * rtcCloud.selectScreenCaptureTarget(
+     *  selectedScreenOrWindow.type,
+     *  selectedScreenOrWindow.sourceId,
+     *  selectedScreenOrWindow.sourceName,
+     *  selectRect,
+     *  true, // enable capture mouse
+     *  true // enable highlight
+     * );
      */
     selectScreenCaptureTarget(source: TRTCScreenCaptureSourceInfo | number, captureRect: Rect | string, property: TRTCScreenCaptureProperty | string, deprecatedCaptureRect?: Rect, captureMouse?: boolean, highlightWindow?: boolean): any;
     /**
@@ -1556,6 +1596,53 @@ declare class TRTCCloud extends EventEmitter {
      * @param {HTMLElement} view - 承载预览画面的 DOM
      * @param {TRTCVideoStreamType} type 屏幕分享使用的线路，可以设置为主路（TRTCVideoStreamTypeBig）或者辅路（TRTCVideoStreamTypeSub），默认使用辅路。
      * @param {TRTCVideoEncParam} params 屏幕分享的画面编码参数，可以设置为 null，表示让 SDK 选择最佳的编码参数（分辨率、码率等）。即使在调用 startScreenCapture 时设置 type=TRTCVideoStreamTypeBig，依然可以使用此接口更新屏幕分享的编码参数。
+     *
+     * @example
+     * // 分享屏幕或窗口
+     * import TRTCCloud, {
+     *  TRTCVideoStreamType,
+     *  TRTCVideoEncParam,
+     *  TRTCVideoResolution,
+     *  TRTCVideoResolutionMode
+     * } from 'trtc-electron-sdk';
+     *
+     * const rtcCloud = new TRTCCloud();
+     *
+     * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
+     *
+     * const selectedScreenOrWindow = screenAndWindows[0];
+     *
+     * const selectRect = new Rect(0, 0, 0, 0);
+     *
+     * const captureProperty = new TRTCScreenCaptureProperty(
+     *  true, // enable capture mouse
+     *  true, // enable highlight
+     *  true, // enable high performance
+     *  0, // default highlight color
+     *  0, // default highlight width
+     *  false // disable capture child window
+     * );
+     *
+     * rtcCloud.selectScreenCaptureTarget(
+     *  selectedScreenOrWindow,
+     *  selectRect,
+     *  captureProperty
+     * );
+     *
+     * const screenShareEncParam = new TRTCVideoEncParam(
+     *  TRTCVideoResolution.TRTCVideoResolution_1280_720,
+     *  TRTCVideoResolutionMode.TRTCVideoResolutionModeLandscape,
+     *  15,
+     *  1600,
+     *  0,
+     *  true,
+     * );
+     *
+     * rtcCloud.startScreenCapture(
+     *  view, // HTML Element
+     *  TRTCVideoStreamType.TRTCVideoStreamTypeSub,
+     *  screenShareEncParam,
+     * );
      */
     startScreenCapture(view?: HTMLElement | null, type?: TRTCVideoStreamType, params?: any): void;
     /**
@@ -2091,6 +2178,8 @@ declare class TRTCCloud extends EventEmitter {
     getPluginList(): PluginInfo[];
     createPlugin(pluginId: string): PluginInfo;
     setPluginCallback(pluginCb: (pluginId: string, errorCode: number, msg: string) => void): void;
+    createVodPlayer(mediaFilePath: string, repeat: boolean): VodPlayer;
+    destroyVodPlayer(vodPlayer: VodPlayer): void;
     getKey(uid: string, type: TRTCVideoStreamType): string;
     setEnableRenderFrame(enable: boolean): void;
     _getRenderer(uid: string, type: TRTCVideoStreamType): any;

package/liteav/trtc.js

@@ -21,6 +21,7 @@ const events_1 = require("events");
 const Renderer_1 = require("./Renderer");
 const util_1 = require("./Render/util");
 const yuv_buffer_1 = __importDefault(require("./Renderer/yuv-buffer"));
+const vod_player_1 = require("./vod_player");
 // @ts-ignore
 const YCbCr_1 = __importDefault(require("yuv-canvas/src/YCbCr"));
 const trtc_define_1 = require("./trtc_define");
@@ -28,6 +29,7 @@ const trtc = require('../build/Release/trtc_electron_sdk.node');
 const pkg = require('../package.json');
 __exportStar(require("./trtc_define"), exports);
 __exportStar(require("./trtc_code"), exports);
+__exportStar(require("./vod_player"), exports);
 // 监听该事件，返回自定义视频渲染数据 ( bgra 格式)
 const CUSTOM_VIDEO_DATA = 'onVideoData';
 const CAMERA_DEVICE_TEST_VIEW = 'camera_device_test_view';
@@ -192,6 +194,7 @@ class TRTCCloud extends events_1.EventEmitter {
         //VideoCallback 本地和远程
         this.localVideoCallback = null;
         this.remoteVideoCallback = new Map();
+        this.vodPlayers = {};
         secMethods(this);
         this.callExperimentalAPI("{\"api\":\"setCurrentEnvironment\",\"params\" :{\"electron\":true}}");
     }
@@ -677,7 +680,7 @@ class TRTCCloud extends events_1.EventEmitter {
      * 如果 userId 为 null，表示开始渲染本地采集的摄像头画面，需要您先调用 [startLocalPreview()]{@link TRTCCloud#startLocalPreview} 触发。
      * 如果 userId 不为 null，表示开始渲染远程用户的首帧画面，需要您先调用 [startRemoteView()]{@link TRTCCloud#startRemoteView} 触发。
      *
-     * 注意：只有当您调用 startLocalPreview()、startRemoteView() 或 startRemoteSubStreamView() 之后，才会触发该回调。
+     * 注意：只有当您调用 startLocalPreview() 或 startRemoteView() 之后，才会触发该回调。
      *
      * @event TRTCCallback#onFirstVideoFrame
      * @param {String} userId     - 本地或远程用户 ID，如果 userId == '' 代表本地，userId != '' 代表远程。
@@ -1087,7 +1090,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;
@@ -1279,7 +1282,7 @@ class TRTCCloud extends events_1.EventEmitter {
                     }
                 }
                 else {
-                    console.error(`trtc:handleVideoSizeChange error: ${userId} ${streamType} buffer not exist`);
+                    console.warn(`trtc:handleVideoSizeChange error: ${userId} ${streamType} buffer not exist`);
                 }
             }
             else {
@@ -1552,17 +1555,21 @@ class TRTCCloud extends events_1.EventEmitter {
      * 2.3 开始向非腾讯云的直播 CDN 转推
      *
      * 该接口跟 startPublishing() 类似，但 startPublishCDNStream() 支持向非腾讯云的直播 CDN 转推。
-     * 使用 startPublishing() 绑定腾讯云直播 CDN 不收取额外的费用。
-     * 使用 startPublishCDNStream() 绑定非腾讯云直播 CDN 需要收取转推费用，且需要通过工单联系我们开通。
+     *
+     * 注意：
+     * - 使用 startPublishing() 绑定腾讯云直播 CDN 不收取额外的费用。
+     * - 使用 startPublishCDNStream() 绑定非腾讯云直播 CDN 需要收取转推费用，且需要通过工单联系我们开通。
      *
      * @param {TRTCPublishCDNParam} param - 转推参数
-     * @param {Number} param.appId - 腾讯云 AppID
-     * @param {Number} param.bizId - 腾讯云直播 bizId
-     * @param {String} param.url   - 旁路转推的 URL
+     * @param {Number} param.appId - 腾讯云直播服务的 AppID
+     * @param {Number} param.bizId - 腾讯云直播服务的 bizid
+     * @param {String} param.url   - 指定该路音视频流在第三方直播服务商的推流地址，推流 URL 必须为 RTMP 格式，必须符合您的目标直播服务商的规范要求，否则目标服务商会拒绝来自 TRTC 后台服务的推流请求。
+     * @param {String} param.streamId - 需要转推的 streamId，默认值：空值。如果不填写，则默认转推调用者的旁路流。
      */
     startPublishCDNStream(param) {
+        const streamId = param.streamId ? param.streamId.trim() : "";
         if (param instanceof trtc_define_1.TRTCPublishCDNParam) {
-            this.rtcCloud.startPublishCDNStream(param.appId, param.bizId, param.url);
+            this.rtcCloud.startPublishCDNStream(param.appId, param.bizId, param.url, streamId);
         }
         else {
             console.error('trtc:startPublishCDNStream, param is not instanceof TRTCPublishCDNParam!');
@@ -1693,7 +1700,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;
@@ -1772,7 +1779,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),
@@ -1945,14 +1952,14 @@ class TRTCCloud extends events_1.EventEmitter {
      * - TRTCVideoFillMode_Fit: 图像长边填满屏幕，短边区域会被填充黑色，但画面的内容肯定是完整的。
      */
     setLocalViewFillMode(mode) {
-        let key = this.getKey('local_video', trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig);
+        const key = this.getKey('local_video', trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig);
         if (this.streams.has(key)) {
             const renderer = this.streams.get(key);
             this.localFillMode = mode;
             renderer.setContentMode(mode);
         }
         else {
-            console.error('trtc:api setLocalViewFillMode failed. the local stream does not exist.');
+            console.warn('trtc:api setLocalViewFillMode failed. the local stream does not exist.');
         }
     }
     /**
@@ -2562,12 +2569,10 @@ class TRTCCloud extends events_1.EventEmitter {
      * - yOffset：水印的坐标，取值范围为0 - 1的浮点数。
      * - fWidthRatio：水印的大小比例，取值范围为0 - 1的浮点数。
      *
-     * 注意：Windows 平台不支持设置水印
-     *
      * @param {TRTCVideoStreamType} streamType - 要设置水印的流类型(TRTCVideoStreamTypeBig、TRTCVideoStreamTypeSub)
-     * @param {ArrayBuffer} srcData - 水印图片源数据（传 null 表示去掉水印）
+     * @param {ArrayBuffer|String} srcData - 水印图片源数据（传 null 表示去掉水印）
      * @param {TRTCWaterMarkSrcType} srcType - 水印图片源数据类型
-     * - TRTCWaterMarkSrcTypeFile  : Electron 平台不支持
+     * - TRTCWaterMarkSrcTypeFile  : 图片文件路径，支持 BMP、GIF、JPEG、PNG、TIFF、Exif、WMF 和 EMF 文件格式
      * - TRTCWaterMarkSrcTypeBGRA32: BGRA32格式内存块
      * - TRTCWaterMarkSrcTypeRGBA32: RGBA32格式内存块
      * @param {Number} nWidth      - 水印图片像素宽度（源数据为文件路径时忽略该参数）
@@ -2690,20 +2695,56 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {Rect} captureRect    - 指定捕获的区域
      * @param {TRTCScreenCaptureProperty} property  - 指定屏幕分享目标的属性，包括捕获鼠标，高亮捕获窗口等，详情参考TRTCScreenCaptureProperty 定义
      *
-     * 废弃参数使用方法(针对 9.3 以下版本):
-     * @param {TRTCScreenCaptureSourceType} type - 采集源类型
-     * - TRTCScreenCaptureSourceTypeWindow: 该分享目标是某一个Windows窗口
-     * - TRTCScreenCaptureSourceTypeScreen: 该分享目标是整个Windows桌面
-     * - TRTCScreenCaptureSourceTypeCustom: 该分享目标是自定义窗口区域
-     * @param {String} sourceId    - 采集源ID，对于窗口，该字段指示窗口句柄；对于屏幕，该字段指示屏幕ID
-     * @param {String} sourcename  - 采集源名称，UTF8编码
-     * @param {Rect} captureRect - 指定捕获的区域
-     * @param {Number} captureRect.left   - 指定捕获的区域的左坐标
-     * @param {Number} captureRect.top    - 指定捕获的区域的上坐标
-     * @param {Number} captureRect.right  - 指定捕获的区域的右坐标
-     * @param {Number} captureRect.bottom - 指定捕获的区域的下坐标
-     * @param {Boolean} captureMouse    - 指定是否捕获鼠标指针
-     * @param {Boolean} highlightWindow - 指定是否高亮正在共享的窗口，以及当捕获图像被遮挡时高亮遮挡窗口提示用户移走遮挡
+     * @example
+     * // 示例1: 选择要分享的窗口或屏幕
+     * import TRTCCloud, {
+     *  Rect,
+     *  TRTCScreenCaptureProperty
+     * } from 'trtc-electron-sdk';
+     *
+     * const rtcCloud = new TRTCCloud();
+     *
+     * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
+     *
+     * const selectedScreenOrWindow = screenAndWindows[0];
+     *
+     * const selectRect = new Rect(0, 0, 0, 0);
+     *
+     * const captureProperty = new TRTCScreenCaptureProperty(
+     *  true, // enable capture mouse
+     *  true, // enable highlight
+     *  true, // enable high performance
+     *  0, // default highlight color
+     *  0, // default highlight width
+     *  false // disable capture child window
+     * );
+     *
+     * rtcCloud.selectScreenCaptureTarget(
+     *  selectedScreenOrWindow,
+     *  selectRect,
+     *  captureProperty
+     * );
+     *
+     * @example
+     * // 示例2: 选择要分享的窗口或屏幕，废弃的接口调用方式
+     * import TRTCCloud, { Rect } from 'trtc-electron-sdk';
+     *
+     * const rtcCloud = new TRTCCloud();
+     *
+     * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
+     *
+     * const selectedScreenOrWindow = screenAndWindows[0];
+     *
+     * const selectRect = new Rect(0, 0, 0, 0);
+     *
+     * rtcCloud.selectScreenCaptureTarget(
+     *  selectedScreenOrWindow.type,
+     *  selectedScreenOrWindow.sourceId,
+     *  selectedScreenOrWindow.sourceName,
+     *  selectRect,
+     *  true, // enable capture mouse
+     *  true // enable highlight
+     * );
      */
     selectScreenCaptureTarget(source, captureRect, property, deprecatedCaptureRect, captureMouse, highlightWindow) {
         if (source.sourceId && captureRect instanceof trtc_define_1.Rect && property instanceof trtc_define_1.TRTCScreenCaptureProperty) {
@@ -2734,6 +2775,53 @@ class TRTCCloud extends events_1.EventEmitter {
      * @param {HTMLElement} view - 承载预览画面的 DOM
      * @param {TRTCVideoStreamType} type 屏幕分享使用的线路，可以设置为主路（TRTCVideoStreamTypeBig）或者辅路（TRTCVideoStreamTypeSub），默认使用辅路。
      * @param {TRTCVideoEncParam} params 屏幕分享的画面编码参数，可以设置为 null，表示让 SDK 选择最佳的编码参数（分辨率、码率等）。即使在调用 startScreenCapture 时设置 type=TRTCVideoStreamTypeBig，依然可以使用此接口更新屏幕分享的编码参数。
+     *
+     * @example
+     * // 分享屏幕或窗口
+     * import TRTCCloud, {
+     *  TRTCVideoStreamType,
+     *  TRTCVideoEncParam,
+     *  TRTCVideoResolution,
+     *  TRTCVideoResolutionMode
+     * } from 'trtc-electron-sdk';
+     *
+     * const rtcCloud = new TRTCCloud();
+     *
+     * const screenAndWindows = rtcCloud.getScreenCaptureSources(320, 180, 32, 32);
+     *
+     * const selectedScreenOrWindow = screenAndWindows[0];
+     *
+     * const selectRect = new Rect(0, 0, 0, 0);
+     *
+     * const captureProperty = new TRTCScreenCaptureProperty(
+     *  true, // enable capture mouse
+     *  true, // enable highlight
+     *  true, // enable high performance
+     *  0, // default highlight color
+     *  0, // default highlight width
+     *  false // disable capture child window
+     * );
+     *
+     * rtcCloud.selectScreenCaptureTarget(
+     *  selectedScreenOrWindow,
+     *  selectRect,
+     *  captureProperty
+     * );
+     *
+     * const screenShareEncParam = new TRTCVideoEncParam(
+     *  TRTCVideoResolution.TRTCVideoResolution_1280_720,
+     *  TRTCVideoResolutionMode.TRTCVideoResolutionModeLandscape,
+     *  15,
+     *  1600,
+     *  0,
+     *  true,
+     * );
+     *
+     * rtcCloud.startScreenCapture(
+     *  view, // HTML Element
+     *  TRTCVideoStreamType.TRTCVideoStreamTypeSub,
+     *  screenShareEncParam,
+     * );
      */
     startScreenCapture(view = null, type = trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub, params = null) {
         if ((type !== trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeSub && type !== trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig)) {
@@ -3651,6 +3739,25 @@ class TRTCCloud extends events_1.EventEmitter {
     setPluginCallback(pluginCb) {
         this.rtcCloud.setPluginCallback(pluginCb);
     }
+    //----------------------------------//
+    // vod apis
+    //----------------------------------//
+    createVodPlayer(mediaFilePath, repeat) {
+        const nativeVodPlayer = this.rtcCloud.createVodPlayer(mediaFilePath, repeat);
+        if (nativeVodPlayer) {
+            const vodPlayer = new vod_player_1.VodPlayer(nativeVodPlayer, mediaFilePath, repeat);
+            vodPlayer.setVodPlayerRenderCallback();
+            vodPlayer.setVodEventCallback();
+            this.vodPlayers[vodPlayer.key] = vodPlayer;
+            return vodPlayer;
+        }
+        return null;
+    }
+    destroyVodPlayer(vodPlayer) {
+        vodPlayer.destroyRender();
+        this.rtcCloud.destroyVodPlayer(vodPlayer.key);
+        delete this.vodPlayers[vodPlayer.key];
+    }
     getKey(uid, type) {
         return String(uid) + '_' + String(type);
     }
@@ -3757,12 +3864,11 @@ class TRTCCloud extends events_1.EventEmitter {
         });
     }
     _initRender(key, view) {
-        let renderer;
         if (this.streams.has(String(key))) {
             this._destroyRender(key, null);
         }
         view.innerHTML = ''; // 事先清空一下，避免画面叠加
-        renderer = (0, Renderer_1.createRenderer)(this.pixelformate, view);
+        const renderer = (0, Renderer_1.createRenderer)(this.pixelformate, view);
         this.streams.set(String(key), renderer);
         if (key === this.getKey('local_video', trtc_define_1.TRTCVideoStreamType.TRTCVideoStreamTypeBig)) {
             // 只有本地视频, 才设置 local fill mode

package/liteav/trtc_define.d.ts

@@ -574,13 +574,15 @@ export declare class TRTCTranscodingConfig {
  * @param {Number} appId - 腾讯云 AppID，请在 [实时音视频控制台](https://console.cloud.tencent.com/rav) 选择已经创建的应用，单击【帐号信息】后，在“直播信息”中获取
  * @param {Number} bizId - 腾讯云直播 bizId，请在 [实时音视频控制台](https://console.cloud.tencent.com/rav) 选择已经创建的应用，单击【帐号信息】后，在“直播信息”中获取
  * @param {String} url - 旁路转推的 URL
+ * @param {String} streamId - 需要转推的 streamId，默认值：空值。如果不填写，则默认转推调用者的旁路流。
  *
  */
 export declare class TRTCPublishCDNParam {
     appId: number;
     bizId: number;
     url: null | string;
-    constructor(appId?: number, bizId?: number, url?: null | string);
+    streamId: null | string;
+    constructor(appId?: number, bizId?: number, url?: null | string, streamId?: null | string);
 }
 /**
  * 5.15 录音参数

package/liteav/trtc_define.js

@@ -1193,13 +1193,15 @@ exports.TRTCTranscodingConfig = TRTCTranscodingConfig;
  * @param {Number} appId - 腾讯云 AppID，请在 [实时音视频控制台](https://console.cloud.tencent.com/rav) 选择已经创建的应用，单击【帐号信息】后，在“直播信息”中获取
  * @param {Number} bizId - 腾讯云直播 bizId，请在 [实时音视频控制台](https://console.cloud.tencent.com/rav) 选择已经创建的应用，单击【帐号信息】后，在“直播信息”中获取
  * @param {String} url - 旁路转推的 URL
+ * @param {String} streamId - 需要转推的 streamId，默认值：空值。如果不填写，则默认转推调用者的旁路流。
  *
  */
 class TRTCPublishCDNParam {
-    constructor(appId = 0, bizId = 0, url = null) {
+    constructor(appId = 0, bizId = 0, url = null, streamId = null) {
         this.appId = appId;
         this.bizId = bizId;
         this.url = url;
+        this.streamId = streamId;
     }
 }
 exports.TRTCPublishCDNParam = TRTCPublishCDNParam;

package/liteav/vod_player.d.ts

@@ -0,0 +1,51 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { TRTCVideoRotation } from './trtc_define';
+export declare enum PlayerEvents {
+    onVodPlayerStarted = "onVodPlayerStarted",
+    onVodPlayerProgress = "onVodPlayerProgress",
+    onVodPlayerPaused = "onVodPlayerPaused",
+    onVodPlayerResumed = "onVodPlayerResumed",
+    onVodPlayerStoped = "onVodPlayerStoped",
+    onVodPlayerError = "onVodPlayerError"
+}
+export declare class VodPlayer extends EventEmitter {
+    key: number;
+    private renderer;
+    private nativeVodPlayer;
+    private mediaFilePath;
+    private repeat;
+    private view;
+    private isStarted;
+    constructor(nativeVodPlayer: any, mediaFilePath: string, repeat: boolean);
+    setVodPlayerView(view: HTMLElement): void;
+    start(): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    seek(msPos: number): void;
+    getDuration(): number;
+    getWidth(): number;
+    getHeight(): number;
+    mute(mute: boolean): void;
+    setVolume(volume: number): void;
+    setRate(rate: number): void;
+    attachTRTC(): void;
+    detachTRTC(): void;
+    publishVideo(): void;
+    publishAudio(): void;
+    unpublishVideo(): void;
+    unpublishAudio(): void;
+    setVodPlayerRenderCallback(): void;
+    setVodEventCallback(): void;
+    _renderVodVideoFrame(frame: {
+        data: Buffer;
+        width: number;
+        height: number;
+        timestamp: number;
+        rotation: TRTCVideoRotation;
+    }): void;
+    _initRender(view: HTMLElement): void;
+    destroyRender(): void;
+}

package/liteav/vod_player.js

@@ -0,0 +1,168 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VodPlayer = exports.PlayerEvents = void 0;
+const events_1 = require("events");
+const Render_1 = __importDefault(require("./Render"));
+var PlayerEvents;
+(function (PlayerEvents) {
+    PlayerEvents["onVodPlayerStarted"] = "onVodPlayerStarted";
+    PlayerEvents["onVodPlayerProgress"] = "onVodPlayerProgress";
+    PlayerEvents["onVodPlayerPaused"] = "onVodPlayerPaused";
+    PlayerEvents["onVodPlayerResumed"] = "onVodPlayerResumed";
+    PlayerEvents["onVodPlayerStoped"] = "onVodPlayerStoped";
+    PlayerEvents["onVodPlayerError"] = "onVodPlayerError";
+})(PlayerEvents = exports.PlayerEvents || (exports.PlayerEvents = {}));
+class VodPlayer extends events_1.EventEmitter {
+    constructor(nativeVodPlayer, mediaFilePath, repeat) {
+        super();
+        this.key = nativeVodPlayer.key;
+        this.nativeVodPlayer = nativeVodPlayer;
+        this.mediaFilePath = mediaFilePath;
+        this.repeat = repeat;
+        this.view = null;
+        this.isStarted = false;
+    }
+    setVodPlayerView(view) {
+        this.view = view;
+        this._initRender(this.view);
+    }
+    start() {
+        if (!this.isStarted) {
+            this.nativeVodPlayer.start();
+        }
+        this.isStarted = true;
+    }
+    pause() {
+        this.nativeVodPlayer.pause();
+    }
+    resume() {
+        this.nativeVodPlayer.resume();
+    }
+    stop() {
+        this.isStarted = false;
+        this.nativeVodPlayer.stop();
+    }
+    seek(msPos) {
+        this.nativeVodPlayer.seek(msPos);
+    }
+    getDuration() {
+        return this.nativeVodPlayer.getDuration();
+    }
+    getWidth() {
+        return this.nativeVodPlayer.getWidth();
+    }
+    getHeight() {
+        return this.nativeVodPlayer.getHeight();
+    }
+    mute(mute) {
+        this.nativeVodPlayer.mute(mute);
+    }
+    setVolume(volume) {
+        this.nativeVodPlayer.setVolume(volume);
+    }
+    setRate(rate) {
+        this.nativeVodPlayer.setRate(rate);
+    }
+    attachTRTC() {
+        this.nativeVodPlayer.attachTRTC();
+    }
+    detachTRTC() {
+        this.nativeVodPlayer.detachTRTC();
+    }
+    publishVideo() {
+        this.nativeVodPlayer.publishVideo();
+    }
+    publishAudio() {
+        this.nativeVodPlayer.publishAudio();
+    }
+    unpublishVideo() {
+        this.nativeVodPlayer.unpublishVideo();
+    }
+    unpublishAudio() {
+        this.nativeVodPlayer.unpublishAudio();
+    }
+    setVodPlayerRenderCallback() {
+        let callback = (width, height, timestamp, rotation, data) => {
+            this._renderVodVideoFrame({
+                data, width, height,
+                timestamp, rotation
+            });
+        };
+        this.nativeVodPlayer.setVodPlayerRenderCallback({
+            onVodVideoFrame: callback
+        });
+    }
+    setVodEventCallback() {
+        let eventCallback = (eventName, param) => {
+            if (eventName === PlayerEvents.onVodPlayerStarted) {
+                const msLength = param;
+                this.emit(eventName, msLength);
+            }
+            if (eventName === PlayerEvents.onVodPlayerProgress) {
+                const msPos = param;
+                this.emit(eventName, msPos);
+            }
+            if (eventName === PlayerEvents.onVodPlayerPaused) {
+                this.emit(eventName);
+            }
+            if (eventName === PlayerEvents.onVodPlayerResumed) {
+                this.emit(eventName);
+            }
+            if (eventName === PlayerEvents.onVodPlayerStoped) {
+                const reason = param;
+                this.emit(eventName, reason);
+            }
+            if (eventName === PlayerEvents.onVodPlayerError) {
+                const error = param;
+                this.emit(eventName, error);
+            }
+        };
+        this.nativeVodPlayer.setVodEventCallback(eventCallback);
+    }
+    _renderVodVideoFrame(frame) {
+        const { data, width, height, timestamp, rotation } = frame;
+        if (!this.renderer || !this.view) {
+            return;
+        }
+        const newData = data.slice(0); // Electron 12 及以下版本，来自底层的帧数据必须复制一次，否则 WebGL 渲染阶段会奔溃
+        const realRotation = rotation * 90; //ratation是0, 1, 2, 3. 绘制内部使用0, 90, 180, 270
+        let ylen = width * height;
+        let ulen = width * height / 4;
+        let ydata = new Uint8Array(newData, 0, ylen);
+        let udata = new Uint8Array(newData, ylen, ulen);
+        let vdata = new Uint8Array(newData, ylen + ulen, ulen);
+        this.renderer.drawFrame({
+            width: width,
+            height: height,
+            rotation: realRotation,
+            timestamp: timestamp,
+            yUint8Array: ydata,
+            uUint8Array: udata,
+            vUint8Array: vdata,
+            isNeedRotate: false
+        });
+        ydata = null;
+        udata = null;
+        vdata = null;
+    }
+    _initRender(view) {
+        if (this.renderer) {
+            this.destroyRender();
+        }
+        this.renderer = new Render_1.default.GlRenderer();
+        view.innerHTML = ''; // 事先清空一下，避免画面叠加
+        this.renderer.bind(view);
+    }
+    destroyRender() {
+        try {
+            this.renderer.unbind();
+            this.renderer = null;
+        }
+        catch (err) {
+        }
+    }
+}
+exports.VodPlayer = VodPlayer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trtc-electron-sdk",
-  "version": "10.6.403",
+  "version": "10.6.404-beta.1",
   "description": "trtc electron sdk",
   "main": "./liteav/trtc.js",
   "types": "./liteav/trtc.d.ts",
@@ -14,6 +14,7 @@
     "rimraf": "^3.0.2",
     "semver": "^6.0.0",
     "signale": "^1.4.0",
+    "yuv-buffer": "^1.0.0",
     "yuv-canvas": "^1.2.6"
   },
   "devDependencies": {