An audience group is a virtual collection used in social platforms and live interactive services to facilitate communication and interaction among multiple users. In live streaming scenarios, audience groups enhance the interaction among viewers and between viewers and the streamer.
Usage notes
Before you can manage audience groups, you must create an interactive message application. For more information, see Create an application.
You can create up to 5,000 interactive message audience groups per interactive message application. Deleted groups do not count toward this quota.
After an audience group is deleted, it remains in the list for about 30 days before it is permanently removed.
Create an audience group
Log on to the ApsaraVideo Live console.
In the navigation pane on the left, choose .
Select a Live Center and an application under Applications, and then click Create Group.
In the Create Interactive Messaging Group dialog box, configure the parameters.
Parameter
Description
Group ID
The ID of the audience group. The ID must be unique and can contain uppercase letters, lowercase letters, and digits. The ID can be up to 64 bytes in length.
Group Name
The name of the audience group. The name can be up to 128 bytes in length.
Owner
The ID of the group creator. The ID can contain uppercase letters, lowercase letters, and digits. The ID can be up to 64 bytes in length.
Administrator
The user IDs of administrators. The IDs can contain uppercase letters, lowercase letters, and digits. The IDs can be up to 64 bytes in length. Separate multiple IDs with commas (,). You can specify up to three administrators.
Group Additional Information
The extension information for the audience group. The information can be up to 32 KB in size.
Click OK.
What to do next
Modify group configurations
On the Groups page, find the group you want to modify and click View Details.
In the Group Information panel that appears, modify the parameters.
Send messages
On the Groups page, find the desired group and click Send Message.
In the Send Message dialog box that appears, configure the parameters and click OK.
NoteThe destination group must be active to receive messages, which means at least one user has joined the group. If a message fails to send, first confirm that there are users in the group.
Parameter
Description
Sender ID
The ID of the sender. The ID can contain uppercase letters, lowercase letters, and digits. The ID can be up to 64 bytes in length.
Sender Additional Information
The extension information for the user sending the message. The information can be up to 512 bytes in length.
Message Type
The message type must be a number.
Message Content
The message body. The content can be up to 15 KB in size.
Delete an audience group
On the Groups page, find the group you want to delete and click Delete Group.
In the dialog box that appears, click OK. This operation is irreversible. Proceed with caution.
NoteWhen an audience group is deleted, it becomes unavailable, and all users in the group are notified that the group has ended.
The messages of a deleted audience group can be queried for seven days after deletion.
A deleted audience group remains in the list for about 30 days before it is permanently removed from the list.
Recover an audience group
On the Groups page, find a deleted group and click Restore Group.
In the dialog box that appears, click OK.
NoteA deleted audience group is retained in the list for 30 days. During this period, you can recover the group. If the group is not recovered within 30 days, it is permanently deleted.
After an audience group is recovered, you can still query the messages that were stored before its deletion.
More information
Message priority
In scenarios such as live channels, users may send messages frequently. This can lead to a high volume of concurrent group messages. When mobile originated messages reach the frequency control threshold, the backend discards some messages to ensure system stability. In practice, when messages arrive too frequently on the client, their readability decreases significantly. Therefore, frequency control is applied to group messages.
Group messages are divided into three priority levels. If the number of messages in a group exceeds the frequency limit, the backend prioritizes the delivery of high-priority messages. Therefore, you should select an appropriate priority level based on the importance of the message. The three priority levels, from highest to lowest, are as follows:
Priority | Recommended message types for this priority |
HIGH | Important messages, such as red packets and gifts. |
MEDIUM | Normal text messages, such as live comments. |
NORMAL | Like messages. |
Tiered message rate limiting
When the number of messages sent per second by all users in a single group exceeds a certain limit (default: 50 messages per second), the backend discards some messages and prioritizes the delivery of higher-priority messages. However, for each message type, the system ensures that the latest message of that type is delivered within a 5-second interval. This prevents low-priority messages from being completely discarded due to tiered rate limiting.
Messages restricted by frequency control are not delivered, cached, or stored. However, a success response is returned to the sender.
High-priority messages
When a message priority is set to HIGH, it is prioritized for delivery during rate limiting and also has high reliability. This means that if a user goes offline due to network issues and misses group messages, the SDK automatically pulls the missed high-priority messages after the user reconnects using the SDK's reconnection and recovery mechanism.
Supergroups
For supergroups (groups with more than 2,000 members), you cannot query the member list. Notifications about members joining or leaving the group are sent at intervals of at least 5 seconds. These notifications do not show the full list of users who joined or left, but they do show an accurate member count. When a group is upgraded to a supergroup, its member list is immediately cleared. A supergroup cannot be reverted to a normal group until all members leave, at which point the group is shut down. It reverts to a normal group only when it is reopened.