客户端如何同步已发消息
App 业务端调用 IM Server API 发送消息时,通常期待发件人用户的客户端也可同步该已发消息,例如:
- 发件人的客户端在线时,通过 Server API 发送的消息可自动同步至发件人的客户端设备。
- 发件人的离线的客户端再次上线时,可自动收取通过 Server API 发送的消息。
- 发件人的客户端拉取历史消息时,总可以获取从通过 Server API 发送的消息。
您可以通过以下方式实现上述需求:
- 设置
isIncludeSender
参数为1
,当发件人的客户端在线时,服务端将自动向发件人的客户端同步已发送的消息。 - 开通多设备消息同步,当发件人的离线客户端再次上线时,会从服务端同步已发消息。
- 开通历史消息云存储,客户端可以获取历史已发消息。
提示
融云默认不向发件人的客户端同步通过 Server API 发出的消息,也不会将该已发消息存入发件人的服务端历史消息记录。
设置 isIncludeSender 参数
调用 IM Server API 的发送消息接口时,设置 isIncludeSender
参数为 1
,这将保证在发件人客户端在线的情况下同步接收已发送的消息。部分接口支持 isSyncSender
参数,作用一致。
如果不传该参数,服务端使用默认值 0
,即不同步,发送者的客户端无法获取该条已发消息。
以下接口支持 isIncludeSender
:
以下接口支持 isSyncSender
: