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.

Memulai analisis segmen

Untuk memulai deteksi segmen dalam panggilan video yang disimpan StartSegmentDetection. 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.

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 array SegmentTypes untuk mendeteksi isyarat teknis dan/atau segmen deteksi sorotan 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.

• 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.

Memfilter hasil analisis

Anda dapat menggunakan parameter input Filters (StartSegmentDetectionFilters) untuk menentukan kepercayaan deteksi minimum yang dikembalikan dalam respons. Di dalamFilters, gunakan ShotFilter (StartShotDetectionFilter) untuk memfilter bidikan yang terdeteksi. Gunakan TechnicalCueFilter (StartTechnicalCueDetectionFilter) untuk memfilter isyarat teknis.

Untuk kode sampel, lihat Contoh: Mendeteksi segmen dalam video yang tersimpan.

Mendapatkan hasil analisis segmen

Amazon Rekognition Video menerbitkan status penyelesaian analisis video ke topik Amazon Simple Notification Service. Jika analisis video berhasil, hubungi GetSegmentDetectionuntuk 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.

{
    "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 mencakup metadata audio dalam array,AudioMetadata, objek. AudioMetadata Ada beberapa pengaliran 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 VideoMetadataobjek dalam array. VideoMetadata Objek berisi informasi tentang pengaliran video dalam file input yang dipilih Amazon Rekognition Video 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.

• Meminta informasi — tipe analisis yang diminta dalam panggilan ke StartSegmentDetection dikembalikan dalam bidang SelectedSegmentTypes.

Segmen

Isyarat teknis dan informasi bidikan yang terdeteksi dalam video dikembalikan dalam arraySegments, SegmentDetectionobjek. 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 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 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. DurationFramesmemberikan 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 — TechnicalCueSegment bidang adalah TechnicalCueSegmentobjek yang berisi kepercayaan deteksi dan jenis isyarat teknis. Jenis isyarat teknis adalahColorBars,,,EndCredits, BlackFramesOpeningCredits, StudioLogoSlate, danContent.

• Shot — ShotSegment bidang adalah ShotSegmentobjek yang berisi kepercayaan deteksi dan pengenal untuk segmen pemotretan 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.