Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan API Segmen Amazon Rekognition
Deteksi segmen Amazon Rekognition Video dalam video yang disimpan adalah operasi Amazon Rekognition Video yang tidak sinkron. API Segmen Amazon Rekognition adalah API komposit tempat Anda memilih tipe analisis (isyarat teknis atau deteksi sorotan) dari satu panggilan API. Untuk informasi tentang memanggil operasi yang tidak sinkron, lihat [Memanggil operasi Amazon Rekognition Video](api-video.md).
**Topics**
+ [Memulai analisis segmen](#segment-api-start)
+ [Mendapatkan hasil analisis segmen](#segment-api-get)
## Memulai analisis segmen
Untuk memulai deteksi segmen dalam video yang tersimpan panggil [StartSegmentDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartSegmentDetection.html). Parameter input yang sama seperti operasi Amazon Rekognition Video lainnya dengan penambahan seleksi tipe segmen dan pemfilteran hasil. Untuk informasi selengkapnya, lihat [Memulai analisis video](api-video.md#api-video-start).
Berikut ini adalah contoh JSON diteruskan oleh `StartSegmentDetection`. Permintaan menyatakan bahwa kedua isyarat teknis dan segmen deteksi sorotan terdeteksi. Filter yang berbeda untuk kepercayaan pendeteksian minimum diminta untuk segmen isyarat teknis (90%) dan segmen deteksi bidikan (80%).
```
{
"Video": {
"S3Object": {
"Bucket": "test_files",
"Name": "test_file.mp4"
}
"SegmentTypes":["TECHNICAL_CUES", "SHOT"]
"Filters": {
"TechnicalCueFilter": {
"MinSegmentConfidence": 90,
"BlackFrame" : {
"MaxPixelThreshold": 0.1,
"MinCoveragePercentage": 95
}
},
"ShotFilter" : {
"MinSegmentConfidence": 60
}
}
}
```
### Memilih tipe segmen
Gunakan parameter input `SegmentTypes` array untuk mendeteksi segmen deteksi cue and/or shot teknis dalam video input.
+ TECHNICAL\_CUE — mengidentifikasi stempel waktu akurat bingkai untuk awal, akhir, dan durasi isyarat teknis (bingkai hitam, bilah warna, kredit pembuka, kredit akhir, logo studio, dan konten program utama) yang terdeteksi dalam video. Misalnya, Anda dapat menggunakan isyarat teknis untuk menemukan awal kredit akhir. Untuk informasi selengkapnya, lihat [Isyarat teknis](segments.md#segment-technical-cue).
+ SHOT — Mengidentifikasi awal, akhir, dan durasi sorotan. Misalnya, Anda dapat menggunakan deteksi pengambilan citra untuk mengidentifikasi calon sorotan untuk pengeditan akhir video. Untuk informasi selengkapnya, lihat [Deteksi sorotan](segments.md#segment-shot-detection).
### Memfilter hasil analisis
Anda dapat menggunakan parameter input `Filters` ([StartSegmentDetectionFilters](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartSegmentDetectionFilters.html)) untuk menentukan kepercayaan deteksi minimum yang dikembalikan dalam respons. Dalam `Filters`, gunakan `ShotFilter` ([StartShotDetectionFilter](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartShotDetectionFilter.html)) untuk memfilter bidikan yang terdeteksi. Gunakan `TechnicalCueFilter` ([StartTechnicalCueDetectionFilter](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartTechnicalCueDetectionFilter.html)) untuk memfilter isyarat teknis.
Untuk kode sampel, lihat [Contoh: Mendeteksi segmen dalam video yang tersimpan](segment-example.md).
## Mendapatkan hasil analisis segmen
Amazon Rekognition Video menerbitkan status penyelesaian analisis video ke topik Amazon Simple Notification Service. Jika analisis video berhasil, hubungi [GetSegmentDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetSegmentDetection.html)untuk mendapatkan hasil analisis video.
Berikut ini adalah contoh permintaan `GetSegmentDetection`. `JobId` adalah pengenal tugas yang dikembalikan dari panggilan ke `StartSegmentDetection`. Untuk informasi tentang mengatur parameter, lihat [Mendapatkan hasil analisis Amazon Rekognition Video](api-video.md#api-video-get).
```
{
"JobId": "270c1cc5e1d0ea2fbc59d97cb69a72a5495da75851976b14a1784ca90fc180e3",
"MaxResults": 10,
"NextToken": "XfXnZKiyMOGDhzBzYUhS5puM+g1IgezqFeYpv/H/+5noP/LmM57FitUAwSQ5D6G4AB/PNwolrw=="
}
```
`GetSegmentDetection` memberikan hasil untuk analisis yang diminta dan informasi umum tentang video yang disimpan.
### Informasi umum
`GetSegmentDection` mengembalikan informasi umum berikut.
+ **Informasi audio** — Respons meliputi metadata audio dalam array, `AudioMetadata`, dari objek [AudioMetadata](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_AudioMetadata.html). Ada beberapa aliran audio. Setiap objek `AudioMetadata` berisi metadata untuk aliran audio tunggal. Informasi audio di objek `AudioMetadata` termasuk codec audio, jumlah saluran audio, durasi pengaliran audio, dan laju sampel. Metadata audio dikembalikan di setiap halaman informasi yang dikembalikan oleh `GetSegmentDetection`.
+ **Informasi video** — Saat ini, Amazon Rekognition Video mengembalikan satu objek [VideoMetadata](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_VideoMetadata.html) di array `VideoMetadata`. Objek berisi informasi tentang pengaliran video dalam file input yang Amazon Rekognition Video pilih untuk dianalisis. Objek `VideoMetadata` mancakup codec video, format video dan informasi lainnya. Metadata video dikembalikan di setiap halaman informasi yang dikembalikan oleh `GetSegmentDetection`.
+ **Informasi halaman** — Contoh tersebut menunjukkan satu halaman informasi segmen. Anda dapat menentukan berapa banyak elemen yang bisa dikembalikan dalam parameter input `MaxResults` untuk `GetSegmentDetection`. Jika hasilnya lebih dari `MaxResults`, `GetSegmentDetection` mengembalikan sebuah token (`NextToken`) yang digunakan untuk mendapatkan halaman hasil berikutnya. Untuk informasi selengkapnya, lihat [Mendapatkan hasil analisis Amazon Rekognition Video](api-video.md#api-video-get).
+ **Meminta informasi** — tipe analisis yang diminta dalam panggilan ke `StartSegmentDetection` dikembalikan dalam bidang `SelectedSegmentTypes`.
### Segmen
Petunjuk teknis dan informasi sorotan terdeteksi dalam video dikembalikan dalam array, `Segments`, dari objek [SegmentDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_SegmentDetection.html). Array diurutkan berdasarkan tipe segmen (TECHNICAL\_CUE atau SHOT) yang ditentukan dalam parameter input `SegmentTypes` dari `StartSegmentDetection`. Dalam setiap tipe segmen, array diurutkan berdasarkan nilai-nilai timestamp. Setiap objek `SegmentDetection` meliputi informasi tentang tipe segmen yang terdeteksi (isyarat Teknis atau deteksi sorotan) dan informasi umum, seperti waktu mulai, waktu akhir, dan durasi segmen.
Informasi waktu dikembalikan dalam tiga format.
+
**Milidetik**
Jumlah milidetik sejak awal video. Format bidang `DurationMillis`, `StartTimestampMillis`, dan `EndTimestampMillis` adalah milidetik.
+
**Timecode**
Format Amazon Rekognition Video timecodes adalah [SMPTE](https://en.wikipedia.org/wiki/SMPTE_timecode) yang memungkinkan setiap frame video memiliki nilai kode waktu yang unik. Formatnya adalah *jj:mm:dd:bingkai*. Misalnya, nilai kode waktu 01:05:40:07, akan dibaca sebagai satu jam, lima menit, empat puluh detik dan tujuh frame. Kasus penggunaan kecepatan [frame yang menurun](https://en.wikipedia.org/wiki/SMPTE_timecode#Drop-frame_timecode) didukung oleh Amazon Rekognition Video. Format timecode tingkat pengurangan adalah *jj:mm:dd;bingkai*. Format bidang `DurationSMPTE`, `StartTimecodeSMPTE`, dan `EndTimecodeSMPTE` adalah timecode.
+
**Penghitung Bingkai**
Durasi setiap segmen video juga dinyatakan dengan jumlah frame. Bidang `StartFrameNumber` memberikan nomor bingkai di awal segmen video, dan `EndFrameNumber` memberikan nomor bingkai di akhir segmen video. `DurationFrames`memberikan jumlah total frame dalam segmen video. Nilai-nilai ini dihitung menggunakan indeks bingkai yang dimulai dengan 0.
Anda dapat menggunakan bidang `SegmentType` untuk menentukan tipe segmen yang dikembalikan oleh Amazon Rekognition Video.
+ **Isyarat Teknis** — bidang `TechnicalCueSegment` adalah objek [TechnicalCueSegment](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_TechnicalCueSegment.html) yang berisi kepercayaan deteksi dan tipe isyarat teknis. Jenis-jenis isyarat teknis adalah`ColorBars`,,`EndCredits`,`BlackFrames`,`OpeningCredits`, `StudioLogo``Slate`, dan`Content`.
+ **Sorotan** — bidang `ShotSegment` adalah objek [ShotSegment](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ShotSegment.html) yang berisi kepercayaan deteksi dan pengenal untuk segmen sorotan dalam video.
Berikut ini adalah contoh respons JSON dari `GetSegmentDetection`.
```
{
"SelectedSegmentTypes": [
{
"ModelVersion": "2.0",
"Type": "SHOT"
},
{
"ModelVersion": "2.0",
"Type": "TECHNICAL_CUE"
}
],
"Segments": [
{
"DurationFrames": 299,
"DurationSMPTE": "00:00:09;29",
"StartFrameNumber": 0,
"EndFrameNumber": 299,
"EndTimecodeSMPTE": "00:00:09;29",
"EndTimestampMillis": 9976,
"StartTimestampMillis": 0,
"DurationMillis": 9976,
"StartTimecodeSMPTE": "00:00:00;00",
"Type": "TECHNICAL_CUE",
"TechnicalCueSegment": {
"Confidence": 90.45006561279297,
"Type": "BlackFrames"
}
},
{
"DurationFrames": 150,
"DurationSMPTE": "00:00:05;00",
"StartFrameNumber": 299,
"EndFrameNumber": 449,
"EndTimecodeSMPTE": "00:00:14;29",
"EndTimestampMillis": 14981,
"StartTimestampMillis": 9976,
"DurationMillis": 5005,
"StartTimecodeSMPTE": "00:00:09;29",
"Type": "TECHNICAL_CUE",
"TechnicalCueSegment": {
"Confidence": 100.0,
"Type": "Content"
}
},
{
"DurationFrames": 299,
"ShotSegment": {
"Index": 0,
"Confidence": 99.9982681274414
},
"DurationSMPTE": "00:00:09;29",
"StartFrameNumber": 0,
"EndFrameNumber": 299,
"EndTimecodeSMPTE": "00:00:09;29",
"EndTimestampMillis": 9976,
"StartTimestampMillis": 0,
"DurationMillis": 9976,
"StartTimecodeSMPTE": "00:00:00;00",
"Type": "SHOT"
},
{
"DurationFrames": 149,
"ShotSegment": {
"Index": 1,
"Confidence": 99.9982681274414
},
"DurationSMPTE": "00:00:04;29",
"StartFrameNumber": 300,
"EndFrameNumber": 449,
"EndTimecodeSMPTE": "00:00:14;29",
"EndTimestampMillis": 14981,
"StartTimestampMillis": 10010,
"DurationMillis": 4971,
"StartTimecodeSMPTE": "00:00:10;00",
"Type": "SHOT"
}
],
"JobStatus": "SUCCEEDED",
"VideoMetadata": [
{
"Format": "QuickTime / MOV",
"FrameRate": 29.970029830932617,
"Codec": "h264",
"DurationMillis": 15015,
"FrameHeight": 1080,
"FrameWidth": 1920,
"ColorRange": "LIMITED"
}
],
"AudioMetadata": [
{
"NumberOfChannels": 1,
"SampleRate": 48000,
"Codec": "aac",
"DurationMillis": 15007
}
]
}
```
Untuk kode sampel, lihat [Contoh: Mendeteksi segmen dalam video yang tersimpan](segment-example.md).