appendMessage

功能介绍

为一条消息,附着另一条消息,添加至链表。可用于创建多Element消息,实现图文消息混排等效果。

为一个消息添加一系列额外的消息,一般用于消息中图文混排。

只能在创建message的阶段进行appendMessage操作。

参数详解

参数名称 参数类型 是否必填 描述
createMessageBaseId string 需要添加Element的创建的消息id
createMessageAppendId string 添加的创建消息id

返回模板

V2TimValueCallback<V2TimMessage>

{
    code : number
    desc : string
    data : {
      msgID: string
      timestamp: number
      progress: number
      sender: string
      nickName: string
      friendRemark: string
      faceUrl: string
      nameCard: string
      groupID: string
      userID: string
      status: number
      elemType: number
      textElem: V2TimTextElem
      customElem: V2TimCustomElem
      imageElem: V2TimImageElem
      soundElem: V2TimSoundElem
      videoElem: V2TimVideoElem
      fileElem: V2TimFileElem
      locationElem: V2TimLocationElem
      faceElem: V2TimFaceElem
      groupTipsElem: V2TimGroupTipsElem
      mergerElem: V2TimMergerElem
      localCustomData: string
      localCustomInt: number
      cloudCustomData: string
      isSelf: boolean
      isRead: boolean
      isPeerRead: boolean
      priority: number
      offlinePushInfo: V2TimOfflinePushInfo
      groupAtUserList: string[]
      seq: string
      random: number
      isExcludedFromUnreadCount: boolean
      isExcludedFromLastMessage: boolean
      id: string
      needReadReceipt: boolean
    }
}

返回值详解

名称 数值类型 描述
code number 请求结果错误码
desc string 请求结果描述
data V2TimMessage 添加消息后的信息

代码示例

import { TencentImSDKPlugin } from 'react-native-tim-js';

// 创建文本消息
const createTextMessageRes = await TencentImSDKPlugin.v2TIMManager
    .getMessageManager()
    .createTextMessage(
        'test' // 文本信息
    );
// 创建append消息
const createAppendMessageRes = await TencentImSDKPlugin.v2TIMManager
    .getMessageManager()
    .createTextMessage(
        'append' // 添加的文本信息
    );
if (createTextMessageRes.code === 0 && createAppendMessageRes.code === 0) {
    // 文本信息创建成功
    const id = createTextMessageRes.data?.id;
    const appendId = createAppendMessageRes.data?.id;
    // 为第一个消息添加一个Text消息
    const appendMessageRes = await TencentImSDKPlugin.v2TIMManager
        .getMessageManager()
        .appendMessage(id!, appendId!);
    if (appendMessageRes.code === 0) {
        // 发送文本消息
        // 在sendMessage时,若只填写receiver则发个人用户单聊消息
        //                 若只填写groupID则发群组消息
        //                 若填写了receiver与groupID则发群内的个人用户,消息在群聊中显示,只有指定receiver能看见
        const sendMessageRes = await TencentImSDKPlugin.v2TIMManager
            .getMessageManager()
            .sendMessage({ id: id!, receiver: 'userID', groupID: 'groupID' }); //注意此时的id为被添加的消息id
        if (sendMessageRes.code === 0) {
            // 发送成功
            // append的Text消息在sendMessageRes.data.textElem.nextElem中
        }
    }
}

results matching ""

    No results matching ""