GetMezzanineInfo - ApsaraVideo VOD

Mengambil informasi file sumber audio atau video, seperti URL file, resolusi, dan bitrate.

Deskripsi operasi

Informasi lengkap mengenai file sumber tersedia setelah aliran video atau audio selesai ditranskode.

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

vod:GetMezzanineInfo

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
VideoId	string	No	ID file audio atau video. Dapatkan ID dengan salah satu cara berikut: Untuk file audio atau video yang diunggah ke Konsol: Masuk ke Konsol VOD. Di panel navigasi, pilih Media Library > Audio/Video untuk melihat ID video. Saat Anda mendapatkan URL unggah dan kredensial dengan memanggil operasi CreateUploadVideo, ID audio/video adalah nilai parameter `VideoId` dalam respons. Setelah video diunggah, panggil operasi SearchMedia untuk menanyakan ID audio/video. ID tersebut adalah nilai parameter `VideoId` dalam respons.	1f1a6fc03ca04814031b8a6559e****
AuthTimeout	integer	No	Waktu kedaluwarsa URL yang ditandatangani untuk file sumber (`FileURL`). Satuan: detik. Nilai default adalah 3600. Nilai minimum adalah 1. Jika `OutputType` diatur ke cdn: `FileURL` hanya kedaluwarsa jika Penandatanganan URL diaktifkan. Jika tidak, URL berlaku permanen. Nilai minimum: 1. Nilai maksimum: tidak terbatas. Nilai default: 3600. Jika `OutputType` diatur ke oss: `FileURL` hanya kedaluwarsa jika izin penyimpanan diatur ke private. Jika tidak, URL berlaku permanen. Nilai minimum: 1. Nilai maksimum: Untuk mengurangi risiko keamanan pada origin, nilai maksimum adalah 2592000 (30 hari) jika file audio atau video disimpan di bucket VOD. Nilai maksimum adalah 129600 (36 jam) jika file audio atau video disimpan di bucket OSS Anda sendiri. Nilai default: 3600.	3600
OutputType	string	No	Tipe URL output. Nilai yang valid: oss: URL origin. cdn (default): URL akselerasi. Catatan Jika tipe bucket file sumber adalah `in`, hanya URL OSS yang dikembalikan.	oss
AdditionType	string	No	Tipe informasi tambahan. Pisahkan beberapa tipe dengan koma (,). Secara default, hanya informasi dasar yang dikembalikan. Nilai yang valid: video: informasi aliran video. audio: informasi aliran audio.	video
ReferenceId	string	No	ID kustom. ID hanya boleh berisi huruf kecil, huruf besar, angka, tanda hubung (-), dan garis bawah (_). Panjang ID harus antara 6 hingga 64 karakter dan unik untuk setiap pengguna.	123-123

Elemen respons

Element	Type	Description	Example
	object	Respons yang dikembalikan.
RequestId	string	ID permintaan.	25818875-5F78-4AF6-D7393642CA58****
Mezzanine	object	Informasi file.
CreationTime	string	Waktu pembuatan file. Waktu dalam format UTC yyyy-MM-ddTHH:mm:ssZ.	2017-11-14T09:15:50Z
Status	string	Status file. Nilai yang valid: Uploading: Status awal file, yang menunjukkan bahwa file sedang diunggah. Normal: File telah diunggah. UploadFail: Pengunggahan file gagal. Deleted: File telah dihapus.	Normal
FileURL	string	URL file sumber.	http://example-bucket-**.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1**.mp4
VideoId	string	ID video.	1f1a6fc03ca04814031b8a6559e****
Height	integer	Tinggi file. Satuan: piksel.	540
Bitrate	string	Bitrate file. Satuan: Kbps.	771.2280
FileName	string	Nama file.	27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
OutputType	string	Tipe URL output. Nilai yang valid: oss: URL origin. cdn (default): URL akselerasi. Catatan Hanya URL OSS untuk file dalam format MP4 yang didukung untuk pemutaran.	oss
PreprocessStatus	string	Status pra-pemrosesan. Nilai yang valid: UnPreprocess: Tidak ada pra-pemrosesan yang dilakukan. Preprocessing: File sedang dipra-pemroses. PreprocessSucceed: File telah selesai dipra-pemroses. PreprocessFailed: Pra-pemrosesan file gagal.	UnPreprocess
Width	integer	Lebar file. Satuan: piksel.	960
Size	integer	Ukuran file. Satuan: byte.	4096477
Duration	string	Durasi file. Satuan: detik.	42.4930
Fps	string	Laju frame file, dalam frame per detik.	25.0000
AudioStreamList	array<object>	Informasi mengenai aliran audio.
	object	Detail aliran audio.
Index	string	Nomor urut aliran audio, yang menunjukkan posisi aliran audio dalam keseluruhan aliran media.	0
Timebase	string	Dasar waktu.	0.000000
SampleFmt	string	Format pengambilan sampel.	fltp
SampleRate	string	Laju sampel.	44100
ChannelLayout	string	Tata letak saluran suara. Nilai yang valid: mono: mono. stereo: stereo.	mono
Lang	string	Bahasa.	und
CodecLongName	string	Nama panjang format encoding.	AAC (Advanced Audio Coding)
Channels	string	Jumlah saluran suara.	1
NumFrames	string	Jumlah total frame.	1
Bitrate	string	Bitrate.	62.885
CodecTagString	string	Tag format encoding.	mp4a
StartTime	string	Waktu mulai. Waktu dalam format UTC yyyy-MM-ddTHH:mm:ssZ.	2017-01-11T12:00:00Z
CodecName	string	Nama singkat format encoding.	aac
Duration	string	Durasi.	3.227574
CodecTag	string	Tag format encoding.	0x6134706d
CodecTimeBase	string	Dasar waktu codec.	1/44100
VideoStreamList	array<object>	Informasi mengenai aliran video.
	object	Detail aliran video.
Timebase	string	Dasar waktu.	0.000000
Index	string	Nomor urut aliran video, yang menunjukkan posisi aliran video dalam keseluruhan aliran media.	1
AvgFPS	string	Laju frame rata-rata.	30.0
PixFmt	string	Format piksel.	yuv420p
Lang	string	Bahasa.	und
Sar	string	Rasio aspek sampel (SAR).	0:1
Height	string	Tinggi video.	320
CodecLongName	string	Nama panjang format encoding.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
NumFrames	string	Jumlah total frame.	0
Bitrate	string	Bitrate file. Satuan: Kbps.	500
Rotate	string	Sudut rotasi video. Nilai yang valid: [0, 360).	90
CodecTagString	string	Tag format encoding.	avc1
HasBFrames	string	Menunjukkan apakah terdapat B-frame.	0
Profile	string	Profil codec.	Main
StartTime	string	Waktu mulai. Waktu dalam format UTC yyyy-MM-ddTHH:mm:ssZ.	2017-01-11T12:00:00Z
Dar	string	Rasio aspek tampilan (DAR).	0:1
CodecName	string	Nama singkat format encoding.	h264
Width	string	Lebar video.	568
Duration	string	Durasi.	3.166667
Fps	string	Laju frame tujuan.	30.0
CodecTag	string	Tag format encoding.	0x31637661
CodecTimeBase	string	Dasar waktu codec.	1/60
Level	string	Tingkat encoding.	30
HDRType	string	Tipe High Dynamic Range (HDR) dari aliran video.	HDR
StorageClass	string	Kelas penyimpanan aset media. Nilai yang valid: Standard: Standard. IA: Infrequent Access. Archive: Archive. ColdArchive: Cold Archive. SourceIA: Source Infrequent Access. SourceArchive: Source Archive. SourceColdArchive: Source Cold Archive. Changing: Kelas penyimpanan aset media sedang diubah. SourceChanging: Kelas penyimpanan file sumber sedang diubah.	Standard
RestoreStatus	string	Keadaan dipulihkan aset media. Nilai yang valid: Processing: Aset media sedang dipulihkan. Success: Aset media telah dipulihkan. Failed: Pemulihan aset media gagal.	Success
RestoreExpiration	string	Waktu kedaluwarsa aset media yang dipulihkan.	2023-03-30T10:14:14Z
FileMD5	string

Contoh

Respons sukses

JSONformat

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "Mezzanine": {
    "CreationTime": "2017-11-14T09:15:50Z",
    "Status": "Normal",
    "FileURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "VideoId": "1f1a6fc03ca04814031b8a6559e****",
    "Height": 540,
    "Bitrate": "771.2280",
    "FileName": "27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "OutputType": "oss",
    "PreprocessStatus": "UnPreprocess",
    "Width": 960,
    "Size": 4096477,
    "Duration": "42.4930",
    "Fps": "25.0000",
    "AudioStreamList": [
      {
        "Index": "0",
        "Timebase": "0.000000",
        "SampleFmt": "fltp",
        "SampleRate": "44100",
        "ChannelLayout": "mono",
        "Lang": "und",
        "CodecLongName": "AAC (Advanced Audio Coding)",
        "Channels": "1",
        "NumFrames": "1",
        "Bitrate": "62.885",
        "CodecTagString": "mp4a",
        "StartTime": "2017-01-11T12:00:00Z",
        "CodecName": "aac",
        "Duration": "3.227574",
        "CodecTag": "0x6134706d",
        "CodecTimeBase": "1/44100"
      }
    ],
    "VideoStreamList": [
      {
        "Timebase": "0.000000",
        "Index": "1",
        "AvgFPS": "30.0",
        "PixFmt": "yuv420p",
        "Lang": "und",
        "Sar": "0:1",
        "Height": "320",
        "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
        "NumFrames": "0",
        "Bitrate": "500",
        "Rotate": "90",
        "CodecTagString": "avc1",
        "HasBFrames": "0",
        "Profile": "Main",
        "StartTime": "2017-01-11T12:00:00Z",
        "Dar": "0:1",
        "CodecName": "h264",
        "Width": "568",
        "Duration": "3.166667",
        "Fps": "30.0",
        "CodecTag": "0x31637661",
        "CodecTimeBase": "1/60",
        "Level": "30",
        "HDRType": "HDR"
      }
    ],
    "StorageClass": "Standard",
    "RestoreStatus": "Success",
    "RestoreExpiration": "2023-03-30T10:14:14Z",
    "FileMD5": ""
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.