• UIKit
  • SDK
  • 서버 API
Chat/
SDK/
React Native/
SDK
  • Run Demo
  • SDK 통합
  • 초기화
  • 로그인 및 로그아웃
  • 메시지
    • 메시지 개요
    • 메시지 보내기
    • 메시지 받기
    • 과거 메시지
    • 메시지 전달
    • 메시지 수정
    • 메시지 삽입
    • 메시지 삭제
    • 메시지 비우기
    • 메시지 철회
    • 온라인 메시지
    • 읽음 확인
    • 메시지 조회
    • 그룹 @ 메시지
    • 지향적 그룹 메시지
    • 알림 음소거
    • 메시지 확장
  • 그룹
    • 개요
    • 그룹 관리
    • 그룹 정보
    • 그룹 멤버 관리
    • 그룹 멤버 정보
    • 그룹 속성 사용자 정의
    • 커뮤니티 관리
  • 사용자
    • 사용자 정보
    • 친구 관리
    • 친구 목록
    • 블록리스트
  • 오프라인 푸시
    • 오프라인 푸시
  • 국부 검색
    • 메시지 검색
    • 친구 검색
    • 그룹 검색
    • 그룹 멤버 검색
  • 시그널링
    • 시그널링 관리
  • Changelog
  • Guideline for Beginners
  • 콘솔 안내
    • 애플리케이션 생성 및 업그레이드
    • 기본 구성
    • 기능 구성
    • 계정 관리
    • 그룹 관리
    • 콜백 구성
  • 제품 소개
    • 메시지 관리
      • 1대1 메시지
      • 메시지 저장
      • 오프라인 푸시
      • 그룹 메시지
      • 메시지 포맷
    • 계정 시스템
      • 로그인 인증
      • 온라인 상태 관리
    • 그룹 관련
      • 그룹 시스템
      • 그룹 관리
    • 사용자 정보 및 관계망
      • 정보 관리
      • 관계망 관리
  • 구매 가이드
    • 과금 개요
    • 가격
  • 에러코드
이 페이지는 현재 영어로만 제공되며 한국어 버전은 곧 제공될 예정입니다. 기다려 주셔서 감사드립니다.

로그인 및 로그아웃

Feature Description

After initializing the IM SDK, you need to call the SDK login API to authenticate your account to get the permissions to use message, conversation, and other features.
Caution:
Only the conversation acquisition API can be called immediately after you call the login API, and other APIs can be called only after you have successfully logged in to the SDK. Therefore, make sure that you have logged in successfully before using other features; otherwise, such features may become abnormal or unavailable.

Login

You don't need to sign up on your first login, as you will automatically sign up if the login is successful. Call the login API (Details) to login in.
Key parameters of the login API are as follows:
Parameter
Description
Remarks
UserID
Unique user ID
It can contain up to 32 bytes of letters (a–z and A-Z), digits (0–9), underscores (_), and hyphens (-).
UserSig
Login ticket
It is calculated by your business server to ensure security. For more information, see Generating UserSig.
You can call the login API in the following scenarios:
You use the features of the IM SDK for the first time after your application is started.
Your ticket expires on login: The callback of the login API returns the ERR_USER_SIG_EXPIRED (6206) or ERR_SVR_ACCOUNT_USERSIG_EXPIRED (70001) error code. In this case, you need to generate a new userSig to log in again.
Your ticket expires when the user is online: You may receive the onUserSigExpired callback (Details) when users are online. In this case, you need to generate a new userSig to log in again.
A user is kicked offline: When a user is kicked offline, the IM SDK will notify you through the onKickedOffline callback (Details). In this case, you can prompt the user and call login to log in again.
You don't need to call the login API in the following scenarios:
After the user's network is disconnected and then reconnected, you don't need to call the login function, as the IM SDK will automatically go online.
When a login process is already running. In this case, repeated login is unnecessary.
Note:
After you call the IM SDK API and log in successfully, DAU calculation will start; therefore, call the login API as needed to avoid a high DAU.
You cannot log in to multiple IM SDK accounts of the same application at the same time; otherwise, only the last logged in account will be online.
Below is the sample code:
import { TencentImSDKPlugin } from "react-native-tim-js";

const userID = "your user id";
const userSig = "userSig from your server";
const res = await TencentImSDKPlugin.v2TIMManager.login(userID, userSig);
if (res.code == 0) {
// Logic for successful login
} else {
// Logic for failed login
}

Getting the UserID

After logging in successfully, call getLoginUser (Details) to get the UserID. If the login fails, the UserID will be empty.
Below is the sample code:
import { TencentImSDKPlugin } from "react-native-tim-js";

// Get the `UserID` of the logged-in user
const getLoginUserRes = await TencentImSDKPlugin.v2TIMManager.getLoginUser();
if (getLoginUserRes.code == 0) {
userID = getLoginUserRes.data;
}

Getting the login status

Call getLoginStatus (Details) to get the login status. If a user is logged in or logging in, don't call the login API frequently. The IM SDK supports the following login statuses:
Login Status
Description
V2TIM_STATUS_LOGINED (0)
Logged in
V2TIM_STATUS_LOGINING (1)
Logging in
V2TIM_STATUS_LOGOUT (2)
Not logged in
Below is the sample code:
import { TencentImSDKPlugin } from "react-native-tim-js";

const getLoginStatusRes =
await TencentImSDKPlugin.v2TIMManager.getLoginStatus();
if (getLoginStatusRes.code == 0) {
const status = getLoginStatusRes.data;
if (status == 0) {
// Logged in
} else if (status == 1) {
// Logging in
} else if (status == 2) {
// Not logged in
}
}

Multi-Client Login and Mutual Kickout

You can configure multi-client login policies for the IM SDK in the Tencent Cloud console. There are multiple multi-client login policies, such as A user can be concurrently online on a mobile or desktop platform and the web platform or A user can be concurrently online on all platforms. For more information on the configuration, see Feature Configuration.
You can configure the Max Login Instances per User per Platform for the IM SDK in the Tencent Cloud console, that is, the maximum number of instances on the same platform that can be concurrently online. This feature is available only for the Ultimate edition. A user can be concurrently online on up to ten clients on the web platform or on up to three clients on the Android, iPhone, iPad, Windows, or macOS platform (the maximum number of clients that can be concurrently online on Flutter is subject to the actual compilation result). For more information on the configuration, see Feature Configuration.
When you call the login API (Details) to log in, if the limit specified by the multi-client login policy for your account is exceeded, a newly logged in instance will kick out an earlier one. The one kicked out will receive onKickedOffline(Details).

Logout

Generally, if your application's lifecycle is the same as the IM SDK's lifecycle, there is no need to log out before exiting the application. In special cases, for example, if you use the IM SDK only after entering a specific UI and no longer use it after exiting the UI, you can call the logout API (Details) to log out of the SDK, after which you will no longer receive new messages. Note that in this case, you also need to call unInitSDK (Details) after the logout to uninitialize the SDK.
Below is the sample code:
import { TencentImSDKPlugin } from "react-native-tim-js";

const logoutRes = await TencentImSDKPlugin.v2TIMManager.logout();
if (logoutRes.code == 0) {
}

Account Switch

Call login (Details) to switch between accounts in the application.
For example, to switch the logged-in user from alice to bob, just log bob in. You don't need to explicitly call logout alice, as this operation will be handled automatically inside the IM SDK.