GetClip - Amazon Kinesis Video Streams
Sintaks PermintaanURIParameter PermintaanIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

GetClip

Mengunduh MP4 file (klip) yang berisi media yang diarsipkan dan sesuai permintaan dari aliran video yang ditentukan selama rentang waktu yang ditentukan.

ARNParameter Stream StreamName dan Stream bersifat opsional, tetapi Anda harus menentukan StreamName atau Stream ARN saat menjalankan API operasi ini.

catatan

Anda harus terlebih dahulu memanggil GetDataEndpoint API untuk mendapatkan titik akhir. Kemudian kirim GetClip permintaan ke titik akhir ini menggunakan parameter --endpoint-url.

Aliran video Amazon Kinesis memiliki persyaratan berikut untuk menyediakan data melalui: MP4

Anda dapat memantau jumlah data keluar dengan memantau CloudWatch metrik GetClip.OutgoingBytes Amazon. Untuk informasi tentang penggunaan CloudWatch untuk memantau Kinesis Video Streams, lihat Memantau Kinesis Video Streams. Untuk informasi harga, lihat Harga dan Harga Amazon Kinesis Video Streams AWS . Biaya untuk AWS data keluar berlaku.

penting

Data pribadi codec (CPD) yang terkandung dalam setiap fragmen berisi informasi inisialisasi khusus codec, seperti frame rate, resolusi, dan profil pengkodean, yang diperlukan untuk memecahkan kode fragmen dengan benar. CPDperubahan tidak didukung antara fragmen target dari klip yang dihasilkan. CPDHarus tetap konsisten melalui media yang ditanyakan, jika tidak kesalahan akan dikembalikan.

penting

Perubahan trek tidak didukung. Trek harus tetap konsisten di seluruh media yang ditanyakan. Kesalahan dikembalikan jika fragmen dalam aliran berubah dari hanya memiliki video menjadi audio dan video, atau jika trek AAC audio diubah menjadi trek audio A-Law.

Sintaks Permintaan

POST /getClip HTTP/1.1
Content-type: application/json

{
   "ClipFragmentSelector": { 
      "FragmentSelectorType": "string",
      "TimestampRange": { 
         "EndTimestamp": number,
         "StartTimestamp": number
      }
   },
   "StreamARN": "string",
   "StreamName": "string"
}

URIParameter Permintaan

Permintaan tidak menggunakan URI parameter apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam JSON format.

ClipFragmentSelector

Rentang waktu klip yang diminta dan sumber stempel waktu.

Tipe: Objek ClipFragmentSelector

Wajib: Ya

StreamARN

Amazon Resource Name (ARN) dari stream untuk mengambil klip media.

Anda harus menentukan salah satu StreamName atau StreamARN.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.

Pola: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Wajib: Tidak

StreamName

Nama aliran untuk mengambil klip media.

Anda harus menentukan salah satu StreamName atau StreamARN.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Pola: [a-zA-Z0-9_.-]+

Diperlukan: Tidak

Sintaksis Respons

HTTP/1.1 200
Content-Type: ContentType

Payload

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Respons mengembalikan HTTP header berikut.

ContentType

Jenis konten media dalam klip yang diminta.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: ^[a-zA-Z0-9_\.\-]+$

Respons mengembalikan yang berikut sebagai HTTP tubuh.

Payload

MP4File tradisional yang berisi klip media dari aliran video yang ditentukan. Output akan berisi 100 MB pertama atau 200 fragmen pertama dari stempel waktu awal yang ditentukan. Untuk informasi lebih lanjut, lihat kuota Kinesis Video Streams.

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

ClientLimitExceededException

Kinesis Video Streams telah membatasi permintaan karena Anda telah melampaui batas. Coba buat panggilan nanti. Untuk informasi tentang batasan, lihat Kuota Kinesis Video Streams.

HTTPKode Status: 400

InvalidArgumentException

Parameter yang ditentukan melebihi batasannya, tidak didukung, atau tidak dapat digunakan.

HTTPKode Status: 400

InvalidCodecPrivateDataException

Data pribadi codec di setidaknya salah satu trek aliran video tidak valid untuk operasi ini.

HTTPKode Status: 400

InvalidMediaFrameException

Satu atau beberapa frame dalam klip yang diminta tidak dapat diuraikan berdasarkan codec yang ditentukan.

HTTPKode Status: 400

MissingCodecPrivateDataException

Tidak ada data pribadi codec yang ditemukan di setidaknya satu trek aliran video.

HTTPKode Status: 400

NoDataRetentionException

GetImagesdiminta untuk aliran yang tidak menyimpan data (yaitu, memiliki DataRetentionInHours 0).

HTTPKode Status: 400

NotAuthorizedException

Kode Status: 403, Penelepon tidak berwenang untuk melakukan operasi pada aliran yang diberikan, atau token telah kedaluwarsa.

HTTPKode Status: 401

ResourceNotFoundException

GetImagesakan memunculkan kesalahan ini ketika Kinesis Video Streams tidak dapat menemukan aliran yang Anda tentukan.

GetHLSStreamingSessionURLdan GetDASHStreamingSessionURL membuang kesalahan ini jika sesi dengan PlaybackMode dari ON_DEMAND atau LIVE_REPLAY diminta untuk aliran yang tidak memiliki fragmen dalam rentang waktu yang diminta, atau jika sesi dengan PlaybackMode of LIVE diminta untuk aliran yang tidak memiliki fragmen dalam 30 detik terakhir.

HTTPKode Status: 404

UnsupportedStreamMediaTypeException

Jenis media (misalnya, video h.264 atau h.265 atau atau audio G.711) tidak dapat ditentukan dari codec trek di fragmen pertama untuk sesi IDs pemutaran. AAC ID codec untuk trek 1 harus V_MPEG/ISO/AVC dan, secara opsional, ID codec untuk trek 2 seharusnya. A_AAC

HTTPKode Status: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: