v1.12 变更日志

客户端-服务器 API

弃用

• 按照 MSC4156 的规定，弃用 POST /_matrix/client/v3/join/{roomIdOrAlias} 和 POST /_matrix/client/v3/knock/{roomIdOrAlias} 接口中的 server_name 查询参数。(#1933)

移除的接口

• 移除对设备专属推送规则的引用。(#1842)
• 按照 MSC4159 的规定，移除 HTML 锚点元素中已弃用的 name 属性。(#1870)

向后兼容的变更

• 按照 MSC4170 的规定，在 GET /_matrix/client/v3/profile/{userId}/avatar_url 和 GET /_matrix/client/v3/profile/{userId}/displayname 接口中新增 403 响应。(#1867)
• 按照 MSC2867，新增对房间标记为未读的支持。(#1895, #1941)
• 按照 MSC4156，在 POST /_matrix/client/v3/join/{roomIdOrAlias} 和 POST /_matrix/client/v3/knock/{roomIdOrAlias} 接口中新增 via 查询参数。(#1933)
• 按照 MSC3939，新增账户锁定功能。(#1934)
• 按照 MSC4189，访客账户现可通过新认证接口下载/获取媒体缩略图。(#1959)

规范澄清

• 重命名并排序特性概要表中的模块，以便于浏览。(#1855)
• 明确房间头像不可加密。(#1871)
• 记录“Secrets”部分的缩写及别名。(#1875)
• 提高事务 ID 生成建议的准确性。(#1888)
• 明确说明已弃用的 dont_notify 和 coalesce 推送动作必须被忽略而非拒绝。(#1890)
• 修复规范中各处的拼写错误。(#1892)
• 在功能表中补充缺失的 m.set_displayname、m.set_avatar_url 和 m.3pid_changes 的引用。(#1897)
• 明确回退登录页面调用的是 window.matrixLogin.onLogin 而非 window.onLogin。(#1899)
• 移除有关无任何有效条件的受限房间的混淆性描述。(#1903)
• 明确 window.matrixLogin.onLogin 调用时传递的是 POST /_matrix/client/v3/login 的响应体。(#1905)
• 按照 MSC3882，记录 m.get_login_token 能力。(#1908)
• 明确 POST /_matrix/client/v3/login 中的“用户标识符”对象包含依赖标识类型的其他属性。(#1909)
• 不再特别说明 GET /_matrix/client/v3/profile/{userId} 可以返回附加属性，因为几乎所有接口都如此。(#1910)
• 改进未认证媒体弃用提示框的描述，贡献者：@HarHarLinks。(#1916)
• GET /.well-known/matrix/client 中的附加属性不再强制要求为对象类型。(#1920)
• 记录规范中使用了 RFC 2119 关键词。贡献者：@HarHarLinks。(#1928)
• 按照 MSC2701 与 MSC2702，明确媒体库中 Content-Type 和 Content-Disposition 的用法。(#1935)
• GET /_matrix/client/v3/capabilities 的附加键值不再强制要求为对象类型。(#1945)

服务器-服务器 API

向后兼容的变更

• 按照 MSC4170，在 GET /_matrix/federation/v1/query/profile 接口中新增 403 响应。(#1867)

规范澄清

• 因已不再出现在 schema，移除 PDU 示例中的 origin 字段。(#1918)
• 记录规范中使用了 RFC 2119 关键词。贡献者：@HarHarLinks。(#1928)
• 修正 GET /_matrix/key/v2/server 响应 schema 中的必需字段。(#1930)
• 用“服务器名称”替代“DNS 名称”，以避免和附录中定义的“服务器名称”包含的“DNS 名称”混淆。(#1946)

应用服务 API

规范澄清

• 记录规范中使用了 RFC 2119 关键词。贡献者：@HarHarLinks。(#1928)

身份验证服务 API

规范澄清

• 记录规范中使用了 RFC 2119 关键词。贡献者：@HarHarLinks。(#1928)

推送网关 API

规范澄清

• 记录规范中使用了 RFC 2119 关键词。贡献者：@HarHarLinks。(#1928)

房间版本

规范澄清

• 修复 state resolution v2 中的格式问题。(#1896)
• 记录规范中使用了 RFC 2119 关键词。贡献者：@HarHarLinks。(#1928)

附录

规范澄清

• 记录规范中使用了 RFC 2119 关键词。贡献者：@HarHarLinks。(#1928)

内部变更/工具链

规范澄清

• Matrix.org 基金会不再要求贡献者需提供“真实”或“法律可识别”的姓名。(#1886, #1914)
• 记录 removal 变更日志分类。(#1907)
• 启用专用字体以更好地支持数学符号。(#1919)
• 记录规范中使用了 RFC 2119 关键词。贡献者：@HarHarLinks。(#1928)
• 为变更日志在 /changelog/$VERSION/checklist.md 下提供 markdown 检查表。(#1937, #1954)
• 在 OpenAPI 定义和 JSON Schema 属性中新增 deprecated 字段。(#1940)
• 使用相对永久链接跳转到最新变更日志。(#1956)