本文介绍在鸿蒙平台下如何快速集成云信 NIMSDK 到项目中:

一、环境要求

二、SDK 接入流程

三、Demo 使用

四、问题反馈

五、参考

通过以上步骤，您可以基本了解鸿蒙NIMSDK 的接入与使用。

• DevEco Studio NEXT Developer Beta1（5.0.3.403） 及以上。
• HarmonyOS SDK API 11 及以上。
• 运行环境 HarnomyOS NEXT 2.1.2.5 (Canary1) 以上

• 真机华为 Mate 系列
• 操作系统 HarnomyOS NEXT 2.1.2.5 (Canary1) 以上

于“设置”->“关于手机”页面查看

创建应用，详情官方文档：点这里

打开 NIMAPIDemo 配置签名：当前 NIMAPIDemo 已经配置好 Huawei Phone 模拟器与部分网易内部 HarmonyOS NEXT 真机的安装证书与 Profile，支持所有模拟器安装应用。若期望将证书移动到私有华为开发者账号体系下，需要按照一下步骤自动生成。更详细步骤详见 华为-创建 HarmonyOS 应用

如果使用模拟器，可以直接运行，如果需要真机调试，详情参考

IMSDK 提供如下产品功能：登录、会话、消息、群组、用户、好友、存储服务、推送、自定义通知、设置、信令、聊天室、圈组等功能。

对应上述功能提供业务组件 har 包包括 connversation、conversationgroup、message、team、user、friend、setting、notifation、signalling、chatroom、 qchat（开发中，暂不提供）。

将 SDK 文件拷贝到 Harmony 工程，例如放至 entry 模块下的 libs 目录。

修改模块目录的 oh-package.json5 文件，在 dependencies 节点增加依赖声明。

{
    "name": "entry",
    "version": "1.0.0",
    "description": "Please describe the basic information.",
    "main": "",
    "author": "",
    "license": "",
    
    ...
    
    "dependencies": {
        <!-- 业务模版har包， 可以按需添加 -->
        "@nimsdk/nim": "file:../../libs/nim.har",
        "@nimsdk/base": "file:../../libs/base.har",
        "@nimsdk/chatroom": "file:../../libs/chatroom.har",
        "@nimsdk/friend": "file:../../libs/friend.har",
        "@nimsdk/message": "file:../../libs/message.har",
        "@nimsdk/user": "file:../../libs/user.har",
        "@nimsdk/team": "file:../../libs/team.har",
        "@nimsdk/conversation": "file:../../libs/conversation.har",
        "@nimsdk/conversationgroup": "file:../../libs/conversationgroup.har",
        "@nimsdk/signalling": "file:../../libs/signalling.har",
    }
  ...
}

调用 NIMSdk.registerCustomServices 方法注册使用的服务。

• 参数说明

  static registerCustomServices(serviceType: V2NIMProvidedServiceType, creator: V2ServiceCreator)
  

  参数	类型	说明
  serviceType	V2NIMProvidedServiceType	服务类型
  creator	V2ServiceCreator	服务构造器

• 示例代码

    // import 
    import { NIMInitializeOptions, NIMServiceOptions, V2NIMProvidedServiceType } from '@nimsdk/base'
    import { NIMSdk } from '@nimsdk/nim'
    import { NIMInterface } from '@nimsdk/base'
    import { V2NIMTeamServiceImpl } from '@nimsdk/team'
    import { V2NIMConversationServiceImpl } from '@nimsdk/conversation'
    import { V2NIMUserServiceImpl } from '@nimsdk/user';
    import { V2NIMFriendServiceImpl } from '@nimsdk/friend';
    import { V2NIMClientAntispamUtil, V2NIMMessageServiceImpl } from '@nimsdk/message';
    import { V2NIMConversationGroupServiceImpl } from '@nimsdk/conversationgroup';
    import { V2NIMNotificationServiceImpl } from '@nimsdk/notification'
    import { V2NIMSettingServiceImpl } from '@nimsdk/setting'
    import { V2NIMSignallingServiceImpl } from '@nimsdk/signalling'
  
    // 根据业务，选择所需服务进行注册
    NIMSdk.registerCustomServices(V2NIMProvidedServiceType.V2NIM_PROVIDED_SERVICE_TEAM, (core, serviceName, serviceConfig) => new V2NIMTeamServiceImpl(core, serviceName, serviceConfig))
    NIMSdk.registerCustomServices(V2NIMProvidedServiceType.V2NIM_PROVIDED_SERVICE_CLIENT_ANTISPAM_UTIL, (core, serviceName, serviceConfig) => new V2NIMClientAntispamUtil(core, serviceName, serviceConfig));
    NIMSdk.registerCustomServices(V2NIMProvidedServiceType.V2NIM_PROVIDED_SERVICE_NOTIFICATION, (core, serviceName, serviceConfig) => new V2NIMNotificationServiceImpl(core, serviceName, serviceConfig));
    NIMSdk.registerCustomServices(V2NIMProvidedServiceType.V2NIM_PROVIDED_SERVICE_CONVERSATION, (core, serviceName, serviceConfig) => new V2NIMConversationServiceImpl(core, serviceName, serviceConfig));
    NIMSdk.registerCustomServices(V2NIMProvidedServiceType.V2NIM_PROVIDED_SERVICE_CONVERSATION_GROUP, (core, serviceName, serviceConfig) => new V2NIMConversationGroupServiceImpl(core, serviceName, serviceConfig));
    NIMSdk.registerCustomServices(V2NIMProvidedServiceType.V2NIM_PROVIDED_SERVICE_MESSAGE, (core, serviceName, serviceConfig) => new V2NIMMessageServiceImpl(core, serviceName, serviceConfig));
    NIMSdk.registerCustomServices(V2NIMProvidedServiceType.V2NIM_PROVIDED_SERVICE_USER, (core, serviceName, serviceConfig) => new V2NIMUserServiceImpl(core, serviceName, serviceConfig));
    NIMSdk.registerCustomServices(V2NIMProvidedServiceType.V2NIM_PROVIDED_SERVICE_FRIEND, (core, serviceName, serviceConfig) => new V2NIMFriendServiceImpl(core, serviceName, serviceConfig));
    NIMSdk.registerCustomServices(V2NIMProvidedServiceType.V2NIM_PROVIDED_SERVICE_SETTING, (core, serviceName, serviceConfig) => new V2NIMSettingServiceImpl(core, serviceName, serviceConfig));
    NIMSdk.registerCustomServices(V2NIMProvidedServiceType.V2NIM_PROVIDED_SERVICE_SIGNALLING, (core, serviceName, serviceConfig) => new V2NIMSignallingServiceImpl(core, serviceName, serviceConfig))

调用 newInstance 方法创建实例并实现初始化。

• 参数说明

  static newInstance(context: common.Context, initializeOptions: NIMInitializeOptions, serviceOptions: NIMServiceOptions = {}): NIMInterface
  

  参数	类型	说明
  context	common.Context	应用上下文
  initializeOptions	NIMInitializeOptions	SDK 的配置信息
  serviceOptions	NIMServiceOptions	业务服务的配置信息

  NIMInitializeOptions 的配置参数

  参数	类型	必填	说明
  appkey	string	是	应用的 App Key，在云信控制台创建应用后获取。
  xhrConnectTimeout	number	否，默认为 30000 ms	建立连接时的 xhr 请求的超时时间
  socketConnectTimeout	number	否，默认为 30000 ms	建立 websocket 连接的超时时间

  NIMServiceOptions 的配置参数

  参数	类型	必填	说明
  loginServiceConfig	NIMLoginServiceConfig	否	LoginService的配置参数

  NIMLoginServiceConfig 的配置参数

  参数	类型	必填	说明
  lbsUrls	string[]	否	lbs 地址。SDK 连接时会向 lbs 地址请求得到 socket 连接地址
  linkUrl	string	否	socket 备用地址，当 lbs 请求失败时，尝试直接连接 socket 备用地址
  customClientType	number	否	自定义客户端类型
  customTag	string	否	自定义客户端标签

• 示例代码

  let initializeOptions: NIMInitializeOptions = {
    appkey: "45c6af3c98409b18a84451215d0bdd6e",
  };
  
  let serviceOptions: NIMServiceOptions = {
    loginServiceConfig: {
      lbsUrls: ['https://imtest.netease.im/lbs/webconf'],
      linkUrl: 'weblink-harmony-tmp.netease.im:443'
    }
  }
  
  const nim = NIMSdk.newInstance(context, initializeOptions, serviceOptions)
  

demo 提供 IM 个业务模块 API 的调用事例，便于开发者快速了解 api 的使用方式，下载 demo 代码后，可以直接运行 demo 运行进入登陆界面进行登陆： 体验 demo 可以将 用户名：cjl 秘密： 123456 输入进行登陆：

see loginService

see conversationService

see messageService

see teamService

see userService, friendService

see pushService

以上界面对应的功能接口，都有单独的功能页面进行实现，在接入sdk 时，可以找的对应的接口，进行参考使用。

如果您在使用过程中，有任何疑问都可以直接在本工程上提交 issue，或者在云信官网进行咨询。

云信官网

鸿蒙开发官网