本文介绍如何初始化适配 Web 类型应用的 V10 系列网易云信即时通讯 SDK（简称 NIM SDK）。初始化的模块主要包括 IM 消息、会话、用户资料、好友关系、用户关系、群组。

调用时机

对 NIM SDK 进行初始化的时机，是在调用各项即时通讯功能之前。一般情况下，在应用的生命周期内，仅需进行一次初始化。

前提条件

初始化 NIM SDK 前，请确保您已经完成了以下操作：

• 集成 NIM SDK。
• 在 网易云信控制台 上 创建应用，并获取 App Key 和 App Secret。
• 注册网易云信 IM 账号，获取 IM 账号和 Token。

实现初始化

调用 V2NIM.getInstance 方法创建 NIM 实例，同时配置初始化参数。

• V2NIM.getInstance 方法为单例模式，对于同一个账号永远返回同一个实例，即只在第一次调用时初始化一个实例，后续调用该方法会直接返回初始化过的实例。

• 如需更新初始化配置，不建议继续调用 V2NIM.getInstance 方法，推荐调用 setOptions 方法更新原 SDK 实例的初始化配置。

  如果您需要使用 V10 NIM SDK API，请将 NIMInitializeOptions.apiVersion 参数取值设置为 v2。

参数说明

TypeScriptgetInstance(_options?: NIMInitializeOptions, _otherOptions?: NIMOtherOptions): NIMInterface

NIMInitializeOptions 全部参数请参考 NIMInitializeOptions，部分重要 参数说明如下表所示：

NIMOtherOptions 全部参数请参考 NIMOtherOptions，部分重要 参数说明如下表所示：

NIMEModuleParamV2Login 参数说明：

示例代码

TypeScriptconst nim = NIM.getInstance(
  /**
   * param1: NIMInitializeOptions
   */
  {
    appkey: "YOUR_APPKEY",
    debugLevel: "debug",
    apiVersion: "v2"
  }
)

TypeScriptconst nim = NIM.getInstance(
  /**
   * param1: NIMInitializeOptions
   */
  {
  appkey: "YOUR_APPKEY",
  debugLevel: "debug",
  apiVersion: "v2"
}, {
  V2NIMLoginServiceConfig: {
    lbsUrls: [
      "https://lbs.netease.im/lbs/wxwebconf.jsp"
    ],
    linkUrl: "wlnimsc0.netease.im"
  }
});

下一步

完成初始化后，您可以尝试 登录 IM。