All Products
Search

This Product

    ApsaraVideo Live:AddCasterVideoResource

    Document Center

    ApsaraVideo Live:AddCasterVideoResource

    Last Updated:Jun 10, 2026

    Menambahkan sumber video ke studio produksi. Jumlah sumber video yang dapat Anda tambahkan dibatasi oleh jumlah endpoint ingest di studio produksi.

    Deskripsi operasi

    Before you add a video source, you must create a production studio. The number of video sources that you can add is limited by the number of ingest endpoints in the production studio. For more information about creating a production studio by calling an API operation, see Create a production studio.

    QPS limit

    This operation is limited to 10 queries per second (QPS) per user. If you exceed this limit, API calls are throttled, which can impact your business. Call this operation at a reasonable rate.

    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

    live:AddCasterVideoResource

    create

    *Caster

    acs:live:*:{#accountId}:caster/{#CasterId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    CasterId

    string

    Yes

    ID wilayah.

    LIVEPRODUCER_POST-cn-0pp1czt****
    ResourceName

    string

    Yes

    ID studio produksi.

    • Jika Anda membuat studio produksi dengan memanggil operasi CreateCaster, cari nilai CasterId di tanggapan.

    • Jika Anda membuat studio produksi di konsol ApsaraVideo Live, buka Konsol Live > Studio Produksi > Studio Produksi Cloud untuk mencari nama studio produksi.

    Catatan

    Nama studio produksi pada daftar di halaman Studio Produksi Cloud adalah ID studio produksi.

    test001
    LocationId

    string

    No

    Nama sumber video.

    RV01
    LiveStreamUrl

    string

    No

    Pengidentifikasi lokasi untuk sumber video. Parameter ini wajib diisi.

    Pengidentifikasi tersebut mereferensikan posisi video dalam tata letak. Setiap lokasi mendukung maksimum satu sumber daya. Formatnya adalah RV diikuti angka dari 01 hingga 99. Misalnya, RV01.

    rtmp://guide.aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201****?auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5****
    MaterialId

    string

    No

    URL streaming Alibaba Cloud.

    Penting

    • Parameter ini wajib diisi jika tipe sumber video adalah aliran langsung.

    • Jika tipe sumber video bukan aliran langsung, jangan sertakan parameter ini di permintaan.

    .

    f080575eb5f4427684fc0715159a****
    VodUrl

    string

    No

    ID Aset media.

    Penting Parameter ini wajib diisi dan hanya berlaku jika sumber video adalah Aset media.

    Jika Anda memanggil operasi DescribeCasterConfig untuk mengkueri konfigurasi studio produksi, Tampilan nilai parameter UrgentMaterialId di tanggapan.

    Catatan

    Nilai UrgentMaterialId adalah ID Aset media.

    http://learn.aliyundoc.com/AppName/StreamName.flv
    BeginOffset

    integer

    No

    URL file video-on-demand (VOD).

    Penting Parameter ini hanya berlaku jika sumber video adalah file yang tidak ada di Material Library.

    Catatan

    File VOD harus dalam format MP4, FLV, atau TS.

    1000
    EndOffset

    integer

    No

    Offset awal file video. Unit: milidetik.

    Penting Parameter ini hanya berlaku jika sumber video adalah file.

    Catatan

    Nilai lebih besar dari 0 menentukan offset dari frame pertama. Sistem mulai membaca file dari offset ini.

    10000
    RepeatNum

    integer

    No

    Offset akhir file video. Unit: milidetik.

    Penting Parameter ini hanya berlaku jika sumber video adalah file.

    • Nilai lebih besar dari 0 menetapkan titik akhir pembacaan pada offset dari frame pertama.

    • Nilai lebih kecil dari 0 menetapkan titik akhir pembacaan pada offset dari frame terakhir.

    0
    PtsCallbackInterval

    integer

    No

    Jumlah pengulangan video.

    Penting Parameter ini hanya berlaku jika sumber video adalah file.

    • 0 (default): Video diputar hanya sekali.

    • -1: Video diulang tanpa batas.

    2000
    FixedDelayDuration

    integer

    No

    Interval callback PTS. Unit: milidetik.

    0
    ImageId

    string

    No

    Delay tetap untuk video agar dapat menyinkronkan caption. Unit: milidetik. Nilai default: 0. Nilai valid: [0, 5000].

    a089175eb5f4427684fc0715159a****
    ImageUrl

    string

    No

    ID aset gambar.

    Catatan

    Parameter ini hanya berlaku dan wajib diisi jika tipe sumber video adalah Image.

    http://learn.aliyundoc.com/AppName/image.jpg
    ImageUrl

    string

    No

    图片素材 URL。

    Catatan

    当视频源类型为图片且图片文件未导入素材库时，本参数才可用。支持上传 jpg、png 格式图片，最大文件不可超过 10M。

    http://learn.aliyundoc.com/AppName/image.jpg
    Catatan

    Tipe sumber video ditentukan oleh tipe sumber daya pada URL streaming.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    CF60DB6A-7FD6-426E-9288-122CC1A52FA7
    ResourceId

    string

    The resource ID. Use this ID as a request parameter to delete or modify a production studio video source.

    e5542d98-b08c-46bf-83e9-5b09d08c****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7",
  "ResourceId": "e5542d98-b08c-46bf-83e9-5b09d08c****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidCasterId.Malformed %s, please check and try again later.
    400 InvalidParameter.Malformed There are invalid parameters: %s.
    400 InvalidUserId.Malformed %s, please check userId.
    400 InvalidLiveStreamUrl.Malformed %s, please check and try again later.
    400 InvalidMaterialId.Malformed %s, please check and try again later.
    400 InvalidVodUrl.Malformed %s, please check and try again later.
    400 ResourceNumberExceed %s, please check and try again later.
    400 MissingParameter %s.
    400 DuplicateLocationID %s, please check and try again later.
    400 UnexpectedLocationID %s, please check and try again later.
    401 IllegalOperation %s, please check and try again later.
    500 InternalError %s, please try again later.
    404 InvalidCaster.NotFound %s, please check and try again later.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.