docs-matrix-spec/locales/zh-Hans/rooms/v4.md at 1030e735c0f4dd563f21b6010f86da2404118f7c

2025-04-20 16:13:37 +08:00

title	type	weight	version
房间版本 4	docs	40	4

{{< boxes/warning >}} 本页面的翻译未经核对，可能存在翻译质量不佳、错翻、漏翻等情况。您可以在 Forgejo 存储库打开 Issue、提交 Pull Request 或邮件联系我们提出改进建议和参与翻译与核对。 {{< /boxes/warning >}}

本房间版本在版本 3 的基础上，采用了不同的事件 ID 编码方式。

客户端注意事项

本房间版本更改了发送给客户端的事件 ID 格式。客户端应始终将事件 ID 视为不可理解的标识符，而不应关心其具体格式。在将事件 ID 包含在请求路径中时，客户端仍需对其进行编码。

客户端应做好事件 ID 的格式已从 $randomstring:example.org 更改为类似 $Rqnc-F-dvnEYJTyHq_iKxU2bZ1CI92-kuZq3a5lr5Zg（请注意没有域名部分）的准备。

虽然本房间版本对此未作更改，但如客户端在本地实现了修订算法，应参考下文的修订部分，了解完整内容。

{{% boxes/warning %}} 本节内容仅供服务器实现者参考。使用 Client-Server API 的应用通常不会受到此处细节的影响。上述关于客户端注意事项的部分，才是 Client-Server API 用例应参考的内容。 {{% /boxes/warning %}}

房间版本 4 使用了房间版本 3 中定义的相同算法，不过在生成事件 ID 时采用了 URL 安全的 base64 编码方式。

{{% boxes/rationale %}} 房间版本 3 生成的事件 ID，对于未对事件 ID 编码的客户端实现来说难以正常使用。此外，由于 / 字符在某些反向代理软件中会被区别对待，也引发了相关担忧，并在一般管理上带来了不便。 {{% /boxes/rationale %}}

以下内容自 v3 起未作修改，为保证完整性予以收录。

事件格式与房间版本 3 相同，但以下示例中的事件 ID 已根据本房间版本的更改进行了更新。