Merge remote-tracking branch 'origin/master'

CHANGELOG.md

@@ -2,6 +2,21 @@
 
 开发版本. 频繁更新, 不保证高稳定性
 
+## `0.18.0` 2020/2/20
+
+### mirai-core
+- 添加 `MessageSource.time`
+- 添加事件监听时额外的 `coroutineContext`
+- 为一些带有 `operator` 的事件添加 `.isByBot` 的属性扩展
+- 优化事件广播逻辑, 修复可能无法触发监听的问题
+- 为所有 `Contact` 添加 `toString()` (#80)
+
+### mirai-core-qqandroid
+- 支持成员禁言状态和时间查询 `Member.muteTimeRemaining`
+- 修复 `At` 的 `display` (#73), 同时修复 `QuoteReply` 无法显示问题 (#54).
+- 广播 `BotReloginEvent` (#78)
+- 支持机器人自身禁言时间的更新和查询 (#82)
+
 ## `0.17.0` 2020/2/20
 
 ### mirai-core

gradle.properties

 # style guide
 kotlin.code.style=official
 # config
-mirai_version=0.17.0
+mirai_version=0.18.0
 mirai_japt_version=1.0.1
 kotlin.incremental.multiplatform=true
 kotlin.parallel.tasks.in.project=true

mirai-api-http/README_CH.md

@@ -331,24 +331,26 @@ Content-Type：multipart/form-data
 
 
 
-### 获取Bot收到的消息
+### 获取Bot收到的消息和事件
 
 ```
 [GET] /fetchMessage?sessionKey=YourSessionKey&count=10
 ```
 
+使用此方法获取bot接收到的消息和各类事件
+
 #### 请求:
 
-| 名字       | 可选  | 举例           | 说明            |
-| ---------- | ----- | -------------- | --------------- |
-| sessionKey | false | YourSessionKey | 你的session key |
-| count      | false | 10             | 获取消息的数量  |
+| 名字       | 可选  | 举例           | 说明                 |
+| ---------- | ----- | -------------- | -------------------- |
+| sessionKey | false | YourSessionKey | 你的session key      |
+| count      | false | 10             | 获取消息和事件的数量 |
 
 #### 响应: 返回JSON对象
 
 ```json5
 [{
-    "type": "GroupMessage",        // 消息类型：GroupMessage或FriendMessage
+    "type": "GroupMessage",        // 消息类型：GroupMessage或FriendMessage或各类Event
 	"messageChain": [{             // 消息链，是一个消息对象构成的数组
 	    "type": "Source",
 	    "uid": 123456
@@ -366,9 +368,8 @@ Content-Type：multipart/form-data
             "permission": "MEMBER"      // 发送群中，Bot的群限权
         }
     }
- },
- {
-    "type": "FriendMessage",         // 消息类型：GroupMessage或FriendMessage
+ },{
+    "type": "FriendMessage",         // 消息类型：GroupMessage或FriendMessage或各类Event
         "messageChain": [{           // 消息链，是一个消息对象构成的数组
         "type": "Plain",
         "text": "Miral牛逼"
@@ -378,11 +379,40 @@ Content-Type：multipart/form-data
         "nickName": "",              // 发送者的昵称
         "remark": ""                 // 发送者的备注
     }
+ },{
+    "type": "MemberMuteEvent",       // 消息类型：GroupMessage或FriendMessage或各类Event
+    "durationSeconds": 600,
+    "member":{
+        "id": 123456789,
+        "memberName": "禁言对象",
+        "permission": "MEMBER",
+        "group": {
+            "id": 123456789,
+            "name": "Miral Technology",
+            "permission": "MEMBER"
+        }
+    },
+    "operator":{
+        "id": 987654321, 
+        "memberName": "群主大人", 
+        "permission": "OWNER",
+        "group": {
+            "id": 123456789,
+            "name": "Miral Technology",
+            "permission": "MEMBER"
+        }
+    }
 }]
 ```
 
 
 
+### 事件类型一览
+[事件类型一览](./EventType_CN.md)
+
+> 事件为Bot被动接收的信息，无法主动构建
+
+
 ### 消息类型一览
 
 #### 消息是构成消息链的基本对象，目前支持的消息类型有

mirai-api-http/src/main/kotlin/net/mamoe/mirai/api/http/data/common/BotEventDTO.kt

@@ -38,7 +38,7 @@ fun BotEvent.toDTO() = when(this) {
         is MemberJoinEvent -> MemberJoinEventDTO(MemberDTO(member))
         is MemberLeaveEvent.Kick -> MemberLeaveEventKickDTO(MemberDTO(member), operator?.let(::MemberDTO))
         is MemberLeaveEvent.Quit -> MemberLeaveEventQuitDTO(MemberDTO(member))
-        is MemberCardChangeEvent -> MemberCardChangeEventDTO(origin, new, GroupDTO(group), operator?.let(::MemberDTO))
+        is MemberCardChangeEvent -> MemberCardChangeEventDTO(origin, new, MemberDTO(member), operator?.let(::MemberDTO))
         is MemberSpecialTitleChangeEvent -> MemberSpecialTitleChangeEventDTO(origin, new, MemberDTO(member))
         is MemberPermissionChangeEvent -> MemberPermissionChangeEventDTO(origin, new, MemberDTO(member))
         is MemberMuteEvent -> MemberMuteEventDTO(durationSeconds, MemberDTO(member), operator?.let(::MemberDTO))
@@ -103,7 +103,7 @@ data class MemberLeaveEventKickDTO(val member: MemberDTO, val operator: MemberDT
 data class MemberLeaveEventQuitDTO(val member: MemberDTO) : BotEventDTO()
 @Serializable
 @SerialName("MemberCardChangeEvent")
-data class MemberCardChangeEventDTO(val origin: String, val new: String, val group: GroupDTO, val operator: MemberDTO?) : BotEventDTO()
+data class MemberCardChangeEventDTO(val origin: String, val new: String, val member: MemberDTO, val operator: MemberDTO?) : BotEventDTO()
 @Serializable
 @SerialName("MemberSpecialTitleChangeEvent")
 data class MemberSpecialTitleChangeEventDTO(val origin: String, val new: String, val member: MemberDTO) : BotEventDTO()