初始化
关于停止维护 IMLib v2 旧版 SDK 的声明
注意
- Web IMLib v2 版本目前已停止维护,建议您优先选择最新的 IMLib 版本。
- 已集成 IMLib v2 版本的用户,转为使用 Adapter 方式进行支持。集成旧版 2x SDK 的客户可以通过
RongIMLib-v2-Adapter
无缝替换升级。详见 升级说明。- 未来我们将在
RongIMLib-v2-Adapter
上进行问题修复,但不会增加新功能。
功能描述
融云 SDK 需要开发者在工程中调用下面方法来初始化 SDK。在应用整个生命周期中,开发者只需要将 SDK 初始化一次。
危险
- 请在开发功能之前从 融云开发者控制台 注册得到的 Appkey,通过调用
RongIMLib.RongIMClient.init
传入 AppKey,进行 SDK 初始化。 - 开发者在使用融云 SDK 所有功能之前,开发者必须先调用此方法初始化 SDK。 在页面的整个生命周期中,开发者只需要将 SDK 初始化一 次。
API 参考:LogLevel
参数说明
参数 | 类型 | 必填 | 说明 | 最低版本 | 废弃版本 |
---|---|---|---|---|---|
appKey | String | 是 | 应用的唯一标识 | 2.0.0 | |
Object | 否 | 仅在桌面版有效,Web 可忽略 | 2.0.0 | 2.6.0 | |
options | Object | 否 | 参数配置 | 2.0.0 |
options
参数说明
参数 | 类型 | 必填 | 说明 | 最低版本 | 废弃版本 |
---|---|---|---|---|---|
navi | String | 否 | 私有部署 navi 导航 | 2.0.0 | |
String | 否 | 私有部署 api 地址 | 2.0.0 | 2.6.0 | |
String | 否 | 私有部署 protobuf 地址 | 2.0.0 | 2.6.0 | |
logLevel | LogLevel | 否 | 输出日志等级 | 2.8.0 | |
logStdout | Function | 否 | 修改默认日志输出函数 | 2.8.0 | |
checkCA | Boolean | 否 | PC 端的 https 证书认证开关,默认为 true | 2.9.4 | |
readReceiptTimeout | Number | 否 | web 端群聊天回执状态本地存储过期时间,默认为:1,最大为:15,单位:天 | 2.9.4 |
LogLevel
类型说明
关键字 | 值 | 说明 |
---|---|---|
DEBUG | 0 | 调试 |
INFO | 1 | 信息 |
WARN | 2 | 警告 |
ERROR | 3 | 错误 |
NONE | 1000 | 不展示任何日志 |
logStdout
方法参数说明
参数 | 类型 | 说明 |
---|---|---|
logLevel | LogLevel | 输出日志等级 |
content | string | 日志内容 |
代码示例
var appKey = 'kj29chm026yyn';
var options = {
navi:'', // 私有部署配置,公有云用户可忽略
api:'', // 私有部署配置,公有云用户可忽略
logLevel: 0
}
RongIMLib.RongIMClient.init(appkey, null, options);