1.本页介绍Android SDK集成至开发包内所需的初始化接口函数.
(注意:在接入云平台实现SDK音频等各个能力之前必须先调用初始化接口函数)
2.SDK初始化流程
3.如何开始?
初始化接口
1. 添加初始化回调
原型:- ULSService.addInitListener(InitListener listener)
功能:添加初始化回调接口
返回:无
备注:必须在链接云平台前调用该函数
参数:
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
listener | InitListener | 必选 | 监听接口 |
2. 移除初始化回调
原型:- ULSService.removeInitListener(InitListener listener)
功能:移除监听器接口
返回:无
备注:移除之前添加的监听器
参数:
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
listener | InitListener | 必选 | 监听接口 |
3. 添加连接回调
原型:- ULSService.addConnectionListener(ConnectionListener listener)
功能:添加链接回调接口
返回:无
备注:必须在链接云平台前调用该函数
参数:
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
listener | ConnectionListener | 必选 | 监听接口 |
4. 移除连接回调
原型:- ULSService.removeConnectionListener(ConnectionListener listener)
功能:移除监听器接口
返回:无
备注:移除之前添加的监听器
参数:
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
listener | ConnectionListener | 必选 | 监听接口 |
5. 添加呼叫状态回调
原型:- ULSCall.addCallStateListener(CallStateListener listener)
功能:呼叫状态回调
返回:无
备注:每一发起新呼叫前调用函数,同时呼叫结束后系统会自动去除
参数:
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
listener | CallStateListener | 必选 | 监听接口 |
6. 初始化SDK:方式1
原型:- ULSService.setDeveloper(String devId,String appId);
功能:设置开发者ID,应用ID
返回:无
备注:设置完开发者信息事,可直接后续初始化
参数:
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
devId | Context | 必选 | 开发者ID |
appId | Context | 必选 | 应用ID |
原型:- ULSService.init(Context context,boolean logSwitch);
功能:初始化SDK ,启动语音通话等功能
返回:无
备注:初始化操作是异步的,过监听回调进行判断成功与失败
参数:
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
context | Context | 必选 | 当前程序上下文 |
logSwitch | Boolean | 必选 | 日志开关 |
7. 初始化SDK:方式2
原型:- ULSService.init(Context context,String devId,String appId,boolean logSwitch);
功能:初始化SDK ,启动语音通话等功能
返回:无
备注:初始化操作是异步的,过监听回调进行判断成功与失败
参数:
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
context | Context | 必选 | 当前程序上下文 |
devId | Context | 必选 | 开发者ID |
appId | Context | 必选 | 应用ID |
logSwitch | Boolean | 必选 | 日志开关 |
8. 连接云平台
原型:- ULSService.connect(String clientId, String clientPwd)
功能:连接云平台
返回:无
备注:链接云平台前,必须初始化SDK和添加链接回调接口
参数:
参数 | 类型 | 约束 | 说明 |
---|---|---|---|
clientId | String | 必选 | 子账户ID |
clientPwd | String | 必选 | 子账户密码 |
9. 断开云平台连接
原型:- ULSService.uninit()
功能:断开与云平台的连接
返回:无
备注:断开与云平台链接
参数:无
10. 获取连接云平台状态
原型:- ULSService.isConnected()
功能:判断是否链接上云平台
返回:true或false
备注:true表示链接成功,false表示链接失败
参数:无
11. 获取SDK版本号
原型:- ULSService.getSDKVersion()
功能:获取SDK 的版本
返回:SDK 版本号
备注:开发者通过此方法获得版本号
参数:无
配置回调函数
12.初始化成功
原型:- onInitSuccessfull()
功能:初始化平台成功回调
返回:初始化成功的状态
备注:初始化云平台成功后的回调此方法
参数:无
13.初始化失败
原型:- onInitFailed(ULSReason reason)
功能:初始化云平台失败回调
返回:错误状态码
备注:初始化云平台失败后回调
参数:
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
Reson | ULSReson | 必选 | 失败返回信息 |
14.断开释放成功
原型:- onInitSuccessfull()
功能:断开释放平台成功回调
返回:断开释放成功的状态
备注:断开释放云平台成功后的回调此方法
参数:无
15.连接成功
原型:- onConnectionSuccessfull()
功能:连接云平台成功回调
返回:连接成功的状态
备注:连接云平台成功后的回调此方法
参数:无
16.连接失败
原型:- onConnectionFailed(ULSReason reason)
功能:连接云平台失败回调
返回:错误状态码
备注:链接云平台失败后回调
参数:
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
Reson | ULSReson | 必选 | 失败返回信息 |