SDKsWASM

创建自定义消息

使用 WASM SDK 创建结构化业务自定义消息。

createCustomMessage() 适合订单、任务、邀请或投票等业务消息。

参数说明

参数	类型	是否必填	说明
`data`	`string`	是	业务数据的完整字符串，通常保存序列化后的 JSON。
`extension`	`string`	是	业务扩展信息的完整字符串。
`description`	`string`	是	消息类型说明或不支持该类型时的降级展示文本。
`searchText` 商业版	`string`	否	供本地消息搜索和列表展示使用的纯文本。

const { data: message } = await openimsdk.createCustomMessage({
  data: JSON.stringify({ type: 'task', taskID: 'task_42' }),
  extension: JSON.stringify({ schemaVersion: 1 }),
  description: '任务卡片',
});

data 是业务数据，extension 是扩展信息，description 用于类型说明或降级展示。三者都是完整字符串，接收端应按双方约定的版本、大小和字段解析，并为未知版本提供降级展示。

商业版如需让自定义消息参与本地消息搜索，可以额外传入 searchText商业版。它只提供可检索文本，不替代实际业务数据：

const { data: searchableMessage } = await openimsdk.createCustomMessage({
  data: JSON.stringify({ type: 'task', taskID: 'task_42' }),
  extension: JSON.stringify({ schemaVersion: 1 }),
  description: '任务卡片',
  searchText: '任务 task_42',
});

Promise 成功只返回待发送 MessageItem。发送与自定义业务事件是不同链路。

这个页面有帮助吗？