Gunakan BatchGetMediaInfos untuk Mengambil Detail Aset Media - Intelligent Media Services - Alibaba Cloud - Intelligent Media Services

Mengambil informasi satu atau beberapa 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:BatchGetMediaInfos

get

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
MediaIds	string	No	ID aset media yang akan dikueri, dipisahkan dengan koma.	****b48fb04483915d4f2cd8**,**c48fb37407365d4f2cd8****
AdditionType	string	No	Informasi tambahan tentang aset media yang akan dikueri. Secara default, hanya BasicInfo yang dikembalikan. Informasi file tambahan meliputi: FileInfo DynamicMetaData	FileInfo,DynamicMetaData
AuthTimeout	integer	No	Waktu kedaluwarsa otentikasi, dalam detik. Nilai minimum: 1. Nilai maksimum: 86400. Nilai default: 3600.	30

Elemen respons

Element	Type	Description	Example
	object	Skema respons.
RequestId	string	ID permintaan.	****11-DB8D-4A9A-875B-275798****
MediaInfos	array<object>	Kumpulan aset media yang cocok.
	array<object>	Kumpulan aset media yang cocok.
MediaId	string	ID aset media.	****c48fb37407365d4f2cd8****
MediaBasicInfo	object	Informasi dasar aset media.
MediaId	string	ID aset media.	****c48fb37407365d4f2cd8****
InputURL	string	URL aset media yang akan didaftarkan di sistem terkait.	https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
MediaType	string	Tipe media aset media. Nilai valid: Image Video Audio Text	video
BusinessType	string	Tipe bisnis aset media.	general
Source	string	Sumber. Nilai valid: OSS vod	oss
Title	string	Judul.	title
Description	string	Deskripsi.	description
Category	string	Kategori.	category1
MediaTags	string	Tag.	tag1, tag2
CoverURL	string	URL sampul.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	Data pengguna.	userDataTest
Snapshots	string	Snapshot.	[ "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=" ]
Status	string	Status resource.	Normal
TranscodeStatus	string	Status transkoding.	Init
CreateTime	string	Waktu pembuatan aset media. Waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (diakhiri dengan Z).	2020-12-26T04:11:10Z
ModifiedTime	string	Waktu modifikasi aset media. Waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (diakhiri dengan Z).	2020-12-26T04:11:12Z
DeletedTime	string	Waktu penghapusan aset media. Waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (diakhiri dengan Z).	2020-12-26T04:11:10Z
SpriteImages	string	Gambar sprite.	[{"bucket":"example-bucket","count":"32","iceJobId":"****83ec44d58b2069def2e**","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"**e438b14ff39293eaec25****","tileCount":"1"}]
Biz	string	Bisnis tempat aset media berada.	ICE
FileInfoList	array<object>	Daftar informasi dasar file.
	array<object>	Informasi dasar file.
FileBasicInfo	object	Informasi dasar file, termasuk durasi dan ukuran.
FileName	string	Nama file.	example
FileStatus	string	Status file.	Normal
FileType	string	Tipe file.	source_file
FileSize	string	Ukuran file dalam byte.	30611502
FileUrl	string	URL OSS file.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
Region	string	Wilayah penyimpanan file.	cn-shanghai
FormatName	string	Format kontainer.	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	Durasi.	200
Bitrate	string	Laju bit.	1132.68
Width	string	Lebar.	1920
Height	string	Tinggi.	1080
AudioStreamInfoList	array<object>	Informasi aliran audio. Aset media dapat berisi beberapa aliran audio.
	object
Index	string	Indeks aliran audio.	1
CodecName	string	Nama pendek kodek.	aac
CodecLongName	string	Nama panjang kodek.	AAC (Advanced Audio Coding)
CodecTimeBase	string	Basis waktu kodek.	1/24000
CodecTagString	string	String tag kodek.	mp4a
CodecTag	string	Tag kodek.	0x6134706d
Profile	string	Profil pengkodean.	High
SampleFmt	string	Format sampel.	fltp
SampleRate	string	Laju sampel.	44100
Channels	string	Jumlah saluran.	2
ChannelLayout	string	Tata letak saluran.	stereo
Timebase	string	Basis waktu.	1/44100
StartTime	string	Waktu mulai. Unit: detik.	0.000000
Duration	string	Durasi.	16.200998
Bitrate	string	bitrate.	127.794
Fps	string	Laju frame audio.	8
NumFrames	string	Jumlah total frame.	10
Lang	string	Bahasa.	und
VideoStreamInfoList	array<object>	Informasi aliran video. Aset media dapat memiliki beberapa aliran video.
	object
Index	string	Indeks aliran video.	0
CodecName	string	Nama pendek kodek.	h264
CodecLongName	string	Nama panjang kodek.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile	string	Profil pengkodean.	High
CodecTimeBase	string	Basis waktu kodek.	1/48
CodecTagString	string	String tag kodek.	[0][0][0][0]
CodecTag	string	Tag kodek.	0x0000
Width	string	Lebar.	960
Height	string	Tinggi.	540
HasBFrames	string	Apakah aliran video berisi B-frame.	2
Sar	string	Rasio aspek sampel.	0:1
Dar	string	Rasio aspek tampilan.	0:1
PixFmt	string	Format piksel.	yuv420p
Level	string	Tingkat pengkodean.	30
Fps	string	Laju frame video.	24.0
AvgFPS	string	Laju frame rata-rata.	24.0
Timebase	string	Basis waktu.	1/12288
StartTime	string	Waktu mulai. Unit: detik.	0.081706
Duration	string	Durasi.	216.206706
Bitrate	string	bitrate.	1001.594
NumFrames	string	Jumlah total frame.	5184
Lang	string	Bahasa.	und
Rotate	string	Rotasi.	0
Nb_frames	string	Jumlah total frame.	5184
SubtitleStreamInfoList	array<object>	Informasi aliran subtitle. Aset media dapat memiliki beberapa aliran subtitle.
	object
Index	string	Indeks aliran audio.	1
CodecName	string	Nama pendek kodek.	srt
CodecLongName	string	Nama panjang kodek.	SubRip Text
CodecTimeBase	string	Basis waktu kodek.	29.97
CodecTagString	string	String tag kodek.	unicode
CodecTag	string	Tag kodek.	unicode
Timebase	string	Basis waktu.	30
StartTime	string	Waktu mulai. Unit: detik.	0
Duration	string	Durasi.	1
Lang	string	Bahasa.	und
MediaDynamicInfo	object	Jenis aset media.
DynamicMetaData	object	Jenis. Nilai valid: ai: Data AI yang diproses dari hasil AI asli. user-defined: Metadata yang ditentukan pengguna. system: Metadata yang disediakan sistem.
Data	string	Jenis aset media.	system
IgnoredList	array	Daftar informasi aset media yang gagal diambil.
	string	Informasi aset media.	**20b48fb04483915d4f2cd8ac**

Contoh

Respons sukses

JSONformat

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaInfos": [
    {
      "MediaId": "******c48fb37407365d4f2cd8******",
      "MediaBasicInfo": {
        "MediaId": "******c48fb37407365d4f2cd8******",
        "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
        "MediaType": "video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "title",
        "Description": "description",
        "Category": "category1",
        "MediaTags": "tag1, tag2",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userDataTest",
        "Snapshots": "[\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\"\n]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-26T04:11:10Z",
        "ModifiedTime": "2020-12-26T04:11:12Z",
        "DeletedTime": "2020-12-26T04:11:10Z",
        "SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
        "Biz": "ICE"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example",
            "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": "200",
            "Bitrate": "1132.68",
            "Width": "1920",
            "Height": "1080"
          },
          "AudioStreamInfoList": [
            {
              "Index": "1",
              "CodecName": "aac",
              "CodecLongName": "AAC (Advanced Audio Coding)",
              "CodecTimeBase": "1/24000",
              "CodecTagString": "mp4a",
              "CodecTag": "0x6134706d",
              "Profile": "High",
              "SampleFmt": "fltp",
              "SampleRate": "44100",
              "Channels": "2",
              "ChannelLayout": "stereo",
              "Timebase": "1/44100",
              "StartTime": "0.000000",
              "Duration": "16.200998",
              "Bitrate": "127.794",
              "Fps": "8",
              "NumFrames": "10",
              "Lang": "und"
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "0",
              "CodecName": "h264",
              "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
              "Profile": "High",
              "CodecTimeBase": "1/48",
              "CodecTagString": "[0][0][0][0]",
              "CodecTag": "0x0000",
              "Width": "960",
              "Height": "540",
              "HasBFrames": "2",
              "Sar": "0:1",
              "Dar": "0:1",
              "PixFmt": "yuv420p",
              "Level": "30",
              "Fps": "24.0",
              "AvgFPS": "24.0",
              "Timebase": "1/12288",
              "StartTime": "0.081706",
              "Duration": "216.206706",
              "Bitrate": "1001.594",
              "NumFrames": "5184",
              "Lang": "und",
              "Rotate": "0",
              "Nb_frames": "5184"
            }
          ],
          "SubtitleStreamInfoList": [
            {
              "Index": "1",
              "CodecName": "srt",
              "CodecLongName": "SubRip Text",
              "CodecTimeBase": "29.97",
              "CodecTagString": "unicode",
              "CodecTag": "unicode",
              "Timebase": "30",
              "StartTime": "0",
              "Duration": "1",
              "Lang": "und"
            }
          ]
        }
      ],
      "MediaDynamicInfo": {
        "DynamicMetaData": {
          "Data": "system"
        }
      }
    }
  ],
  "IgnoredList": [
    "****20b48fb04483915d4f2cd8ac****"
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.