Stream Chat 中系统消息的自定义头像与名称配置指南-Python教程-PHP中文网

Stream Chat 中系统消息的自定义头像与名称配置指南

在 Stream Chat 中，可通过将消息 type 设为 "system" 并在 user 对象中完整传入 name 和 image 字段，实现系统消息的个性化展示（如使用应用 Logo 和名称），而非默认的“system”文本和占位头像。

在 stream chat 中，可通过将消息 `type` 设为 `"system"` 并在 `user` 对象中完整传入 `name` 和 `image` 字段，实现系统消息的个性化展示（如使用应用 logo 和名称），而非默认的“system”文本和占位头像。

Stream Chat 默认将 type: "regular" 的消息视为普通用户消息，即使 user.id 是系统专用 ID，前端 SDK 仍会忽略 user.name 和 user.image 字段，强制显示为“system”及默认头像。根本解法是显式声明消息类型为 "system"——这不仅语义正确，更触发 SDK 的系统消息渲染逻辑，使其尊重所传入的 user 元数据。

以下是推荐的后端发送代码（Python）：

message = {
    "text": f"Today's reading: {passage_reference}",
    "isGroupPlanPassage": True,
    "passageReference": passage_reference,
    "passageData": {
        "planId": plan_data.get("groupPlanID"),
        "passageNumber": current_passage_number
    },
    "user": {
        "id": system_user_id,           # 必须存在且唯一（建议固定如 "app-system"）
        "name": app_name,               # 如 "BiblePlan App"
        "image": image_url              # 如 "https://cdn.example.com/logo-48x48.png"
    },
    "type": "system"                    # ✅ 关键：启用自定义系统消息渲染
}

⚠️ 注意事项：

Upload audio to AIOZ Stream
快速上传音频至 AIOZ Stream API。支持默认或自定义编码配置创建音频对象，上传文件并完成处理后返回音频链接。

下载

system_user_id 必须是已在 Stream 后台或通过 Admin API 预创建的有效用户 ID（不能是临时构造的字符串），否则消息可能被拒绝或渲染异常；

image URL 需为公开可访问的 HTTPS 地址，尺寸建议 ≥ 48×48 px 以保证清晰度；

前端需配合定制：React SDK 默认对 type: "system" 消息使用 SystemMessage 组件，你可通过自定义 SystemMessage 覆盖其 UI，例如注入品牌色、调整排版或添加图标；

避免混用 type: "regular" + 系统用户——这属于反模式，既无法自定义外观，也违背消息语义设计。