Daftarkan aset media - Intelligent Media Services - Alibaba Cloud - Intelligent Media Services

Memulai tugas pendaftaran aset media dan menetapkan IMS mediaId baru ke aset media. Berdasarkan InputURL, operasi ini secara asinkron memanggil layanan informasi aset media lainnya untuk mengambil informasi file tentang aset media. Anda juga dapat mengatur informasi dasar seperti judul, tag, dan deskripsi. Operasi ini mengembalikan mediaId secara sinkron. Anda dapat memanggil operasi GetMediaInfo untuk mengambil informasi detail aset media. Saat ini, hanya file OSS dan aset media VOD yang didukung sebagai nilai InputURL.

Deskripsi operasi

Pendaftaran aset media adalah tugas asinkron yang biasanya membutuhkan waktu 2 hingga 3 detik untuk selesai. Ketika operasi pendaftaran mengembalikan mediaId, aset media mungkin belum sepenuhnya terdaftar. Dalam hal ini, memanggil GetMediaInfo mungkin tidak mengembalikan informasi file dari aset media.

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

create

*Semua resource.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InputURL	string	Yes	URL aset media yang akan didaftarkan dalam sistem yang sesuai. Setelah terdaftar, URL ini tidak dapat diubah dan dilampirkan pada IMS mediaId. URL OSS. Dua format didukung: http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 oss://example-bucket/example.mp4 (Format ini mengasumsikan secara default bahwa wilayah OSS sama dengan area pendaftaran layanan.) Aset media VOD: vod://*20b48fb04483915d4f2cd8ac**	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 atau vod://**20b48fb04483915d4f2cd8ac**
MediaType	string	No	Tipe media dari aset media. Nilai valid: image video audio text Ketika nilainya adalah "text", businessType harus diatur ke "subtitles" atau "font". Tentukan bidang ini sesuai kebutuhan. Ketika bidang InputURL adalah URL OSS, tipe media juga dapat ditentukan secara otomatis berdasarkan ekstensi nama file (hanya untuk ekstensi file gambar, video, dan audio). Untuk pemetaan antara ekstensi file dan tipe media, lihat Format file.	video.
BusinessType	string	No	Tipe bisnis dari aset media. Nilai valid: subtitles font watermark opening ending general	opening.
Title	string	No	Judul. Jika tidak disediakan, judul default dibuat secara otomatis berdasarkan tanggal. Panjang maksimum: 128 byte. Dikodekan UTF-8.	defaultTitle.
Description	string	No	Deskripsi konten. Panjang maksimum: 1024 byte. Dikodekan UTF-8.	defaultDescription.
MediaTags	string	No	Tag. Jumlah tag maksimum: 16. Pisahkan beberapa tag dengan koma. Panjang maksimum satu tag: 32 byte. Dikodekan UTF-8.	tag1,tag2
CoverURL	string	No	URL gambar sampul. Panjang maksimum: 128 byte. Dikodekan UTF-8.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png.
UserData	string	No	Data pengguna. Konfigurasi URL callback kustom didukung. Untuk instruksi konfigurasi, lihat Mengonfigurasi callback setelah pengeditan selesai. Panjang maksimum: 1024 byte. Dikodekan UTF-8. Format Json.	{"NotifyAddress":"http://xx.xx.xxx"} atau {"NotifyAddress":"https://xx.xx.xxx"} atau {"NotifyAddress":"ice-callback-demo"}
Overwrite	boolean	No	Apakah akan menimpa aset media yang sudah terdaftar. Nilai default: false. true: Jika inputUrl sudah terdaftar, aset media yang ada dihapus dan aset media baru didaftarkan. false: Jika inputUrl sudah terdaftar, aset media baru tidak didaftarkan. Nilai inputUrl duplikat tidak didukung.	true.
ClientToken	string	No	Token klien. UUID 32 karakter yang memastikan idempotensi permintaan.	**0311a423d11a5f7dee713535**
RegisterConfig	string	No	Konfigurasi pendaftaran. Secara default, gambar sprite dihasilkan untuk aset media. Untuk menonaktifkannya, atur bidang NeedSprite ke false. Secara default, snapshot dihasilkan. Untuk menonaktifkannya, atur bidang NeedSnapshot ke false. Untuk menentukan pengatur waktu untuk gambar sampul, konfigurasikan CoverConfig, yang berisi bidang berikut: StartTime: Waktu dalam detik saat gambar sampul diambil dari aset media. Hingga empat tempat desimal didukung. Setelah pendaftaran aset media, untuk mengimpor aset media ke perpustakaan pencarian kustom, konfigurasikan SearchLibName. Untuk informasi tentang cara membuat dan menggunakan perpustakaan pencarian kustom, lihat Menggunakan perpustakaan pencarian kustom.	{ "NeedSprite": "false", "CoverConfig": { "StartTime": 1.0 }, "SearchLibName": "test" }
CateId	integer	No	ID kategori.	3048
WorkflowId	string	No	ID alur kerja.	****b4fb044839815d4f2cd8****
ReferenceId	string	No	ID kustom. Hanya huruf kecil, huruf besar, angka, tanda hubung (-), dan garis bawah (_) yang didukung. Panjangnya harus 6 hingga 64 karakter. ID harus unik untuk setiap pengguna.	123-123
SmartTagTemplateId	string	No	Templat tagging cerdas. Nilai valid: S00000101-300080: Templat sistem yang mencakup pemahaman konten NLP. S00000103-000001: Templat sistem yang mencakup pemahaman konten NLP dan semua kemampuan tagging. S00000103-000002: Templat sistem yang mencakup semua kemampuan tagging tetapi tidak mencakup pemahaman konten NLP. Untuk informasi lebih lanjut tentang kemampuan tagging, lihat dokumentasi. Setelah bidang ini dikonfigurasi, tugas analisis tagging cerdas secara otomatis dimulai upon pendaftaran aset media. Untuk informasi penagihan, lihat Penagihan Smart Tag Edisi Standar.	S00000101-300080

Elemen respons

Element	Type	Description	Example
	object	Skema respons.
RequestId	string	ID permintaan.	****5A-CAAC-4850-A3AF-B74606****
MediaId	string	ID aset media IMS.	****b48fb04483915d4f2cd8****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "******5A-CAAC-4850-A3AF-B74606******",
  "MediaId": "******b48fb04483915d4f2cd8******"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
403	Forbidden	User not authorized to operate on the specified resource.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.