跳到主要内容

初始化

在使用 SDK 其它功能前，必须先进行初始化。本文中将详细说明 IMLib SDK 初始化的方法。

首次使用融云的用户，我们建议先阅读 IMLib SDK 快速上手 ，以完成开发者账号注册等工作。

推送

推送是常见的基础功能。IMLib 已支持鸿蒙推送，详细说明见推送。

海外数据中心

  • SDK 默认使用北京数据中心；如果您使用海外数据中心，请注意在初始化配置中传入正确的区域码
  • SDK 各个数据中心地址参考：配置海外数据中心服务地址

初始化 SDK

在 UIAbility 的 onCreate() 方法中，调用初始化方法，传入生产或开发环境的 App Key。

// 在 UIAbility 中获取 context
let context = this.context

let initOption = new InitOption();
let appKey = "从融云后台获取的 appKey";
IMEngine.getInstance().init(context, appKey, initOption);

初始化配置 InitOption 中封装了区域码 AreaCode，导航服务地址 naviServer ，统计服务地址 statisticServer，文件下载路径 mediaSavePath。

  • 如果 App Key 属于中国（北京）数据中心，您无需传入任何配置，SDK 会使用默认配置。
  • 如果 App Key 属于海外数据中心，则必须传入有效的区域码（AreaCode）配置。请务必在控制台核验当前 App Key 所属海外数据中心后，找到 AreaCode 中对应的枚举值进行配置。

例如，使用新加坡数据中心的应用的生产或开发环境的 App Key：

// 在 UIAbility 中获取 context
let context = this.context

let initOption = new InitOption();
initOption.areaCode = AreaCode.SG;

let appKey = "Singapore_dev_AppKey";

IMEngine.getInstance().init(context, appKey, initOption);

除区域码外，初始化配置（InitOption）中还封装了以下配置：

  • 导航服务地址（naviServer）：一般情况下不建议单独配置。SDK 内部默认使用与区域码对应的地址。
  • 数据统计服务地址（statisticServer）：一般情况下不建议单独配置。SDK 内部默认使用与区域码对应的地址。
  • 文件下载路径 （mediaSavePath）：SDK 内部默认使用应用的 RongCloud/Media 目录。
// 在 UIAbility 中获取 context
let context = this.context

let initOption = new InitOption();
initOption.areaCode = AreaCode.BJ;
initOption.naviServer = "http(s)://naviServer";
initOption.statisticServer = "http(s)://StatisticServer";
initOption.mediaSavePath = "MyFile/Path/";

let appKey = "Your_AppKey";

IMEngine.getInstance().init(context, appKey, initOption);
最后于 更新