docs-matrix-spec/locales/zh-Hans/client-server-api/modules/stickers.md
2025-04-20 16:13:37 +08:00

1.3 KiB
Raw Blame History

贴纸消息

该模块允许用户在房间或直接消息会话中发送贴纸消息。

贴纸消息是一种特殊的图片消息,展示时不带有控件(例如,不会显示“下载”链接,或在点击时以灯箱方式显示,如 m.image 事件中所示)。

贴纸消息旨在在消息时间线上提供简单的“反馈”事件。Matrix 客户端应提供某种机制以显示贴纸的“body”例如在悬停时作为工具提示显示或在点击贴纸图片时以弹窗形式展示。

事件

贴纸事件以单个 m.sticker 事件的形式,在房间的 timeline 部分,通过 /sync 接收。

{{% event event="m.sticker" %}}

客户端行为

支持此消息类型的客户端应直接在时间线中展示事件 URL 指向的图片内容。

应在 info 对象中提供缩略图图片。这主要是为那些尚未完全支持 m.sticker 事件类型的客户端提供的降级方案。在大多数情况下,将缩略图 URL 设为与主事件内容相同的 URL 即可。

建议贴纸图片内容的大小为 512x512 像素或更小。图片文件的尺寸应为 info 对象中指定的理想展示尺寸的两倍,以便在高 DPI 屏幕上渲染更清晰的图像。