From a132438f4b5b1a8091e4fb5c2228290b7d38fc99 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=A5=87=E8=91=A9=E3=81=AE=E7=81=B5=E6=A2=A6?=
 <cutereimu@vip.qq.com>
Date: Wed, 13 Nov 2024 20:31:37 +0800
Subject: [PATCH] =?UTF-8?q?=E5=8D=8F=E8=AE=AE=E6=96=87=E6=A1=A3=E9=87=8D?=
 =?UTF-8?q?=E6=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 doc/README.md | 115 +++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 110 insertions(+), 5 deletions(-)

diff --git a/doc/README.md b/doc/README.md
index 14225df..0fe302f 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -48,14 +48,14 @@ http协议全部采用POST请求，请求体和回包都采用json格式。
 
 ## 全部协议
 
-### 心跳、登录相关
+<details><summary>心跳、登录相关</summary>
 
 **心跳请求**
 
 协议类型：websocket
 
 示例：
-    
+
 ```jsonc
 {
   "name": "heart_cs",
@@ -85,9 +85,10 @@ http协议全部采用POST请求，请求体和回包都采用json格式。
 
 ```jsonc
 {
-  "name": "login_cs",
+  "name": "login",
   "data": {
-    "name": "test01"
+    "token": "xxxxx", // 客户端token，服务器是以token来判定唯一的用户
+    "name": "test01" // 用户名
   }
 }
 ```
@@ -98,7 +99,111 @@ http协议全部采用POST请求，请求体和回包都采用json格式。
 {
   "code": 0,
   "data": {
-    "room_id": 10 // 房间号，如果为0则表示没有房间
+    "rid": "test01" // 房间号，如果为null则表示没有房间
+  }
+}
+```
+
+</details> 
+
+<details><summary>房间配置</summary>
+
+**创建房间**
+
+协议类型：http
+
+请求：
+
+```jsonc
+{
+  "name": "create_room",
+  "data": { // 很多协议的结构都和这个一样
+    "rid": "test01", // 房间名
+    "type": 1, // 1-标准赛，2-BP赛，3-link赛
+    "solo": false, // 是否为无导播局
+    "add_robot": false, // 是否为打机器人局
+    "game_time": 30, // 游戏总时间（不含倒计时），单位：分
+    "countdown": 5, // 倒计时，单位：秒
+    "games": ["6", "7", "8"], // 含有哪些作品
+    "ranks": ["L", "EX"], // 含有哪些游戏难度，也就是L卡和EX卡
+    "need_win": 2, // 需要胜利的局数，例如2表示bo3
+    "difficulty": 1, // 难度（影响不同星级的卡的分布），1对应E，2对应N，3对应L，其它对应随机
+    "cd_time": 30, // 选卡cd，收卡后要多少秒才能选下一张卡
+    "reserved_type": 1 // 纯客户端用的一个类型字段，服务器只负责透传
   }
 }
 ```
+
+返回：
+
+```jsonc
+{
+  "code": 0,
+  "data": {
+    "rid": "10" // 房间名
+  }
+}
+```
+
+**获取房间配置**
+
+协议类型：http
+
+请求：
+
+```jsonc
+{
+  "name": "get_room_config",
+  "data": {
+    "rid": "test01" // 房间名
+  }
+}
+```
+
+返回：
+
+```jsonc
+{
+  "code": 0,
+  "data": { // 和create_room结构一样
+  }
+}
+```
+
+**修改房间配置**
+
+协议类型：http
+
+请求：
+
+```jsonc
+{
+  "name": "update_room",
+  "data": { // 和create_room结构一样
+  }
+}
+```
+
+返回：
+
+```jsonc
+{
+  "code": 0,
+}
+```
+
+**推送房间配置更新**
+
+协议类型：websocket
+
+示例：
+
+```jsonc
+{
+  "name": "update_room_config_sc",
+  "data": { // 和create_room结构一样
+  }
+}
+```
+
+</details>