tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
媒体直播
    文档

    Data Types

    最后更新时间：2024-01-24 11:22:54

      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
      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.

      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.
      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.

      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 The DRM type. Valid values: FAIRPLAY, WIDEVINE, AES128, PLAYREADY. For HLS, this can be FAIRPLAY or AES128 or PLAYREADY. For DASH, valid values: WIDEVINE or PLAYREADY.

      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

      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. 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.

      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, 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.
      InputDomain String No The domain of an SRT_PUSH address. If this is a request parameter, you don’t need to specify it.
      Note: This field may return null, indicating that no valid value was found.
      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.

      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.

      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.
      TimedMetadataSettings TimedMetadataSettingInfo No Meta information controls configuration.

      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.
      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.

      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/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.

      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.

      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.
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款