Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membaca hasil analisis video streaming
Anda dapat menggunakan Pustaka Klien Amazon Kinesis Data Streams untuk memakai hasil analisis yang dikirim ke aliran output Amazon Kinesis Data Streams. Untuk informasi selengkapnya, lihat [Membaca Data dari Aliran Data Kinesis](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html). Amazon Rekognition Video menempatkan catatan frame JSON untuk setiap frame yang dianalisis ke dalam aliran output Kinesis. Amazon Rekognition Video tidak menganalisis setiap frame yang diteruskan melalui aliran video Kinesis.
Catatan frame yang dikirim ke aliran data Kinesis berisi informasi tentang di fragmen aliran video Kinesis mana frame berada, lokasi frame berada dalam fragment, dan wajah yang dikenali dalam frame. Hal ini juga mencakup informasi status untuk pemroses aliran. Untuk informasi selengkapnya, lihat [Memahami rekam bingkai JSON pengenalan wajah Kinesis](streaming-video-kinesis-output-reference.md).
Pustaka Parser Amazon Kinesis Video Streams berisi contoh uji yang memakai hasil Amazon Rekognition Video dan mengintegrasikannya dengan aliran video Kinesis asli. Untuk informasi selengkapnya, lihat [Menampilkan hasil Rekognition dengan Kinesis Video Streams secara lokal](displaying-rekognition-results-locally.md).
Amazon Rekognition Video mengalirkan informasi analisis Amazon Rekognition Video ke aliran data Kinesis. Berikut ini adalah contoh JSON untuk satu catatan.
```
{
"InputInformation": {
"KinesisVideo": {
"StreamArn": "arn:aws:kinesisvideo:us-west-2:nnnnnnnnnnnn:stream/stream-name",
"FragmentNumber": "91343852333289682796718532614445757584843717598",
"ServerTimestamp": 1510552593.455,
"ProducerTimestamp": 1510552593.193,
"FrameOffsetInSeconds": 2
}
},
"StreamProcessorInformation": {
"Status": "RUNNING"
},
"FaceSearchResponse": [
{
"DetectedFace": {
"BoundingBox": {
"Height": 0.075,
"Width": 0.05625,
"Left": 0.428125,
"Top": 0.40833333
},
"Confidence": 99.975174,
"Landmarks": [
{
"X": 0.4452057,
"Y": 0.4395594,
"Type": "eyeLeft"
},
{
"X": 0.46340984,
"Y": 0.43744427,
"Type": "eyeRight"
},
{
"X": 0.45960626,
"Y": 0.4526856,
"Type": "nose"
},
{
"X": 0.44958648,
"Y": 0.4696949,
"Type": "mouthLeft"
},
{
"X": 0.46409217,
"Y": 0.46704912,
"Type": "mouthRight"
}
],
"Pose": {
"Pitch": 2.9691637,
"Roll": -6.8904796,
"Yaw": 23.84388
},
"Quality": {
"Brightness": 40.592964,
"Sharpness": 96.09616
}
},
"MatchedFaces": [
{
"Similarity": 88.863960,
"Face": {
"BoundingBox": {
"Height": 0.557692,
"Width": 0.749838,
"Left": 0.103426,
"Top": 0.206731
},
"FaceId": "ed1b560f-d6af-5158-989a-ff586c931545",
"Confidence": 99.999201,
"ImageId": "70e09693-2114-57e1-807c-50b6d61fa4dc",
"ExternalImageId": "matchedImage.jpeg"
}
}
]
}
]
}
```
Dalam contoh JSON, catat hal berikut:
+ **InputInformation**— Informasi tentang aliran video Kinesis yang digunakan untuk mengalirkan video ke Amazon Rekognition Video. Untuk informasi selengkapnya, lihat [InputInformation](streaming-video-kinesis-output-reference.md#streaming-video-kinesis-output-reference-inputinformation).
+ **StreamProcessorInformation**— Informasi status untuk prosesor aliran Video Rekognition Amazon. Satu-satunya nilai yang mungkin untuk bidang `Status` adalah BERJALAN. Untuk informasi selengkapnya, lihat [StreamProcessorInformation](streaming-video-kinesis-output-reference-streamprocessorinformation.md).
+ **FaceSearchResponse**— Berisi informasi tentang wajah dalam video streaming yang cocok dengan wajah dalam koleksi input. [FaceSearchResponse](streaming-video-kinesis-output-reference.md#streaming-video-kinesis-output-reference-facesearchresponse)berisi [DetectedFace](streaming-video-kinesis-output-reference.md#streaming-video-kinesis-output-reference-detectedface) objek, yang merupakan wajah yang terdeteksi dalam bingkai video yang dianalisis. Untuk setiap wajah yang terdeteksi, array `MatchedFaces` berisi array objek wajah yang cocok ([MatchedFace](streaming-video-kinesis-output-reference.md#streaming-video-kinesis-output-reference-facematch)) yang ditemukan dalam koleksi masukan, bersama dengan skor kesamaan.
## Memetakan aliran video Kinesis ke aliran data Kinesis
Anda mungkin ingin memetakan frame aliran video Kinesis ke frame yang dianalisis yang dikirim ke aliran data Kinesis. Misalnya, selama tampilan video streaming, Anda mungkin ingin menampilkan kotak-kotak di sekitar wajah orang yang dikenal. Koordinat kotak batas dikirim sebagai bagian dari Catatan Pengenal Wajah Kinesis ke aliran data Kinesis. Untuk menampilkan kotak pembatas dengan benar, Anda perlu memetakan informasi waktu yang dikirim dengan Catatan Pengenalan Wajah Kinesis dengan frame yang sesuai dalam aliran video Kinesis sumber.
Teknik yang Anda gunakan untuk memetakan aliran video Kinesis ke aliran data Kinesis tergantung pada apakah Anda sedang melakukan streaming media langsung (seperti video streaming langsung), atau jika Anda sedang melakukan streaming media yang diarsipkan (seperti video yang tersimpan).
### Pemetaan saat Anda melakukan streaming media langsung
**Untuk memetakan frame aliran video Kinesis ke frame aliran data Kinesis**
1. Atur parameter `FragmentTimeCodeType` input [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)operasi ke`RELATIVE`.
1. Panggil `PutMedia` untuk mengirimkan media langsung ke dalam aliran video Kinesis.
1. Saat Anda menerima Catatan Pengenalan Wajah Kinesis dari aliran data Kinesis, simpan nilai `ProducerTimestamp` dan `FrameOffsetInSeconds` dari bidang [KinesisVideo](streaming-video-kinesis-output-reference.md#streaming-video-kinesis-output-reference-kinesisvideostreams-kinesisvideo).
1. Hitung stempel waktu yang sesuai dengan frame aliran video Kinesis dengan menambahkan nilai bidang `ProducerTimestamp` dan `FrameOffsetInSeconds` bersama-sama.
### Pemetaan saat Anda melakukan streaming media yang diarsipkan
**Untuk memetakan frame aliran video Kinesis ke frame aliran data Kinesis**
1. Panggilan [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)untuk mengirimkan media yang diarsipkan ke dalam aliran video Kinesis.
1. Ketika Anda menerima objek `Acknowledgement` dari respons operasi `PutMedia`, simpan nilai bidang `FragmentNumber` dari bidang [Muatan](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html#API_dataplane_PutMedia_ResponseSyntax) . `FragmentNumber` adalah nomor fragmen untuk klaster MKV.
1. Saat Anda menerima Catatan Pengenalan Wajah Kinesis dari aliran data Kinesis, simpan nilai bidang `FrameOffsetInSeconds` dari bidang [KinesisVideo](streaming-video-kinesis-output-reference.md#streaming-video-kinesis-output-reference-kinesisvideostreams-kinesisvideo).
1. Hitung pemetaan dengan menggunakan nilai-nilai `FrameOffsetInSeconds` dan `FragmentNumber` yang Anda disimpan dalam langkah 2 dan 3. `FrameOffsetInSeconds` adalah offset ke dalam fragmen dengan `FragmentNumber` khusus yang dikirim ke aliran data Amazon Kinesis. Untuk informasi selengkapnya tentang mendapatkan frame video untuk nomor fragmen tertentu, lihat [Media Amazon Kinesis Video Streams yang Diarsipkan](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_Operations_Amazon_Kinesis_Video_Streams_Archived_Media.html).