====== 在多个设备上登录 ======

更新时间：2022-08-10

环信即时通讯 IM 支持同一个用户 ID 在多个平台或者多个设备上登录；

客户端支持查询当前账号的已登录设备列表，可强制该账号从其他已登录设备下线；

环信即时通讯 IM React Native SDK 支持在同一账号所有已登录设备上同步在线和离线消息以及对应的回执和已读状态、接收离线推送通知、同步好友、群组以及聊天室相关的操作。

默认最多支持 4 个设备同时在线，具体见 [[https://www.easemob.com/pricing/im|环信即时通讯 IM 价格]]。如需增加支持的设备数量，可以联系环信即时通讯 IM 的商务经理。

===== 技术原理 =====

用户在 React Native 端上初始化 SDK 时会生成设备识别 ID，用于多设备登录和推送。服务器会将新消息发送到已登录的设备。环信即时通讯 IM React Native SDK 提供如下方法实现多个设备上的互动功能。

  * 获取其他登录设备的 ID
  * 给其他设备发送消息
  * 多端同步通知

===== 前提条件 =====

开始前，请确保满足以下条件：

  * 完成 SDK 初始化，并连接到服务器，详见 [[ccim:rn:quickstart|快速开始]] 及 [[ccim:rn:overview|SDK 集成概述]]。
  * 了解环信即时通讯 IM 的使用限制，详见 [[https://docs-im.easemob.com/ccim/limitation|使用限制]]。
  * 了解环信即时通讯 IM 的套餐包，详见 [[https://www.easemob.com/pricing/im|环信即时通讯 IM 价格]]。

===== 实现方法 =====

==== 获取其他登录设备的 ID ====

你可以调用 ''%%getSelfIdsOnOtherPlatform%%'' 方法获取其他登录设备的 ID。你在当前设备上发送消息时，其他设备通过这些 ID 接收消息，实现不同设备之间的消息传输。

<code typescript>
ChatClient.getInstance()
  .contactManager.getSelfIdsOnOtherPlatform()
  .then((ids) => {
    console.log("get ids success.", ids);
  })
  .catch((reason) => {
    console.log("get ids fail.", reason);
  });
</code>

==== 给其他设备发送消息 ====

举例：发送文本消息给其他端。

<code typescript>
// content: 设置文本内容
// targetId: 来自 `getSelfIdsOnOtherPlatform` 方法的异步结果
// chatType: 个人类型
const msg = ChatMessage.createTextMessage(targetId, content, chatType);
// 执行消息发送
ChatClient.getInstance()
  .chatManager.sendMessage(msg！, new ChatMessageCallback())
  .then(() => {
    // 消息发送动作完成，会在这里打印日志。
    // 消息的发送结果通过回调返回
    console.log("send message operation success.");
  })
  .catch((reason) => {
    // 消息发送动作失败，会在这里打印日志。
    console.log("send message operation fail.", reason);
  });
</code>

==== 多端同步通知 ====

账号 A 同时在设备 A 和设备 B 上登录，账号 A 在设备 A 上进行一些操作，设备 B 上会收到这些操作对应的通知。

你需要先实现 ''%%ChatMultiDeviceEventListener%%'' 监听其他设备上的操作，再设置多设备监听器。

<code typescript>
let customListener: ChatCustomEventListener = new (class
  implements ChatCustomEventListener
{
  onDataReceived(params: any): void {
    // 可能是好友事件、群组事件、子区事件等。
  }
})();

// 清空监听器
ChatClient.getInstance().removeAllCustomListener();

// 添加监听器
ChatClient.getInstance().addCustomListener(customListener);
</code>