描述

在使用eSDK CloudEC系列业务，配套CloudEC解决方案实现各类业务前，需要先完成SDK初始化。

业务流程

图1 初始化和去初始化组件流程图 

• 初始化
  1. 应用程序在初始化组件前，调用TsdkManager类的getInstance()方法得到实例对象并且初始化对象的值。
     说明： 

     在得到实例对象的同时需要传入一些必要的参数，上下文(context)，应用程序库加载路径(appPath)，SDK事件通知处理对象(notify)。

     代码示例：

     //java code TsdkManager tsdkManager = TsdkManager.getInstance(context, appPath, ServiceNotify.getInstance());

  2. 应用程序在初始化组件前，调用TsdkManager类的setConfigParam()方法设置业务参数。

     除必选参数外，应用程序若不进行相应参数设置，组件则使用默认配置。参数解释如业务参数所示。

     表1 业务参数

     业务参数	对应的参数	说明
     日志参数	TsdkLogParam	移动平台必选，初始化前设置
     TLS参数	TsdkTlsParam	可选，初始化前设置
     Proxy参数	TsdkProxyParam	可选，登录前设置
     Service Security参数	TsdkServiceSecurityParam	可选，登录前设置
     本地IP地址	TsdkLocalAddress	移动平台必选，登录前设置
     应用程序文件路径信息	TsdkAppFilePathInfo	使用企业通讯录功能时必选，初始化前设置
     设备DPI信息	TsdkDeviceDpiInfo	可选，初始化前设置
     网络信息参数	TsdkNetworkInfoParam	可选，登录前设置
     设置会议控制参数	TsdkConfCtrlParam	必选，初始化前设置，当前仅 TSDK_E_CONF_CTRL_PROTOCOL_IDO
     设置会议显示的本端信息	TsdkDisplayLocalInfo	可选，业务启动前设置

     代码示例：

     //java code TsdkLogParam logParam = new TsdkLogParam(); logParam.setFileCount(1); logParam.setLevel(TsdkLogLevel.TSDK_E_LOG_DEBUG); logParam.setMaxSizeKb(1024 * 4); logParam.setPath(Environment.getExternalStorageDirectory() + File.separator + "ECSDKDemo" + "/"); int ret = TsdkManager.getInstance().setConfigParam(logParam);

  3. 应用程序调用TsdkManager类的init()方法实现组件初始化。
     说明： 

     1. 应用程序信息参数(TsdkAppInfoParam)包含客户端类型、产品信息以及当前应用程序支持的功能，SDK将根据相应的信息完成初始化：
        1. 对于PC客户端，终端类型(client_type)应取值TSDK_E_CLIENT_PC；对于移动客户端，终端类型(client_type)应取值TSDK_E_CLIENT_MOBILE。
        2. 产品名信息，标识应用程序的类型，取值如“eSDK-Mobile”，对于可能存在的EC服务器特定的配置，此值存在差异，若填写与服务器配置不匹配，会导致登录过程失败。
     2. 应用程序关注的事件如事件所示。

     表2 事件

     事件	事件说明
     onEvtAuthSuccess	鉴权成功（用于呈现登录过程，应用层一般无需处理）。
     onEvtAuthFailed	鉴权失败。
     onEvtAuthRefreshFailed	鉴权刷新失败。
     onEvtLoginSuccess	登录成功。
     onEvtLoginFailed	登录失败。
     onEvtLogoutSuccess	登出成功。
     onEvtLogoutFailed	登出失败。
     onEvtForceLogout	强制登出。
     onEvtVoipAccountStatus	VoIP帐号信息。
     onEvtFirewallDetectFailed	防火墙探测失败。
     onEvtBuildStgTunnelFailed	创建STG通道失败。
     onEvtSecurityTunnelInfoInd	安全隧道信息通知。
     onEvtGetTempUserResult	获取用于匿名方式加入会议的临时用户结果通知。
     onEvtCallStartResult	发起呼叫结果。
     onEvtCallIncoming	来电事件。
     onEvtCallOutgoing	呼出事件。
     onEvtCallRingback	回铃音事件（在需要APP播放回铃音时上报）。
     onEvtCallRtpCreated	RTP通道已建立，可以进行二次拨号。
     onEvtCallConnected	通话已建立。
     onEvtCallEnded	呼叫结束。
     onEvtCallDestroy	呼叫结束后销毁呼叫控制信息。
     onEvtOpenVideoReq	远端请求打开视频。
     onEvtRefuseOpenVideoInd	远端拒绝请求打开视频通知。
     onEvtCloseVideoInd	关闭视频（视频转音频）通知。
     onEvtOpenVideoInd	打开视频（音频转视频）通知。
     onEvtRefreshViewInd	视频view刷新通知。
     onEvtCallRouteChange	移动路由变化通知。
     onEvtPlayMediaEnd	音频文件播放结束通知。
     onEvtSessionModified	会话修改完成通知。
     onEvtSessionCodec	会话正在使用的codec通知。
     onEvtHoldSuccess	呼叫保持成功。
     onEvtHoldFailed	呼叫保持失败。
     onEvtUnholdSuccess	恢复通话成功。
     onEvtUnholdFailed	恢复通话失败。
     onEvtEndcallFailed	结束通话失败。
     onEvtBookConfResult	预约会议结果。
     onEvtQueryConfListResult	查询会议列表结果。
     onEvtQueryConfDetailResult	查询会议详情结果。
     onEvtJoinConfResult	加入会议结果。
     onEvtGetDataconfParamResult	获取数据会议参数结果。
     onEvtConfctrlOperationResult	会控操作结果。
     onEvtInfoAndStatusUpdate	会议信息及状态更新。
     onEvtSpeakerInd	发言方通知。
     onEvtRequestConfRightFailed	申请会控权限失败。
     onEvtConfIncomingInd	会议来电通知。
     onEvtConfEndInd	会议结束通知。
     onEvtJoinDataConfResult	加入数据会议结果。
     onEvtAsStateChange	应用共享状态通知。
     onEvtAsOwnerChange	共享者变更通知。
     onEvtRecvChatMsg	收到会议中的聊天消息通知。
     onEvtTransToConfResult	呼叫转成会议结果。
     onEvtDsDocNew	新建一个共享文档。
     onEvtDsDocDel	删除一个共享文档。
     onEvtWbDocNew	新建一个白板文档。
     onEvtWbDocDel	删除一个白板文档。
     onEvtSearchContactsResult	查询联系人结果。
     onEvtGetIconResult	获取头像结果。

  代码示例：

  //Java code TsdkAppInfoParam appInfoParam = new TsdkAppInfoParam(); appInfoParam.setClientType(TSDK_E_CLIENT_MOBILE); appInfoParam.setProductName("SoftClient on Mobile"); appInfoParam.setDeviceSn("123"); appInfoParam.setSupportAudioAndVideoCall(this.isSupportAudioAndVideoCall?1:0); appInfoParam.setSupportAudioAndVideoConf(this.isSupportAudioAndVideoConf?1:0); appInfoParam.setSupportDataConf(this.isSupportDataConf?1:0); appInfoParam.setSupportCtd(this.isSupportCTD?1:0); appInfoParam.setSupportEnterpriseAddressBook(this.isSupportAddressbook?1:0); appInfoParam.setSupportIm(0); appInfoParam.setSupportRichMediaMessage(0); int ret = TsdkManager.getInstance().init(appInfoParam);

• 去初始化

  应用程序关闭时，UI调用TsdkManager类的uninit()方法去初始化基础组件，释放相应资源。

  代码示例：

  //Java code public int uninit();

注意事项

无。