1.4 KiB
1.4 KiB
客户端配置
客户端可以在他们的主服务器上为其账户存储自定义配置数据。这些账户数据将在不同设备间同步，并且能够在特定设备上的多次安装之间保持持久性。用户只能查看其自己账户的账户数据。
账户数据可以是全局的，也可以限定在特定房间内。这里没有继承机制：如果某个 type 类型的数据在房间的账户数据中缺失，不会自动回退到同类型的全局账户数据。
事件
客户端通过 /sync 响应中的 account_data 部分接收账户数据事件。
这些事件也可以在 /events 响应中接收，或者作为房间 /sync 响应中的 account_data 部分收到。出现在 /events 中的 m.tag 事件会带有所对应房间的 room_id。
客户端行为
{{% http-api spec="client-server" api="account-data" %}}
服务器行为
服务器必须拒绝设置服务器自身管理的事件类型的账户数据，并返回 405 错误响应。
目前，仅包括 m.fully_read
和 m.push_rules 事件类型。这一规定同样适用于全局和按房间划分的账户数据。
{{% boxes/note %}}
{{% changed-in v="1.10" %}} m.push_rules 被添加到了拒绝列表中。
{{% /boxes/note %}}
服务器必须允许客户端正常读取上述事件类型的数据。