Leave a Chatroom

Leaving a chatroom can occur under the following circumstances:

• Passive Exit: The chatroom has an automatic kick-out mechanism for offline members. When triggered, the RC server will remove the user from the chatroom. Users who are banned will also be kicked out.
• Active Exit: The client provides an API that allows users to actively leave the chatroom.

Automatic Exit Mechanism for Offline Chatroom Members

The chatroom has an automatic exit mechanism for offline members. If a user goes offline and meets the following default conditions, the RC server will automatically kick them out of the chatroom:

• If the 31st message is generated within 30 seconds after the user goes offline, the automatic kick-out is triggered.
• Or, if a new message is generated in the chatroom after the user has been offline for 30 seconds, the automatic kick-out is triggered.

tip

• The default conditions require that new messages must be generated in the chatroom; otherwise, the kick-out action cannot be triggered. If no messages are generated in the chatroom, abnormal users cannot be kicked out.
• If you need to modify the default behavior's dependency on new messages, please submit a ticket to enable the Real-Time Kick-Out for Abnormal Chatroom Members. Once this service is enabled, the server will determine the user's abnormal status based on SDK behavior (requires Android/iOS IMLib SDK version ≧ 5.1.6, Web IMLib version ≧ 5.3.2), and the abnormal user will be kicked out within 5 minutes.
• To protect specific users from being automatically kicked out (e.g., in certain scenarios where you may want users to remain in the chatroom), you can use the Chatroom User Allowlist feature provided by the Server API.

Active Exit from a Chatroom

Client users can actively leave a chatroom.

Example Call

[[RCIMClient sharedRCIMClient] quitChatRoom:@"chatroomId"
                                    success:^{

                                    } error:^(RCErrorCode status) {

                                    }];

Input Parameters

Parameter	Type	Description
targetId	NSString	The chatroom ID, with a maximum length of 64 characters.
successBlock	Block	Callback for successful exit from the chatroom
errorBlock	Block	Callback for failed exit from the chatroom

Return Parameters

errorBlock Description:

Callback Parameter	Callback Type	Description
status	RCErrorCode	Error code for failed exit from the chatroom