edit-icon download-icon

AddCustomLiveStreamTranscode

Last Updated: Apr 11, 2018

Description

Add custom transcode configuration information.

Request parameter

Parameters Type Required Example values Description
Action String Yes AddCustomLiveStreamTranscode

The name of this interface. Value: AddCustomLiveStreamTranscode

App String Yes AppName

Name of the app, which the live stream belongs to.
Value requirement: number, upper case letters, lower case letters, underline (_), or hyphen (-).

Domain String Yes live.aliyunlive.com

Your CDN domain name.

FPS Integer Yes 30

Transcode video frame per second. Unit: fps.
Value requirement: [1, 30]

Height Integer Yes 720

Transcode video width.

  • Value requirement: Width ≥ 100
  • max(Height, Width) ≤ 1920
  • min(Height, Width) ≤ 1080

Template String Yes LDtest

Transcode template custom name.
Value requirement: number, upper case letters, lower case letters, or hyphen (-).
Note: This name and the standard transcode template are not the same.

TemplateType String Yes h264

Custom trascode template type. Currently,

  • only suppports: h264-nbhd (custom H264 narrowband high-definition template)
  • not supports: h264 (custom H264 standard template).

VideoBitrate Integer Yes 720

Transcode video bit rate, unit: kbps.
Value requirement: [1, 6000]
Note: transoded video approximates the bit rate you set as much as possible, but not actually the same, especially when the bit rate you set is much too higher or lower.

Width Integer Yes 576

Transcode video width.

  • Value requirement: Width ≥ 100
  • max(Height, Width) ≤ 1920
  • min(Height, Width) ≤ 1080

Version String No 1.0

Version.

Return parameter

Parameters Type Example values Description
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

The ID of the job request.

Example

Return example

  1. https://live.aliyuncs.com?Action=AddCustomLiveStreamTranscode&Domain=test101.cdnpe.com&App=AppName&Template=LDtest&TemplateType=h264&Height=1280&Width=720&FPS=25&VideoBitrate=2400&<public request parameter>

Normal return example

JSON format

  1. {
  2. "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  3. }

Exception return example

JSON format

  1. {
  2. "Code":"InternalError",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  6. }

Error code

For more information about error code of this product, see Error code.

Thank you! We've received your feedback.