初始化
在使用 IMLib 的能力之前,必须先调用 IMLib 的初始化方法,并且确保在应用的整个生命周期内仅执行一次。
App Key 是使用 IMLib 进行即时通讯功能开发的必要条件,也是应用的唯一标识。在集成 IMLib 前,请务必先通过融云控制台注册并获取专属的 App Key
。
提示
请注意区分开发环境与生产环境所使用的 App Key。只有在 App Key 完全一致的情况下,不同用户之间的消息才能正常互通
使用 init 方法进行 SDK 初始化,并将 App Key 作为参数传入。
接口
JavaScript
RongIMLib.init(options)
参数说明
参数 options 为 Object 类型,包含的属性值如下:
参数 | 类型 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|
appkey | String | 是 | 应用的唯一标识 | 3.0.0 |
areaCode | AreaCode | 否 | 区域码配置。默认连接北京数据中心,如您的 App Key 属于新加坡、北美等数据中心,需传入对应区域码。详见海外数据中心使用指南。 | 5.7.9 |
logOutputLevel | EnableLogL | 否 | 日志输出级别,默认为 EnableLogL.WARN | 5.6.0 |
示例代码
JavaScript
// 应用初始化,务必保证此操作在应用生命周期内仅执行一次
RongIMLib.init({
appkey: '<Your-App-Key>'
});