登录服务

你需要登录才能真正连接上 RTM 服务器、访问 RTM 的网络资源，如发送消息、订阅频道等。在登录 RTM 服务之前，你需要确保你的设备处于网络连接的状态并完成了应用设置。

登录服务

执行登录操作时，客户端会尝试与 RTM 服务器建立长连接，一旦建立成功，客户端会按照固定的时间间隔向 RTM 服务器传递心跳信息以保持客户端的活跃状态，直到客户端主动退出登录或掉线超时才会中断连接。在此期间，用户可以在自己的权限和使用限制范围内自由地访问 RTM 的网络资源。

TypeScript

import { RtmError } from '@shengwang/rtm-full';

try {
  const response = await rtmClient.login("your_token");
  console.log("Login successful:", response);
} catch (error) {
  console.error("Login failed:", error);
  if (error instanceof RtmError) {
    console.error(`Login failed: ${error.reason} (code: ${error.errorCode})`);
  } else {
    console.error("Login failed");
  }
}

你可以通过 login 的返回值或监听 linkState 事件通知来判断登录是否成功以及登录失败的错误码和错误原因。执行登录操作时，客户端的网络连接状态为 CONNECTING；登录成功后，其状态会更新为 CONNECTED 状态。为持续监测客户端的网络连接状态，声网建议你在应用的整个生命周期内持续监听 linkState 事件通知，详见事件监听。

信息

用户成功登录 RTM 服务后，应用的 PCU 会增加，这将影响你的账单数据。

退出登录

当不再需要使用 RTM 服务时，你可以通过显式调用 logout 退出登录。退出登录意味着客户端与 RTM 服务器关闭长连接，你会自动退出或取消订阅所有频道（Stream Channel 及 Message Channel），频道中的其他用户也会收到你的离开频道的 presence 事件通知。

TypeScript

import { RtmError } from '@shengwang/rtm-full';

try {
  const response = await rtmClient.logout();
  console.log("Logout successful:", response);
} catch (error) {
  console.error("Logout failed:", error);
  if (error instanceof RtmError) {
    console.error(`logout: ${error.reason} (code: ${error.errorCode})`);
  } else {
    console.error("Logout failed");
  }
}

在离开应用时显示地执行退出登录的指令是一种良好的实践习惯。退出登录后，你就无法通过 API 访问 RTM 网络资源。

销毁 RTM 实例

如果你不再需要使用 RTM 服务，为避免内存泄漏、错误和异常（即空指针异常）引起的性能下降，声网建议你及时销毁 RtmClient 实例。

TypeScript

rtmClient.release();