跳到正文

useMessageSend ​

向当前会话发送文本、媒体、位置、自定义、CMD 和 multi_body 复合消息,并支持失败重发。

导入与签名 ​

ts
import { useMessageSend } from '@easemob-community/uikit-im'

const sender = useMessageSend()

主要方法 ​

方法关键参数
sendTextMessage(text, ext?, options?)文本、业务扩展、群已读配置
sendImageMessage(data, options?, ext?)File 或图片 URL
sendFileMessage(file, options?, ext?)浏览器 File
sendAudioMessage(file, duration, options?, ext?)音频与时长
sendVideoMessage(file, duration, options?, ext?)视频与时长
sendCustomMessage(event, params?, ext?)自定义事件与载荷
sendMultiBodyMessage(bodies, ext?, options?)2~20 个有序复合分段、业务扩展、群已读配置
resendMessage(message)重发失败消息;复合消息复用原对象以保留附件上传进度

最小用法 ​

ts
const { sendTextMessage } = useMessageSend()
await sendTextMessage('你好')

所有发送方法使用当前会话;群已读回执由会话类型、群规模和 SendMessageOptions 共同决定。

发送复合消息 ​

MultiBodySegmentInput 支持 text/image/file/voice/video/location/custom。本地文件使用 data: File,远端资源使用 originalUrl;分段顺序就是接收方的展示顺序。

ts
const { sendMultiBodyMessage } = useMessageSend()

await sendMultiBodyMessage([
  { type: 'text', content: '请看设计稿' },
  { type: 'image', data: imageFile, filename: imageFile.name },
  { type: 'text', content: '第三版已更新' },
], { source: 'composer' }, { groupReadReceiptEnabled: true })

发送创建限制为 2~20 段。websdk4 不支持此能力,调用会得到 MULTI_BODY_UNSUPPORTED;内置输入入口还需要同时设置 input.features.multiBody: true。复合消息不可编辑或翻译,附件下载可调用 domain 的 downloadMultiBodyAttachments(message),返回按分段顺序排列的附件数组。