tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Documentation

Data Types

Last updated: 2024-12-09 14:31:30

    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 encoding format, only AAC and PASSTHROUGH are available, with AAC as the 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), VBR.
    WatermarkId String No Watermark ID
    SmartSubtitles Integer No Whether to convert audio to text. 0 (default): No; 1: Yes.
    SubtitleConfiguration String No The subtitle settings. Currently, the following subtitles are supported:
    eng2eng: English speech to English text.
    eng2chs: English speech to Chinese text.
    eng2chseng: English speech to English and Chinese text.
    chs2chs: Chinese speech to Chinese text.
    chs2eng: Chinese speech to English text.
    chs2chseng: Chinese speech to Chinese and English text.
    FaceBlurringEnabled Integer No Whether to enable the face blur function, 1 is on, 0 is off, and the default is 0.
    AudioSelectorName String No Only AttachedInputs.AudioSelectors.Name can be selected. The following types need to be filled in: 'RTP_PUSH', 'SRT_PUSH', 'UDP_PUSH', 'RTP-FEC_PUSH'.
    AudioNormalization AudioNormalizationSettings No Audio transcoding special configuration information.
    AudioSampleRate Integer No Audio sampling rate, unit HZ.
    FrameRateType String No This field indicates how to specify the output video frame rate. If FOLLOW_SOURCE is selected, the output video frame rate will be set equal to the input video frame rate of the first input. If SPECIFIED_FRACTION is selected, the output video frame rate is determined by the fraction (frame rate numerator and frame rate denominator). If SPECIFIED_HZ is selected, the frame rate of the output video is determined by the HZ you enter.
    FrameRateNumerator Integer No Valid when the FrameRateType type you select is SPECIFIED_FRACTION, the output frame rate numerator setting.
    FrameRateDenominator Integer No Valid when the FrameRateType type you select is SPECIFIED_FRACTION, the output frame rate denominator setting.
    BFramesNum Integer No The number of B frames can be selected from 1 to 3.
    RefFramesNum Integer No The number of reference frames can be selected from 1 to 16.
    AdditionalRateSettings AdditionalRateSetting No Additional video bitrate configuration.
    VideoCodecDetails VideoCodecDetail No Video encoding configuration.
    AudioCodecDetails AudioCodecDetail No Audio encoding configuration.
    MultiAudioTrackEnabled Integer No Whether to enable multiple audio tracks 0: Not required 1: Required Default value 0.
    AudioTracks Array of AudioTrackInfo No Quantity limit 0-20 Valid when MultiAudioTrackEnabled is turned on.
    VideoEnhanceEnabled Integer No
    VideoEnhanceSettings Array of VideoEnhanceSetting No
    GopSize Integer No Key frame interval, 300-10000, optional.
    GopSizeUnits String No Keyframe units, only support MILLISECONDS (milliseconds).
    ColorSpaceSettings ColorSpaceSetting No Color space setting.

    AdditionalRateSetting

    additional bit rate configuration.

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

    Name Type Required Description
    VideoMaxBitrate Integer No The maximum bit rate in a VBR scenario must be a multiple of 1000 and between 50000 - 40000000.
    BufferSize Integer No Cache configuration supports configuring a Max Bitrate value of 1-4 times.
    QualityLevel Integer No VBR scene is valid, video quality level, only supports user input numbers between 1-51.

    AmazonS3Settings

    Amazon S3 destination setting.

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

    Name Type Required Description
    AccessKeyID String No Access key ID of the S3 sub-account.
    SecretAccessKey String No Secret access key of the S3 sub-account.
    Region String No Region of S3.
    Bucket String No Bucket name of S3.
    FilePath String No File output path, which can be empty. If it is not empty, it starts with / and ends with /.
    FileName String No User-defined name, supports alphanumeric characters, underscores, and hyphens, with a length between 1 and 32 characters.
    FileExt String No File suffix, only supports jpg.
    TimeFormat String No Support unix or utc0, default unix.

    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.
    CaptionSelectors Array of CaptionSelector No Caption selector for the input. There can be 0 to 1 audio selectors.

    AudioCodecDetail

    Audio codec configuration.

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

    Name Type Required Description
    ChannelMode String No Channel configuration, optional values: MONO (mono), STEREO (two-channel), 5.1 (surround).
    Profile String No Level in aac case, optional values: "LC" "HE-AAC" "HE-AACV2".

    AudioNormalizationSettings

    Special configuration information for audio transcoding.

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

    Name Type Required Description
    AudioNormalizationEnabled Integer No Whether to enable special configuration for audio transcoding: 1: Enable 0: Disable, the default value is 0.
    TargetLUFS Float No Loudness value, floating-point number, rounded to one decimal place, range -5 to -70.

    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.
    AudioSelectorType String No Audio input type, optional values: 'PID_SELECTOR' 'TRACK_SELECTOR', default value PID_SELECTOR.
    AudioTrackSelection InputTracks No AudioTrack configuration.

    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 encoding format, only AAC and PASSTHROUGH are available, with AAC as the default.
    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.
    AudioNormalization AudioNormalizationSettings No Audio transcoding special configuration information.
    AudioSampleRate Integer No Audio sampling rate, unit HZ.
    AudioCodecDetails AudioCodecDetail No Audio encoding parameters.

    AudioTrackInfo

    Audio track configuration.

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

    Name Type Required Description
    TrackName String No User input is limited to letters and numbers, the length should not exceed 20, and should not be repeated in the same channel.
    AudioCodec String No Audio encoding format, only AAC and PASSTHROUGH are available, with AAC as the default.
    AudioBitrate Integer No Audio bitrate.
    AudioSampleRate Integer No Audio sample rate.
    AudioSelectorName String No Only values defined by AttachedInputs.$.AudioSelectors.$.audioPidSelection.pid can be entered.
    AudioNormalization AudioNormalizationSettings No Audio loudness configuration.
    AudioCodecDetails AudioCodecDetail No Audio encoding configuration.

    CaptionSelector

    Caption selector.

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

    Name Type Required Description
    Name String No Caption selector name, which can contain 1-32 letters, digits, and underscores.
    CaptionSourceType String No Caption source type, only support SCTE-128.

    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.

    ColorSpaceSetting

    Color space setting.

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

    Name Type Required Description
    ColorSpace String No Color space, supports PASSTHROUGH (transparent transmission, only supports H265); optional.

    CosSettings

    Cos destination setting.

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

    Name Type Required Description
    Region String No Region of COS.
    Bucket String No Bucket name of COS.
    FilePath String No File output path, which can be empty. If it is not empty, it ends with /.
    FileName String No User-defined name, supports alphanumeric characters, underscores, and hyphens, with a length between 1 and 32 characters.
    FileExt String No File suffix, only supports jpg.
    TimeFormat String No Support unix or utc0, default unix.

    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.
    H265PackageType String No The HLS package type when the H.265 codec is used. Valid values: hvc1, hev1 (default).

    DeliveryRestrictionsInfo

    Distribution configuration information.

    Used by actions: CreateStreamLivePlan, DescribeStreamLivePlans.

    Name Type Required Description
    WebDeliveryAllowed String No Corresponds to SCTE-35 web_delivery_allowed_flag parameter.
    NoRegionalBlackout String No Corresponds to SCTE-35 no_regional_blackout_flag parameter.
    ArchiveAllowed String No Corresponds to SCTE-35 archive_allowed_flag.
    DeviceRestrictions String No Corresponds to SCTE-35 device_restrictions parameter.

    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.
    DestinationType String No The destination type of the retweet. Currently available values are: Standard, AWS_MediaPackageV1, AWS_MediaPackageV2. The default is: Standard. When the output group type is FRAME_CAPTURE, valid values are: AWS_AmazonS3, COS.
    AmazonS3Settings AmazonS3Settings No Aws S3 destination setting.
    CosSettings CosSettings No Cos destination setting.

    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.
    KeyUri String No The URI of the license server when AES-128 is used. This parameter may be empty.
    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.
    DrmType String No Optional Types:
    FAIRPLAY, WIDEVINE, PLAYREADY, AES128

    HLS-TS supports FAIRPLAY and AES128.

    HLS-FMP4 supports FAIRPLAY, WIDEVINE, PLAYREADY, AES128, and combinations of two or three from FAIRPLAY, WIDEVINE, and PLAYREADY (concatenated with commas, e.g., "FAIRPLAY,WIDEVINE,PLAYREADY").

    DASH supports WIDEVINE, PLAYREADY, and combinations of PLAYREADY and WIDEVINE (concatenated with commas, e.g., "PLAYREADY,WIDEVINE").

    EventNotifySetting

    The callback settings.

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

    Name Type Required Description
    PushEventSettings PushEventSetting No The callback configuration for push events.

    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, SCTE35_TIME_SIGNAL, SCTE35_SPLICE_INSERT, SCTE35_RETURN_TO_NETWORK. 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.
    SCTE35SegmentationDescriptor Array of SegmentationDescriptorInfo No SCTE-35 configuration information.
    SpliceEventID Integer No A 32-bit unique segmentation event identifier.Only one occurrence of a given segmentation_event_id value shall be active at any one time.
    SpliceDuration Integer No The duration of the segment in 90kHz ticks.It used to give the splicer an indication of when the break will be over and when the network In Point will occur. If not specifyed,the splice_insert will continue when enter a return_to_network to end the splice_insert at the appropriate time.
    TimedMetadataSetting TimedMetadataInfo No Meta information plan configuration.

    EventSettingsResp

    Configuration information of an event in the plan

    Used by actions: DescribeStreamLivePlans.

    Name Type Required Description
    EventType String Yes Valid values: INPUT_SWITCH, TIMED_RECORD, SCTE35_TIME_SIGNAL, SCTE35_SPLICE_INSERT, SCTE35_RETURN_TO_NETWORK.
    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.
    SCTE35SegmentationDescriptor Array of SegmentationDescriptorRespInfo No SCTE-35 configuration information.
    SpliceEventID Integer No A 32-bit unique segmentation event identifier.Only one occurrence of a given segmentation_event_id value shall be active at any one time.
    SpliceDuration String No The duration of the segment in 90kHz ticks.It used to give the splicer an indication of when the break will be over and when the network In Point will occur. If not specifyed,the splice_insert will continue when enter a return_to_network to end the splice_insert at the appropriate time.
    TimedMetadataSetting TimedMetadataInfo No Meta information plan configuration.

    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

    FrameCaptureTemplate

    Frame capture template.

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

    Name Type Required Description
    Name String Yes Name of frame capture template, limited to uppercase and lowercase letters and numbers, with a length between 1 and 20 characters.
    Width Integer No Width of frame capture, optional, input range is from 0 to 3000, must be a multiple of 2.
    Height Integer No Height of frame capture, optional, input range is from 0 to 3000, must be a multiple of 2.
    CaptureInterval Integer No Interval of frame capture, an integer between 1 and 3600.
    CaptureIntervalUnits String No Interval units of frame capture, only supports SECONDS.
    ScalingBehavior String No Scaling behavior of frame capture, supports DEFAULT or STRETCH_TO_OUTPUT, with DEFAULT being the default option.
    Sharpness Integer No Sharpness, an integer between 0 and 100.

    HighlightInfo

    Collection configuration.

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

    Name Type Required Description
    HighlightEnabled Integer No Whether to enable input recognition 0: Disable 1 Enable Default value 0 Disable.
    Type String No The product where the results are saved, optional: COS. Currently, only Tencent Cloud COS is supported. In the future, it will be connected to AWS S3 and COS will be used by default.
    Region String No Valid when Type is COS, the region where COS is stored.
    Bucket String No Valid when Type is COS, the bucket name stored in COS.
    Path String No Valid when Type is COS, the path where cos is stored.
    Filename String No Valid when Type is COS, the file name stored in cos.
    TimestampFormat String No Valid when Type is COS, the file name suffix stored in COS is automatically generated in the time format, optional values: unix, utc. Unix is the second-level timestamp and UTC is the year, month and day represented by the zero time zone.
    AudioSelectorNames Array of String No Audio selector list is optional and can be empty. If not filled in, an audio will be used as the output of the recognition result by default.

    HighlightResInfoResp

    Highlight results information.

    Used by actions: DescribeMediaLiveHighlightResult.

    Name Type Required Description
    TaskId String No MPS task ID.
    SegmentUrl String No Highlights video link.
    CovImgUrl String No Collection cover link.
    CreateTime Integer No Generation time, UTC format.
    StartTime Float No Starting pts.
    EndTime Float No End pts.
    Duration Float No Duration in seconds.

    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: [3,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. Default value is: SEPARATE.
    SegmentType String No The segment type. Valid values: ts (default), fmp4.
    Currently, fMP4 segments do not support DRM or time shifting.
    H265PackageType String No The HLS package type when the H.265 codec is used. Valid values: hvc1, hev1 (default).
    LowLatency Integer No Whether to enable low latency 0:CLOSE, 1:OPEN, default value: 0.
    PartialSegmentDuration Integer No Low latency slice size, unit ms. Value range: integer [200-HlsRemuxSettings.SegmentDuration] Default value: 500ms.
    PartialSegmentPlaySite Integer No Low latency slice playback position, unit ms. Value range: integer [3HlsRemuxSettings.PartiSegmentDuration - 3HlsRemuxSettings.SegmentDuration], Default value: 3*HlsRemuxSettings.PartiSegmentDuration.
    StreamOrder Integer No Hls main m3u8 file sorting rules by bitrate, optional values: 1: video bitrate ascending order; 2: video bitrate descending order. Default value: 1.
    VideoResolution Integer No Whether the Hls main m3u8 file contains resolution information, optional values: 1: INCLUDE includes video resolution; 2: EXCLUDE does not include video resolution. Default value: 1.
    EndListTag Integer No Whether to include the EXT-X-ENDLIST tag, 1 includes EXT-X-ENDLIST tag, 2 does not include EXT-X-ENDLIST tag; the default value is 1.

    InputAnalysisInfo

    Recognition configuration for input content.

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

    Name Type Required Description
    HighlightSetting HighlightInfo No Highlight configuration.

    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.

    InputLossBehaviorInfo

    Complement the last video frame related settings.

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

    Name Type Required Description
    RepeatLastFrameMs Integer No The time to fill in the last video frame, unit ms, range 0-1000000, 1000000 means always inserting, default 0 means filling in black screen frame.
    InputLossImageType String No Fill frame type, COLOR means solid color filling, IMAGE means picture filling, the default is COLOR.
    ColorRGB String No When the type is COLOR, the corresponding rgb value
    ImageUrl String No When the type is IMAGE, the corresponding image url value

    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

    The input settings.
    The format of an RTMP_PUSH address is ${InputAddress}/${AppName}/${StreamName}.
    The format of an SRT_PUSH address is ${InputAddress}?streamid=${StreamName},h=${InputDomain}.

    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, MP4_PULL, RTSP_PULL or SRT_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.
    InputDomain String No The domain name of the SRT_PUSH push address. No need to fill in the input parameter.
    UserName String No The username, which is used for authentication.
    Note: This field may return null, indicating that no valid value was found.
    Password String No The password, which is used for authentication.
    Note: This field may return null, indicating that no valid value was found.
    ContentType String No This parameter is valid when the input source is HLS_PULL and MP4_PULL. It indicates the type of file the source is. The optional values are: LIVE, VOD. Please note that if you do not enter this parameter, the system will take the default input value VOD.

    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.

    InputStreamInfo

    The input stream information.

    Used by actions: QueryInputStreamState.

    Name Type Description
    InputAddress String The input stream address.
    AppName String The input stream path.
    StreamName String The input stream name.
    Status Integer The input stream status. 1 indicates the stream is active.

    InputTrack

    Audio track configuration.

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

    Name Type Required Description
    TrackIndex Integer No Audio track index 1-based index mapping to the specified audio track integer starting from 1.

    InputTracks

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

    Name Type Required Description
    Tracks Array of InputTrack No Audio track configuration information.

    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.
    CaptionTemplateNames Array of String No For the subtitle template used, only the AVTemplateNames is valid.
    TimedMetadataSettings TimedMetadataSettingInfo No Meta information controls configuration.
    FrameCaptureTemplateNames Array of String No Frame capture template name array. Quantity limit: [0,1].

    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.

    PipelineInputSettingsInfo

    Pipeline failover information.

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

    Name Type Required Description
    FaultBehavior String No Pipeline failover configuration, the valid value is: 1.PIPELINE_FAILOVER (channels are mutually failover); 2.PIPELINE_FILLING (channels fill in themselves). Default value: PIPELINE_FILLING. The specific content is specified by FaultBehavior.

    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.

    PushEventSetting

    The callback configuration for push events.

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

    Name Type Required Description
    NotifyUrl String Yes The callback URL (required).
    NotifyKey String No The callback key (optional).

    QueryDispatchInputInfo

    The stream status of the queried input.

    Used by actions: QueryInputStreamState.

    Name Type Description
    InputID String The input ID.
    InputName String The input name.
    Protocol String The input protocol.
    InputStreamInfoList Array of InputStreamInfo The stream status of the input.

    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.

    SegmentationDescriptorInfo

    SCTE-35 configuration information.

    Used by actions: CreateStreamLivePlan.

    Name Type Required Description
    EventID Integer No A 32-bit unique segmentation event identifier. Only one occurrence of a given segmentation_event_id value shall be active at any one time.
    EventCancelIndicator Integer No Indicates that a previously sent segmentation event, identified by segmentation_event_id, has been cancelled.
    DeliveryRestrictions DeliveryRestrictionsInfo No Distribution configuration.
    Duration Integer No The duration of the segment in 90kHz ticks. indicat when the segment will be over and when the next segmentation message will occur.Shall be 0 for end messages.the time signal will continue until insert a cancellation message when not specify the duration.
    UPIDType Integer No Corresponds to SCTE-35 segmentation_upid_type parameter.
    UPID String No Corresponds to SCTE-35 segmentation_upid.
    TypeID Integer No Corresponds to SCTE-35 segmentation_type_id.
    Num Integer No Corresponds to SCTE-35 segment_num。This field provides support for numbering segments within a given collection of segments.
    Expected Integer No Corresponds to SCTE-35 segment_expected.This field provides a count of the expected number of individual segments within a collection of segments.
    SubSegmentNum Integer No Corresponds to SCTE-35 sub_segment_num.This field provides identification for a specific sub-segment within a collection of sub-segments.
    SubSegmentsExpected Integer No Corresponds to SCTE-35 sub_segments_expected.This field provides a count of the expected number of individual sub-segments within the collection of sub-segments.

    SegmentationDescriptorRespInfo

    SCTE-35 configuration information.

    Used by actions: DescribeStreamLivePlans.

    Name Type Description
    EventID Integer A 32-bit unique segmentation event identifier. Only one occurrence of a given segmentation_event_id value shall be active at any one time.
    EventCancelIndicator Integer Indicates that a previously sent segmentation event, identified by segmentation_event_id, has been cancelled.
    DeliveryRestrictions DeliveryRestrictionsInfo Distribution configuration.
    Duration String The duration of the segment in 90kHz ticks. indicat when the segment will be over and when the next segmentation message will occur.Shall be 0 for end messages.the time signal will continue until insert a cancellation message when not specify the duration.
    UPIDType Integer Corresponds to SCTE-35 segmentation_upid_type parameter.
    UPID String Corresponds to SCTE-35 segmentation_upid.
    TypeID Integer Corresponds to SCTE-35 segmentation_type_id.
    Num Integer Corresponds to SCTE-35 segment_num。This field provides support for numbering segments within a given collection of segments.
    Expected Integer Corresponds to SCTE-35 segment_expected.This field provides a count of the expected number of individual segments within a collection of segments.
    SubSegmentNum Integer Corresponds to SCTE-35 sub_segment_num.This field provides identification for a specific sub-segment within a collection of sub-segments.
    SubSegmentsExpected Integer Corresponds to SCTE-35 sub_segments_expected.This field provides a count of the expected number of individual sub-segments within the collection of sub-segments.

    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.
    CaptionTemplates Array of SubtitleConf
    PlanSettings PlanSettings Event settings
    Note: This field may return null, indicating that no valid value was found.
    EventNotifySettings EventNotifySetting The callback settings.
    Note: This field may return null, indicating that no valid value was found.
    InputLossBehavior InputLossBehaviorInfo Supplement the last video frame configuration settings.
    PipelineInputSettings PipelineInputSettingsInfo Pipeline configuration.
    InputAnalysisSettings InputAnalysisInfo Recognition configuration for input content.
    Tags Array of Tag Console tag list.
    FrameCaptureTemplates Array of FrameCaptureTemplate Frame capture templates.

    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,
    DASH_ARCHIVE, HLS_STREAM_PACKAGE,
    DASH_STREAM_PACKAGE,
    FRAME_CAPTURE, RTP, RTMP, M2TS.
    Outputs Array of OutputInfo Yes Output information
    If the type is RTMP, RTP or FRAME_CAPTURE, 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/HLS_STREAM_PACKAGE 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.

    SubtitleConf

    Subtitle template configuration.

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

    Name Type Required Description
    Name String No Template name.
    CaptionSelectorName String No Name of caption selector. Required when CaptionSource selects INPUT.
    CaptionSource String No Optional values: INPUT (source subtitle information), ANALYSIS (intelligent speech recognition to subtitles).
    ContentType Integer No Optional values: 1 Source, 2 Source+Target, 3 Target (original language only, original language + translation language, translation language). Required when CaptionSource selects ANALYSIS .
    TargetType Integer No Output mode: 1 Burn in, 2 Embedded. Support 2 when CaptionSource selects INPUT. Support 1 when CaptionSource selects ANALYSIS .
    SourceLanguage String No Original phonetic language.
    Optional values: Chinese, English, Japanese, Korean. Required when CaptionSource selects ANALYSIS .
    TargetLanguage String No Target language.
    Optional values: Chinese, English, Japanese, Korean. Required when CaptionSource selects ANALYSIS .
    FontStyle SubtitleFontConf No Font style configuration. Required when CaptionSource selects ANALYSIS .
    StateEffectMode String No There are two modes: STEADY and DYNAMIC, corresponding to steady state and unstable state respectively; the default is STEADY. Required when CaptionSource selects ANALYSIS .
    SteadyStateDelayedTime Integer No Steady-state delay time, unit seconds; optional values: 10, 20, default 10. Required when CaptionSource selects ANALYSIS .

    SubtitleFontConf

    Subtitle style configuration.

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

    Name Type Required Description
    LineSpacing Integer No Line spacing.
    Margins Integer No Margins.
    Lines Integer No Rows.
    CharactersPerLine Integer No Number of characters per line.
    SourceTextFont String No Original font Helvetica: simhei.ttf Song Dynasty: simsun.ttc Dynacw Diamond Black: hkjgh.ttf Helvetica font: helvetica.ttf; Need to be set in Source or Source+Target mode
    TextColor String No Font color is represented by 6 RGB hexadecimal characters.
    BackgroundColor String No The background color is represented by 6 RGB hexadecimal characters.
    BackgroundAlpha Integer No Background transparency, a number from 0-100.
    PreviewContent String No Preview copy.
    PreviewWindowHeight Integer No Preview window height.
    PreviewWindowWidth Integer No Preview window width.
    TranslatedTextFont String No Translation language font, the enumeration value is the same as Font, the fonts supported by the language need to be distinguished; TextColor needs to be set in Target or Source+Target mode

    Tag

    Console Tag, for documentation please refer to: https://www.tencentcloud.com/document/product/651.

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

    Name Type Required Description
    TagKey String Yes Tag key, for restrictions please refer to the tag documentation: https://www.tencentcloud.com/document/product/651/13354.
    TagValue String Yes Tag value, for restrictions please refer to the tag documentation: https://www.tencentcloud.com/document/product/651/13354.
    Category String No Tag type, optional; for documentation please refer to: https://www.tencentcloud.com/document/product/651/33023#tag.

    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: [300, 2592000]. Default value: 300Note: This field may return null, indicating that no valid value was found.

    TimedMetadataInfo

    Transparent transmission of meta information plan configuration.

    Used by actions: CreateStreamLivePlan, DescribeStreamLivePlans.

    Name Type Required Description
    ID3 String No Base64-encoded id3 metadata information, with a maximum limit of 1024 characters.

    TimedMetadataSettingInfo

    Transparent transmission of ID3 information configuration.

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

    Name Type Required Description
    Behavior Integer No Whether to transparently transmit ID3 information, optional values: 0:NO_PASSTHROUGH, 1:PASSTHROUGH, default 0.

    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.

    VideoCodecDetail

    Video codec additional configuration.

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

    Name Type Required Description
    Profile String No The three image quality levels of h264 include: BASELINE, HIGH, and MAIN. The default option is MAIN.
    Level String No Profile corresponding codec performance, options include: 1, 1.1, 1.2, 1.3, 2, 2.1, 2.2, 2.3, 3, 3.1, 3.2, 4, 4.1, 4.2, 5, 5.1, AUTO. The default option is AUTO.
    EntropyEncoding String No Codecs include entropy coding and lossless coding, and options include: CABAC and CAVLC. The default option is CABAC. .
    AdaptiveQuantization String No Mode, options include: AUTO, HIGH, HIGHER, LOW, MAX, MEDIUM, OFF. The default option is: AUTO. .
    LookAheadRateControl String No Analyze subsequent encoded frames in advance, options include: HIGH, LOW, MEDIUM. The default option is: MEDIUM. .

    VideoEnhanceSetting

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

    Name Type Required Description
    Type String Yes
    Strength Float Yes

    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), VBR.
    WatermarkId String No Watermark ID
    Note: This field may return null, indicating that no valid value was found.
    FaceBlurringEnabled Integer No Whether to enable the face blur function, 1 is on, 0 is off, and the default is 0.
    FrameRateType String No This field indicates how to specify the output video frame rate. If FOLLOW_SOURCE is selected, the output video frame rate will be set equal to the input video frame rate of the first input. If SPECIFIED_FRACTION is selected, the output video frame rate is determined by the fraction (frame rate numerator and frame rate denominator). If SPECIFIED_HZ is selected, the frame rate of the output video is determined by the HZ you enter.
    FrameRateNumerator Integer No Valid when the FrameRateType type you select is SPECIFIED_FRACTION, the output frame rate numerator setting.
    FrameRateDenominator Integer No Valid when the FrameRateType type you select is SPECIFIED_FRACTION, the output frame rate denominator setting.
    BFramesNum Integer No The number of B frames can be selected from 1 to 3.
    RefFramesNum Integer No The number of reference frames can be selected from 1 to 16.
    AdditionalRateSettings AdditionalRateSetting No Additional video bitrate configuration.
    VideoCodecDetails VideoCodecDetail No Video encoding configuration.
    VideoEnhanceEnabled Integer No
    VideoEnhanceSettings Array of VideoEnhanceSetting No
    ColorSpaceSettings ColorSpaceSetting No Color space setting.
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    Privacy PolicyLegalCookie Policy