Skip to main content

Connection

After the application client successfully connects to the RC server, it can utilize the messaging functionality of the RC IM SDK.

Upon receiving a connection request from the client, the RC server will determine whether to allow the user to connect based on the user authentication token (Token parameter) carried in the connection request.

Prerequisites​

  • Register a user (to obtain a Token) via the server API. The RC client SDK does not provide a method to obtain a Token. The application can call its own server to retrieve the Token from the RC server.
    • After obtaining the Token, the client can save the Token as needed for subsequent connections. The specific storage location depends on the application client design. If the Token is not expired, there is no need to request a new Token from RC.
    • The Token validity period can be configured in the Console, and it is set to be permanently valid by default. Even if a new Token is regenerated, the old Token that has not expired remains valid. After the Token expires, a new Token needs to be obtained.
  • It is recommended that the application set up a connection status listener before connecting.
  • The SDK has been initialized.
tip

Do not directly call the server API to obtain a Token on the client side. Obtaining a Token requires providing the App Key and App Secret of the application. If these credentials are stored on the client side, once the application is decompiled, the App Key and App Secret may be leaked. Therefore, make sure to obtain the Token on the application server.

Connecting to the Chat Server​

Please decide the appropriate timing (login, registration, or other moments to avoid being unable to enter the application homepage) to initiate a connection request to the RC chat server based on the application's business requirements and design.

Please note the following points:

  • The connect() method must be called after the SDK is initialized. Otherwise, there may be no callback.
  • The SDK itself has a reconnection mechanism, so there is no need to call connect() multiple times within an application lifecycle.
  • Call it once during the application lifecycle.

Use the connect method to initiate a connection, passing in the user authentication token (Token).

RongIMLib.connect('<Your-token>').then((res) => {
  if (res.code === 0) {
    console.log(res.data.userId)
  }
})
Last updated on