SDKsuni-app

创建名片消息

使用 OpenIMCardElem 创建用户名片消息。

参数说明

createCardMessage() 接收 OpenIMCardElem。合同字段都是可选值，但创建可展示名片时应提供以下完整快照：

参数	类型	建议	说明
`userID`	`string` 或 `null`	必填	名片对应的用户 ID。
`nickname`	`string` 或 `null`	必填	名片中保存的展示名称。
`faceURL`	`string` 或 `null`	必填	名片中保存的头像地址。
`ex`	`string` 或 `null`	必填	名片扩展信息；没有内容时传空字符串。

import { createCardMessage } from '@/uni_modules/unix-openim-sdk'

const message = await createCardMessage({
  userID: 'user_b',
  nickname: 'Alex',
  faceURL: 'https://example.com/avatar.png',
  ex: '',
})

Promise 成功只创建 OpenIMMessageItem | null，不会自动发送。名片是创建时快照，不会随用户资料自动更新；接收方点击后应按 userID 查询最新资料，也不要把名片字段当作可信身份认证。

这个页面有帮助吗？