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

# GetClip
<a name="API_reader_GetClip"></a>

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

Parameter StreaMarn StreamName dan parameter bersifat opsional, tetapi Anda harus menentukan salah satu StreamName atau StreaMarn saat menjalankan operasi API 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](https://docs.aws.amazon.com/cli/latest/reference/). 

Aliran video Amazon Kinesis memiliki persyaratan berikut untuk menyediakan data melalui: MP4
+  [Persyaratan trek pemutaran video](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html).
+ Retensi data harus lebih besar dari 0.
+ Trek video dari setiap fragmen harus berisi data pribadi codec dalam Advanced Video Coding (AVC) untuk format H.264 dan HEVC untuk format H.265. Untuk informasi lebih lanjut, lihat spesifikasi [MPEG-4](https://www.iso.org/standard/55980.html) 14496-15. ISO/IEC Untuk informasi tentang mengadaptasi data aliran ke format tertentu, lihat [Bendera Adaptasi NAL](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html).
+ [Track audio (jika ada) dari setiap fragmen harus berisi data pribadi codec dalam format AAC ([spesifikasi AAC ISO/IEC 13818-7](https://www.iso.org/standard/43345.html)) atau format MS Wave.](https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html)

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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html) Streams. [Untuk informasi harga, lihat Harga dan Harga [Amazon Kinesis Video](https://aws.amazon.com/kinesis/video-streams/pricing/) Streams AWS .](https://aws.amazon.com/pricing/) 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. Perubahan CPD tidak didukung antara fragmen target dari klip yang dihasilkan. CPD harus 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 audio AAC diubah menjadi trek audio A-Law.

## Minta Sintaks
<a name="API_reader_GetClip_RequestSyntax"></a>

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

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

## Parameter Permintaan URI
<a name="API_reader_GetClip_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_reader_GetClip_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [ClipFragmentSelector](#API_reader_GetClip_RequestSyntax) **   <a name="KinesisVideo-reader_GetClip-request-ClipFragmentSelector"></a>
Rentang waktu klip yang diminta dan sumber stempel waktu.  
Tipe: Objek [ClipFragmentSelector](API_reader_ClipFragmentSelector.md)  
Wajib: Ya

 ** [StreamARN](#API_reader_GetClip_RequestSyntax) **   <a name="KinesisVideo-reader_GetClip-request-StreamARN"></a>
Nama Sumber Daya Amazon (ARN) dari aliran 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](#API_reader_GetClip_RequestSyntax) **   <a name="KinesisVideo-reader_GetClip-request-StreamName"></a>
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
<a name="API_reader_GetClip_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: ContentType

Payload
```

## Elemen Respons
<a name="API_reader_GetClip_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Respons mengembalikan header HTTP berikut.

 ** [ContentType](#API_reader_GetClip_ResponseSyntax) **   <a name="KinesisVideo-reader_GetClip-response-ContentType"></a>
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 isi HTTP.

 ** [Payload](#API_reader_GetClip_ResponseSyntax) **   <a name="KinesisVideo-reader_GetClip-response-Payload"></a>
 MP4 File 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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). 

## Kesalahan
<a name="API_reader_GetClip_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** 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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html).  
Kode Status HTTP: 400

 ** InvalidArgumentException **   
Parameter yang ditentukan melebihi batasannya, tidak didukung, atau tidak dapat digunakan.  
Kode Status HTTP: 400

 ** InvalidCodecPrivateDataException **   
Data pribadi codec di setidaknya salah satu trek aliran video tidak valid untuk operasi ini.  
Kode Status HTTP: 400

 ** InvalidMediaFrameException **   
Satu atau beberapa frame dalam klip yang diminta tidak dapat diuraikan berdasarkan codec yang ditentukan.  
Kode Status HTTP: 400

 ** MissingCodecPrivateDataException **   
Tidak ada data pribadi codec yang ditemukan di setidaknya satu trek aliran video.  
Kode Status HTTP: 400

 ** NoDataRetentionException **   
 `GetImages`diminta untuk aliran yang tidak menyimpan data (yaitu, memiliki `DataRetentionInHours` 0).   
Kode Status HTTP: 400

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

 ** ResourceNotFoundException **   
 `GetImages`akan memunculkan kesalahan ini ketika Kinesis Video Streams tidak dapat menemukan aliran yang Anda tentukan.  
 `GetHLSStreamingSessionURL`dan `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.  
Kode Status HTTP: 404

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

## Lihat Juga
<a name="API_reader_GetClip_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetClip) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetClip) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetClip) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetClip) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetClip) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetClip) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetClip) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetClip) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetClip) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetClip)