All Products
Search

This Product

    Intelligent Media Services:SubmitLiveEditingJob

    Document Center

    Intelligent Media Services:SubmitLiveEditingJob

    Last Updated:Aug 06, 2026

    Pencampuran aliran langsung (live editing) menggabungkan satu atau beberapa segmen aliran langsung menjadi produk jadi. Setelah Anda mengirimkan tugas live editing, tugas tersebut masuk ke antrian latar belakang dan dieksekusi secara asinkron. Anda dapat memanggil operasi GetLiveEditingJob untuk menanyakan status pekerjaan berdasarkan jobId, atau memanggil operasi GetMediaInfo untuk menanyakan informasi aset media yang dihasilkan berdasarkan MediaId.

    Deskripsi operasi

    • Ini adalah operasi asinkron. Setelah Anda mengirimkan tugas, ID tugas dikembalikan (tugas belum selesai dan masuk ke antrian latar belakang untuk eksekusi asinkron). Hasil akhir dikirimkan melalui Notifikasi callback. Anda juga dapat secara proaktif menanyakan status tugas dengan memanggil GetLiveEditingJob.

    • Live editing didukung untuk aliran langsung yang direkam ke OSS dan VOD. Saat mencampurkan beberapa aliran langsung, semua aliran harus direkam ke OSS atau semuanya ke VOD.

    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:SubmitLiveEditingJob

    *Semua Sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Clips

    string

    Yes

    Daftar segmen klip. Output dihasilkan dengan menggabungkan segmen-segmen dalam daftar secara berurutan. JSON Array.

    Setiap segmen berisi waktu mulai dan waktu akhir. Jika parameter aliran langsung tidak ditentukan, konfigurasi aliran langsung tingkat luar akan digunakan. Timestamp waktu mulai dan waktu akhir keduanya dalam UTC. Untuk detail parameter, lihat struktur data Clip di bawah ini.

    [{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" , "AppName": "app", "DomainName": "domain.com", "StreamName": "stream"}, {\"StartTime\": \" 2021-06-21T08:05:00Z\", \"EndTime\": \" 2021-06-21T08:09:00Z\" }]
    ProjectId

    string

    No

    ID proyek live editing. Jika parameter ini tidak kosong, konfigurasi penyimpanan yang terkait dengan proyek tersebut akan digunakan. Jika parameter ini kosong, konfigurasi penyimpanan yang ditentukan dalam parameter permintaan akan digunakan.

    ****fddd7748b58bf1d47e95****
    LiveStreamConfig

    string

    No

    Konfigurasi aliran langsung. JSON Object. Item konfigurasi berikut wajib disediakan:

    • AppName: nama aplikasi tempat aliran tersebut berada.

    • DomainName: Nama domain.

    • StreamName: nama aliran langsung.

    { "AppName": "app", "DomainName": "domain.com", "StreamName": "stream" }
    OutputMediaConfig

    string

    No

    Konfigurasi tujuan untuk output. JSON Object. Anda dapat menentukan URL output di OSS atau lokasi penyimpanan di bucket VOD.

    • Saat mengeluarkan output ke OSS, MediaURL dari tujuan output wajib disediakan.

    • Saat mengeluarkan output ke VOD, parameter StorageLocation dan FileName wajib disediakan.

    { "MediaURL": "https://ice-auto-test.oss-cn-shanghai.aliyuncs.com/testfile.mp4" }, or { "StorageLocation": "bucket.oss-cn-shanghai.aliyuncs.com", "FileName": "output.mp4" }
    MediaProduceConfig

    string

    No

    Konfigurasi pencampuran untuk menghasilkan segmen, dalam format JSON. Mode menentukan mode editing. Nilai yang valid:

    • AccurateFast (default): editing akurat cepat. Mode ini lebih cepat daripada mode Accurate. Resolusi file output sama dengan resolusi aliran sumber. Lebar dan tinggi output kustom tidak didukung.

    • Accurate: editing akurat. Anda dapat menentukan lebar dan tinggi output.

    • Rough: editing kasar. Presisi minimum adalah satu segmen TS. Output berisi semua segmen dalam rentang waktu mulai dan akhir yang ditentukan. Anda dapat menentukan lebar dan tinggi output.

    • RoughFast: editing kasar cepat. Mode ini lebih cepat daripada mode Accurate. Presisi minimum adalah satu segmen TS. Output berisi semua segmen dalam rentang waktu mulai dan akhir yang ditentukan. Resolusi file output sama dengan resolusi aliran sumber. Lebar dan tinggi output kustom tidak didukung.

    { "Mode": "AccurateFast"}
    UserData

    string

    No

    Pengaturan kustom. JSON Object. Panjang maksimum: 512 byte.

    {"key": "value"}
    OutputMediaTarget

    string

    No

    Jenis target output. Nilai yang valid:

    • oss-object: objek OSS di bucket OSS Alibaba Cloud.

    • vod-media: aset media di Alibaba Cloud VOD.

    oss-object

    Struktur data Clip

    PropertyTypeExampleDescriptionRequired
    StartTimeString2021-06-21T08:01:00ZWaktu mulai segmen klip, dalam format timestamp UTC.Yes
    EndTimeString2021-06-21T08:05:00ZWaktu akhir segmen klip, dalam format timestamp UTC.Yes
    AppNameStringappNama aplikasi tempat aliran tersebut berada. Jika parameter ini kosong, konfigurasi aliran langsung tingkat luar akan digunakan.No
    DomainNameStringdomain.comNama domain. Jika parameter ini kosong, konfigurasi aliran langsung tingkat luar akan digunakan.No
    StreamNameStringstreamNama aliran langsung. Jika parameter ini kosong, konfigurasi aliran langsung tingkat luar akan digunakan.No
    CoverTimeString2021-06-21T08:03:00ZMenentukan timestamp dalam segmen untuk digunakan sebagai gambar sampul output, dalam format timestamp UTC. Saat beberapa klip memiliki parameter CoverTime yang diatur, hanya yang pertama yang berlaku. CoverTime harus lebih besar dari atau sama dengan StartTime dan kurang dari atau sama dengan EndTime.No
    CoverUrlStringhttps://test.oss-ap-southeast-1.aliyuncs.comURL output tangkapan layar kustom. Bucket OSS harus berada di Wilayah yang sama dengan Wilayah akses layanan. Hanya bucket OSS milik sendiri yang didukung. Bucket yang dikelola VOD tidak didukung.No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons

    RequestId

    string

    ID permintaan.

    ****36-3C1E-4417-BDB2-1E034F****
    ProjectId

    string

    ID proyek live editing.

    ****fddd7748b58bf1d47e95****
    JobId

    string

    ID tugas live editing.

    ****d80e4e4044975745c14b****
    MediaId

    string

    ID aset media dari output.

    ****c469e944b5a856828dc2****
    MediaURL

    string

    URL output.

    http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4
    VodMediaId

    string

    ID aset media VOD. Parameter ini dikembalikan saat tujuan output video adalah VOD.

    ****d7578s4h75ci945c14b****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "ProjectId": "****fddd7748b58bf1d47e95****",
  "JobId": "****d80e4e4044975745c14b****",
  "MediaId": "****c469e944b5a856828dc2****",
  "MediaURL": "http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4",
  "VodMediaId": "****d7578s4h75ci945c14b****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.