public class StartWhiteboardPushRequest extends AbstractModel
header, 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 对主白板推流任务进行操作时,是否同时同步操作备份任务 | 
| Boolean | getAutoPublish()Get 在实时音视频旁路推流模式选择为`指定用户旁路`模式的时候,是否自动旁路白板推流。
默认在实时音视频的旁路推流模式选择为 `指定用户旁路` 模式的情况下,不会自动旁路白板推流,如果希望旁路白板推流,请将此参数设置为true。
如果实时音视频的旁路推流模式选择为 `全局自动旁路` 模式,可忽略此参数。 | 
| Boolean | getAutoRecord()Get 在实时音视频云端录制模式选择为 `指定用户录制` 模式的时候是否自动录制白板推流。
默认在实时音视频的云端录制模式选择为 `指定用户录制` 模式的情况下,不会自动进行白板推流录制,如果希望进行白板推流录制,请将此参数设置为true。
如果实时音视频的云端录制模式选择为 `全局自动录制` 模式,可忽略此参数。 | 
| Long | getAutoStopTimeout()Get 自动停止推流超时时间,单位秒,取值范围[300, 259200], 默认值为1800秒。
当白板超过设定时间没有操作的时候,白板推流服务会自动停止白板推流。 | 
| WhiteboardPushBackupParam | getBackup()Get 备份白板推流相关参数。
指定了备份参数的情况下,白板推流服务会在房间内新增一路白板画面视频流,即同一个房间内会有两路白板画面推流。 | 
| String | getExtraData()Get 内部参数,不需要关注此参数 | 
| String | getGroupId()Get 白板进行信令同步的 IM 群组 ID。
在没有指定`GroupId`的情况下,白板推流服务将使用 `RoomId` 的字符串形式作为同步白板信令的IM群组ID。
在指定了`GroupId`的情况下,白板推流将优先`GroupId`作为同步白板信令的群组ID。请在开始推流前确保指定的IM群组已创建完成,否则会导致推流失败。 | 
| AuthParam | getIMAuthParam()Get IM鉴权信息参数,用于IM鉴权。
当白板信令所使用的IM应用与白板应用的SdkAppId不一致时,可以通过此参数提供对应IM应用鉴权信息。
如果提供了此参数,白板推流服务会优先使用此参数指定的SdkAppId作为白板信令的传输通道,否则使用公共参数中的SdkAppId作为白板信令的传输通道。 | 
| String | getPrivateMapKey()Get TRTC高级权限控制参数,如果在实时音视频开启了高级权限控制功能,必须提供PrivateMapKey才能保证正常推流。 | 
| String | getPushUserId()Get 用于白板推流服务进入白板房间的用户ID。在没有额外指定`IMAuthParam`和`TRTCAuthParam`的情况下,这个用户ID同时会用于IM登录、IM加群、TRTC进房推流等操作。
用户ID最大长度不能大于60个字节,该用户ID必须是一个单独的未同时在其他地方使用的用户ID,白板推流服务使用这个用户ID进入房间进行白板音视频推流,若该用户ID和其他地方同时在使用的用户ID重复,会导致白板推流服务与其他使用场景账号互踢,影响正常推流。 | 
| String | getPushUserSig()Get 与`PushUserId`对应的IM签名(usersig)。 | 
| Long | getRoomId()Get 需要推流的白板房间号,取值范围: (1, 4294967295)。
1. | 
| Long | getSdkAppId()Get 客户的SdkAppId | 
| AuthParam | getTRTCAuthParam()Get TRTC鉴权信息参数,用于TRTC进房推流鉴权。
当需要推流到的TRTC房间所对应的TRTC应用与白板应用的SdkAppId不一致时,可以通过此参数提供对应的TRTC应用鉴权信息。
如果提供了此参数,白板推流服务会优先使用此参数指定的SdkAppId作为白板推流的目标TRTC应用,否则使用公共参数中的SdkAppId作为白板推流的目标TRTC应用。 | 
| String | getTRTCEnterRoomMode()Get 指定白板推流时推流用户进TRTC房间的进房模式。默认为 TRTCAppSceneVideoCall
TRTCAppSceneVideoCall - 视频通话场景,即绝大多数时间都是两人或两人以上视频通话的场景,内部编码器和网络协议优化侧重流畅性,降低通话延迟和卡顿率。
TRTCAppSceneLIVE - 直播场景,即绝大多数时间都是一人直播,偶尔有多人视频互动的场景,内部编码器和网络协议优化侧重性能和兼容性,性能和清晰度表现更佳。 | 
| Long | getTRTCRoomId()Get TRTC数字类型房间号,取值范围: (1, 4294967295)。
在同时指定了`RoomId`与`TRTCRoomId`的情况下,优先使用`TRTCRoomId`作为白板流进行推流的TRTC房间号。
当指定了`TRTCRoomIdStr`的情况下,此字段将被忽略。 | 
| String | getTRTCRoomIdStr()Get TRTC字符串类型房间号。
在指定了`TRTCRoomIdStr`的情况下,会优先使用`TRTCRoomIdStr`作为白板流进行推流的TRTC房间号。 | 
| String | getUserDefinedRecordId()Get 指定白板推流这路流在音视频云端录制中的RecordID,指定的RecordID会用于填充实时音视频云端录制完成后的回调消息中的 "userdefinerecordid" 字段内容,便于您更方便的识别录制回调,以及在点播媒体资源管理中查找相应的录制视频文件。
限制长度为64字节,只允许包含大小写英文字母(a-zA-Z)、数字(0-9)及下划线和连词符。
此字段设置后,不管`AutoRecord`字段取值如何,都将自动进行白板推流录制。
默认RecordId生成规则如下:
urlencode(SdkAppID_RoomID_PushUserID)
例如:
SdkAppID = 12345678,RoomID = 12345,PushUserID = push_user_1
那么:RecordId = 12345678_12345_push_user_1 | 
| String | getUserDefinedStreamId()Get 指定实时音视频在旁路白板推流这路流时的StreamID,设置之后,您就可以在腾讯云直播 CDN 上通过标准直播方案(FLV或HLS)播放该用户的音视频流。
限制长度为64字节,只允许包含大小写英文字母(a-zA-Z)、数字(0-9)及下划线和连词符。
此字段设置后,不管`AutoPublish`字段取值如何,都将自动旁路白板推流。
默认StreamID生成规则如下:
urlencode(SdkAppID_RoomID_PushUserID_main)
例如:
SdkAppID = 12345678,RoomID = 12345,PushUserID = push_user_1
那么:StreamID = 12345678_12345_push_user_1_main | 
| Long | getVideoBitrate()Get 白板推流码率, 取值范围[0, 2000],默认1200kbps。
这里的码率设置是一个参考值,实际推流的时候使用的是动态码率,所以真实码率不会固定为指定值,会在指定值附近波动。 | 
| Long | getVideoFPS()Get 白板推流视频帧率,取值范围[0, 30],默认20fps | 
| Whiteboard | getWhiteboard()Get 白板参数,例如白板宽高、背景颜色等 | 
| void | setAutoManageBackup(Boolean AutoManageBackup)Set 对主白板推流任务进行操作时,是否同时同步操作备份任务 | 
| void | setAutoPublish(Boolean AutoPublish)Set 在实时音视频旁路推流模式选择为`指定用户旁路`模式的时候,是否自动旁路白板推流。
默认在实时音视频的旁路推流模式选择为 `指定用户旁路` 模式的情况下,不会自动旁路白板推流,如果希望旁路白板推流,请将此参数设置为true。
如果实时音视频的旁路推流模式选择为 `全局自动旁路` 模式,可忽略此参数。 | 
| void | setAutoRecord(Boolean AutoRecord)Set 在实时音视频云端录制模式选择为 `指定用户录制` 模式的时候是否自动录制白板推流。
默认在实时音视频的云端录制模式选择为 `指定用户录制` 模式的情况下,不会自动进行白板推流录制,如果希望进行白板推流录制,请将此参数设置为true。
如果实时音视频的云端录制模式选择为 `全局自动录制` 模式,可忽略此参数。 | 
| void | setAutoStopTimeout(Long AutoStopTimeout)Set 自动停止推流超时时间,单位秒,取值范围[300, 259200], 默认值为1800秒。
当白板超过设定时间没有操作的时候,白板推流服务会自动停止白板推流。 | 
| void | setBackup(WhiteboardPushBackupParam Backup)Set 备份白板推流相关参数。
指定了备份参数的情况下,白板推流服务会在房间内新增一路白板画面视频流,即同一个房间内会有两路白板画面推流。 | 
| void | setExtraData(String ExtraData)Set 内部参数,不需要关注此参数 | 
| void | setGroupId(String GroupId)Set 白板进行信令同步的 IM 群组 ID。
在没有指定`GroupId`的情况下,白板推流服务将使用 `RoomId` 的字符串形式作为同步白板信令的IM群组ID。
在指定了`GroupId`的情况下,白板推流将优先`GroupId`作为同步白板信令的群组ID。请在开始推流前确保指定的IM群组已创建完成,否则会导致推流失败。 | 
| void | setIMAuthParam(AuthParam IMAuthParam)Set IM鉴权信息参数,用于IM鉴权。
当白板信令所使用的IM应用与白板应用的SdkAppId不一致时,可以通过此参数提供对应IM应用鉴权信息。
如果提供了此参数,白板推流服务会优先使用此参数指定的SdkAppId作为白板信令的传输通道,否则使用公共参数中的SdkAppId作为白板信令的传输通道。 | 
| void | setPrivateMapKey(String PrivateMapKey)Set TRTC高级权限控制参数,如果在实时音视频开启了高级权限控制功能,必须提供PrivateMapKey才能保证正常推流。 | 
| void | setPushUserId(String PushUserId)Set 用于白板推流服务进入白板房间的用户ID。在没有额外指定`IMAuthParam`和`TRTCAuthParam`的情况下,这个用户ID同时会用于IM登录、IM加群、TRTC进房推流等操作。
用户ID最大长度不能大于60个字节,该用户ID必须是一个单独的未同时在其他地方使用的用户ID,白板推流服务使用这个用户ID进入房间进行白板音视频推流,若该用户ID和其他地方同时在使用的用户ID重复,会导致白板推流服务与其他使用场景账号互踢,影响正常推流。 | 
| void | setPushUserSig(String PushUserSig)Set 与`PushUserId`对应的IM签名(usersig)。 | 
| void | setRoomId(Long RoomId)Set 需要推流的白板房间号,取值范围: (1, 4294967295)。
1. | 
| void | setSdkAppId(Long SdkAppId)Set 客户的SdkAppId | 
| void | setTRTCAuthParam(AuthParam TRTCAuthParam)Set TRTC鉴权信息参数,用于TRTC进房推流鉴权。
当需要推流到的TRTC房间所对应的TRTC应用与白板应用的SdkAppId不一致时,可以通过此参数提供对应的TRTC应用鉴权信息。
如果提供了此参数,白板推流服务会优先使用此参数指定的SdkAppId作为白板推流的目标TRTC应用,否则使用公共参数中的SdkAppId作为白板推流的目标TRTC应用。 | 
| void | setTRTCEnterRoomMode(String TRTCEnterRoomMode)Set 指定白板推流时推流用户进TRTC房间的进房模式。默认为 TRTCAppSceneVideoCall
TRTCAppSceneVideoCall - 视频通话场景,即绝大多数时间都是两人或两人以上视频通话的场景,内部编码器和网络协议优化侧重流畅性,降低通话延迟和卡顿率。
TRTCAppSceneLIVE - 直播场景,即绝大多数时间都是一人直播,偶尔有多人视频互动的场景,内部编码器和网络协议优化侧重性能和兼容性,性能和清晰度表现更佳。 | 
| void | setTRTCRoomId(Long TRTCRoomId)Set TRTC数字类型房间号,取值范围: (1, 4294967295)。
在同时指定了`RoomId`与`TRTCRoomId`的情况下,优先使用`TRTCRoomId`作为白板流进行推流的TRTC房间号。
当指定了`TRTCRoomIdStr`的情况下,此字段将被忽略。 | 
| void | setTRTCRoomIdStr(String TRTCRoomIdStr)Set TRTC字符串类型房间号。
在指定了`TRTCRoomIdStr`的情况下,会优先使用`TRTCRoomIdStr`作为白板流进行推流的TRTC房间号。 | 
| void | setUserDefinedRecordId(String UserDefinedRecordId)Set 指定白板推流这路流在音视频云端录制中的RecordID,指定的RecordID会用于填充实时音视频云端录制完成后的回调消息中的 "userdefinerecordid" 字段内容,便于您更方便的识别录制回调,以及在点播媒体资源管理中查找相应的录制视频文件。
限制长度为64字节,只允许包含大小写英文字母(a-zA-Z)、数字(0-9)及下划线和连词符。
此字段设置后,不管`AutoRecord`字段取值如何,都将自动进行白板推流录制。
默认RecordId生成规则如下:
urlencode(SdkAppID_RoomID_PushUserID)
例如:
SdkAppID = 12345678,RoomID = 12345,PushUserID = push_user_1
那么:RecordId = 12345678_12345_push_user_1 | 
| void | setUserDefinedStreamId(String UserDefinedStreamId)Set 指定实时音视频在旁路白板推流这路流时的StreamID,设置之后,您就可以在腾讯云直播 CDN 上通过标准直播方案(FLV或HLS)播放该用户的音视频流。
限制长度为64字节,只允许包含大小写英文字母(a-zA-Z)、数字(0-9)及下划线和连词符。
此字段设置后,不管`AutoPublish`字段取值如何,都将自动旁路白板推流。
默认StreamID生成规则如下:
urlencode(SdkAppID_RoomID_PushUserID_main)
例如:
SdkAppID = 12345678,RoomID = 12345,PushUserID = push_user_1
那么:StreamID = 12345678_12345_push_user_1_main | 
| void | setVideoBitrate(Long VideoBitrate)Set 白板推流码率, 取值范围[0, 2000],默认1200kbps。
这里的码率设置是一个参考值,实际推流的时候使用的是动态码率,所以真实码率不会固定为指定值,会在指定值附近波动。 | 
| void | setVideoFPS(Long VideoFPS)Set 白板推流视频帧率,取值范围[0, 30],默认20fps | 
| void | setWhiteboard(Whiteboard Whiteboard)Set 白板参数,例如白板宽高、背景颜色等 | 
| void | toMap(HashMap<String,String> map,
     String prefix)Internal implementation, normal users should not use it. | 
any, fromJsonString, getBinaryParams, GetHeader, getMultipartRequestParams, getSkipSign, isStream, set, SetHeader, setParamArrayObj, setParamArraySimple, setParamObj, setParamSimple, setSkipSign, toJsonStringpublic StartWhiteboardPushRequest()
public StartWhiteboardPushRequest(StartWhiteboardPushRequest source)
public Long getSdkAppId()
public void setSdkAppId(Long SdkAppId)
SdkAppId - 客户的SdkAppIdpublic Long getRoomId()
public void setRoomId(Long RoomId)
RoomId - 需要推流的白板房间号,取值范围: (1, 4294967295)。
1. 在没有指定`GroupId`的情况下,白板推流默认以`RoomId`的字符串表达形式作为IM群组ID(比如RoomId为1234,则IM群组ID为"1234"),并加群进行信令同步,请在开始推流前确保相应IM群组已创建完成,否则会导致推流失败。
2. 在没有指定`TRTCRoomId`和`TRTCRoomIdStr`的情况下,默认会以`RoomId`作为白板流进行推流的TRTC房间号。public String getPushUserId()
public void setPushUserId(String PushUserId)
PushUserId - 用于白板推流服务进入白板房间的用户ID。在没有额外指定`IMAuthParam`和`TRTCAuthParam`的情况下,这个用户ID同时会用于IM登录、IM加群、TRTC进房推流等操作。
用户ID最大长度不能大于60个字节,该用户ID必须是一个单独的未同时在其他地方使用的用户ID,白板推流服务使用这个用户ID进入房间进行白板音视频推流,若该用户ID和其他地方同时在使用的用户ID重复,会导致白板推流服务与其他使用场景账号互踢,影响正常推流。public String getPushUserSig()
public void setPushUserSig(String PushUserSig)
PushUserSig - 与`PushUserId`对应的IM签名(usersig)。public Whiteboard getWhiteboard()
public void setWhiteboard(Whiteboard Whiteboard)
Whiteboard - 白板参数,例如白板宽高、背景颜色等public Long getAutoStopTimeout()
public void setAutoStopTimeout(Long AutoStopTimeout)
AutoStopTimeout - 自动停止推流超时时间,单位秒,取值范围[300, 259200], 默认值为1800秒。
当白板超过设定时间没有操作的时候,白板推流服务会自动停止白板推流。public Boolean getAutoManageBackup()
public void setAutoManageBackup(Boolean AutoManageBackup)
AutoManageBackup - 对主白板推流任务进行操作时,是否同时同步操作备份任务public WhiteboardPushBackupParam getBackup()
public void setBackup(WhiteboardPushBackupParam Backup)
Backup - 备份白板推流相关参数。
指定了备份参数的情况下,白板推流服务会在房间内新增一路白板画面视频流,即同一个房间内会有两路白板画面推流。public String getPrivateMapKey()
public void setPrivateMapKey(String PrivateMapKey)
PrivateMapKey - TRTC高级权限控制参数,如果在实时音视频开启了高级权限控制功能,必须提供PrivateMapKey才能保证正常推流。public Long getVideoFPS()
public void setVideoFPS(Long VideoFPS)
VideoFPS - 白板推流视频帧率,取值范围[0, 30],默认20fpspublic Long getVideoBitrate()
public void setVideoBitrate(Long VideoBitrate)
VideoBitrate - 白板推流码率, 取值范围[0, 2000],默认1200kbps。
这里的码率设置是一个参考值,实际推流的时候使用的是动态码率,所以真实码率不会固定为指定值,会在指定值附近波动。public Boolean getAutoRecord()
public void setAutoRecord(Boolean AutoRecord)
AutoRecord - 在实时音视频云端录制模式选择为 `指定用户录制` 模式的时候是否自动录制白板推流。
默认在实时音视频的云端录制模式选择为 `指定用户录制` 模式的情况下,不会自动进行白板推流录制,如果希望进行白板推流录制,请将此参数设置为true。
如果实时音视频的云端录制模式选择为 `全局自动录制` 模式,可忽略此参数。public String getUserDefinedRecordId()
public void setUserDefinedRecordId(String UserDefinedRecordId)
UserDefinedRecordId - 指定白板推流这路流在音视频云端录制中的RecordID,指定的RecordID会用于填充实时音视频云端录制完成后的回调消息中的 "userdefinerecordid" 字段内容,便于您更方便的识别录制回调,以及在点播媒体资源管理中查找相应的录制视频文件。
限制长度为64字节,只允许包含大小写英文字母(a-zA-Z)、数字(0-9)及下划线和连词符。
此字段设置后,不管`AutoRecord`字段取值如何,都将自动进行白板推流录制。
默认RecordId生成规则如下:
urlencode(SdkAppID_RoomID_PushUserID)
例如:
SdkAppID = 12345678,RoomID = 12345,PushUserID = push_user_1
那么:RecordId = 12345678_12345_push_user_1public Boolean getAutoPublish()
public void setAutoPublish(Boolean AutoPublish)
AutoPublish - 在实时音视频旁路推流模式选择为`指定用户旁路`模式的时候,是否自动旁路白板推流。
默认在实时音视频的旁路推流模式选择为 `指定用户旁路` 模式的情况下,不会自动旁路白板推流,如果希望旁路白板推流,请将此参数设置为true。
如果实时音视频的旁路推流模式选择为 `全局自动旁路` 模式,可忽略此参数。public String getUserDefinedStreamId()
public void setUserDefinedStreamId(String UserDefinedStreamId)
UserDefinedStreamId - 指定实时音视频在旁路白板推流这路流时的StreamID,设置之后,您就可以在腾讯云直播 CDN 上通过标准直播方案(FLV或HLS)播放该用户的音视频流。
限制长度为64字节,只允许包含大小写英文字母(a-zA-Z)、数字(0-9)及下划线和连词符。
此字段设置后,不管`AutoPublish`字段取值如何,都将自动旁路白板推流。
默认StreamID生成规则如下:
urlencode(SdkAppID_RoomID_PushUserID_main)
例如:
SdkAppID = 12345678,RoomID = 12345,PushUserID = push_user_1
那么:StreamID = 12345678_12345_push_user_1_mainpublic String getExtraData()
public void setExtraData(String ExtraData)
ExtraData - 内部参数,不需要关注此参数public Long getTRTCRoomId()
public void setTRTCRoomId(Long TRTCRoomId)
TRTCRoomId - TRTC数字类型房间号,取值范围: (1, 4294967295)。
在同时指定了`RoomId`与`TRTCRoomId`的情况下,优先使用`TRTCRoomId`作为白板流进行推流的TRTC房间号。
当指定了`TRTCRoomIdStr`的情况下,此字段将被忽略。public String getTRTCRoomIdStr()
public void setTRTCRoomIdStr(String TRTCRoomIdStr)
TRTCRoomIdStr - TRTC字符串类型房间号。
在指定了`TRTCRoomIdStr`的情况下,会优先使用`TRTCRoomIdStr`作为白板流进行推流的TRTC房间号。public AuthParam getIMAuthParam()
public void setIMAuthParam(AuthParam IMAuthParam)
IMAuthParam - IM鉴权信息参数,用于IM鉴权。
当白板信令所使用的IM应用与白板应用的SdkAppId不一致时,可以通过此参数提供对应IM应用鉴权信息。
如果提供了此参数,白板推流服务会优先使用此参数指定的SdkAppId作为白板信令的传输通道,否则使用公共参数中的SdkAppId作为白板信令的传输通道。public AuthParam getTRTCAuthParam()
public void setTRTCAuthParam(AuthParam TRTCAuthParam)
TRTCAuthParam - TRTC鉴权信息参数,用于TRTC进房推流鉴权。
当需要推流到的TRTC房间所对应的TRTC应用与白板应用的SdkAppId不一致时,可以通过此参数提供对应的TRTC应用鉴权信息。
如果提供了此参数,白板推流服务会优先使用此参数指定的SdkAppId作为白板推流的目标TRTC应用,否则使用公共参数中的SdkAppId作为白板推流的目标TRTC应用。public String getTRTCEnterRoomMode()
public void setTRTCEnterRoomMode(String TRTCEnterRoomMode)
TRTCEnterRoomMode - 指定白板推流时推流用户进TRTC房间的进房模式。默认为 TRTCAppSceneVideoCall
TRTCAppSceneVideoCall - 视频通话场景,即绝大多数时间都是两人或两人以上视频通话的场景,内部编码器和网络协议优化侧重流畅性,降低通话延迟和卡顿率。
TRTCAppSceneLIVE - 直播场景,即绝大多数时间都是一人直播,偶尔有多人视频互动的场景,内部编码器和网络协议优化侧重性能和兼容性,性能和清晰度表现更佳。public String getGroupId()
public void setGroupId(String GroupId)
GroupId - 白板进行信令同步的 IM 群组 ID。
在没有指定`GroupId`的情况下,白板推流服务将使用 `RoomId` 的字符串形式作为同步白板信令的IM群组ID。
在指定了`GroupId`的情况下,白板推流将优先`GroupId`作为同步白板信令的群组ID。请在开始推流前确保指定的IM群组已创建完成,否则会导致推流失败。Copyright © 2025. All rights reserved.