tencent cloud

Feedback

Data Types

Last updated: 2022-03-24 14:59:26

AVTemplate

Audio/Video transcoding template

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Name String Yes Name of an audio/video transcoding template, which can contain 1-20 case-sensitive letters and digits
NeedVideo Integer No Whether video is needed. 0: not needed; 1: needed
Vcodec String No Video codec. Valid values: H264, H265. If this parameter is left empty, the original video codec will be used.
Width Integer No Video width. Value range: (0, 3000]. The value must be an integer multiple of 4. If this parameter is left empty, the original video width will be used.
Height Integer No Video height. Value range: (0, 3000]. The value must be an integer multiple of 4. If this parameter is left empty, the original video height will be used.
Fps Integer No Video frame rate. Value range: [1, 240]. If this parameter is left empty, the original frame rate will be used.
TopSpeed String No Whether to enable top speed codec transcoding. Valid values: CLOSE (disable), OPEN (enable). Default value: CLOSE
BitrateCompressionRatio Integer No Compression ratio for top speed codec transcoding. Value range: [0, 50]. The lower the compression ratio, the higher the image quality.
NeedAudio Integer No Whether audio is needed. 0: not needed; 1: needed
Acodec String No Audio codec. Valid value: AAC (default)
AudioBitrate Integer No Audio bitrate. If this parameter is left empty, the original bitrate will be used.
Valid values: 6000, 7000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000
VideoBitrate Integer No Video bitrate. Value range: [50000, 40000000]. The value must be an integer multiple of 1000. If this parameter is left empty, the original bitrate will be used.
RateControlMode String No Bitrate control mode. Valid values: CBR, ABR (default)
WatermarkId String No Watermark ID

AttachedInput

Channel-associated input

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Id String Yes Input ID
AudioSelectors Array of AudioSelectorInfo No Audio selector for the input. There can be 0 to 20 audio selectors.
Note: this field may return null, indicating that no valid value was found.
PullBehavior String No Pull mode. If the input type is HLS_PULL or MP4_PULL, you can set this parameter to LOOP or ONCE. LOOP is the default value.
Note: this field may return null, indicating that no valid value was found.
FailOverSettings FailOverSettings No Input failover configuration
Note: this field may return null, indicating that no valid value was found.

AudioPidSelectionInfo

Audio Pid selection.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Pid Integer No Audio Pid. Default value: 0.

AudioPipelineInputStatistics

Pipeline input audio statistics.

Used by actions: DescribeStreamLiveChannelInputStatistics.

Name Type Description
Fps Integer Audio FPS.
Rate Integer Audio bitrate in bps.
Pid Integer Audio Pid, which is available only if the input is rtp/udp.

AudioSelectorInfo

Audio selector.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Name String Yes Audio name, which can contain 1-32 letters, digits, and underscores.
AudioPidSelection AudioPidSelectionInfo No Audio Pid selection.

AudioTemplateInfo

Audio transcoding template.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
AudioSelectorName String Yes Only AttachedInputs.AudioSelectors.Name can be selected. This parameter is required for RTP_PUSH and UDP_PUSH.
Name String Yes Audio transcoding template name, which can contain 1-20 letters and digits.
Acodec String No Audio codec. Valid value: AAC. Default value: AAC.
AudioBitrate Integer No Audio bitrate. If this parameter is left empty, the original value will be used.
Valid values: 6000, 7000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000
LanguageCode String No Audio language code, whose length is always 3 characters.

ChannelAlertInfos

Channel alarm information.

Used by actions: DescribeStreamLiveChannelAlerts.

Name Type Description
Pipeline0 Array of ChannelPipelineAlerts Alarm details of pipeline 0 under this channel.
Pipeline1 Array of ChannelPipelineAlerts Alarm details of pipeline 1 under this channel.

ChannelInputStatistics

Channel output statistics.

Used by actions: DescribeStreamLiveChannelInputStatistics.

Name Type Description
InputId String Input ID.
Statistics InputStatistics Input statistics.

ChannelOutputsStatistics

Channel output information.

Used by actions: DescribeStreamLiveChannelOutputStatistics.

Name Type Description
OutputGroupName String Output group name.
Statistics OutputsStatistics Output group statistics.

ChannelPipelineAlerts

Channel alarm details.

Used by actions: DescribeStreamLiveChannelAlerts.

Name Type Description
SetTime String Alarm start time in UTC time.
ClearTime String Alarm end time in UTC time.
This time is available only after the alarm ends.
Type String Alarm type.
Message String Alarm details.

CreateImageSettings

Watermark image settings

Used by actions: CreateStreamLiveWatermark, ModifyStreamLiveWatermark.

Name Type Required Description
ImageType String No Image file format. Valid values: png, jpg.
ImageContent String No Base64 encoded image content
Location String No Origin. Valid values: TOP_LEFT, BOTTOM_LEFT, TOP_RIGHT, BOTTOM_RIGHT.
XPos Integer No The watermark’s horizontal distance from the origin as a percentage of the video width. Value range: 0-100. Default: 10.
YPos Integer No The watermark’s vertical distance from the origin as a percentage of the video height. Value range: 0-100. Default: 10.
Width Integer No The watermark image’s width as a percentage of the video width. Value range: 0-100. Default: 10.
0 means to scale the width proportionally to the height.
You cannot set both Width and Height to 0.
Height Integer No The watermark image’s height as a percentage of the video height. Value range: 0-100. Default: 10.
0 means to scale the height proportionally to the width.
You cannot set both Width and Height to 0.

CreateTextSettings

Watermark text settings

Used by actions: CreateStreamLiveWatermark, ModifyStreamLiveWatermark.

Name Type Required Description
Text String Yes Text
Location String No Origin. Valid values: TOP_LEFT, BOTTOM_LEFT, TOP_RIGHT, BOTTOM_RIGHT.
XPos Integer No The watermark’s horizontal distance from the origin as a percentage of the video width. Value range: 0-100. Default: 10.
YPos Integer No The watermark’s vertical distance from the origin as a percentage of the video height. Value range: 0-100. Default: 10.
FontSize Integer No Font size. Value range: 25-50.
FontColor String No Font color, which is an RGB color value. Default value: 0x000000.

DashRemuxSettingsInfo

DASH configuration information.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
SegmentDuration Integer No Segment duration in ms. Value range: [1000,30000]. Default value: 4000. The value can only be a multiple of 1,000.
SegmentNumber Integer No Number of segments. Value range: [1,30]. Default value: 5.
PeriodTriggers String No Whether to enable multi-period. Valid values: CLOSE/OPEN. Default value: CLOSE.

DescribeImageSettings

Watermark image settings

Used by actions: DescribeStreamLiveWatermark, DescribeStreamLiveWatermarks.

Name Type Description
Location String Origin
XPos Integer The watermark image’s horizontal distance from the origin as a percentage of the video width
YPos Integer The watermark image’s vertical distance from the origin as a percentage of the video height
Width Integer The watermark image’s width as a percentage of the video width
Height Integer The watermark image’s height as a percentage of the video height

DescribeTextSettings

Watermark text settings

Used by actions: DescribeStreamLiveWatermark, DescribeStreamLiveWatermarks.

Name Type Description
Text String Text
Location String Origin
XPos Integer The watermark image’s horizontal distance from the origin as a percentage of the video width
YPos Integer The watermark image’s vertical distance from the origin as a percentage of the video height
FontSize Integer Font size
FontColor String Font color

DescribeTranscodeDetailInfo

Transcoding details.

Used by actions: DescribeStreamLiveTranscodeDetail.

Name Type Description
ChannelId String The channel ID.
StartTime String The start time (UTC+8) of transcoding in the format of yyyy-MM-dd HH:mm:ss.
EndTime String The end time (UTC+8) of transcoding in the format of yyyy-MM-dd HH:mm:ss.
Duration Integer The duration (s) of transcoding.
ModuleCodec String The encoding method.
Examples:
liveprocessor_H264: Live transcoding-H264
liveprocessor_H265: Live transcoding-H265
topspeed_H264: Top speed codec-H264
topspeed_H265: Top speed codec-H265
Bitrate Integer The target bitrate (Kbps).
Type String The transcoding type.
PushDomain String The push domain name.
Resolution String The target resolution.

DescribeWatermarkInfo

Watermark information

Used by actions: DescribeStreamLiveWatermark, DescribeStreamLiveWatermarks.

Name Type Description
Id String Watermark ID
Name String Watermark name
Type String Watermark type. Valid values: STATIC_IMAGE, TEXT.
ImageSettings DescribeImageSettings Watermark image settings. This parameter is valid if Type is STATIC_IMAGE.
Note: This field may return null, indicating that no valid value was found.
TextSettings DescribeTextSettings Watermark text settings. This parameter is valid if Type is TEXT.
Note: This field may return null, indicating that no valid value was found.
UpdateTime String Last modified time (UTC+0) of the watermark, in the format of 2020-01-01T12:00:00Z
Note: This field may return null, indicating that no valid value was found.
AttachedChannels Array of String List of channel IDs the watermark is bound to
Note: This field may return null, indicating that no valid value was found.

DestinationInfo

Relay destination address.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
OutputUrl String Yes Relay destination address. Length limit: [1,512].
AuthKey String No Authentication key. Length limit: [1,128].
Note: this field may return null, indicating that no valid values can be obtained.
Username String No Authentication username. Length limit: [1,128].
Note: this field may return null, indicating that no valid values can be obtained.
Password String No Authentication password. Length limit: [1,128].
Note: this field may return null, indicating that no valid values can be obtained.

DrmKey

Custom DRM key.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Key String Yes DRM key, which is a 32-bit hexadecimal string.
Note: uppercase letters in the string will be automatically converted to lowercase ones.
Track String No Required for Widevine encryption. Valid values: SD, HD, UHD1, UHD2, AUDIO, ALL.
ALL refers to all tracks. If this parameter is set to ALL, no other tracks can be added.
Note: this field may return null, indicating that no valid values can be obtained.
KeyId String No Required for Widevine encryption. It is a 32-bit hexadecimal string.
Note: uppercase letters in the string will be automatically converted to lowercase ones.
Note: this field may return null, indicating that no valid values can be obtained.
Iv String No Required when FairPlay uses the AES encryption method. It is a 32-bit hexadecimal string.
For more information about this parameter, please see:
https://tools.ietf.org/html/rfc3826
Note: uppercase letters in the string will be automatically converted to lowercase ones.
Note: this field may return null, indicating that no valid values can be obtained.

DrmSettingsInfo

DRM configuration information, which takes effect only for HLS and DASH.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
State String No Whether to enable DRM encryption. Valid values: CLOSE (disable), OPEN (enable). Default value: CLOSE
DRM encryption is supported only for HLS, DASH, HLS_ARCHIVE, DASH_ARCHIVE, HLS_MEDIAPACKAGE, and DASH_MEDIAPACKAGE outputs.
Scheme String No Valid values: CustomDRMKeys (default value), SDMCDRM
CustomDRMKeys means encryption keys customized by users.
SDMCDRM means the DRM key management system of SDMC.
ContentId String No If Scheme is set to CustomDRMKeys, this parameter is required.
If Scheme is set to SDMCDRM, this parameter is optional. It supports digits, letters, hyphens, and underscores and must contain 1 to 36 characters. If it is not specified, the value of ChannelId will be used.
Keys Array of DrmKey No The key customized by the content user, which is required when Scheme is set to CustomDRMKeys.
Note: this field may return null, indicating that no valid values can be obtained.
SDMCSettings SDMCSettingsInfo No SDMC key configuration. This parameter is used when Scheme is set to SDMCDRM.
Note: This field may return null, indicating that no valid value was found.

EventSettingsDestinationReq

Destination address information in event settings

Used by actions: CreateStreamLivePlan.

Name Type Required Description
Url String Yes URL of the COS bucket to save recording files

EventSettingsDestinationResp

Destination address information in event settings

Used by actions: DescribeStreamLivePlans.

Name Type Description
Url String URL of the COS bucket where recording files are saved

EventSettingsReq

Configuration information of an event in the plan

Used by actions: CreateStreamLivePlan.

Name Type Required Description
EventType String Yes Valid values: INPUT_SWITCH, TIMED_RECORD. If it is not specified, INPUT_SWITCH will be used.
InputAttachment String No ID of the input to attach, which is required if EventType is INPUT_SWITCH
OutputGroupName String No Name of the output group to attach. This parameter is required if EventType is TIMED_RECORD.
ManifestName String No Name of the manifest file for timed recording, which must end with .m3u8 for HLS and .mpd for DASH. This parameter is required if EventType is TIMED_RECORD.
Destinations Array of EventSettingsDestinationReq No URL of the COS bucket to save recording files. This parameter is required if EventType is TIMED_RECORD. It may contain 1 or 2 URLs. The first URL corresponds to pipeline 0 and the second pipeline 1.

EventSettingsResp

Configuration information of an event in the plan

Used by actions: DescribeStreamLivePlans.

Name Type Required Description
EventType String Yes Only INPUT_SWITCH is supported currently.
InputAttachment String No ID of the input attached, which is not empty if EventType is INPUT_SWITCH
OutputGroupName String No Name of the output group attached. This parameter is not empty if EventType is TIMED_RECORD.
ManifestName String No Name of the manifest file for timed recording, which ends with .m3u8 for HLS and .mpd for DASH. This parameter is not empty if EventType is TIMED_RECORD.
Destinations Array of EventSettingsDestinationResp No URL of the COS bucket where recording files are saved. This parameter is not empty if EventType is TIMED_RECORD. It may contain 1 or 2 URLs. The first URL corresponds to pipeline 0 and the second pipeline 1.

FailOverSettings

Input failover settings

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
SecondaryInputId String No ID of the backup input
Note: this field may return null, indicating that no valid value was found.
LossThreshold Integer No The wait time (ms) for triggering failover after the primary input becomes unavailable. Value range: [1000, 86400000]. Default value: 3000
RecoverBehavior String No Failover policy. Valid values: CURRENT_PREFERRED (default), PRIMARY_PREFERRED

HlsRemuxSettingsInfo

HLS protocol configuration.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
SegmentDuration Integer No Segment duration in ms. Value range: [1000,30000]. Default value: 4000. The value can only be a multiple of 1,000.
SegmentNumber Integer No Number of segments. Value range: [1,30]. Default value: 5.
PdtInsertion String No Whether to enable PDT insertion. Valid values: CLOSE/OPEN. Default value: CLOSE.
PdtDuration Integer No PDT duration in seconds. Value range: (0,3000]. Default value: 600.
Scheme String No Audio/Video packaging scheme. Valid values: SEPARATE, MERGE

InputInfo

Input information.

Used by actions: DescribeStreamLiveInput, DescribeStreamLiveInputs.

Name Type Description
Region String Input region.
Id String Input ID.
Name String Input name.
Type String Input type.
SecurityGroupIds Array of String Array of security groups associated with input.
AttachedChannels Array of String Array of channels associated with input.
Note: this field may return null, indicating that no valid values can be obtained.
InputSettings Array of InputSettingInfo Input configuration array.

InputSecurityGroupInfo

Input security group information.

Used by actions: DescribeStreamLiveInputSecurityGroup, DescribeStreamLiveInputSecurityGroups.

Name Type Description
Id String Input security group ID.
Name String Input security group name.
Whitelist Array of String List of allowlist entries.
OccupiedInputs Array of String List of bound input streams.
Note: this field may return null, indicating that no valid values can be obtained.
Region String Input security group address.

InputSettingInfo

Input settings information.

Used by actions: CreateStreamLiveInput, DescribeStreamLiveInput, DescribeStreamLiveInputs, ModifyStreamLiveInput.

Name Type Required Description
AppName String No Application name, which is valid if Type is RTMP_PUSH and can contain 1-32 letters and digits
Note: This field may return null, indicating that no valid value was found.
StreamName String No Stream name, which is valid if Type is RTMP_PUSH and can contain 1-32 letters and digits
Note: This field may return null, indicating that no valid value was found.
SourceUrl String No Source URL, which is valid if Type is RTMP_PULL, HLS_PULL, or MP4_PULL and can contain 1-512 characters
Note: This field may return null, indicating that no valid value was found.
InputAddress String No RTP/UDP input address, which does not need to be entered for the input parameter.
Note: this field may return null, indicating that no valid values can be obtained.
SourceType String No Source type for stream pulling and relaying. To pull content from private-read COS buckets under the current account, set this parameter to TencentCOS; otherwise, leave it empty.
Note: this field may return null, indicating that no valid value was found.
DelayTime Integer No Delayed time (ms) for playback, which is valid if Type is RTMP_PUSH
Value range: 0 (default) or 10000-600000
The value must be a multiple of 1,000.
Note: This field may return null, indicating that no valid value was found.

InputStatistics

Input statistics.

Used by actions: DescribeStreamLiveChannelInputStatistics.

Name Type Description
Pipeline0 Array of PipelineInputStatistics Input statistics of pipeline 0.
Pipeline1 Array of PipelineInputStatistics Input statistics of pipeline 1.

LogInfo

Log information.

Used by actions: DescribeStreamLiveChannelLogs.

Name Type Description
Type String Log type.
It contains the value of StreamStart which refers to the push information.
Time String Time when the log is printed.
Message LogMessageInfo Log details.

LogMessageInfo

Log details.

Used by actions: DescribeStreamLiveChannelLogs.

Name Type Description
StreamInfo StreamInfo Push information.
Note: this field may return null, indicating that no valid values can be obtained.

OutputInfo

Output information.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Name String Yes Output name.
AudioTemplateNames Array of String No Audio transcoding template name array.
Quantity limit: [0,1] for RTMP; [0,20] for others.
Note: this field may return null, indicating that no valid values can be obtained.
VideoTemplateNames Array of String No Video transcoding template name array. Quantity limit: [0,1].
Note: this field may return null, indicating that no valid values can be obtained.
Scte35Settings Scte35SettingsInfo No SCTE-35 information configuration.
AVTemplateNames Array of String No Audio/Video transcoding template name. If HlsRemuxSettings.Scheme is MERGE, there is 1 audio/video transcoding template. Otherwise, this parameter is empty.
Note: this field may return null, indicating that no valid value was found.

OutputsStatistics

Channel output statistics.

Used by actions: DescribeStreamLiveChannelOutputStatistics.

Name Type Description
Pipeline0 Array of PipelineOutputStatistics Output information of pipeline 0.
Pipeline1 Array of PipelineOutputStatistics Output information of pipeline 1.

PipelineInputStatistics

Pipeline input statistics.

Used by actions: DescribeStreamLiveChannelInputStatistics.

Name Type Description
Timestamp Integer Data timestamp in seconds.
NetworkIn Integer Input bandwidth in bps.
Video Array of VideoPipelineInputStatistics Video information array.
For rtp/udp input, the quantity is the number of Pid of the input video.
For other inputs, the quantity is 1.
Audio Array of AudioPipelineInputStatistics Audio information array.
For rtp/udp input, the quantity is the number of Pid of the input audio.
For other inputs, the quantity is 1.

PipelineLogInfo

Pipeline log information.

Used by actions: DescribeStreamLiveChannelLogs.

Name Type Description
Pipeline0 Array of LogInfo Log information of pipeline 0.
Note: this field may return null, indicating that no valid values can be obtained.
Pipeline1 Array of LogInfo Log information of pipeline 1.
Note: this field may return null, indicating that no valid values can be obtained.

PipelineOutputStatistics

Channel output statistics.

Used by actions: DescribeStreamLiveChannelOutputStatistics.

Name Type Description
Timestamp Integer Timestamp.
In seconds, indicating data time.
NetworkOut Integer Output bandwidth in bps.

PlanReq

Event configuration information

Used by actions: CreateStreamLivePlan.

Name Type Required Description
EventName String Yes Event name
TimingSettings TimingSettingsReq Yes Event trigger time settings
EventSettings EventSettingsReq Yes Event configuration

PlanResp

Event configuration information

Used by actions: DescribeStreamLivePlans.

Name Type Required Description
EventName String Yes Event name
TimingSettings TimingSettingsResp Yes Event trigger time settings
EventSettings EventSettingsResp Yes Event configuration

PlanSettings

Event settings

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
TimedRecordSettings TimedRecordSettings No Timed recording settings
Note: This field may return null, indicating that no valid value was found.

RegionInfo

Region information

Used by actions: DescribeStreamLiveRegions.

Name Type Description
Name String Region name

SDMCSettingsInfo

SDMC DRM configuration information. This parameter is valid only when Scheme is set to SDMCDRM.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Uid String Yes User ID in the SDMC DRM system
Tracks Integer Yes Tracks of the SDMC DRM system. This parameter is valid for DASH output groups.
1: audio
2: SD
4: HD
8: UHD1
16: UHD2

Default value: 31 (audio + SD + HD + UHD1 + UHD2)
SecretId String Yes Key ID in the SDMC DRM system; required
SecretKey String Yes Key in the SDMC DRM system; required
Url String Yes Key request URL of the SDMC DRM system, which is https://uat.multidrm.tv/cpix/2.2/getcontentkey by default
TokenName String Yes Token name in an SDMC key request URL, which is token by default

Scte35SettingsInfo

SCTE-35 configuration information.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Behavior String No Whether to pass through SCTE-35 information. Valid values: NO_PASSTHROUGH/PASSTHROUGH. Default value: NO_PASSTHROUGH.

StreamAudioInfo

Audio information.

Used by actions: DescribeStreamLiveChannelLogs.

Name Type Description
Pid Integer Audio Pid.
Note: this field may return null, indicating that no valid values can be obtained.
Codec String Audio codec.
Note: this field may return null, indicating that no valid values can be obtained.
Fps Integer Audio frame rate.
Note: this field may return null, indicating that no valid values can be obtained.
Rate Integer Audio bitrate.
Note: this field may return null, indicating that no valid values can be obtained.
SampleRate Integer Audio sample rate.
Note: this field may return null, indicating that no valid values can be obtained.

StreamInfo

Push information.

Used by actions: DescribeStreamLiveChannelLogs.

Name Type Description
ClientIp String Client IP.
Video Array of StreamVideoInfo Video information of pushed streams.
Audio Array of StreamAudioInfo Audio information of pushed streams.
Scte35 Array of StreamScte35Info SCTE-35 information of pushed streams.

StreamLiveChannelInfo

Channel information

Used by actions: DescribeStreamLiveChannel, DescribeStreamLiveChannels.

Name Type Description
Id String Channel ID
State String Channel status
AttachedInputs Array of AttachedInput Information of attached inputs
OutputGroups Array of StreamLiveOutputGroupsInfo Information of output groups
Name String Channel name
AudioTemplates Array of AudioTemplateInfo Audio transcoding templates
Note: this field may return null, indicating that no valid value was found.
VideoTemplates Array of VideoTemplateInfo Video transcoding templates
Note: this field may return null, indicating that no valid value was found.
AVTemplates Array of AVTemplate Audio/Video transcoding templates
Note: this field may return null, indicating that no valid value was found.
PlanSettings PlanSettings Event settings
Note: This field may return null, indicating that no valid value was found.

StreamLiveOutputGroupsInfo

Channel output group information

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Name String Yes Output group name, which can contain 1-32 case-sensitive letters, digits, and underscores and must be unique at the channel level
Type String Yes Output protocol
Valid values: HLS, DASH, HLS_ARCHIVE, HLS_STREAM_PACKAGE, DASH_STREAM_PACKAGE
Outputs Array of OutputInfo Yes Output information
If the type is RTMP or RTP, only one output is allowed; if it is HLS or DASH, 1-10 outputs are allowed.
Destinations Array of DestinationInfo Yes Relay destinations. Quantity: [1, 2]
HlsRemuxSettings HlsRemuxSettingsInfo No HLS protocol configuration information, which takes effect only for HLS/HLS_ARCHIVE outputs
Note: this field may return null, indicating that no valid value was found.
DrmSettings DrmSettingsInfo No DRM configuration information
Note: this field may return null, indicating that no valid value was found.
DashRemuxSettings DashRemuxSettingsInfo No DASH protocol configuration information, which takes effect only for DASH/DASH_ARCHIVE outputs
Note: this field may return null, indicating that no valid value was found.
StreamPackageSettings StreamPackageSettingsInfo No StreamPackage configuration information, which is required if the output type is StreamPackage
Note: this field may return null, indicating that no valid value was found.
TimeShiftSettings TimeShiftSettingsInfo No Time-shift configuration information
Note: This field may return null, indicating that no valid value was found.

StreamLiveRegionInfo

StreamLive region information

Used by actions: DescribeStreamLiveRegions.

Name Type Description
Regions Array of RegionInfo List of StreamLive regions

StreamPackageSettingsInfo

StreamPackage settings when the output type is StreamPackage

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Id String Yes Channel ID in StreamPackage

StreamScte35Info

SCTE-35 information.

Used by actions: DescribeStreamLiveChannelLogs.

Name Type Description
Pid Integer SCTE-35 Pid.
Note: this field may return null, indicating that no valid values can be obtained.

StreamVideoInfo

Video information of pushed streams.

Used by actions: DescribeStreamLiveChannelLogs.

Name Type Description
Pid Integer Video Pid.
Note: this field may return null, indicating that no valid values can be obtained.
Codec String Video codec.
Note: this field may return null, indicating that no valid values can be obtained.
Fps Integer Video frame rate.
Note: this field may return null, indicating that no valid values can be obtained.
Rate Integer Video bitrate.
Note: this field may return null, indicating that no valid values can be obtained.
Width Integer Video width.
Note: this field may return null, indicating that no valid values can be obtained.
Height Integer Video height.
Note: this field may return null, indicating that no valid values can be obtained.

TimeShiftSettingsInfo

Time-shift configuration. This parameter is valid only for HLS_ARCHIVE and DASH_ARCHIVE output groups.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
State String No Whether to enable time shifting. Valid values: OPEN; CLOSE
Note: This field may return null, indicating that no valid value was found.
PlayDomain String No Domain name bound for time shifting
Note: This field may return null, indicating that no valid value was found.
StartoverWindow Integer No Allowable time-shift period (s). Value range: [600, 1209600]. Default value: 300
Note: This field may return null, indicating that no valid value was found.

TimedRecordSettings

Timed recording settings

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
AutoClear String No Whether to automatically delete finished recording events. Valid values: CLOSE, OPEN. If this parameter is left empty, CLOSE will be used.
If it is set to OPEN, a recording event will be deleted 7 days after it is finished.
Note: This field may return null, indicating that no valid value was found.

TimingSettingsReq

Event trigger time settings

Used by actions: CreateStreamLivePlan.

Name Type Required Description
StartType String Yes Event trigger type. Valid values: FIXED_TIME, IMMEDIATE. This parameter is required if EventType is INPUT_SWITCH.
Time String No This parameter is required if EventType is INPUT_SWITCH and StartType is FIXED_TIME.
It must be in UTC format, e.g., 2020-01-01T12:00:00Z.
StartTime String No This parameter is required if EventType is TIMED_RECORD.
It specifies the recording start time in UTC format (e.g., 2020-01-01T12:00:00Z) and must be at least 1 minute later than the current time.
EndTime String No This parameter is required if EventType is TIMED_RECORD.
It specifies the recording end time in UTC format (e.g., 2020-01-01T12:00:00Z) and must be at least 1 minute later than the recording start time.

TimingSettingsResp

Event trigger time settings

Used by actions: DescribeStreamLivePlans.

Name Type Required Description
StartType String Yes Event trigger type
Time String No Not empty if StartType is FIXED_TIME
UTC time, such as 2020-01-01T12:00:00Z
StartTime String No This parameter cannot be empty if EventType is TIMED_RECORD.
It indicates the start time for recording in UTC format (e.g., 2020-01-01T12:00:00Z) and must be at least 1 minute later than the current time.
EndTime String No This parameter cannot be empty if EventType is TIMED_RECORD.
It indicates the end time for recording in UTC format (e.g., 2020-01-01T12:00:00Z) and must be at least 1 minute later than the start time for recording.

VideoPipelineInputStatistics

Pipeline input video statistics.

Used by actions: DescribeStreamLiveChannelInputStatistics.

Name Type Description
Fps Integer Video FPS.
Rate Integer Video bitrate in bps.
Pid Integer Video Pid, which is available only if the input is rtp/udp.

VideoTemplateInfo

Video transcoding template.

Used by actions: CreateStreamLiveChannel, DescribeStreamLiveChannel, DescribeStreamLiveChannels, ModifyStreamLiveChannel.

Name Type Required Description
Name String Yes Video transcoding template name, which can contain 1-20 letters and digits.
Vcodec String No Video codec. Valid values: H264/H265. If this parameter is left empty, the original value will be used.
VideoBitrate Integer No Video bitrate. Value range: [50000,40000000]. The value can only be a multiple of 1,000. If this parameter is left empty, the original value will be used.
Width Integer No Video width. Value range: (0,3000]. The value can only be a multiple of 4. If this parameter is left empty, the original value will be used.
Height Integer No Video height. Value range: (0,3000]. The value can only be a multiple of 4. If this parameter is left empty, the original value will be used.
Fps Integer No Video frame rate. Value range: [1,240]. If this parameter is left empty, the original value will be used.
TopSpeed String No Whether to enable top speed codec. Valid value: CLOSE/OPEN. Default value: CLOSE.
BitrateCompressionRatio Integer No Top speed codec compression ratio. Value range: [0,50]. The lower the compression ratio, the higher the image quality.
RateControlMode String No Bitrate control mode. Valid values: CBR, ABR (default)
WatermarkId String No Watermark ID
Note: This field may return null, indicating that no valid value was found.
Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support