Merge pull request #98 from haoxiuwen/doc-shengwang

Modify Message Deletion Docs and Message Receipt Docs

Author: haoxiuwen

docs/docs/sdk/android/limitation.md

@@ -85,7 +85,7 @@
 
 ### 置顶消息
 
-- 单个会话默认可置顶 20 条消息。你可以联系声网商务提升该上限，最大可调整至 100。
+单个会话默认可置顶 20 条消息。你可以联系声网商务提升该上限，最大可调整至 100。
 
 ### 消息仅投递在线用户
 

docs/docs/sdk/android/message_delete.md

@@ -10,9 +10,9 @@
 
 - `ChatManager#asyncDeleteAllMsgsAndConversations`：清空当前用户的聊天记录，包括单聊、群聊和聊天室的消息和会话，同时可以选择是否单向清除服务端的聊天记录。
 - `Conversation#removeMessagesFromServer`：按消息时间或消息 ID 单向删除服务端的历史消息。
-- `ChatManager#clearAllMessages`：删除本地指定会话的所有消息。
-- `ChatManager#removeMessages(startTime, endTime)`：删除指定时间段的本地消息。
-- `ChatManager#removeMessage(targetMessageId)`：删除本地单个会话的指定消息。
+- `Conversation#clearAllMessages`：删除本地指定会话的所有消息。
+- `Conversation#removeMessages(startTime, endTime)`：删除指定会话一段时间内的本地消息。
+- `Conversation#removeMessage(targetMessageId)`：删除本地会话的指定消息。
 
 ## 前提条件
 
@@ -87,7 +87,7 @@ if(conversation != null) {
 }
 ```
 
-### 删除单个本地会话指定时间段的消息
+### 删除本地会话指定时间段的消息
 
 你可以删除本地指定会话在一段时间内的本地消息，示例代码如下：
 
@@ -98,9 +98,9 @@ if(conversation != null) {
 }
 ```
 
-### 删除本地单个会话的指定消息
+### 删除本地会话的指定消息
 
-你可以删除本地单个会话的指定消息，示例代码如下：
+你可以删除本地会话的指定消息，示例代码如下：
 
 ```java
 Conversation conversation = ChatClient.getInstance().chatManager().getConversation(conversationId);

docs/docs/sdk/android/message_import_insert.md

@@ -6,10 +6,11 @@
 
 ## 技术原理
 
-即时通讯 IM Android SDK 支持提供 `ChatManager` 类支持在本地导入和插入消息，其中包含如下主要方法：
+即时通讯 IM Android SDK 支持提供 `ChatManager` 类和 `Conversation` 类支持在本地导入和插入消息，其中包含如下主要方法：
 
 - `ChatManager#importMessages`：批量导入消息到数据库；
-- `ChatManager#insertMessage`：在本地指定会话中插入一条消息。
+- `Conversation#insertMessage`：在本地指定会话中插入一条消息。
+- `ChatManager#saveMessage`：直接插入消息。若会话不存在，SDK 会自动创建会话。
 
 ## 前提条件
 
@@ -48,7 +49,7 @@ ChatClient.getInstance().chatManager().importMessages(msgs);
 // 将消息插入到指定会话中。
 Conversation conversation = ChatClient.getInstance().chatManager().getConversation(username);
 conversation.insertMessage(message);
-// 直接插入消息。
+// 直接插入消息。若会话不存在，SDK 会自动创建会话。
 ChatClient.getInstance().chatManager().saveMessage(message);
 ```
 

docs/docs/sdk/android/message_receipt.md

@@ -194,7 +194,7 @@ options.setRequireAck(true);
 与单聊消息的 app 层级设置已读回执功能不同，群聊消息是在发送消息时设置指定消息是否需要已读回执。
 
 ```java
-ChatMessage message = ChatMessage.createTxtSendMessage(content, to);
+ChatMessage message = ChatMessage.createTextSendMessage(content, to);
 message.setIsNeedGroupAck(true);
 ```
 
@@ -275,14 +275,14 @@ public void asyncFetchGroupReadAcks(
 
 | 字段       | 描述   | 
 | :--------- | :----- | 
-| `ChatMessage#isUnread` | 用户是否已读了该消息。如果是自己发送的消息，该字段的值固定为 `true`。| 
+| `ChatMessage#isUnread` | 用户是否已读了该消息。如果是自己发送的消息，该字段的值固定为 `false`，表示该消息已读。| 
 | `ChatMessage#isAcked`      | 是否（消息接收方）已发送或（消息发送方）已收到消息已读回执。如果是自己发送的消息，记录的是对方是否已读。如果是对方的消息，则记录的是自己是否发送过已读回执。 | 
 
 对于群聊消息，本地数据库通过以下字段存储消息已读状态：
 
 | 字段       | 描述   | 
 | :--------- | :----- | 
-| `ChatMessage#isUnread` | 用户是否已读了该消息。如果是自己发送的消息，该字段的值固定为 `true`。| 
+| `ChatMessage#isUnread` | 用户是否已读了该消息。如果是自己发送的消息，该字段的值固定为 `false`，表示该消息已读。| 
 | `ChatMessage#groupAckCount`  | 已阅读消息的群成员数量。  | 
 
 ### 已读回执与未读消息数

docs/docs/sdk/android/message_send_receive.md

@@ -504,7 +504,7 @@ ChatClient.getInstance().chatManager().sendMessage(message);
 当 SDK 提供的消息类型不满足需求时，你可以通过消息扩展字段传递自定义的内容，从而生成自己需要的消息类型，例如，消息中需要携带被回复的消息内容或者是图文消息等场景。
 
 ```java
-ChatMessage message = ChatMessage.createTxtSendMessage(content, toChatUsername);
+ChatMessage message = ChatMessage.createTextSendMessage(content, toChatUsername);
 // 增加自定义属性。
 message.setAttribute("attribute1", "value");
 message.setAttribute("attribute2", true);

docs/docs/sdk/android/multi_device.md

@@ -63,7 +63,7 @@ List<String> ids = ChatClient.getInstance().contactManager().getSelfIdsOnOtherPl
 // 选择一个登录 ID 作为消息接收方。
 String toChatUsername = ids.get(0);
 // 创建一条文本消息，content 为消息文字内容，toChatUsername 传入登录 ID 作为消息接收方。
-ChatMessage message = ChatMessage.createTxtSendMessage(content, toChatUsername); 
+ChatMessage message = ChatMessage.createTextSendMessage(content, toChatUsername); 
 // 发送消息。
 ChatClient.getInstance().chatManager().sendMessage(message); 
 ```

docs/docs/sdk/android/thread_message.md

@@ -39,7 +39,7 @@
 
 ```java
 // 创建一条文本消息，`content` 为消息文字内容，`chatThreadId` 为子区 ID。
-ChatMessage message = ChatMessage.createTxtSendMessage(content, chatThreadId); 
+ChatMessage message = ChatMessage.createTextSendMessage(content, chatThreadId); 
 // 设置消息类型，子区消息需要将 `ChatType` 设置为 `GroupChat`。
 message.setChatType(ChatType.GroupChat); 
 // 设置消息标记 `isChatThreadMessage` 为 `true`。

docs/docs/sdk/flutter/integration.md

@@ -49,6 +49,6 @@ iOS 需要 iOS 11.0 以上版本。
 
 ```shell
 cd quick_start
-flutter pub add im_flutter_sdk
+flutter pub add shengwang_chat_sdk
 flutter pub get
 ```

docs/docs/sdk/flutter/message_delete.md

@@ -10,9 +10,9 @@
 
 - `ChatManager#deleteAllMessageAndConversation`：清空当前用户的聊天记录，包括单聊、群聊和聊天室的消息和会话，同时可以选择是否单向清除服务端的聊天记录。
 - `ChatManager#deleteRemoteMessagesBefore`/`ChatManager#deleteRemoteMessagesWithIds`：根据消息时间或消息 ID 单向删除服务端的历史消息。
-- `ChatManager#deleteAllMessages`：删除本地指定会话的所有消息。
-- `ChatManager#deleteMessagesWithTs`：删除指定时间段的本地消息。
-- `ChatManager#deleteMessage`：删除本地单个会话的指定消息。
+- `Conversation#deleteAllMessages`：删除本地指定会话的所有消息。
+- `Conversation#deleteMessagesWithTs`：删除指定时间段的本地消息。
+- `Conversation#deleteMessage`：删除本地会话的指定消息。
 
 ## 前提条件
 
@@ -69,7 +69,7 @@ ChatConversation? conversation = await ChatClient.getInstance.chatManager
 await conversation?.deleteAllMessages();
 ```
 
-### 删除单个本地会话指定时间段的消息
+### 删除本地会话指定时间段的消息
 
 你可以删除本地指定会话在一段时间内的本地消息，示例代码如下：
 
@@ -79,9 +79,9 @@ ChatConversation? conversation = await ChatClient.getInstance.chatManager
 await conversation?.deleteMessagesWithTs(startTs, endTs);
 ```
 
-### 删除本地单个会话的指定消息
+### 删除本地会话的指定消息
 
-你可以删除本地单个会话的指定消息，示例代码如下：
+你可以删除本地会话的指定消息，示例代码如下：
 
 ```dart
 ChatConversation? conversation = await ChatClient.getInstance.chatManager

docs/docs/sdk/harmonyos/message_delete.md

@@ -10,7 +10,7 @@
 
 - `ChatManager#removeMessagesFromServer`：按消息时间或消息 ID 单向删除服务端的历史消息。
 - `Conversation#clearAllMessages`：删除本地指定会话的所有消息。
-- `Conversation#removeMessage(targetMessageId)`：删除本地单个会话的指定消息。
+- `Conversation#removeMessage(targetMessageId)`：删除本地会话的指定消息。
 
 ## 前提条件
 
@@ -50,9 +50,9 @@ if(conversation) {
 }
 ```
 
-### 删除本地单个会话的指定消息
+### 删除本地会话的指定消息
 
-你可以删除本地单个会话的指定消息，示例代码如下：
+你可以删除本地会话的指定消息，示例代码如下：
 
 ```typescript
 let conversation = ChatClient.getInstance().chatManager()?.getConversation(conversationId);