Gunakan AddEditingProjectMaterials untuk menambahkan materi ke proyek pengeditan online - Layanan Media Cerdas - Alibaba Cloud - Intelligent Media Services

Menambahkan satu atau beberapa material ke proyek Pengeditan daring.

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

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ProjectId	string	Yes	ID proyek Pengeditan daring.	***b2101cb318c***
MaterialMaps	string	Yes	ID material. Pisahkan beberapa ID material dengan koma (,). Setiap tipe mendukung hingga 10 ID material. "video": video "audio": audio "image": image "liveStream": live stream "editingProject": editing project	{"video":"***2e057304fcd9b145c5cafc*", "image":"8021a8d493da643c8acd98*,*cb6307a4edea614d8b3f3c*", "liveStream": "[{\"appName\":\"testrecord\",\"domainName\":\"test.alivecdn.com\",\"liveUrl\":\"rtmp://test.alivecdn.com/testrecord/teststream\",\"streamName\":\"teststream\"}]", "editingProject": "*9b145c5cafc2e057304fcd***"}

Elemen respons

Element	Type	Description	Example
	object	Skema Respons
RequestId	string	ID permintaan.	***ACB-44F2-5F2D-88D7-1283E70***
ProjectId	string	ID proyek Pengeditan daring.	***67ae06542b9b93e0d1c387***
MediaInfos	array<object>	Kumpulan aset media yang memenuhi syarat.
	array<object>
MediaId	string	ID aset media.	***5cb2e35433198daae94a72***
MediaBasicInfo	object	Informasi dasar mengenai aset media.
MediaId	string	ID aset media.	***5cb2e35433198daae94a72***
InputURL	string	URL aset media di layanan lain.	http://bucket.oss-cn-shanghai.aliyuncs.com/file.mp4
MediaType	string	Tipe aset media.	Video
BusinessType	string	Jenis bisnis aset media.	general
Source	string	Sumber aset media.	oss
Title	string	Judul aset media.	default_title_2020-12-23T03:32:59Z
Description	string	Deskripsi aset media.	sample_description
Category	string	Kategori aset media.	audio
MediaTags	string	Tag aset media.	sample_tag
CoverURL	string	URL Gambar mini aset media.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	Data pengguna.	userData
Snapshots	string	Snapshot aset media.	null
Status	string	Status aset media. Nilai yang valid: - Init - Preparing - PrepareFail - Normal	Normal
TranscodeStatus	string	Status Transkoding aset media.	Init
CreateTime	string	Waktu saat aset media dibuat.	2020-12-23T03:32:59Z
ModifiedTime	string	Waktu terakhir aset media dimodifikasi.	2020-12-23T03:32:59Z
DeletedTime	string	Waktu saat aset media dihapus.	2020-12-23T03:32:59Z
SpriteImages	string	Sprite aset media.	http://outin-example.oss-cn-shanghai.aliyuncs.com/test.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
FileInfoList	array<object>	FileInfos
	array<object>
FileBasicInfo	object	Informasi dasar file, termasuk Durasi dan ukuran.
FileName	string	Nama file.	example.mp4
FileStatus	string	Status file. -Uploading -Normal -UploadFail -Disable -Deleted	Normal
FileType	string	Tipe file.	source_file
FileSize	string	Ukuran file. Satuan: byte.	30611502
FileUrl	string	URL Object Storage Service (OSS) file tersebut.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
Region	string	Wilayah tempat file berada.	cn-shanghai
FormatName	string	format kontainer.	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	Durasi.	216.206667
Bitrate	string	bitrate.	1132.68
Width	string	Lebar.	960
Height	string	Tinggi.	540
LiveMaterials	array<object>	Material yang terkait dengan live stream.
	object
AppName	string	Nama aplikasi live stream.	testrecord
StreamName	string	Nama aliran live stream.	teststream
DomainName	string	Nama domain live stream.	test.alivecdn.com
LiveUrl	string	URL live stream.	rtmp://test.alivecdn.com/testrecord/teststream
ProjectMaterials	array	Material yang terkait dengan proyek editing. Setelah live stream berakhir, proyek editing live akan dikaitkan dengan proyek editing standar.	***9b145c5cafc2e057304fcd***
	string	ID proyek editing standar yang dikaitkan dengan proyek editing live.	***c38767ae06542b9b93e0d1***

Contoh

Respons sukses

JSONformat

{
  "RequestId": "*****ACB-44F2-5F2D-88D7-1283E70*****",
  "ProjectId": "*****67ae06542b9b93e0d1c387*****",
  "MediaInfos": [
    {
      "MediaId": "*****5cb2e35433198daae94a72*****",
      "MediaBasicInfo": {
        "MediaId": "*****5cb2e35433198daae94a72*****",
        "InputURL": "http://bucket.oss-cn-shanghai.aliyuncs.com/file.mp4",
        "MediaType": "Video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "default_title_2020-12-23T03:32:59Z",
        "Description": "sample_description",
        "Category": "audio",
        "MediaTags": "sample_tag",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userData",
        "Snapshots": "null",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-23T03:32:59Z",
        "ModifiedTime": "2020-12-23T03:32:59Z",
        "DeletedTime": "2020-12-23T03:32:59Z",
        "SpriteImages": "http://outin-example.oss-cn-shanghai.aliyuncs.com/test.png?Expires=&OSSAccessKeyId=&Signature=&security-token="
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example.mp4",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "30611502",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "216.206667",
            "Bitrate": "1132.68",
            "Width": "960",
            "Height": "540"
          }
        }
      ]
    }
  ],
  "LiveMaterials": [
    {
      "AppName": "testrecord",
      "StreamName": "teststream",
      "DomainName": "test.alivecdn.com",
      "LiveUrl": "rtmp://test.alivecdn.com/testrecord/teststream"
    }
  ],
  "ProjectMaterials": [
    "*****c38767ae06542b9b93e0d1*****"
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParameter	The specified parameter \ is not valid.
404	ProjectNotFound	The specified project not found

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.