markConversationMessageAsRead

功能介绍

说明

标记会话已读, 1、会话类型为单聊，该接口用于消除未读数以及单聊的已读回执发送，调用该接口后 对方发送的消息的已读状态会更新。 2、会话类型为群聊或通知，该接口仅仅用于消除未读数。

注意

相关回调：
onConversationChanged
onRecvC2CReadReceipt

iOS

函数原型

  Future markConversationMessageAsRead({
    required String conversationID,
    String? operationID,
  })

输入参数

参数名称	参数类型	是否必填	描述
conversationID	String	是	会话 ID

返回结果

名称	类型	描述
~	~	无异常抛出则操作成功

代码示例

    await OpenIM.iMManager.messageManager.markMessageAsReadByConID(conversationID: '', messageIDList: []);
    // todo

Android

函数原型

- (void)markConversationMessageAsRead:(NSString *)conversationID
                            onSuccess:(nullable OIMSuccessCallback)onSuccess
                            onFailure:(nullable OIMFailureCallback)onFailure;

输入参数

参数名称	参数类型	是否必填	描述
conversationID	NSString	是	会话 ID

返回结果

名称	类型	描述
onSuccess	OIMSuccessCallback	成功返回
onFailure	OIMFailureCallback	失败返回

代码示例

[OIMManager.manager markConversationMessageAsRead:@""
                                   onSuccess:^(NSString * _Nullable data) {

} onFailure:^(NSInteger code, NSString * _Nullable msg) {

}];

Flutter

函数原型

public void markMessageAsReadByConID(OnBase<String> callBack, String conversationID)

输入参数

参数名称	参数类型	是否必填	描述
callBack	OnBase<String>	是	回调接口
conversationID	String	是	会话 ID

代码示例

       OpenIMClient.getInstance().messageManager.markMessageAsReadByConID(new OnBase<String>() {
            @Override
            public void onError(int code, String error) {

            }

            @Override
            public void onSuccess(String data) {

            }
        },conversationID);

uni-app

函数原型

IMSDK.markConversationMessageAsRead(conversationID: string,operationID?: string): Promise<WsResponse>

输入参数

参数名称	参数类型	是否必填	描述
conversationID	string	是	会话 ID

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<WsResponse>	调用成功回调
Promise.catch()	Promise<WsResponse>	调用失败回调

代码示例

import { getSDK } from '@openim/wasm-client-sdk';
const IMSDK = getSDK();

// use in electron with ffi
// import { getWithRenderProcess } from '@openim/electron-client-sdk/lib/render';
// const { instance: IMSDK } = getWithRenderProcess();

// use in mini program
// import { getSDK } from '@openim/client-sdk';
// const IMSDK = getSDK();

IMSDK.markConversationMessageAsRead('conversationID')
  .then(({ data }) => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

Browser/Electron/MiniProgram

函数原型

IMSDK.asyncApi('markConversationMessageAsRead', operationID: string, conversationID: string): Promise<void>

输入参数

参数名称	参数类型	是否必填	描述
operationID	string	是	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数
conversationID	string	是	会话 ID

返回结果

通过openim-uniapp-polyfill包将函数 Promise 化，调用时需要使用then和catch判断并处理成功和失败回调。

参数名称	参数类型	描述
Promise.then()	Promise<void>	调用成功回调
Promise.catch()	Promise<CatchResponse>	调用失败回调

代码示例

import IMSDK from 'openim-uniapp-polyfill';

IMSDK.asyncApi('markConversationMessageAsRead', IMSDK.uuid(), 'conversationID')
  .then(() => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

React-Native

函数原型

OpenIMSDK.markConversationMessageAsRead(conversationID: string, operationID?: string): Promise<void>

输入参数

参数名称	参数类型	是否必填	描述
conversationID	string	是	会话 ID
operationID	string	否	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<void>	调用成功回调
Promise.catch()	Promise<OpenIMApiError>	调用失败回调

代码示例

import OpenIMSDK from "@openim/rn-client-sdk";

OpenIMSDK.markConversationMessageAsRead('conversationID')
  .then(() => {
    // 调用成功
  })
  .catch((error) => {
    // 调用失败
  });

Unity

函数原型

public static void MarkConversationMessageAsRead(OnBase<bool> cb, string conversationId)

输入参数

参数名称	参数类型	是否必填	描述
cb	OnBase	是	回调函数
conversationId	string	是	会话 ID

代码示例

IMSDK.MarkConversationMessageAsRead((suc,errCode,errMsg)=>{

},conversationId);