Usage Restrictions

2025-07-31

This article introduces the usage restrictions of the ZEGO Express SDK Room service, including frequency limits, string sizes, etc.

Room

The ZEGO Room service supports up to one million users online simultaneously in a single Room. The default total login QPS for all users in each Room is 200, which means a maximum of 200 users can log in to the same Room per second.

Notes

If you need to increase the limit, please contact ZEGOCLOUD Technical Support for evaluation.

Room Real-time Messages

SDK Interface	Size Limit	Sending Frequency Limit (within a single Room in the SDK)	Description
Send broadcast message sendBroadcastMessage	The default message length limit is 1 KB. Notes If you need to send messages larger than 1 KB, please contact ZEGOCLOUD Technical Support for configuration.	10 times/s	Messages are reliable. The maximum QPS for a single user calling this interface on the client is 2 (the interval between two calls cannot be less than 500 milliseconds). Send broadcast messages to all users in the same Room, and all users in the Room can receive the messages.
Send barrage message sendBarrageMessage	The default message length limit is 1 KB. Notes If you need to send messages larger than 1 KB, please contact ZEGOCLOUD Technical Support for configuration.	20 times/s	Messages are not guaranteed to be reliable.
Send custom signaling message sendCustomCommand	The message length cannot exceed 1 KB.	When sending to a single user: 200 messages/s When sending to multiple users: 10 messages/s	Messages are reliable. Send custom messages to all users in the same Room, and all users in the Room can receive the messages.

Notes

Message reliability here refers to whether the peer user can successfully receive the message when the network connection is normal.

Room Extra Info

SDK Interface	Size Limit	Sending Frequency Limit (within a single Room in the SDK)	Description
Set Room extra info setRoomExtraInfo	key: The key value of the Room extra message, cannot exceed 10 B, and cannot be an empty string. Only one key type is allowed in a Room. value: The content of the Room extra info, cannot exceed 128 B, and can be an empty string.	10 times/s	When a single user calls this interface multiple times on the client, please ensure that the callback notification of the previous interface call has been successfully received before calling again.