====== 阅后即焚 ======

----

阅后即焚：用户A发送消息，当用户B接收并查看消息后，消息将同时从用户A和用户B的设备上删除。

{{:start:490integrationcases:fireafterread.jpg|阅后即焚消息传递过程}}

用户A发送消息给用户B，当用户B查看消息后，发送已读回执给用户A，并删除掉查看后的消息，用户A收到消息回执，同时删除消息。

  - 用户A发送消息，消息扩展中添加阅后即焚标识，表示本条消息是阅后即焚消息。
  - 用户B收到消息，解析消息扩展中是否有阅后即焚的标识，如果有，发送已读回执时删除本地消息。
  - 用户A收到消息回执，从本地查询该消息回执对应的消息是否是阅后即焚消息，如果是就删除本地消息并更新显示。

===== 发送阅后即焚消息 =====

=== Android示例 ===

<code java>
// 阅后即焚关键字(只是举例，您可以自定义具体字段)
private final String FIRE_FLAG = "fire";
...
// 创建消息，toChatUsername 为接收方环信 id
EMMessage message = EMMessage.createTxtSendMessage("这是一条阅后即焚消息", toChatUsername);
// 设置为单聊
message.setChatType(ChatType.Chat);
// 设置阅后即焚扩展
message.setAttribute(FIRE_FLAG, true);
// 发送消息
EMClient.getInstance().chatManager().sendMessage(message);
</code>

=== iOS示例 ===

<code objc>
#define FIRE_FLAG @"fire" // 阅后即焚关键字(只是举例，您可以自定义具体字段)

// 此处以文字消息举例
EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:@"这是一条阅后即焚的消息");
// 设置消息body"];
NSString *toUsername = @"接收方环信id";
    
NSDictionary *ext = @{FIRE_FLAG:@YES};
NSString *currentUsername = [EMClient sharedClient].currentUsername; // 当前登录环信id
EMMessage *msg = [[EMMessage alloc] initWithConversationID:toUsername
                                                      from:currentUsername
                                                        to:toUsername
                                                      body:body
                                                       ext:ext];
msg.chatType = EMChatTypeChat; // 设置为单聊
[EMClient.sharedClient.chatManager sendMessage:msg progress:nil completion:nil];
</code>

===== 接收阅后即焚消息，查看后发送回执并删除本地消息 =====

=== Android示例 ===

<code java>
// 阅后即焚关键字(只是举例，您可以自定义具体字段)
private final String FIRE_FLAG = "fire";
...
/**
 * 新消息回调
 */
@Override
public void onMessageReceived(List<EMMessage> messages) {
    for (EMMessage message : messages) {
        // 判断是否为阅后即焚消息
        if (message.getBooleanAttribute(FIRE_FLAG, false)) {
            // update ui
        }
    }
}
...
// 当消息已读之后，发送已读回执，并删除消息
try {
    EMClient.getInstance().chatManager().ackMessageRead(message.getFrom(), message.getMsgId());
    // 消息所属会话
    EMConversation conversation = EMClient.getInstance().chatManager().getConversation(message.getFrom(), EMConversation.EMConversationType.Chat, true);
    conversation.removeMessage(message.getMsgId());
} catch (HyphenateException e) {
    e.printStackTrace();
}
</code>

=== iOS示例 ===

<code objc>
#define FIRE_FLAG @"fire" // 阅后即焚关键字(只是举例，您可以自定义具体字段)

// 接收消息回调
- (void)messagesDidReceive:(NSArray *)aMessages {
    for (EMMessage *msg in aMessages) {
        // 判断是否有阅后即焚消息标识
        if ([message.ext[FIRE_FLAG] boolValue]) {
            //update ui
        }
    }
}

// 当用户已经读取过消息后，删除消息并发送已读回执
- (void)fireMessageAndSendAck:(EMMessage *)message {
    // 发送已读回执
    [EMClient.sharedClient.chatManager sendMessageReadAck:message completion:nil];
    // _conversation ,消息所在会话
    [_conversation deleteMessageWithId:message.messageId error:nil ;]
}

</code>

===== 消息发送方收到回执，判断需要焚毁，删除本地消息 =====

=== Android示例 ===

<code java>
// 阅后即焚关键字(只是举例，您可以自定义具体字段)
private final String FIRE_FLAG = "fire";
...
/**
 * 收到消息已读回执
 */
@Override
public void onMessageRead(List<EMMessage> messages) {
    for (EMMessage message : messages) {
        if (message.getBooleanAttribute(FIRE_FLAG, false)) {
            // 消息所属会话
            EMConversation conversation = EMClient.getInstance().chatManager().getConversation(message.getFrom(), EMConversation.EMConversationType.Chat, true);
            // 删除消息
            conversation.removeMessage(message.getMsgId());
        }
    }
}
</code>

=== iOS示例 ===

<code objc>
#define FIRE_FLAG @"fire" // 阅后即焚关键字(只是举例，您可以自定义具体字段)
// 收到已读回执
- (void)messagesDidRead:(NSArray *)aMessages {
    for (EMMessage *msg in aMessages) {
        if ([msg.ext[FIRE_FLAG] boolValue]) {
            EMConversation *con = [EMClient.sharedClient.chatManager getConversation:msg.from type:EMConversationTypeChat createIfNotExist:YES]; // 消息所在会话
            [con deleteMessageWithId:msg.messageId error:nil]; // 删除消息
            // update ui
        }
    }
}
</code>

----
<WRAP group>
<WRAP half column>
上一页：[[start:490integrationcases:50groupchatat|群组@功能]]
</WRAP>

<WRAP half column>
下一页：[[start:490integrationcases:revoke-messages|消息回撤]]
</WRAP>
</WRAP>