IM 即时通讯
Android
产品介绍
简介
产品优势
主要功能
功能介绍
帐号集成与登录
群组功能
聊天室功能
聊天室标签功能
圈组功能
多端登录与互踢策略
质量数据监控台
海外数据中心
IM平滑迁移方案
接口及业务限制
更新日志
IM UIKit 更新日志
NIM SDK 开发版更新日志
NIM SDK 稳定版更新日志
体验 Demo
下载 SDK 与 Demo 源码
快速开始
跑通 IM Demo 源码
实现单聊消息收发(不含 UI)
跑通圈组 Demo 源码
实现圈组消息收发(不含 UI)
含 UI 集成
什么是 IM UIKit
IM UIKit 功能概览
快速集成 IM UIKit
组件导入
初始化
界面跳转
自定义用户信息
全局配置
会话列表相关
集成会话列表界面
会话列表事件监听
自定义会话列表界面 UI
会话列表 API 概览
会话消息相关
集成会话界面
会话界面事件监听
实现音视频通话
实现地理位置消息功能(含 UI)
实现自定义消息发送(含 UI)
自定义会话界面 UI
会话消息 API 概览
通讯录相关
集成通讯录界面
自定义通讯录界面 UI
通讯录界面事件监听
通讯录 API 概览
IM UIKit 常见问题排查
IM UIKit API 概览
不含 UI 集成
集成 SDK
初始化
登录相关
登录 IM
多端登录与互踢
登出 IM
消息相关
消息概述
消息收发
自定义消息收发
消息配置选项
NOS 存储场景
广播消息收发
消息已读回执
消息撤回
消息重发与转发
消息更新
消息过滤
语音消息处理
插入本地消息
历史消息
最近会话
服务端会话服务
用户资料
用户关系
在线状态订阅
系统通知
系统通知概述
内置系统通知管理
内置系统通知未读数
自定义系统通知收发
Android 离线推送
实现离线推送
配置消息的推送属性
设置群消息强制推送
设置推送全局免打扰
设置多端推送策略
集成小米推送
集成华为推送
集成荣耀推送
集成 OPPO 推送
集成 vivo 推送
集成魅族推送
集成谷歌推送(FCM)
消息提醒
实现消息提醒
配置消息提醒功能
设置群消息强制提醒
设置消息提醒文案
定制通知栏显示信息
群组功能
群组概述
群组管理
群成员管理
群消息管理
超大群功能
聊天室
圈组功能
圈组概述
登录管理
服务器相关
服务器概述
服务器管理
服务器成员管理
游客功能
服务器未读数管理
频道相关
频道概述
频道管理
频道黑白名单
实时互动频道
频道分组
频道分组黑白名单
频道未读数管理
搜索服务器和频道
身份组相关
身份组概述
身份组应用场景
服务器身份组
频道身份组
用户定制权限
频道分组身份组
自定义权限项
成员权限查询与判定
身份组相关查询
圈组订阅机制
圈组消息相关
图解圈组消息流转
圈组消息收发
圈组消息撤回
圈组消息更新
圈组消息删除
消息正在输入
会话消息回复(Thread)
圈组快捷评论
获取频道最后一条消息
查询历史消息
查询@我的消息
圈组消息缓存
圈组消息搜索
圈组系统通知相关
圈组系统通知概述
圈组系统通知收发
圈组系统通知更新
圈组离线推送
圈组内容审核
圈组相关抄送
圈组第三方回调
圈组各端接口命名差异
反垃圾
聊天扩展
其他
最佳实践
IM 登录最佳实践
IM 应用隐私合规
聊天室重要消息投递
API 参考
Android SDK API
Android SDK 状态码
IM 控制台指南
创建应用
注册 IM 账号
升级服务
开通聊天室功能
配置应用客户端标识
常见问题
FAQ
错题集
Android 端推送问题排查
第三方推送厂商的限制说明
服务协议

消息收发

更新时间: 2023/01/09 10:49:44

NetEase IM Android SDK(以下简称“NIM SDK”)支持收发多种消息类型,助您快速实现多样化的消息业务场景。NIM SDK 提供MessageBuilder类、MsgServiceObserve接口和MsgService接口,支持构建、监听和收发多种类型的消息。SDK 中定义消息的结构为IMMessage(不支持继承扩展),不同消息类型以MsgTypeEnum作区分。发送不同类型消息的方法均为sendMessage。单聊消息和群聊消息都通过该方法发送,通过参数sessionType设置发送的为单聊消息还是群聊消息。

本文介绍通过网易云信 NIM SDK 实现消息收发的技术原理、前提条件以及具体的实现流程。

技术原理

应用集成 NIM SDK 并完成 SDK 初始化后,消息收发流程如下图所示(本地提示消息通知消息除外)。

上图中的流程可归纳为如下三步:

  1. 账号集成与登录
    1. 开发者将应用的用户账号传入云信 IM 服务器,注册云信 IM 账号(又称 accid)。
    2. 云信 IM 服务器返回 Token 给应用服务器。
    3. 应用客户端登录应用服务器。
    4. 应用服务器将 Token 返回给应用客户端。
    5. 用户带 Token 登录云信 IM 服务器。
  2. 用户A 发送一条消息到云信 IM 服务器。
  3. 云信 IM 服务器投递消息至其他用户,分为如下两种情况:
    • 如为单聊消息,IM 服务器将其投递至用户B。
    • 如为群聊消息,IM 服务器将其投递至群内其他每一位用户。

上图仅以静态 Token 登录为例展示消息收发流程。网易云信 IM 还支持动态 Token 登录鉴权和第三方回调登录鉴权,相关详情请参见登录鉴权

前提条件

在实现消息收发之前,请确保:

API使用限制

发送消息(sendMessage)的方法调用存在频控,一分钟内默认最多可调用 300 次。

实现消息收发

收发文本消息

uml diagram

实现流程

  1. 发送方接收方调用observeMsgStatus方法注册消息状态变化观察者,监听消息状态MsgStatusEnum的变化。

    // 监听消息状态变化
    NIMClient.getService(MsgServiceObserve.class).observeMsgStatus(statusObserver, register);
    
    private Observer<IMMessage> statusObserver = new Observer<IMMessage>() {
            @Override
            public void onEvent(IMMessage msg) {
                // 1、根据sessionId判断是否是自己的消息
                // 2、更改内存中消息的状态
                // 3、刷新界面
            }
        };
    
  2. 接收方调用observeReceiveMessage方法,注册消息接收观察者,监听消息到达事件。

    Observer<List<IMMessage>> incomingMessageObserver =
        new Observer<List<IMMessage>>() {
            @Override
            public void onEvent(List<IMMessage> messages) {
                // 处理新收到的消息,为了上传处理方便,SDK 保证参数 messages 全部来自同一个聊天对象。
            }
        }
    NIMClient.getService(MsgServiceObserve.class)
            .observeReceiveMessage(incomingMessageObserver, true);
    
  3. 发送方调用createTextMessage方法,构建一条文本消息。

    通过sessionType参数,可设置发送的文本消息为单聊消息或群聊消息。如设置为群聊消息,请确保已创建相应的群组。

    参数 说明
    sessionId 聊天对象的 ID,根据会话类型sessionType判断
    • 如果是单聊,则sessionId为用户的云信IM帐号(即accid
    • 如果是群聊,则sessionId为群组 ID
    sessionType 会话类型,SessionTypeEnum.P2P 为单聊类型,SessionTypeEnum.Team 为群聊类型
    text 文本消息内容
  4. 发送方调用sendMessage方法,发送已构建的文本消息。

    可通过消息配置选项CustomMessageConfig设置该消息是否存入云端、写入漫游、计入未读数等。具体配置示例请参见消息配置选项

    // 该帐号为示例
    String account = "testAccount";
    // 以单聊类型为例
    SessionTypeEnum sessionType = SessionTypeEnum.P2P;
    String text = "this is an example";
    // 创建一个文本消息
    IMMessage textMessage = MessageBuilder.createTextMessage(account, sessionType, text);
    // 发送给对方
    NIMClient.getService(MsgService.class).sendMessage(textMessage, false).setCallback(new RequestCallback<Void>() {
                    @Override
                    public void onSuccess(Void param) {
    
                    }
    
                    @Override
                    public void onFailed(int code) {
                        
                    }
    
                    @Override
                    public void onException(Throwable exception) {
    
                    }
                });
    
  5. 接收方通过observeReceiveMessage触发的回调函数收到文本消息。

收发多媒体消息

多媒体消息包括图片消息、语音消息、视频消息和文件消息。

NIM SDK 提供了高清语音的录制与播放的功能,用于处理语音消息。相关详情请参见语音消息处理

API调用时序

uml diagram

实现流程

  1. 发送方接收方调用observeMsgStatus方法注册消息状态变化观察者,监听消息状态MsgStatusEnum和消息附件接收或发送状态AttachStatusEnum的变化。

    // 监听消息状态变化
    NIMClient.getService(MsgServiceObserve.class).observeMsgStatus(statusObserver, register);
    
    private Observer<IMMessage> statusObserver = new Observer<IMMessage>() {
            @Override
            public void onEvent(IMMessage msg) {
                // 1、根据sessionId判断是否是自己的消息
                // 2、更改内存中消息的状态
                // 3、刷新界面
            }
        };
    
  2. 发送方接收方调用observeAttachmentProgress注册消息附件上传/下载观察者,监听消息附件的上传/下载进度。

  3. 接收方调用observeReceiveMessage方法,注册消息接收观察者,监听消息接收。

    Observer<List<IMMessage>> incomingMessageObserver =
        new Observer<List<IMMessage>>() {
            @Override
            public void onEvent(List<IMMessage> messages) {
                // 处理新收到的消息,为了上传处理方便,SDK 保证参数 messages 全部来自同一个聊天对象。
            }
        }
    NIMClient.getService(MsgServiceObserve.class)
            .observeReceiveMessage(incomingMessageObserver, true);
    
    
  4. 发送方构建多媒体消息。

    消息类型
    创建方法
    图片消息 调用createImageMessage方法,构建一条图片消息。也可调用其重载方法,指定图片上传时使用的多媒体资源存储场景
    语音消息 调用createAudioMesssage方法,构建一条语音消息。也可调用其重载方法,指定音频上传时使用的多媒体资源存储场景
    视频消息 调用createVideoMessage方法,构建一条视频消息。也可调用其重载方法,指定视频上传时使用的多媒体资源存储场景
    文件消息 调用createFileMessage方法,构建一条文件消息。也可调用其重载方法,指定文件上传时使用的多媒体资源存储场景

    上述方法的部分参数说明如下:

    参数 说明
    sessionId 聊天对象的 ID,根据会话类型sessionType判断
    • 如果是单聊,则sessionId为用户的云信IM帐号(即accid
    • 如果是群聊,则sessionId为群组 ID
    sessionType 会话类型,SessionTypeEnum.P2P 为单聊类型,SessionTypeEnum.Team 为群聊类型
  5. 发送方调用sendMessage方法,发送已构建的多媒体消息。

    • 可通过消息配置选项CustomMessageConfig设置该消息是否存入云端、写入漫游、计入未读数等。具体配置示例请参见消息配置选项
    • 如发送的为图片消息、视频消息或文件消息,发送后可调用cancelUploadAttachment方法取消附件(图片、视频或文件)的上传。如果附件已经上传成功,操作将会失败 。如果成功取消了附件的上传,那么相应的消息会发送失败,对应的消息状态是MsgStatusEnum.fail,附件状态是AttachStatusEnum.cancel
    • 如果同一个图片/文件消息需要多次发送时,建议控制时序依次发送,避免出现发送失败的问题。

    构建并发送多媒体消息的示例代码如下:

    发送图片消息
    // 该帐号为示例,请先注册
    String account = "testAccount";
    // 以单聊类型为例
    SessionTypeEnum sessionType = SessionTypeEnum.P2P;
    // 示例图片,需要开发者在相应目录下有图片
    File file = new File("/sdcard/test.jpg");
    // 创建一个图片消息
    IMMessage message = MessageBuilder.createImageMessage(account, sessionType, file, file.getName());
    // 或者:创建一个图片消息并指定图片上传时使用的文件资源场景,"nos_scene_key"请替换成开发者已经配置的
    IMMessage message = MessageBuilder.createImageMessage(account, sessionType, file, file.getName(),"nos_scene_key");
    // 发送给对方
    NIMClient.getService(MsgService.class).sendMessage(message, false).setCallback(new RequestCallback<Void>() {
                    @Override
                    public void onSuccess(Void param) {
    
                    }
    
                    @Override
                    public void onFailed(int code) {
                        
                    }
    
                    @Override
                    public void onException(Throwable exception) {
    
                    }
                });
    
    发送语音消息
    // 该帐号为示例,请先注册
    String account = "testAccount";
    // 以单聊类型为例
    SessionTypeEnum sessionType = SessionTypeEnum.P2P;
    // 示例音频,需要开发者在相应目录下有文件
    File audioFile = new File("/sdcard/testAudio.mp3");
    // 音频时长,时间为示例
    long audiolength = 2000;
    // 创建音频消息
    IMMessage audioMessage = MessageBuilder.createAudioMessage(account, sessionType, audioFile, audioLength);
    // 或者:创建一个音频消息并指定音频上传时使用的文件资源场景,"nos_scene_key"请替换成开发者已经配置的
    IMMessage audioMessage = MessageBuilder.createAudioMessage(account, sessionType, audioFile, "nos_scene_key");
    // 发送给对方
    NIMClient.getService(MsgService.class).sendMessage(audioMessage, false).setCallback(new RequestCallback<Void>() {
                    @Override
                    public void onSuccess(Void param) {
    
                    }
    
                    @Override
                    public void onFailed(int code) {
                        
                    }
    
                    @Override
                    public void onException(Throwable exception) {
    
                    }
                });
    
    发送视频消息
    // 该帐号为示例,请先注册
    String account = "testAccount";
    // 以单聊类型为例
    SessionTypeEnum sessionType = SessionTypeEnum.P2P;
    // 示例视频,需要开发者在相应目录下有文件
    File file = new File("/sdcard/testVideo.mp4");
    // 获取视频mediaPlayer
    MediaPlayer mediaPlayer;
    try {
        mediaPlayer = MediaPlayer.create(context, Uri.fromFile(file));
    } catch (Exception e) {
        e.printStackTrace();
    }
    // 视频文件持续时间
    long duration = mediaPlayer == null ? 0 : mediaPlayer.getDuration();
    // 视频高度
    int height = mediaPlayer == null ? 0 : mediaPlayer.getVideoHeight();
    // 视频宽度
    int width = mediaPlayer == null ? 0 : mediaPlayer.getVideoWidth();
    // 创建视频消息
    IMMessage message = MessageBuilder.createVideoMessage(account, sessionType, file, duration, width, height, null);
    // 或者:创建一个视频消息并指定视频上传时使用的文件资源场景,"nos_scene_key"请替换成开发者已经配置的
    IMMessage message = MessageBuilder.createVideoMessage(account, sessionType, file, duration, width, height, null,"nos_scene_key");
    // 发送给对方
    NIMClient.getService(MsgService.class).sendMessage(message, false).setCallback(new RequestCallback<Void>() {
                    @Override
                    public void onSuccess(Void param) {
    
                    }
    
                    @Override
                    public void onFailed(int code) {
                        
                    }
    
                    @Override
                    public void onException(Throwable exception) {
    
                    }
                });
    
    发送文件消息
    // 该帐号为示例,请先注册
    String account = "testAccount";
    // 以单聊类型为例
    SessionTypeEnum sessionType = SessionTypeEnum.P2P;
    // 示例文件,需要开发者在相应目录下有文件
    File file = new File("/sdcard/test.txt");
    // 创建文件消息
    IMMessage message = MessageBuilder.createFileMessage(account, sessionType, file, file.getName());
    // 或者:创建一个文件消息并指定文件上传时使用的文件资源场景,"nos_scene_key"请替换成开发者已经配置的
    IMMessage message = MessageBuilder.createFileMessage(account, sessionType, file, file.getName(),"nos_scene_key");
    // 发送给对方
    NIMClient.getService(MsgService.class).sendMessage(message, false).setCallback(new RequestCallback<Void>() {
                    @Override
                    public void onSuccess(Void param) {
    
                    }
    
                    @Override
                    public void onFailed(int code) {
                        
                    }
    
                    @Override
                    public void onException(Throwable exception) {
    
                    }
                });
    
  6. 接收方通过observeReceiveMessage的回调函数接收多媒体消息。

    多媒体资源一般默认自动下载,具体的默认下载策略请参见下表:

    消息类型 默认资源下载策略
    图片/视频消息 SDK 在收到消息时,自动下载缩略图和封面图片
    语音消息 SDK 在收到消息时,自动下载原音频
    文件消息 SDK 默认不下载原文件
    • 如果需要下载文件消息的文件资源,可调用downloadAttachment方法手动下载。其他类型多媒体消息的资源如自动下载失败,也可调用该方法手动重新下载。
    • 如需自主选择下载时机,需将初始化配置参数SDKOptions - preloadAttach设置为false,关闭默认资源下载策略,再在合适的时机调用downloadAttachment方法。

    手动下载多媒体资源示例如下:

    // 下载之前判断一下是否已经下载。若重复下载,会报错误码414。(以SnapChatAttachment为例)
    private boolean isOriginImageHasDownloaded(final IMMessage message) {
        if (message.getAttachStatus() == AttachStatusEnum.transferred &&
            !TextUtils.isEmpty(((SnapChatAttachment) message.getAttachment()).getPath())) {
            return true;
        }
        return false;
    }
    // 因为下载的文件可能会很大,这个接口返回类型为 AbortableFuture ,允许用户中途取消下载。
    AbortableFuture future = NIMClient.getService(MsgService.class).downloadAttachment(message, false);
    
  7. 多媒体资源下载完后,接收方可通过对应的MsgAttachment获取到具体的附件内容。多媒体附件的基类是FileAttachment,继承自MsgAttachment

收发地理位置消息

地理位置消息收发流程与文本消息收发流程基本一致,区别在于构建消息的调用方法不同(需调用createLocationMessage)。本节仅简要展示相关调用示例,具体实现流程请参考收发文本消息

可通过消息配置选项CustomMessageConfig设置该消息是否存入云端、写入漫游、计入未读数等。具体配置示例请参见消息配置选项

uml diagram

API调用示例

调用createLocationMessage构建地理位置消息后,调用sendMessage方法将其发送至接收方的示例代码如下:

// 该帐号为示例,请先注册
String account = "testAccount";
// 以单聊类型为例
SessionTypeEnum sessionType = SessionTypeEnum.P2P;
// 纬度
double lat = 30.3;
// 经度
double lng = 120.2;
// 地理位置描述信息
String addr = "杭州";
// 创建地理位置信息
IMMessage message = MessageBuilder.createLocationMessage(account, sessionType, lat, lng, addr);

// 发送给对方
NIMClient.getService(MsgService.class).sendMessage(message, false).setCallback(new RequestCallback<Void>() {
                @Override
                public void onSuccess(Void param) {

                }

                @Override
                public void onFailed(int code) {
                    
                }

                @Override
                public void onException(Throwable exception) {

                }
            });

收发提示消息

提示消息(又叫做 Tip 消息)主要用于会话内的通知提醒,可以看做是自定义消息的简化,有独立的消息类型MsgTypeEnum.tip。 区别于自定义消息,Tip 消息暂不支持 setAttachment设置附件,如需使用附件请使用自定义消息。 Tip 消息的典型使用场景包括进入会话时出现的欢迎消息会话过程中命中敏感词后的提示等。当然这些应用场景也可以用自定义消息实现,但会相对复杂。

本节以 “您撤回了一条消息提示出现在群组中(仅对发送者可见且不发送到服务端)” 这个应用场景为例,介绍实现提示消息收发的流程。

API调用时序

uml diagram

实现流程

本节仅对上述标为橙色的流程作补充说明。撤回消息相关详情,请参见消息撤回

  1. 用户A 在登录 IM 前,调用observeMsgStatus方法注册消息状态变化观察者,监听消息状态MsgStatusEnum的变化。

    // 监听消息状态变化
    NIMClient.getService(MsgServiceObserve.class).observeMsgStatus(statusObserver, register);
    
    private Observer<IMMessage> statusObserver = new Observer<IMMessage>() {
            @Override
            public void onEvent(IMMessage msg) {
                // 1、根据sessionId判断是否是自己的消息
                // 2、更改内存中消息的状态
                // 3、刷新界面
            }
        };
    
  2. 用户A 调用observeReceiveSystemMsg方法,注册系统消息接收事件观察者,监听系统通知(本场景下为监听消息撤回系统通知)。

    NIMClient.getService(SystemMessageObserver.class)
        .observeReceiveSystemMsg(new Observer<SystemMessage>() {
                @Override
                public void onEvent(SystemMessage message) {
                    // 收到系统通知,可以做相应操作
                }
            }, register);
    
  3. 用户A 调用createTeam方法创建高级群,相关示例代码请参见创建群组

  4. 其他用户加入用户A 创建的高级群,具体加入方法请参见入群操作

  5. 用户A 调用createTipMessage方法构建提示消息。

    该方法的部分参数说明如下:

    参数 说明
    sessionId 聊天对象的 ID,根据会话类型sessionType判断
    • 如果是单聊,则sessionId为用户的云信IM帐号(即accid
    • 如果是群聊,则sessionId为群组 ID
    sessionType 会话类型,SessionTypeEnum.P2P 为单聊类型,SessionTypeEnum.Team 为群聊类型
  6. 用户A 调用setConfig方法,调用时将enableUnreadCount设置为false,使该提示消息不计入未读计数。

  7. 用户A 调用saveMessageToLocalEx方法,保存该提示消息到本地数据库,但不发送到服务器。

    第 5 至 7 步的示例代码如下:

    IMMessage message = MessageBuilder.createTipMessage(sessionId, sessionType);
    message.setContent("您撤回了一条消息");
    message.setStatus(MsgStatusEnum.success);
    CustomMessageConfig config = new CustomMessageConfig();
    config.enableUnreadCount = false;
    message.setConfig(config);
    NIMClient.getService(MsgService.class).saveMessageToLocalEx(message, true, time);
    

接收通知消息

针对一些特定场景的事件,云信服务器预置了一些通知消息,在事件发生时下发到 SDK。通知消息也是一种特定消息,开发者需解析消息中附带的信息,来获取通知内容。如最常见的通知消息——群通知事件,如有新成员进群,则群内已有成员将收到此通知消息。

  • 通知消息属于会话内的一种消息,其对应的数据结构为 IMMessage,消息类型为 MsgTypeEnum#notification。通知消息目前用于在群和聊天室的事件通知。

  • 通知消息需要进行解析,具体请参见群组通知消息

  • 可对通知消息进行过滤,具体请参见通知消息过滤

收发自定义消息

除了上述内置消息类型以外,NIM Android SDK 还支持收发自定义消息类型。具体实现流程介绍,请参见自定义消息收发

常见问题

发送消息后如何获取消息内容

通过 observeMsgStatus 注册消息状态变化观察者,该方法可以监听消息发送状态变化中回调IMMessage对象。

可以通过IMMessage对象的如下方法获取消息内容:

  • getDirect方法获取消息方向
  • getSessionId方法获取聊天对象的accid/群组id
  • getContent方法获取文本消息具体内容
  • getAttachment方法获取文件消息附件对象
  • getStatus方法获取消息收发状态
  • getTime方法获取消息时间(单位为毫秒)

如何判断消息已发送成功

调用消息发送接口时,设置回调函数:NIMClient.getService(MsgService.class).sendMessage(IMMessage msg, boolean resend).setCallback(callback),判断是否进入onSuccess回调。

如何设置消息的扩展字段

单聊或群聊消息具有服务端扩展字段和客户端扩展字段。服务端扩展字段只能在消息发送前设置,会同步到其他端;客户端扩展字段在消息发送前后设置均可,不会同步到其他端。

扩展字段,请使用 JSON 格式封装,并传入非格式化的 JSON 字符串,最大长度1024字节。


具体方法如下:

更新客户端扩展字段
  1. 对于单聊或群聊消息,构造IMMessage对象时,通过setLocalExtension方法设置客户端扩展字段。

  2. 调用updateIMMessage方法更新消息的本地扩展字段。

    设置消息的客户端扩展字段后,必须调用updateIMMessage方法,否则无法生效。

更新服务端扩展字段

对于单聊或群聊消息,构造IMMessage对象时,通过setRemoteExtension方法设置消息的服务端扩展字段,

API参考

API
说明
observeMsgStatus 注册/注销消息状态变化观察者
observeReceiveMessage 注册/注销消息接收观察者
observeAttachmentProgress 注册/注销消息附件的上传或下载进度
createTextMessage 构建一条文本消息
createImageMessage(也可调用其重载方法 构建一条图片消息
createAudioMesssage(也可调用其重载方法 构建一条语音消息
createVideoMessage(也可调用其重载方法 构建一条视频消息
createFileMessage(也可调用其重载方法 构建一条文件消息
createLocationMessage 构建一条地理位置消息
createTipMessage 构建一条提示消息
setRemoteExtension 设置提示消息的自定义扩展字段
setConfig 设置消息配置选项,如是否保存至云端、是否存离线、是否开启漫游、是否计入未读数等
setStatus 设置消息状态
sendMessage 发送一条消息
cancelUploadAttachment 取消图片、视频或文件附件的上传
saveMessageToLocal 将消息保存至本地数据库,但不发送至服务端
此文档是否对你有帮助?
有帮助
我要吐槽
  • 技术原理
  • 前提条件
  • API使用限制
  • 实现消息收发
  • 收发文本消息
  • 收发多媒体消息
  • 收发地理位置消息
  • 收发提示消息
  • 接收通知消息
  • 收发自定义消息
  • 常见问题
  • 发送消息后如何获取消息内容
  • 如何判断消息已发送成功
  • 如何设置消息的扩展字段
  • API参考