Electron 接入手册

1. demo环境配置说明

1.1 环境要求

操作系统：win7、win10、win11的32位和64位，MacOS 10.11及以上
nodejs

1.2 文件说明

为了简化 electron 的接入，我们封装了一个 node.js 的 addon，可以在 electron 中直接导入这个 addon，使用里面封装的接口即可。这个 nodejs 的 addon 的名字是 wemeet_electron_sdk.node, windows 和 mac 都是这个名字

1.2.1 Win32环境node文件

1.2.2 Win64环境node文件

1.2.3 Mac x86_64 & arm64位环境node文件

1.2.4 Mac SDK 文件

说明：在windows和mac上wemeet_electron_sdk.node的依赖文件是不一样的，但是我们提供的 .node 文件导出的接口是一致的，所以编码接入的时候无需平台的差异性，打包的时候将对应平台的依赖文件对应目录即可。

1.3 运行demo

运行demo需要配置对应平台的环境，根据下面的指引各自配置环境。

1.3.1 32位 Windows

一、拷贝SDK

方法一：按照如下表格拷贝依赖文件

名称	原路径	目的路径
api-ms-win*.dll	SDK	output/win/win32
msvcp140.dll	SDK	output/win/win32
msvcp140_1.dll (3.21新增)	SDK	output/win/win32
concrt140.dll	SDK	output/win/win32
vcomp140.dll	SDK	output/win/win32
vcruntime140.dll	SDK	output/win/win32
ucrtbase.dll	SDK	output/win/win32
wemeet_base.dll	SDK	output/win/win32
wemeetsdk_x86.dll	SDK	output/win/win32
Release文件夹	SDK	output/win/win32

注意：大版本升级sdk需要删除原来sdk所有目录文件重新拷贝，避免旧包文件残留导致包校验失败

方法二: 直接执行output/win/win32/copy_win32_release.bat(bat文件中的内容也就是做了方法1的操作，写成了脚本)

rmdir /s /q Release
mkdir Release
xcopy /S /E /Y /Q /H /D ..\..\..\..\SDK\Release .\Release
copy  ..\..\..\..\SDK\api-ms-win*.dll .\
copy ..\..\..\..\SDK\msvcp140.dll .\msvcp140.dll
copy ..\..\..\..\SDK\msvcp140_1.dll .\msvcp140_1.dll
copy ..\..\..\..\SDK\concrt140.dll .\concrt140.dll
copy ..\..\..\..\SDK\vcomp140.dll .\vcomp140.dll
copy ..\..\..\..\SDK\vcruntime140.dll .\vcruntime140.dll
copy ..\..\..\..\SDK\ucrtbase.dll .\ucrtbase.dll
copy ..\..\..\..\SDK\wemeet_base.dll .\wemeet_base.dll
copy ..\..\..\..\SDK\wemeetsdk_x86.dll .\wemeetsdk_x86.dll

减包注意（3.21.200包大小优化）：打包可选择对Release\webview和Release\resources\webview目录删除，删除不影响接口调用，使用过程中会触发内置浏览器动态下载(首次初始化触发)。

二、安装electron以及相关的依赖

方法一：Electron_Demo目录下执行npm install安装依赖
方法二：Windows内置了npm依赖包可以直接解压，解压node_modules_x86.zip到当前目录，得到32位windows node环境依赖node_modules目录

三、运行demo

Electron_Demo目录下执行npm start

1.3.2 64位 Windows

一、拷贝SDK

方法一：按照如下表格拷贝依赖文件

名称	原路径	目的路径
api-ms-win*.dll	SDK/Release/x64	output/win/x64
msvcp140.dll	SDK/Release/x64	output/win/x64
msvcp140_1.dll (3.21新增)	SDK	output/win/win32
vcruntime140.dll	SDK/Release/x64	output/win/x64
vcruntime140_1.dll	SDK/Release/x64	output/win/x64
ucrtbase.dll	SDK/Release/x64	output/win/x64
wemeet_base_x64.dll	SDK	output/win/x64
wemeetsdk_x64.dll	SDK	output/win/x64
Release文件夹	SDK	output/win/x64

注意：大版本升级sdk需要删除原来sdk所有目录文件重新拷贝，避免旧包文件残留导致包校验失败

方法二: 直接执行output/win/x64/copy_win32_release.bat(bat文件中的内容也就是做了方法1的操作，写成了脚本)

rmdir /s /q Release
mkdir Release
xcopy /S /E /Y /Q /H /D ..\..\..\..\SDK\Release .\Release
copy  ..\..\..\..\SDK\Release\x64\api-ms-win*.dll .\
copy ..\..\..\..\SDK\Release\x64\msvcp140.dll .\msvcp140.dll
copy ..\..\..\..\SDK\Release\x64\msvcp140_1.dll .\msvcp140_1.dll
copy ..\..\..\..\SDK\Release\x64\vcruntime140.dll .\vcruntime140.dll
copy ..\..\..\..\SDK\Release\x64\vcruntime140_1.dll .\vcruntime140_1.dll
copy ..\..\..\..\SDK\Release\x64\ucrtbase.dll .\ucrtbase.dll
copy ..\..\..\..\SDK\wemeet_base_x64.dll .\wemeet_base_x64.dll
copy ..\..\..\..\SDK\wemeetsdk_x64.dll .\wemeetsdk_x64.dll

减包注意（3.21.200包大小优化）：打包可选择对Release\webview和Release\resources\webview目录删除，删除不影响接口调用，使用过程中会触发内置浏览器动态下载(首次初始化触发)。

二、安装electron以及相关的依赖

方法一：Electron_Demo目录下执行npm install安装依赖
方法二：Windows内置了npm依赖包可以直接解压，解压node_modules_x64.zip到当前目录，得到64位windows node环境依赖node_modules目录

三、运行demo

Electron_Demo目录下执行npm start

1.3.3 Mac 环境

在demo_saas_sdk文件夹下启用终端

方法一、执行命令（注：此时用到的framework、wemeet_electron_sdk.node默认都是双架构）

1.1、按1.2.4中操作执行文件拷贝

1.2、npm install

1.3、npm start

方法二、执行start_electron.sh脚本（注：此时wemeet_electron_sdk.node文件会重新构建生成当前机器对应架构的。如：M1机器上生成arm64架构的，Intel机器上生成x86_64架构的）
执行完1中步骤后，等待即可，无报错情况下会自动打开demo。
执行成功过一次1中步骤后，再次运行demo可输入“npm start”指令或再次执行脚本。

注：执行start_electron.sh脚本会重新生成wemeet_electron_sdk.node默认是对应机器架构的。

Q:压缩包中SDK/TMSDK.framework是一个双架构的framework，可以在x86和arm64下运行，但是体积过大,如何拆分成单架构的framework?

A:将TMSDK.framework和mac_build_framework放在同级目录，双击运行mac_build_framework，等待即可，无报错情况下会在Build/Products/Release/framework下生成x86和arm64两个平台的架构包

Q:启动运行electron失败，提示架构不匹配，如何处理？

A:执行方法二，可以快速解决，生成对应机器的wemeet_electron_sdk.node。可以通过lipo -info xxx命令可以查看当前库的架构，确认是否和当前机器架构对应

2. SDK 接入说明

2.1 申请 SDK Id & SDK Secret

为了让SDK 正常使用，需要为 SDK 配置独有的安全凭证，安全凭证包括 SDK Id 和SDK Secret ，对每一次请求进行验证。联系腾讯会议商务对接人进行信息登记进行 SDK。

2.2 SDK 接入环境配置

2.2.1 32位 Windows

一. 安装32位的nodejs，安装electron

二. 新建electron工程

三. 在package.json加配置

javascript

"scripts": {
  "start": "node start.js && electron ."
},

四. 拷贝SDK文件，参考章节 1.3.1：

五. 在js中导入的wemeet_electron_sdk.node 文件

// path_to_your_wemeet_electron_sdk.node 表示 wemeet_electron_sdk.node的路径
const wemeet_sdk = require('path_to_your_wemeet_electron_sdk.node')
// 这里导入的 wemeet_sdk 会在接下来的接口说明中使用

目录结构如下：

注意，要保证Release目录已经拷贝到wemeet_electron_sdk.node的的同级目录下

2.2.2 64位 Windows

一. 安装64位的nodejs，安装electron

二. 新建electron工程

三. 在package.json加配置

javascript

"scripts": {
  "start": "node start.js && electron ."
},

四. 拷贝SDK文件，参考章节 1.3.2：

五. 在js中导入的wemeet_electron_sdk.node 文件

// path_to_your_wemeet_electron_sdk.node 表示 wemeet_electron_sdk.node的路径
const wemeet_sdk = require('path_to_your_wemeet_electron_sdk.node')
// 这里导入的 wemeet_sdk 会在接下来的接口说明中使用

目录结构如下：

注意，要保证Release目录已经拷贝到wemeet_electron_sdk.node的的同级目录下

2.2.3 Mac x86_64环境

一. 安装nodejs，安装electron

二. 新建electron工程

三. 将wemeet_electron_sdk.node拷贝到 output/mac目录下。

四. 在package.json加配置

"scripts": {
  "start": "node start.js && electron ."
}

五. 修改start.js，拷贝SDK文件，参考demo的start.js：

Mac端：将SDK文件（即SDK/TMSDK.framework）拷贝至node_modules/electron/dist/xxx.app/Contents/Frameworks目录下(注：此时framework是一个双架构包，拆包操作请查看1.3.3)

六. 在js中导入 wemeet_electron_sdk.node 文件

// path_to_your_wemeet_electron_sdk.node 表示 wemeet_electron_sdk.node的路径
const wemeet_sdk = require('path_to_your_wemeet_electron_sdk.node')
// 这里导入的 wemeet_sdk 会在接下来的接口说明中使用

2.2.4 Mac arm64环境

一. 安装nodejs，安装electron

二. 新建electron工程

三. 将wemeet_electron_sdk.node拷贝到 output/mac目录下。

四. 在package.json加配置

"scripts": {
  "start": "node start.js && electron ."
}

五. 修改start.js，拷贝SDK文件，参考demo的start.js：

Mac端：将SDK文件（即SDK/TMSDK.framework）拷贝至node_modules/electron/dist/xxx.app/Contents/Frameworks目录下(注：此时framework是一个双架构包，拆包操作请查看1.3.3)

六. 在js中导入 wemeet_electron_sdk.node 文件

// path_to_your_wemeet_electron_sdk.node 表示 wemeet_electron_sdk.node的路径
const wemeet_sdk = require('path_to_your_wemeet_electron_sdk.node')
// 这里导入的 wemeet_sdk 会在接下来的接口说明中使用

3. 接口说明

注意：接口调用是异步过程，需要在对应的回调中处理接口调用的结果，其中InitWemeetSDK初始化的操作必须要等到该接口的回调之后再进行其他的接口调用，否则其他的接口调用都是无效的

本文档只列出接口的名称和参数，具体参数说明可以参考《TencentMeetingSDK（TMSDK）接口参考文档》

1、初始化 SDK

windows端：wemeet_sdk.InitWemeetSDK(sdk_id, sdk_token, data_path, app_name, app_icon, language);
mac端：wemeet_sdk.InitWemeetSDK(sdk_id, sdk_token, data_path, app_name, language);
说明：3.6.3以上版本新增语言设置可选项，详情参考《TencentMeetingSDK（TMSDK）接口参考文档》

2、登录

wemeet_sdk.Login(sso_url);

3、入会

wemeet_sdk.JoinMeeting(meeting_code, user_display_name, password, invite_url, mic_on, camera_on, speaker_on, face_beauty_on)

4、显示SDK自带的会前界面（显示home界面）

wemeet_sdk.ShowPreMeetingView();

显示home界面【即将移除】

wemeet_sdk.GoToHomeView();

5、登出

wemeet_sdk.Logout();

6、退出会议

wemeet_sdk.LeaveMeeting(leave_meeting_type)

7、会议信息回调开关

wemeet_sdk.SetNeedMeetingInfoCallback(info_on, info_show)

8、邀请回调开关

wemeet_sdk.SetNeedShareCallback(invite_on, invite_show)

9、无线投屏

wemeet_sdk.StartScreenCast(cast_param)

说明：cast_param为json格式字符串，详细可参考《TencentMeetingSDK（TMSDK）接口参考文档》说明。。

10、打开日志目录

wemeet_sdk.OpenLogDirectory()

11、检查登录态

wemeet_sdk.IsAuthorized()

说明: 异步接口，调用登录，接收到登录成功回调后，返回true，没接收登录成功回调前返回false。

12、检查初始化状态

wemeet_sdk.IsInitialized()

说明: 异步接口，调用InitWemeetSDK，接收到初始化成功回调后，返回true，没接收初始化成功回调前返回false，3.0.107加入。

13、显示会议历史

wemeet_sdk.ShowHistoricalMeetingView();

14、显示会议详情

wemeet_sdk.ShowMeetingDetailView(meeting_id, current_sub_meeting_id)

版本 >=3.6.200 重载ShowMeetingDetailView接口，入参可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明：

wemeet_sdk.ShowMeetingDetailView(meeting_id, current_sub_meeting_id, start_time, is_history)

15、登录态跳转

wemeet_sdk.JumpUrlWithLoginStatus(target_url)

16、添加js回调

wemeet_sdk.AddJsCallback(call_back)

说明：这个函数是electron的sdk独有的函数，call_back 是一个js的function，参数是一个json字符串

17、会中窗口置顶

wemeet_sdk.BringInMeetingViewTop()

说明：如果当前没有会中窗口，则不做任何操作。没有回调。3.0.102加入。

18、获取当前sdk_token

wemeet_sdk.GetCurrentSDKToken()

说明：同步接口，返回类型string，返回当前sdk登录使用的sdk_token串。3.0.107加入。

19、刷新sdk_token

wemeet_sdk.RefreshSDKToken(sdk_token)

说明：同步接口，参数是要刷新的sdk_token串。返回类型int，失败返回错误码，成功返回0。

20、获取带登录态的url链接

wemeet_sdk.GetUrlWithLoginStatus(url)

说明：同步接口，参数url为不带登录态的url，返回类型string，返回带登录态的url。

21、设置代理

wemeet_sdk.SetProxyInfo(proxy_info)

说明：参数proxy_info为json格式的string类型，格式可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

22、获取代理

wemeet_sdk.GetProxyInfo()

说明：返回值参考SetProxyInfo。

23、通过json串入会

wemeet_sdk.JoinMeetingByJSON(meeting_josn)

说明：参数meeting_josn为json格式的string类型，格式可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

24、显示预定会议页面

wemeet_sdk.ShowScheduleMeetingView(meeting_type)

说明：参数meeting_type为会议类型，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

25、显示投屏页面

wemeet_sdk.ShowScreenCastView()

说明：展示投屏页面。

26、显示加入会议页面

wemeet_sdk.ShowJoinMeetingView()

说明：展示加入会议页面。

27、获取sdk的版本号

wemeet_sdk.GetSDKVersion()

说明：返回string类型，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

28、一键跳转指定页面

wemeet_sdk.HandleSchema(schema_url)

说明：参数schema_url为跳转链接，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

29、查询会议信息

wemeet_sdk.QueryMeetingInfo(meeting_info)

说明：>= 3.6.200版本，meeting_info为json格式字符串，详细可参考《TencentMeetingSDK（TMSDK）接口参考文档》说明。

30、快速会议

wemeet_sdk.QuickMeeting()

说明：>= 3.6.200版本。

31、获取当前会议状态信息

wemeet_sdk.GetCurrentMeetingInfo()

说明：>= 3.6.300版本,返回string类型，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

32、添加人员操作，接入方可以邀请人加入预定会议、或邀请人员加入会议

wemeet_sdk.AddUsersWithParam(json_param)

说明：>= 3.6.401版本，json_param为json格式字符串，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

33、SDK预定会议界面中，开启定制化通讯录的回调

wemeet_sdk.EnableAddressBookCallback(enable, show)

说明：>= 3.6.401版本，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

34、设置是否使用添加成员的回调

wemeet_sdk.EnableInviteUsersCallback(enable, show)

说明：>= 3.6.401版本，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

35、设置是否开启自定义组织架构信息

wemeet_sdk.EnableCustomOrgInfo(enable)

说明：>= 3.6.401版本，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

36、对相关成员设置自定义的组织架构信息

wemeet_sdk.SetCustomOrgInfo(json_param)

说明：>= 3.6.401版本，json_param为json格式字符串，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

37、短链入会解析

wemeet_sdk.ParseMeetingInfoUrl(scheme_url)

说明：>= 3.12版本，scheme_url为string类型，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

38、查询本地录制信息

wemeet_sdk.QueryLocalRecordInfo(meeting_id, period_id)

说明：>= 3.12版本，meeting_id、period_id为int类型，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

39、查询本地录制信息

wemeet_sdk.ShowRecordFolder(path_id)

说明：>= 3.12版本，path_id为int类型，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

40、查询本地录制信息

wemeet_sdk.Transcode(path_id)

说明：>= 3.12版本，path_id为int类型，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

41、收集日志信息

wemeet_sdk.CollectLogFiles(begin_time, end_time)

说明：>= 3.12版本，begin_time、end_time为string类型，可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

42、反初始化SDK

wemeet_sdk.UninitWemeetSDK(uninit_json)

说明：>= 3.12版本, 可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。

43、获取会中窗口信息

wemeet_sdk.GetMeetingWindowInfo()

说明：>= 3.12版本, 可参考统《TencentMeetingSDK（TMSDK）接口参考文档》说明。