floo::BMXChatService

聊天Service

#include <bmx_chat_service.h>

Public Types

Name
enum class ThumbnailStrategy { ThirdpartyServerCreate = 1, LocalServerCreate}
缩略图生成策略,

Public Functions

Name
virtual ~BMXChatService()
virtual void sendMessage(BMXMessagePtr msg) =0
发送消息,消息状态变化会通过listener通知
virtual void resendMessage(BMXMessagePtr msg) =0
重新发送消息,消息状态变化会通过listener通知
virtual void recallMessage(BMXMessagePtr msg) =0
撤回消息,消息状态变化会通过listener通知
virtual BMXErrorCode forwardMessage(const BMXMessageList & list, BMXConversationPtr to, BMXMessagePtr & newMsg) =0
合并转发消息
virtual void forwardMessage(BMXMessagePtr msg) =0
简单转发消息,用户应当通过BMXMessage::createForwardMessage()先创建转发消息
virtual void ackMessage(BMXMessagePtr msg) =0
发送已读回执
virtual void ackMessageDelivered(BMXMessagePtr msg) =0
发送送达回执
virtual void ackPlayMessage(BMXMessagePtr msg) =0
发送音频/视频消息已播放回执
virtual void readCancel(BMXMessagePtr msg) =0
标记此消息为未读,该消息同步到当前用户的所有设备
virtual void readAllMessage(BMXMessagePtr msg) =0
标记此消息及之前全部消息为已读,该消息同步到当前用户的所有设备
virtual void removeMessage(BMXMessagePtr msg, bool synchronize =true) =0
删除此消息,该消息同步到当前用户的其它设备
virtual void downloadThumbnail(BMXMessagePtr msg, ThumbnailStrategy strategy =ThumbnailStrategy::ThirdpartyServerCreate) =0
下载缩略图,下载状态变化和进度通过listener通知 缩略图生成策略,1 - 第三方服务器生成, 2 - 本地服务器生成,默认值是 1。
virtual void downloadAttachment(BMXMessagePtr msg) =0
下载附件,下载状态变化和进度通过listener通知
virtual void downloadAttachmentByUrl(int64_t msgId, const std::string & url, const std::string & path) =0
下载附件,下载状态变化和进度通过listener通知
virtual void cancelUploadAttachment(BMXMessagePtr msg) =0
取消上传附件
virtual void cancelDownloadAttachment(BMXMessagePtr msg) =0
取消下载附件
virtual int transferingNum() =0
上传或下载中的文件数
virtual BMXErrorCode insertMessages(const BMXMessageList & list) =0
插入消息
virtual BMXMessagePtr getMessage(int64_t msgId) =0
读取一条消息
virtual void deleteConversation(int64_t conversationId, bool synchronize =false) =0
删除会话
virtual BMXConversationPtr openConversation(int64_t conversationId, BMXConversation::Type type, bool createIfNotExist =true) =0
打开一个会话
virtual std::string attachmentDir() =0
获取附件保存路径
virtual std::string attachmentDirForConversation(int64_t conversationId) =0
获取会话的附件保存路径
virtual BMXConversationList getAllConversations() =0
获取所有会话
virtual int getAllConversationsUnreadCount() =0
获取所有会话的全部未读数(标记为屏蔽的个人和群组的未读数不统计在内)
virtual BMXErrorCode retrieveHistoryMessages(BMXConversationPtr conversation, int64_t refMsgId, size_t size, BMXMessageList & result) =0
拉取历史消息
virtual BMXErrorCode searchMessagesByKeyWords(const std::string & keywords, int64_t refTime, size_t size, std::vector< BMXMessageList > & result, BMXConversation::Direction =BMXConversation::Direction::Up) =0
使用关键字搜索消息
virtual BMXErrorCode searchMessages(const std::string & keywords, int64_t refTime, size_t size, std::vector< BMXMessageList > & result, BMXConversation::Direction =BMXConversation::Direction::Up) =0
Deprecated.
virtual BMXErrorCode getGroupAckMessageUserIdList(BMXMessagePtr msg, std::vector< int64_t > & groupMemberIdList) =0
获取发送的群组消息已读用户id列表
virtual BMXErrorCode getGroupAckMessageUnreadUserIdList(BMXMessagePtr msg, std::vector< int64_t > & groupMemberIdList) =0
获取发送的群组消息未读用户id列表
virtual BMXErrorCode getGroupPlayAckMessageUserIdList(BMXMessagePtr msg, std::vector< int64_t > & groupMemberIdList) =0
获取发送的群组音频/视频消息已播放用户id列表(仅用于音频/视频消息)
virtual BMXErrorCode getGroupUnPlayAckMessageUserIdList(BMXMessagePtr msg, std::vector< int64_t > & groupMemberIdList) =0
获取发送的群组音频/视频消息未播放用户id列表(仅用于音频/视频消息)
virtual void addChatListener(BMXChatServiceListener * listener) =0
添加聊天监听者
virtual void removeChatListener(BMXChatServiceListener * listener) =0
移除聊天监听者

Protected Functions

Name
BMXChatService()
void updateMessageId(BMXMessagePtr msg, int64_t newId)

Public Types Documentation

enum ThumbnailStrategy

Enumerator Value Description
ThirdpartyServerCreate 1 第三方服务器生成
LocalServerCreate 本地服务器生成

缩略图生成策略,

Public Functions Documentation

function ~BMXChatService

inline virtual ~BMXChatService()

Example:

function sendMessage

virtual void sendMessage(
    BMXMessagePtr msg
) =0

发送消息,消息状态变化会通过listener通知

Parameters:

  • msg 发送的消息

Example:

client->sendMessage(msg);

function resendMessage

virtual void resendMessage(
    BMXMessagePtr msg
) =0

重新发送消息,消息状态变化会通过listener通知

Parameters:

  • msg 重新发送的消息

Example:

function recallMessage

virtual void recallMessage(
    BMXMessagePtr msg
) =0

撤回消息,消息状态变化会通过listener通知

Parameters:

  • msg 撤回的消息

Example:

function forwardMessage

virtual BMXErrorCode forwardMessage(
    const BMXMessageList & list,
    BMXConversationPtr to,
    BMXMessagePtr & newMsg
) =0

合并转发消息

Parameters:

  • list 转发的消息列表
  • to 消息被转发到的会话
  • newMsg 转发的消息列表合并后生成的新的单条转发消息

Return: BMXErrorCode

Example:

function forwardMessage

virtual void forwardMessage(
    BMXMessagePtr msg
) =0

简单转发消息,用户应当通过BMXMessage::createForwardMessage()先创建转发消息

Parameters:

  • msg 转发的消息

Example:

function ackMessage

virtual void ackMessage(
    BMXMessagePtr msg
) =0

发送已读回执

Parameters:

  • msg 需要发送已读回执的消息

Example:

function ackMessageDelivered

virtual void ackMessageDelivered(
    BMXMessagePtr msg
) =0

发送送达回执

Example:

function ackPlayMessage

virtual void ackPlayMessage(
    BMXMessagePtr msg
) =0

发送音频/视频消息已播放回执

Parameters:

  • msg 需要发送已读回执的消息

Example:

function readCancel

virtual void readCancel(
    BMXMessagePtr msg
) =0

标记此消息为未读,该消息同步到当前用户的所有设备

Parameters:

  • msg 需要发送消息已读取消的消息

Example:

function readAllMessage

virtual void readAllMessage(
    BMXMessagePtr msg
) =0

标记此消息及之前全部消息为已读,该消息同步到当前用户的所有设备

Parameters:

  • msg 需要标记为此消息以前全部消息为已读的消息

Example:

function removeMessage

virtual void removeMessage(
    BMXMessagePtr msg,
    bool synchronize =true
) =0

删除此消息,该消息同步到当前用户的其它设备

Parameters:

  • msg 需要删除的消息
  • synchronize 是否同步到其它设备,不同步的情况下只会删除本地存储的该条消息

Example:

function downloadThumbnail

virtual void downloadThumbnail(
    BMXMessagePtr msg,
    ThumbnailStrategy strategy =ThumbnailStrategy::ThirdpartyServerCreate
) =0

下载缩略图,下载状态变化和进度通过listener通知 缩略图生成策略,1 - 第三方服务器生成, 2 - 本地服务器生成,默认值是 1。

Parameters:

  • msg 需要下载缩略图的消息
  • strategy 缩略图生成策略,1 - 第三方服务器生成, 2 - 本地服务器生成,默认值是 1。

Example:

function downloadAttachment

virtual void downloadAttachment(
    BMXMessagePtr msg
) =0

下载附件,下载状态变化和进度通过listener通知

Parameters:

  • msg 需要下载附件的消息

Example:

function downloadAttachmentByUrl

virtual void downloadAttachmentByUrl(
    int64_t msgId,
    const std::string & url,
    const std::string & path
) =0

下载附件,下载状态变化和进度通过listener通知

Example:

function cancelUploadAttachment

virtual void cancelUploadAttachment(
    BMXMessagePtr msg
) =0

取消上传附件

Parameters:

  • msg 需要取消上传附件的消息

Example:

function cancelDownloadAttachment

virtual void cancelDownloadAttachment(
    BMXMessagePtr msg
) =0

取消下载附件

Parameters:

  • msg 需要取消下载附件的消息

Example:

function transferingNum

virtual int transferingNum() =0

上传或下载中的文件数

Return: 文件数

Example:

function insertMessages

virtual BMXErrorCode insertMessages(
    const BMXMessageList & list
) =0

插入消息

Parameters:

  • list 插入消息列表

Return: BMXErrorCode

Example:

function getMessage

virtual BMXMessagePtr getMessage(
    int64_t msgId
) =0

读取一条消息

Parameters:

  • msgId 需要获取消息的消息id

Return: BMXMessagePtr

Example:

function deleteConversation

virtual void deleteConversation(
    int64_t conversationId,
    bool synchronize =false
) =0

删除会话

Parameters:

  • conversationId 需要删除会话的会话id
  • synchronize 是否同步删除其它设备该会话,默认为false,仅删除本设备会话

Example:

function openConversation

virtual BMXConversationPtr openConversation(
    int64_t conversationId,
    BMXConversation::Type type,
    bool createIfNotExist =true
) =0

打开一个会话

Parameters:

  • conversationId 需要打开的会话的会话id
  • type 会话的类型,单聊还是群聊。
  • createIfNotExist 会话不存在的情况下是否要创建本地会话,默认为创建

Return: BMXConversationPtr

Example:

function attachmentDir

virtual std::string attachmentDir() =0

获取附件保存路径

Return: std::string

Example:

function attachmentDirForConversation

virtual std::string attachmentDirForConversation(
    int64_t conversationId
) =0

获取会话的附件保存路径

Parameters:

  • conversationId 需要获取会话附件路径的会话id

Return: std::string

Example:

function getAllConversations

virtual BMXConversationList getAllConversations() =0

获取所有会话

Return: BMXConversationList

Example:

BMXConversationList conversationList = client->getChatService().getAllConversations();

function getAllConversationsUnreadCount

virtual int getAllConversationsUnreadCount() =0

获取所有会话的全部未读数(标记为屏蔽的个人和群组的未读数不统计在内)

Return: int

Example:

function retrieveHistoryMessages

virtual BMXErrorCode retrieveHistoryMessages(
    BMXConversationPtr conversation,
    int64_t refMsgId,
    size_t size,
    BMXMessageList & result
) =0

拉取历史消息

Parameters:

  • conversation 需要拉取历史消息的会话
  • refMsgId 拉取会话消息的起始消息Id
  • size 拉取的最大消息条数
  • result 拉取操作获取的消息列表,外部初始化传入空列表。

Return: BMXErrorCode

Example:

BMXErrorCode errorCode = client->getChatService().retrieveHistoryMessages(conversationList[0], 0, 10, list);

function searchMessagesByKeyWords

virtual BMXErrorCode searchMessagesByKeyWords(
    const std::string & keywords,
    int64_t refTime,
    size_t size,
    std::vector< BMXMessageList > & result,
    BMXConversation::Direction  =BMXConversation::Direction::Up
) =0

使用关键字搜索消息

Parameters:

  • keywords 搜索的关键字
  • refTime 搜索消息的起始时间
  • size 搜索的最大消息条数
  • result 搜索到的消息结果列表,外部初始化传入空列表。
  • Direction 消息搜索方向,默认(Direction::Up)是从更早的消息中搜索

Return: BMXErrorCode

Example:

function searchMessages

virtual BMXErrorCode searchMessages(
    const std::string & keywords,
    int64_t refTime,
    size_t size,
    std::vector< BMXMessageList > & result,
    BMXConversation::Direction  =BMXConversation::Direction::Up
) =0

Deprecated.

Parameters:

  • keywords 搜索的关键字
  • refTime 搜索消息的起始时间
  • size 搜索的最大消息条数
  • result 搜索到的消息结果列表,外部初始化传入空列表。
  • Direction 消息搜索方向,默认(Direction::Up)是从更早的消息中搜索

Return: BMXErrorCode

use searchMessagesByKeyWords instead.

搜索消息

Example:

function getGroupAckMessageUserIdList

virtual BMXErrorCode getGroupAckMessageUserIdList(
    BMXMessagePtr msg,
    std::vector< int64_t > & groupMemberIdList
) =0

获取发送的群组消息已读用户id列表

Parameters:

  • msg 需要获取已读用户id列表的消息
  • groupMemberIdList 对该条消息已读的用户id列表,初始传入为空列表

Return: BMXErrorCode

Example:

function getGroupAckMessageUnreadUserIdList

virtual BMXErrorCode getGroupAckMessageUnreadUserIdList(
    BMXMessagePtr msg,
    std::vector< int64_t > & groupMemberIdList
) =0

获取发送的群组消息未读用户id列表

Parameters:

  • msg 需要获取未读用户id列表的消息
  • groupMemberIdList 对该条消息未读的用户id列表,初始传入为空列表

Return: BMXErrorCode

Example:

function getGroupPlayAckMessageUserIdList

virtual BMXErrorCode getGroupPlayAckMessageUserIdList(
    BMXMessagePtr msg,
    std::vector< int64_t > & groupMemberIdList
) =0

获取发送的群组音频/视频消息已播放用户id列表(仅用于音频/视频消息)

Parameters:

  • msg 需要获取已播放用户id列表的消息
  • groupMemberIdList 对该条消息已播放的用户id列表,初始传入为空列表

Return: BMXErrorCode

Example:

function getGroupUnPlayAckMessageUserIdList

virtual BMXErrorCode getGroupUnPlayAckMessageUserIdList(
    BMXMessagePtr msg,
    std::vector< int64_t > & groupMemberIdList
) =0

获取发送的群组音频/视频消息未播放用户id列表(仅用于音频/视频消息)

Parameters:

  • msg 需要获取未播放用户id列表的消息
  • groupMemberIdList 对该条消息未播放的用户id列表,初始传入为空列表

Return: BMXErrorCode

Example:

function addChatListener

virtual void addChatListener(
    BMXChatServiceListener * listener
) =0

添加聊天监听者

Parameters:

  • listener 聊天监听者

Example:

client->getChatService().addChatListener(chatListener);

function removeChatListener

virtual void removeChatListener(
    BMXChatServiceListener * listener
) =0

移除聊天监听者

Parameters:

  • listener 聊天监听者

Protected Functions Documentation

Example:

mService->removeChatListener(this);
client->getChatService().removeChatListener(chatListener);

function BMXChatService

inline BMXChatService()

Example:

function updateMessageId

void updateMessageId(
    BMXMessagePtr msg,
    int64_t newId
)

Example:


Updated on 2022-01-26 at 17:20:40 +0800

© 2019-2023 美信拓扑 | 官网 该文件修订时间: 2023-08-09 14:48:15

results matching ""

    No results matching ""