====== 消息撤回 ======

===== 服务设置 =====

  * 默认设置：消息撤回时限默认为2分钟。
  * 是否增值服务：是

===== 功能介绍 =====

  - 用户可以在消息发出后的撤回时限内从客户端发起消息撤回操作；
  - 被撤回的消息将会从服务器的离线队列中删除，如果应用已开通消息漫游，则所有已登录客户端均撤回或不再接收此消息；
  - 消息撤回时限默认2分钟，可根据开发者需求以AppKey为单位进行单独设置。

<WRAP round tip>
**注意：**

消息撤回时限建议短于服务器保存消息的时间（默认7天，若开通[[im:valueaddedservice:messageroaming|消息漫游]]增值服务可延长至3个月或者6个月），如果消息撤回时限被设置成了超过服务端消息保存的时间，需要撤回的消息在请求撤回之前已经由于过期在服务端被删除，消息撤回请求会失败，无法从已经收到该消息的客户端撤回该消息。
</WRAP>
===== 使用方法 =====

==== Android ====

<code java>
EMClient.getInstance().chatManager().recallMessage(contextMenuMessage);
</code>

==== iOS ====

<code objc>
(void)recallMessage:(EMMessage *)aMessage
           completion:(void (^)(EMMessage *aMessage, EMError *aError))aCompletionBlock;
</code>


----
<WRAP group>
<WRAP half column>
上一页：[[im:valueaddedservice:messageroaming|消息漫游]]
</WRAP>

<WRAP half column>
下一章节：[[im:450errorcode:10restapierrorcode|错误码]]
</WRAP>
</WRAP>