docs-matrix-spec/locales/zh-Hans/rooms/fragments/v1-stringy-power-levels.md
2025-04-20 16:13:37 +08:00

1.2 KiB
Raw Blame History

m.room.power_levels 事件支持以字符串形式传递数值

为了与早期实现保持向后兼容, m.room.power_levels 事件中的每个整数值属性 都可以被编码为字符串而非整数。这包括 eventsnotificationsusers 属性中的嵌套值。例如,以下是在此房间版本中有效的 m.room.power_levels 事件:

{
  "content": {
    "ban": "50",
    "events": {
      "m.room.power_levels": "100"
    },
    "events_default": "0",
    "state_default": "50",
    "users": {
      "@example:localhost": "100"
    },
    "users_default": "0"
  },
  "origin_server_ts": 1432735824653,
  "room_id": "!jEsUZKDJdhlrceRyVU:example.org",
  "sender": "@example:example.org",
  "state_key": "",
  "type": "m.room.power_levels"
}

当该值表示整数时,必须符合以下格式:

  • 仅包含一个十进制整数,不允许浮点数或小数点,可以带任意数量的前导零(如 "100""000100"
  • 可选地在整数前面加一个 -+ 字符(如 "+100""-100"
  • 可选地在前后添加任意数量的空白字符(如 " 100 "" 00100 "" +100 "" -100 ")。