快速集成
环境要求
表1 环境要求(强制要求)
平台 | 说明 |
---|---|
Windows 7及以上 | 硬件要求: CPU:i5-2400 四核 3.1GHz及以上 内存:4GB及以上 软件要求:Visual Studio(版本2017及以上,建议2019(注意:Demo工程源码当前仅支持2017或2019),同时安装.NET WPF开发组件)、python3(需安装requests模块)、git、cmake3.15及以上 |
SDK快速集成
介绍集成SDK的主要步骤。
-
下载DEMO到本地
-
解压DEMO压缩包
-
将Yealink_UC_Windows_Csharp_SDKDemo_46.100.xx\config_windows.bat中的sh scripts/config-cmake.sh vs201x || pause ; exit /b 1中的内容改为对应平台的Visual Studio版本,例如用2017的话,就设置为 sh scripts/config-cmake.sh vs2017 || pause ; exit /b 1
-
执行
config_windows.bat
-
打开
Yealink_UC_Windows_Csharp_SDKDemo_46.100.xx/build-windows/{arch}/sdk_demo_csharp_wpf.sln
,点击启动,运行程序。 若启动程序时,出现报错:无法启动程序”X:\desktop-demo-csharp\sdk demo csharp wpf build-windows\x86\Debug\ALL BUILD”系统找不到指定的文件,请右键sdk_demo_csharp_wpf--设为启动项目。界面出现
SDK加载失败
的提示或没有登录入口,需进行鉴权及初始化。 -
YLSDK集成
UI-SDK API的使用可以参考yealink_sdk_lib_csharp.dll库内的接口说明
注意事项: 在初始化YLSDK之前,请监听SDK对应步骤的回调消息,待收到步骤完成的通知再执行下一个步骤。例如:监听SDK加载的消息通知,收到消息通知后再执行SDK鉴权。
为保证UI-SDK的正确使用,请按照以下流程进行API调用及返回值校验。 步骤: a. 监听SDK消息通知,包括加载结果通知、鉴权结果通知、登录结果通知。 图1:监听SDK
b. 调用 LoadSDK 执行加载SDK操作,指定Yealink Meeting.exe进程所在路径, onSDKReady 返回加载结果通知。设置日志回调 SetCallBackFor_onSDKLogEvent 需要在加载SDK之后做。 图2:加载SDK
c. 执行 InitSDK 初始化SDK,该操作阻塞且无消息通知。初始化SDK后,根据实际的App的id和 secret调用 AuthResult 进行鉴权, onAuthResultFunc 返回鉴权结果通知。 图3:SDK初始化、鉴权
d. 根据App下的有效用户账号密码,调用 Login 完成登录, onLoginResultFunc 返回登 录结果通知。 图4:帐号登录
e. 完成了前面的准备工作,可以调用 StartMeeting 建立会议。 图5:建立会议
-
应用程序发布 注:
应用程序需携带“UME qa sdk.exe”所在的bin目录及其bin同级的Resources目录,并确 保LoadSDK传入的是实际的UME qa sdk.exe所在路径。
例如:sdk_demo_csharp_wpf中 LoadSDK("../../../ylsdk/bin"); ,则相对目录的上三级即需存在 ylsdk文件夹,ylsdk文件夹下包含bin和Resources文件夹,“UME qa sdk.exe”则存在于bin目 录中。