All Products
Search
Document Center

Intelligent Media Services:CreateMediaLiveChannel

Last Updated:Jun 11, 2026

Membuat saluran langsung media.

Deskripsi operasi

  • Panggil operasi ini untuk membuat saluran langsung media.

Batas QPS

Batas QPS per pengguna tunggal untuk operasi ini adalah 50 panggilan per detik. Jika batas ini terlampaui, panggilan API akan dibatasi, yang dapat memengaruhi bisnis Anda. Panggil operasi ini sesuai kebutuhan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ice:CreateMediaLiveChannel

create

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Name

string

Yes

Nama saluran. Nama dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_). Panjang nama dapat mencapai 64 karakter.

mych

InputAttachments

array<object>

Yes

Pengaturan lampiran input.

array<object>

No

InputId

string

Yes

ID input yang terikat.

myinput

LanguageName

string

No

Nama bahasa. Parameter ini hanya valid untuk input tipe RTMP dan menentukan tag Name yang digunakan oleh output. Nilai dapat memiliki panjang hingga 32 karakter dan mendukung jenis karakter berikut:

  • Huruf Unicode dari berbagai bahasa, termasuk huruf Latin (seperti bahasa Inggris dan Prancis), karakter Tionghoa, huruf Arab, dan huruf dari bahasa lainnya.

  • Digit: 0-9.

  • Garis bawah (_).

  • Tanda hubung (-).

  • Spasi. Spasi dapat muncul di tengah nilai tetapi tidak di awal atau akhir.

English

AudioSelectors

array<object>

No

Daftar pemilih audio.

array<object>

No

Name

string

Yes

Nama pemilih audio. Nama dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_). Panjang nama dapat mencapai 64 karakter.

myselector

AudioLanguageSelection

object

No

Pemilih bahasa.

LanguageCode

string

Yes

Enter a three-letter ISO 639-2 language code from within an audio source.

eng

AudioPidSelection

object

No

Pemilih PID.

Pid

integer

Yes

Enter a specific PID from within a source.

123

AudioTrackSelection

array<object>

No

Pemilih Track.

object

No

TrackId

integer

Yes

Specify one or more audio tracks from within a source using Track ID.

1

OutputGroups

array<object>

Yes

Konfigurasi kelompok output.

array<object>

No

Name

string

Yes

Nama kelompok output. Nama dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_). Panjang nama dapat mencapai 64 karakter.

group1

Type

string

Yes

Tipe kelompok output. Saat ini, hanya MediaPackage yang didukung.

MediaPackage

Outputs

array<object>

Yes

Pengaturan daftar output.

array<object>

No

Name

string

Yes

Nama output. Nama dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_). Panjang nama dapat mencapai 64 karakter.

output1

MediaType

integer

No

Tipe media output. Nilai valid:

  • 0: audio dan video.

  • 1: hanya audio. Saat diatur ke hanya audio, pengaturan video tidak dapat direferensikan.

  • 2: hanya video. Saat diatur ke hanya video, pengaturan audio tidak dapat direferensikan.

0

MediaPackageOutputSetting

object

No

Pengaturan output saat tipe kelompok output adalah MediaPackage.

NameModifier

string

No

The manifest name modifier. The child manifests include this modifier in their M3U8 file names. Letters, digits, hyphens (-), and underscores (_) are supported. The maximum length is 40 characters.

480p

AudioGroupId

string

No

The manifest audio group ID. To associate several audio tracks into one group, assign the same audio group ID. Viewers can select a track as needed. Letters, digits, hyphens (-), and underscores (_) are supported. It can be up to 40 characters in length.

audiogroup

VideoSettingName

string

No

Nama pengaturan video yang direferensikan.

myVideo1

AudioSettingNames

array

No

Daftar nama pengaturan audio yang direferensikan.

string

No

The name of the referenced AudioSettings.

myAudio1

MediaPackageGroupSetting

object

No

Pengaturan kelompok output saat tipe kelompok output adalah MediaPackage.

GroupName

string

Yes

GroupName dari MediaPackage yang direferensikan.

myPackageGroup

ChannelName

string

Yes

ChannelName dari MediaPackage yang direferensikan.

myPackageChannel

AudioSettings

array<object>

No

Pengaturan audio.

array<object>

No

Name

string

Yes

Nama pengaturan audio. Nama dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_). Panjang nama dapat mencapai 64 karakter.

audio1

AudioSelectorName

string

No

Nama pemilih audio.

a1

LanguageCode

string

No

Kode bahasa ISO 639-2. Nilai memiliki panjang 3 karakter. Jika Track audio yang dipilih oleh pemilih memiliki kode bahasa yang sesuai dalam output, kode bahasa pemilih akan diutamakan. Jika Track audio yang dipilih oleh pemilih tidak memiliki kode bahasa atau tidak ada Track audio yang cocok dengan pemilih, kode bahasa ini akan digunakan.

eng

LanguageName

string

No

Nama bahasa. Parameter ini hanya valid untuk input tipe RTMP dan menentukan tag Name yang digunakan oleh output. Nilai dapat memiliki panjang hingga 32 karakter dan mendukung jenis karakter berikut:

  • Huruf Unicode dari berbagai bahasa, termasuk huruf Latin (seperti bahasa Inggris dan Prancis), karakter Tionghoa, huruf Arab, dan huruf dari bahasa lainnya.

  • Digit: 0-9.

  • Garis bawah (_).

  • Tanda hubung (-).

  • Spasi. Spasi dapat muncul di tengah nilai tetapi tidak di awal atau akhir.

English

AudioCodec

string

No

Tipe Pengkodean audio. Jika dikosongkan, Pengkodean sumber akan digunakan (mode salin). Nilai valid: aac, libfdk_aac.

libfdk_aac

AudioCodecSetting

object

No

Pengaturan Pengkodean audio.

Profile

string

No

Profil pengkodean audio. Saat Kodek diatur ke aac, nilai valid adalah AAC-LOW dan AAC-MAIN. Saat Kodek diatur ke libfdk_aac, nilai valid adalah AAC-LOW, AAC-HE, dan AAC-HEV2.

AAC-LOW

Bitrate

integer

No

Laju bit audio dalam bps. Nilai valid: 8000 hingga 1000000. Nilai harus dapat dibagi habis dengan 1000.

200000

SampleRate

integer

No

Laju sampel audio dalam Hz. Nilai valid: 22050, 32000, 44100, 48000, dan 96000.

44100

VideoSettings

array<object>

No

Pengaturan video.

array<object>

No

Name

string

Yes

Nama pengaturan video. Nama dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_). Panjang nama dapat mencapai 64 karakter.

video1

Width

integer

No

Lebar resolusi video. Jika tidak ditentukan atau diatur ke 0, lebar akan diskalakan secara otomatis berdasarkan nilai Height.

Nilai valid:

  • Untuk Transkoding standar, max(Width, Height) harus kurang dari 3840 dan min(Width, Height) harus kurang dari 2160.

  • Untuk Transkoding HD pita sempit, max(Width, Height) harus kurang dari 1920 dan min(Width, Height) harus kurang dari 1080.

1280

Height

integer

No

Tinggi resolusi video. Jika tidak ditentukan atau diatur ke 0, tinggi akan diskalakan secara otomatis berdasarkan nilai Width.

Nilai valid:

  • Untuk Transkoding standar, max(Width, Height) harus kurang dari 3840 dan min(Width, Height) harus kurang dari 2160.

  • Untuk Transkoding HD pita sempit, max(Width, Height) harus kurang dari 1920 dan min(Width, Height) harus kurang dari 1080.

720

VideoCodec

string

No

Tipe Pengkodean video. Nilai valid: H264, H265.

H264

VideoCodecSetting

object

No

Pengaturan Pengkodean video.

Rate

object

No

Pengaturan laju Pengkodean video. Jika tidak ditentukan, laju sumber akan digunakan.

Bitrate

integer

No

The video bitrate. Unit: bit/s. If you set it to 0 or leave it empty, the source specification is used. Valid values: 50000 to 6000000. The value must be divisible by 1000.

2500000

RateControlMode

string

No

The bitrate control mode. Valid values: CBR, ABR, and VBR.

ABR

MaxBitrate

integer

No

The maximum bitrate. Unit: bit/s. Valid values: 100000 to 6000000. The value must be divisible by 1000.

6000000

BufferSize

integer

No

The video buffer size. Unit: bit/s. Valid values: 100000 to 6000000. The value must be divisible by 1000.

6000000

Framerate

object

No

Pengaturan laju frame video. Jika tidak ditentukan, laju frame sumber akan digunakan.

FramerateControl

string

No

The frame rate mode. Valid values: SPECIFIED (fixed frame rate) and FROM_SOURCE (use source specification).

SPECIFIED

FramerateNumerator

integer

No

The numerator of the fixed frame rate. The parameter is required when FramerateControl is set to SPECIFIED. Valid values: 1 to 60. The numerator must be divisible by the denominator.

25

FramerateDenominator

integer

No

The denominator of the fixed frame rate. The parameter is required when FramerateControl is set to SPECIFIED. Valid values: 1 to 60. The numerator must be divisible by the denominator.

1

Gop

object

No

Pengaturan GOP video. Jika tidak ditentukan, GOP sumber akan digunakan.

GopSizeUnits

string

No

The GOP size unit. Valid values: FRAMES and SECONDS.

FRAMES

GopSize

integer

No

The GOP size. When GopSizeUnits is set to SECONDS, the value range is from 1 to 20. When GopSizeUnits is set to FRAMES, the value range is from 1 to 3000.

90

BframesNum

integer

No

The number of B frames. Valid values: 1 to 3.

3

CodecDetail

object

No

Pengaturan detail Pengkodean video.

Profile

string

No

The H.264 profile. Valid values: BASELINE, HIGH, and MAIN. Default value: MAIN. The parameter takes effect only when the codec is H.264.

MAIN

Level

string

No

The video encoding level. It is not supported yet.

H264_LEVEL_AUTO

VideoCodecType

string

No

Metode Transkoding video. Nilai valid:

  • NORMAL: Transkoding standar.

  • NBHD: Transkoding HD pita sempit.

Nilai default: NORMAL.

NORMAL

Elemen respons

Element

Type

Description

Example

object

Skema Tanggapan.

RequestId

string

ID permintaan.

******11-DB8D-4A9A-875B-275798******

ChannelId

string

ID saluran.

SEGK5KA6KYKAWQQH

Contoh

Respons sukses

JSONformat

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "ChannelId": "SEGK5KA6KYKAWQQH"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.