Gunakan GetMezzanineInfo untuk mengambil informasi file sumber audio dan video - ApsaraVideo VOD - Alibaba Cloud - ApsaraVideo VOD

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

Deskripsi operasi

Informasi lengkap untuk file sumber tersedia setelah aliran video atau audio 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 memperoleh URL unggahan dan kredensial dengan memanggil operasi CreateUploadVideo, ID audio/video adalah nilai parameter `VideoId` dalam respons. Setelah video diunggah, panggil operasi SearchMedia untuk meng-query ID audio/video. ID adalah nilai parameter `VideoId` dalam respons.	1f1a6fc03ca04814031b8a6559e****
AuthTimeout	integer	No	Waktu kedaluwarsa URL bertanda tangan untuk file sumber (`FileURL`). Satuan: detik. Nilai default adalah 3600. Nilai minimum adalah 1. Jika `OutputType` diatur ke cdn: `FileURL` kedaluwarsa hanya jika penandatanganan URL diaktifkan. Jika tidak, URL berlaku secara permanen. Nilai minimum: 1. Nilai maksimum: tidak terbatas. Nilai default: 3600. Jika `OutputType` diatur ke oss: `FileURL` kedaluwarsa hanya jika izin penyimpanan diatur ke privat. Jika tidak, URL berlaku secara permanen. Nilai minimum: 1. Nilai maksimum: Untuk mengurangi risiko keamanan di origin, nilai maksimum adalah 2592000 (30 hari) jika file audio atau video disimpan dalam bucket VOD. Nilai maksimum adalah 129600 (36 jam) jika file audio atau video disimpan dalam bucket OSS Anda sendiri. Nilai default: 3600.	3600
OutputType	string	No	Tipe URL output. Nilai valid: oss: URL origin. cdn (default): URL yang dipercepat. 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 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 (_). ID harus memiliki panjang 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 saat file dibuat. Waktu dalam format yyyy-MM-ddTHH:mm:ssZ dalam UTC.	2017-11-14T09:15:50Z
Status	string	Status file. Nilai valid: Uploading: Keadaan awal file, yang menunjukkan bahwa file sedang diunggah. Normal: File telah diunggah. UploadFail: File gagal diunggah. 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 valid: oss: URL origin. cdn (default): URL yang dipercepat. Catatan Hanya URL OSS untuk file dalam format MP4 yang didukung untuk pemutaran.	oss
PreprocessStatus	string	Status pra-pemrosesan. Nilai valid: UnPreprocess: Tidak ada pra-pemrosesan yang dilakukan. Preprocessing: File sedang dalam pra-pemrosesan. PreprocessSucceed: File telah dipra-proses. PreprocessFailed: File gagal dipra-proses.	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	Frame rate file, dalam frame per detik.	25.0000
AudioStreamList	array<object>	Informasi tentang aliran audio.
	object	Detail aliran audio.
Index	string	The ordinal number of the audio stream, which indicates the position of the audio stream in the entire media stream.	0
Timebase	string	The time base.	0.000000
SampleFmt	string	The sampling format.	fltp
SampleRate	string	The sample rate.	44100
ChannelLayout	string	The sound channel layout. Valid values: mono: mono. stereo: stereo.	mono
Lang	string	The language.	und
CodecLongName	string	The long name of the encoding format.	AAC (Advanced Audio Coding)
Channels	string	The number of sound channels.	1
NumFrames	string	The total number of frames.	1
Bitrate	string	The bitrate.	62.885
CodecTagString	string	The tag of the encoding format.	mp4a
StartTime	string	The start time. The time is in the yyyy-MM-ddTHH:mm:ssZ format in UTC.	2017-01-11T12:00:00Z
CodecName	string	The short name of the encoding format.	aac
Duration	string	The duration.	3.227574
CodecTag	string	The tag of the encoding format.	0x6134706d
CodecTimeBase	string	The codec time base.	1/44100
VideoStreamList	array<object>	Informasi tentang aliran video.
	object	Detail aliran video.
Timebase	string	The time base.	0.000000
Index	string	The ordinal number of the video stream, which indicates the position of the video stream in the entire media stream.	1
AvgFPS	string	The average frame rate.	30.0
PixFmt	string	The pixel format.	yuv420p
Lang	string	The language.	und
Sar	string	The sample aspect ratio (SAR).	0:1
Height	string	The height of the video.	320
CodecLongName	string	The long name of the encoding format.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
NumFrames	string	The total number of frames.	0
Bitrate	string	The bitrate of the file. Unit: Kbps.	500
Rotate	string	The rotation angle of the video. Valid values: [0, 360).	90
CodecTagString	string	The tag of the encoding format.	avc1
HasBFrames	string	Indicates whether B-frames exist.	0
Profile	string	The codec profile.	Main
StartTime	string	The start time. The time is in the yyyy-MM-ddTHH:mm:ssZ format in UTC.	2017-01-11T12:00:00Z
Dar	string	The display aspect ratio (DAR).	0:1
CodecName	string	The short name of the encoding format.	h264
Width	string	The width of the video.	568
Duration	string	The duration.	3.166667
Fps	string	The destination frame rate.	30.0
CodecTag	string	The tag of the encoding format.	0x31637661
CodecTimeBase	string	The codec time base.	1/60
Level	string	The encoding level.	30
HDRType	string	The High Dynamic Range (HDR) type of the video stream.	HDR
StorageClass	string	Kelas penyimpanan aset media. Nilai 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	Status pemulihan aset media. Nilai valid: Processing: Aset media sedang dipulihkan. Success: Aset media telah dipulihkan. Failed: Aset media gagal dipulihkan.	Success
RestoreExpiration	string	Waktu kedaluwarsa aset media yang telah 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.