提交工单
咨询集成、功能及报价等问题
Adds a specified stream to a room.
On the client side, the ZEGO Express SDK will trigger the following callback to notify the client of the event:
Platform | ZEGO Express SDK callback |
---|---|
iOS/macOS | onRoomStreamUpdate |
Android | onRoomStreamUpdate |
Windows | onRoomStreamUpdate |
Web | roomStreamUpdate |
Listed below are the parameters specific to this request and part of the public request parameters. For the complete list of public request parameters, see Server APIs public request parameters.
Parameter | Type | Required | Description |
---|---|---|---|
RoomId |
String |
Yes |
Room ID. |
UserId |
String |
Yes |
User ID of the user who performs this operation. |
UserName |
String |
No |
User name of the user who performs this operation. |
StreamId |
String |
Yes |
Stream ID of the stream to be added. |
StreamTitle |
String |
No |
Stream title, with a maximum length of 127 bytes. |
ExtraInfo |
String |
No |
Extra stream information, with a maximum length of 1024 bytes. |
https://rtc-api.zego.im/?Action=AddStream
&RoomId=123
&UserId=2323
&UserName=df
&StreamId=852
&StreamTitle=%E6%B5%81%E6%A0%87%E9%A2%98&ExtraInfo=%E9%99%84%E5%8A%A0%E4%BF%A1%E6%81%AF
&<Public Request Parameters>
Parameter | Type | Description |
---|---|---|
Code |
Number |
Return code. |
Message |
String |
Description of the request execution result. |
RequestId |
String |
Request ID. |
{
"Code":0,
"Message":"success",
"RequestId":"4443515903608307334"
}
Listed below are the return codes related to this API. For the complete list of return codes, see Return codes.
Return code | Possible cause and solution |
---|---|
104 | The room does not exist. (the detection logic is the same as the return codes 5024 and 50001.) Please check the RoomId. |
206 | The rate limit (requests per second) has exceeded the limit. Please adjust the frequency of your requests or contact ZEGOCLOUD technical support. |
5018 | Room status does not match. Please try again later. |
5024 | The room does not exist. (the detection logic is the same as the return codes 104 and 5001.) Please check the RoomId. |
50001 | The room does not exist. (the detection logic is the same as the return codes 104 and 5024.)
|
50002 | User does not exist. Please check the UserId. |
50003 | Failed to query the user's online info. Please check whether the user is online based on the UserId. |
50004 | Failed to read the user info. Please check whether the user is online based on the UserId. |
50009 | Moderation failed. Please try again later or contact ZEGOCLOUD technical support. |
50011 | The number of recipients of the custom message has exceeded the limit. |
50012 | The length of the custom message has exceeded the limit. |
50013 | Failed to send custom messages. Please contact ZEGOCLOUD technical support. |