【鸿蒙教程】快速集成鸿蒙 IM SDK 并实现单聊发送消息

本文手把手教您快速集成鸿蒙版环信即时通讯 IM 并实现单聊。

教程目录

  • 前提条件
  • 准备开发环境
  • SDK导入及声明
  • SDK 初始化
  • 注册监听回调
  • 注册登录
  • 发送消息

前提条件

  • DevEco Studio NEXT Developer Beta1(5.0.3.300)及以上;
  • HarmonyOS SDK API 12 及以上;
  • 有效的环信即时通讯 IM 开发者账号和 Appkey,见 环信即时通讯云控制台

注:当前华为官网提供的DevEco Studio为3.1.1版本,api 为9,需要联系华为线上服务助手进行申请最新版本

准备开发环境:

打开 DevEco Studio,点击 Create Project。

Choose Your Ability Template 界面,选择 Application > Empty Ability,然后点击 Next

在 Configure Your Project 界面,依次填入以下内容:

  • Project name:你的 HarmonyOS 项目名称,如 HelloWorld。
  • Bundle name:你的项目包的名称,如 com.hyphenate.helloworld。
  • Save location:项目的存储路径。
  • Compatible SDK:项目的支持的最低 API 等级,选择 5.0.0(12) 及以上。
  • Module name:module的名称,默认为 entry

SDK导入及声明:

环信鸿蒙SDK 下载:https://www.easemob.com/download/im

打开 SDK 下载页面,获取最新版的环信即时通讯 IM HarmonyOS SDK,得到 har 形式的 SDK 文件。

Harmony 工程下默认没有libs 目录,在Harmony工程 entry 模块下新建 libs 目录将sdk 导入。

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

添加项目权限

在模块的 module.json5 中添加权限,如下图:

SDK初始化:

注:sdk 初始化需要在入口页面的aboutToAppear中进行初始化,在EntryAbility 中,可能会获取不到上下文。

注册监听回调

可以注册ChatMessageListener 接收消息,ChatMessageListener 可以多次添加。也可以在初始化以后进行全局监听

当有新消息时会收到onMessageReceived 回调。收到为数组,需要进行遍历展示。

注册登录

若支持 SDK 注册,需登录环信即时通讯云控制台,选择 即时通讯 > 服务概览,将 设置下的 用户注册模式 设置为 开放注册。

javascript 复制代码
mkt
javascript 复制代码
ChatClient.getInstance().login(this.userName,this.password).then(()=>{
  ChatLog.d('登录成功');
}).catch((s:ChatError)=>{
  ChatLog.d('登录失败'+s.errorCode+"----"+s.description);
});

catch可以捕获调用接口失败的的错误信息,用来提示用户是失败原因,或者业务上报等

javascript 复制代码
AlertDialog.show(
  {
    title: '提示', //弹窗标题
    message: '登录失败'+s.errorCode+":"+s.description, //弹窗信息
    autoCancel: true, //点击遮障层时,是否关闭弹窗
    alignment: DialogAlignment.Center, //弹窗位置
    offset: { dx: 0, dy: -20 }, //相对于弹窗位置的偏移量
    secondaryButton: {
      value: '关闭',
      action: () => {
        console.log('关闭')
      }
    },
    cancel: () => { //点击遮罩层取消时的回调
      console.info('Closed callbacks')
    }
  }
)

发送消息

发送消息是可以设置 ChatCallback ,获得消息发送的状态。可以在该回调中更新消息的显示状态。例如消息发送失败后的提示等等。

至此成功集成并且发送第一条消息。

相关文档

相关推荐
zhanshuo27 分钟前
干掉复杂逻辑!手把手教你在鸿蒙系统中创建稳定的后台服务
harmonyos
zhanshuo27 分钟前
鸿蒙系统通知开发全攻略:实现跳转、自动消失、消息提醒的完整教程
harmonyos
问道飞鱼1 小时前
【移动端知识】移动端多 WebView 互访方案:Android、iOS 与鸿蒙实现
android·ios·harmonyos·多webview互访
周胡杰2 小时前
鸿蒙加载预置数据库-关系型数据库-如何读取本地/预制数据库
数据库·华为·harmonyos·鸿蒙
脑子缺根弦3 小时前
融合优势:SIP 广播对讲联动华为会议 全场景沟通响应提速
华为·音视频·广播对讲系统
迷曳12 小时前
27、鸿蒙Harmony Next开发:ArkTS并发(Promise和async/await和多线程并发TaskPool和Worker的使用)
前端·华为·多线程·harmonyos
呆呆的小鳄鱼16 小时前
牛客:HJ24 合唱队[华为机考][最长递增子集][动态规划]
算法·华为·动态规划
迷曳16 小时前
24、鸿蒙Harmony Next开发:不依赖UI组件的全局自定义弹出框 (openCustomDialog)
dialog·前端·ui·harmonyos·鸿蒙
DC_BLOG18 小时前
OSPFv3中LSA参数
运维·服务器·华为·智能路由器·huawei
平谷一勺1 天前
鸿蒙状态栏操作
华为·harmonyos·沉浸式状态栏