ryoii пре 4 година
родитељ
комит
a05cc30654

+ 12 - 0
docs/adapter/HttpAdapter.md

@@ -754,6 +754,18 @@ adapterSettings:
 
 通用接口定义: [修改群员设置](../api/API.md#修改群员设置)
 
+### 修改群员管理员
+
+使用此方法修改群员的管理员权限(需要有群主限权)
+
+```
+[POST] /memberAdmin
+```
+
+**本接口为[POST]请求, 参数格式为`application/json`**
+
+通用接口定义: [修改群员管理员](../api/API.md#修改群员管理员)
+
 ## 事件处理
 
 ### 添加好友申请

+ 10 - 0
docs/adapter/ReverseWebsocketAdapter.md

@@ -462,6 +462,16 @@ adapterSettings:
 
 通用接口定义: [修改群员设置](../api/API.md#修改群员设置)
 
+### 修改群员管理员
+
+使用此方法修改群员的管理员权限(需要有群主限权)
+
+```
+命令字: memberAdmin
+```
+
+通用接口定义: [修改群员管理员](../api/API.md#修改群员管理员)
+
 ## 事件处理
 
 ### 添加好友申请

+ 10 - 0
docs/adapter/WebhookAdapter.md

@@ -236,6 +236,16 @@ webhook 不会接收主动请求, 只会接收到事件后向知道地址进行
 
 通用接口定义: [修改群员设置](../api/API.md#修改群员设置)
 
+### 修改群员管理员
+
+使用此方法修改群员的管理员权限(需要有群主限权)
+
+```
+命令字: memberAdmin
+```
+
+通用接口定义: [修改群员管理员](../api/API.md#修改群员管理员)
+
 ## 事件处理
 
 ### 添加好友申请

+ 10 - 0
docs/adapter/WebsocketAdapter.md

@@ -468,6 +468,16 @@ adapterSettings:
 
 通用接口定义: [修改群员设置](../api/API.md#修改群员设置)
 
+### 修改群员管理员
+
+使用此方法修改群员的管理员权限(需要有群主限权)
+
+```
+命令字: memberAdmin
+```
+
+通用接口定义: [修改群员管理员](../api/API.md#修改群员管理员)
+
 ## 事件处理
 
 ### 添加好友申请

+ 36 - 0
docs/api/API.md

@@ -48,6 +48,7 @@
   + [修改群设置](#修改群设置)
   + [获取群员资料](#获取群员设置)
   + [修改群员资料](#修改群员设置)
+  + [修改群员管理员](#修改群员管理员)
 + **[事件处理](#事件处理)**
   + [添加好友申请](#添加好友申请)
   + [用户入群申请](#用户入群申请(Bot需要有管理员权限))
@@ -1118,6 +1119,41 @@
 }
 ```
 
+### 修改群员管理员
+
+使用此方法修改群员的管理员权限(需要有群主限权)
+
+```
+[POST] /memberAdmin
+```
+
+#### 请求:
+
+```json5
+{
+    "sessionKey": "YourSessionKey",
+    "target": 123456789,
+    "memberId": 987654321,
+    "assign": true
+}
+```
+
+| 名字              | 可选  | 类型    | 举例             | 说明                 |
+| ----------------- | ----- | ------- | ---------------- | -------------------- |
+| sessionKey        | true  | String  | "YourSessionKey" | 你的session key      |
+| target            | false | Long    | 123456789        | 指定群的群号         |
+| memberId          | false | Long    | 987654321        | 群员QQ号             |
+| assign            | false | Boolean | true             | 是否设置为管理员       |
+
+#### 响应: 返回统一状态码
+
+```json5
+{
+  "code":0,
+  "msg":"success"
+}
+```
+
 ## 事件处理
 
 ### 添加好友申请

+ 9 - 3
docs/api/EventType.md

@@ -251,7 +251,8 @@
     "id": 123456789,
     "name": "Miral Technology",
     "permission": "MEMBER"
-  }
+  },
+  invitor: null
 }
 ```
 
@@ -261,6 +262,7 @@
 | group.id         | Long   | 群号                                                         |
 | group.name       | String | 群名                                                         |
 | group.permission | String | Bot在群中的权限,OWNER、ADMINISTRATOR或MEMBER(新加入群通常是Member) |
+| invitor          | Object | 如果被要求入群的话,则为邀请人的 Member 对象 |
 
 
 
@@ -273,7 +275,8 @@
     "id": 123456789,
     "name": "Miral Technology",
     "permission": "MEMBER"
-  }
+  },
+  operator: null
 }
 ```
 
@@ -283,6 +286,7 @@
 | group.id         | Long   | 群号                                                         |
 | group.name       | String | 群名                                                         |
 | group.permission | String | Bot在群中的权限,ADMINISTRATOR或MEMBER |
+| operator         | Object | Bot被踢后获取操作人的 Member 对象 |
 
 
 
@@ -673,7 +677,8 @@
       "name":"群名1",
       "permission":"MEMBER" // bot 在群中的权限
     }
-  }
+  },
+  invitor: null
 }
 ```
 
@@ -687,6 +692,7 @@
 | member.group.id         | Long   | 群号                                                         |
 | member.group.name       | String | 群名                                                         |
 | member.group.permission | String | Bot在群中的权限,OWNER、ADMINISTRATOR或MEMBER                |
+| invitor                 | Object | 如果被要求入群的话,则为邀请人的 Member 对象 |
 
 
 

+ 3 - 1
docs/api/MessageType.md

@@ -230,7 +230,8 @@
     "voiceId": "23C477720A37FEB6A9EE4BCCF654014F.amr",
     "url": "https://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
     "path": null,
-    "base64": null
+    "base64": null,
+    "length": 1024,
 }
 ```
 
@@ -240,6 +241,7 @@
 | url     | String | 语音的URL,发送时可作网络语音的链接;接收时为腾讯语音服务器的链接,可用于语音下载 |
 | path    | String | 语音的路径,发送本地语音,路径相对于 JVM 工作路径(默认是当前路径,可通过 `-Duser.dir=...`指定),也可传入绝对路径。 |
 | base64  | String | 语音的 Base64 编码                                           |
+| length  | Long   | 返回的语音长度, 发送消息时可以不传                              |
 
 > 三个参数任选其一,出现多个参数时,按照voiceId > url > path > base64的优先级