public class StartWhiteboardPushRequest extends AbstractModel
skipSign
Constructor and Description |
---|
StartWhiteboardPushRequest() |
StartWhiteboardPushRequest(StartWhiteboardPushRequest source)
NOTE: Any ambiguous key set via .set("AnyKey", "value") will be a shallow copy,
and any explicit key, i.e Foo, set via .setFoo("value") will be a deep copy.
|
Modifier and Type | Method and Description |
---|---|
Boolean |
getAutoManageBackup()
Get Specifies whether to synchronize operations on the primary whiteboard push task to the backup task.
|
Boolean |
getAutoPublish()
Get Specifies whether to enable automatic relay whiteboard push when the relay push mode in TRTC is set to `SubscribeRelayUserIds`.
|
Boolean |
getAutoRecord()
Get Specifies whether to automatically record the whiteboard push when the recording mode in TRTC is set to `SubscribeStreamUserIds`.
|
Long |
getAutoStopTimeout()
Get Whiteboard push timeout.
|
WhiteboardPushBackupParam |
getBackup()
Get Parameters of the backup whiteboard push task.
|
String |
getExtraData()
Get Internal parameter.
|
AuthParam |
getIMAuthParam()
Get IM authentication parameters.
|
String |
getPrivateMapKey()
Get Advanced permission control parameter in TRTC.
|
String |
getPushUserId()
Get User ID used by the whiteboard push service for entering the whiteboard room.
|
String |
getPushUserSig()
Get User's IM signature corresponding to the PushUserId.
|
Long |
getRoomId()
Get Room ID of the whiteboard push task.
|
Long |
getSdkAppId()
Get SdkAppId of the whiteboard application.
|
AuthParam |
getTRTCAuthParam()
Get TRTC authentication parameters, used for room entrance authentication for TRTC push.
|
String |
getTRTCEnterRoomMode()
Get This parameter is available only to users in the allowlist for trial.
|
Long |
getTRTCRoomId()
Get TRTC room ID of the numeric type.
|
String |
getTRTCRoomIdStr()
Get TRTC room ID of the string type.
|
String |
getUserDefinedRecordId()
Get ID of the whiteboard push recording.
|
String |
getUserDefinedStreamId()
Get Stream ID used by TRTC for relay whiteboard push.
|
Long |
getVideoBitrate()
Get Whiteboard push bitrate.
|
Long |
getVideoFPS()
Get Frame rate of the whiteboard push video.
|
Whiteboard |
getWhiteboard()
Get Whiteboard parameters, such as the width, height, and background color of the whiteboard.
|
void |
setAutoManageBackup(Boolean AutoManageBackup)
Set Specifies whether to synchronize operations on the primary whiteboard push task to the backup task.
|
void |
setAutoPublish(Boolean AutoPublish)
Set Specifies whether to enable automatic relay whiteboard push when the relay push mode in TRTC is set to `SubscribeRelayUserIds`.
|
void |
setAutoRecord(Boolean AutoRecord)
Set Specifies whether to automatically record the whiteboard push when the recording mode in TRTC is set to `SubscribeStreamUserIds`.
|
void |
setAutoStopTimeout(Long AutoStopTimeout)
Set Whiteboard push timeout.
|
void |
setBackup(WhiteboardPushBackupParam Backup)
Set Parameters of the backup whiteboard push task.
|
void |
setExtraData(String ExtraData)
Set Internal parameter.
|
void |
setIMAuthParam(AuthParam IMAuthParam)
Set IM authentication parameters.
|
void |
setPrivateMapKey(String PrivateMapKey)
Set Advanced permission control parameter in TRTC.
|
void |
setPushUserId(String PushUserId)
Set User ID used by the whiteboard push service for entering the whiteboard room.
|
void |
setPushUserSig(String PushUserSig)
Set User's IM signature corresponding to the PushUserId.
|
void |
setRoomId(Long RoomId)
Set Room ID of the whiteboard push task.
|
void |
setSdkAppId(Long SdkAppId)
Set SdkAppId of the whiteboard application.
|
void |
setTRTCAuthParam(AuthParam TRTCAuthParam)
Set TRTC authentication parameters, used for room entrance authentication for TRTC push.
|
void |
setTRTCEnterRoomMode(String TRTCEnterRoomMode)
Set This parameter is available only to users in the allowlist for trial.
|
void |
setTRTCRoomId(Long TRTCRoomId)
Set TRTC room ID of the numeric type.
|
void |
setTRTCRoomIdStr(String TRTCRoomIdStr)
Set TRTC room ID of the string type.
|
void |
setUserDefinedRecordId(String UserDefinedRecordId)
Set ID of the whiteboard push recording.
|
void |
setUserDefinedStreamId(String UserDefinedStreamId)
Set Stream ID used by TRTC for relay whiteboard push.
|
void |
setVideoBitrate(Long VideoBitrate)
Set Whiteboard push bitrate.
|
void |
setVideoFPS(Long VideoFPS)
Set Frame rate of the whiteboard push video.
|
void |
setWhiteboard(Whiteboard Whiteboard)
Set Whiteboard parameters, such as the width, height, and background color of the whiteboard.
|
void |
toMap(HashMap<String,String> map,
String prefix)
Internal implementation, normal users should not use it.
|
any, fromJsonString, getBinaryParams, getMultipartRequestParams, getSkipSign, set, setParamArrayObj, setParamArraySimple, setParamObj, setParamSimple, setSkipSign, toJsonString
public StartWhiteboardPushRequest()
public StartWhiteboardPushRequest(StartWhiteboardPushRequest source)
public Long getSdkAppId()
public void setSdkAppId(Long SdkAppId)
SdkAppId
- SdkAppId of the whiteboard application.public Long getRoomId()
public void setRoomId(Long RoomId)
RoomId
- Room ID of the whiteboard push task. Valid range: (1,4294967295).
1. By default, the whiteboard push task uses the RoomId string as the GroupID of the IM group. For example, if the RoomId string is 1234, the GroupID of the IM group is also 1234. Message synchronization requires joining a group. Make sure that an IM group is created before the push starts. Otherwise, the push fails.
2. If neither TRTCRoomId nor TRTCRoomIdStr is specified, the value of RoomId is used as the Tencent Real-Time Communication (TRTC) room ID for the whiteboard push task.public String getPushUserId()
public void setPushUserId(String PushUserId)
PushUserId
- User ID used by the whiteboard push service for entering the whiteboard room. If `IMAuthParam`and `TRTCAuthParam` are not specified, this user ID is used for operations such as logging in to the IM application, joining an IM group, and entering the room for TRTC whiteboard push.
The ID cannot exceed 60 bytes in length and must be an unused ID. The whiteboard push service uses the user ID to enter the room for whiteboard audio/video push. If this ID is already used in another scenario, the other scenario and whiteboard push service will conflict, affecting the pushing operation.public String getPushUserSig()
public void setPushUserSig(String PushUserSig)
PushUserSig
- User's IM signature corresponding to the PushUserId.public Whiteboard getWhiteboard()
public void setWhiteboard(Whiteboard Whiteboard)
Whiteboard
- Whiteboard parameters, such as the width, height, and background color of the whiteboard.public Long getAutoStopTimeout()
public void setAutoStopTimeout(Long AutoStopTimeout)
AutoStopTimeout
- Whiteboard push timeout. Unit: seconds. Valid range: [300,259200]. Default value: 1800.
If no operation is performed on the whiteboard for the specified period of time, the whiteboard push service automatically stops whiteboard push.public Boolean getAutoManageBackup()
public void setAutoManageBackup(Boolean AutoManageBackup)
AutoManageBackup
- Specifies whether to synchronize operations on the primary whiteboard push task to the backup task.public WhiteboardPushBackupParam getBackup()
public void setBackup(WhiteboardPushBackupParam Backup)
Backup
- Parameters of the backup whiteboard push task.
After the backup parameters are specified, the whiteboard push service adds a relayed video stream. That is, there are two video streams on the whiteboard in the same room.public String getPrivateMapKey()
public void setPrivateMapKey(String PrivateMapKey)
PrivateMapKey
- Advanced permission control parameter in TRTC. If the advanced permission control feature is enabled in TRTC, this parameter is required.public Long getVideoFPS()
public void setVideoFPS(Long VideoFPS)
VideoFPS
- Frame rate of the whiteboard push video. Valid range: [0,30]. Default value: 20. Unit: fps.public Long getVideoBitrate()
public void setVideoBitrate(Long VideoBitrate)
VideoBitrate
- Whiteboard push bitrate. Valid range: [0,2000]. Default value: 1200. Unit: kbps.
The bitrate specified here is a reference value. During actual push, a dynamic bitrate is used. The actual bitrate does not remain the specified value but rather fluctuates around it.public Boolean getAutoRecord()
public void setAutoRecord(Boolean AutoRecord)
AutoRecord
- Specifies whether to automatically record the whiteboard push when the recording mode in TRTC is set to `SubscribeStreamUserIds`.
Default value: `false`. If you need to enable automatic whiteboard push recording, set this parameter to `true`.
If the recording mode in TRTC is set to `Global Auto Recording`, ignore this parameter.public String getUserDefinedRecordId()
public void setUserDefinedRecordId(String UserDefinedRecordId)
UserDefinedRecordId
- ID of the whiteboard push recording. The ID is filled in the `userdefinerecordid` parameter in the callback message after cloud recording is complete in TRTC, helping you identify the recording callback and locate the video file in VOD media resource management.
The value can be up to 64 bytes in length and contain letters (a-z and A-Z), digits (0-9), underscores (_), and hyphens (-).
After this parameter is set, automatic whiteboard push recording is enabled regardless of the value of the `AutoRecord` parameter.
Default RecordId generation rule:
urlencode(SdkAppID_RoomID_PushUserID)
Example:
SdkAppID = 12345678,RoomID = 12345,PushUserID = push_user_1
Therefore: RecordId = 12345678_12345_push_user_1public Boolean getAutoPublish()
public void setAutoPublish(Boolean AutoPublish)
AutoPublish
- Specifies whether to enable automatic relay whiteboard push when the relay push mode in TRTC is set to `SubscribeRelayUserIds`.
Default value: `false`. If you need to enable automatic relay whiteboard push, set this parameter to `true`.
If the recording mode in TRTC is set to `Global Auto Relay`, ignore this parameter.public String getUserDefinedStreamId()
public void setUserDefinedStreamId(String UserDefinedStreamId)
UserDefinedStreamId
- Stream ID used by TRTC for relay whiteboard push. With this ID, you can stream the user’s audio/video by using the domain name and standard streaming solution (FLV or HLS) in TRTC.
The value can be up to 64 bytes in length and contain letters (a-z and A-Z), digits (0-9), underscores (_), and hyphens (-).
After this parameter is set, automatic relay whiteboard push is enabled regardless of the value of the `AutoPublish` parameter.
Default StreamID generation rule:
urlencode(SdkAppID_RoomID_PushUserID_main)
Example:
SdkAppID = 12345678,RoomID = 12345,PushUserID = push_user_1
Therefore, StreamID = 12345678_12345_push_user_1_mainpublic String getExtraData()
public void setExtraData(String ExtraData)
ExtraData
- Internal parameter. You can ignore this parameter.public Long getTRTCRoomId()
public void setTRTCRoomId(Long TRTCRoomId)
TRTCRoomId
- TRTC room ID of the numeric type. Valid range: (1,4294967295).
If RoomId and TRTCRoomId are both specified, the value of TRTCRoomId takes priority as the room ID for TRTC whiteboard push.
If the TRTCRoomIdStr parameter is specified, this parameter is ignored.public String getTRTCRoomIdStr()
public void setTRTCRoomIdStr(String TRTCRoomIdStr)
TRTCRoomIdStr
- TRTC room ID of the string type.
If TRTCRoomIdStr is specified, its value takes priority as the room ID for TRTC whiteboard push.public AuthParam getIMAuthParam()
public void setIMAuthParam(AuthParam IMAuthParam)
IMAuthParam
- IM authentication parameters.
If the ID of the IM application used by whiteboard messages is different from SdkAppId of the whiteboard application, specify this parameter to provide authentication information of the IM application.
If this parameter is specified, the whiteboard push service preferably uses the SdkAppId value in this parameter as the transmission channel for whiteboard messages. If this parameter is left empty, the SdkAppId value in the common parameters is used.public AuthParam getTRTCAuthParam()
public void setTRTCAuthParam(AuthParam TRTCAuthParam)
TRTCAuthParam
- TRTC authentication parameters, used for room entrance authentication for TRTC push.
If the ID of the TRTC application to which the target TRTC room belongs is different from SdkAppId of the whiteboard application, specify this parameter to provide authentication information of the TRTC application.
If this parameter is specified, the whiteboard push service preferably uses the SdkAppId value in this parameter as the ID of the target TRTC application. If this parameter is left empty, the SdkAppId value in the common parameters is used.public String getTRTCEnterRoomMode()
public void setTRTCEnterRoomMode(String TRTCEnterRoomMode)
TRTCEnterRoomMode
- This parameter is available only to users in the allowlist for trial.
TRTC room entrance mode for whiteboard push. Default value: `TRTCAppSceneVideoCall`.
`TRTCAppSceneVideoCall`: This scenario is most suitable when there are two or more people on a video call. The internal encoders and network protocols are optimized for video smoothness to reduce call latency and lagging.
`TRTCAppSceneLIVE`: This scenario is most suitable when there is only one person speaking or performing for an online audience, and occasionally multiple people interact with one another through video. The internal encoders and network protocols are optimized for performance and compatibility to deliver better performance and video clarity.Copyright © 2023. All rights reserved.