Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo dell'API Amazon Rekognition Segment

Il rilevamento dei segmenti di Video Amazon Rekognition nei video archiviati è un'operazione asincrona di Video Amazon Rekognition. Video Amazon Rekognition Segment API è un'API composita in cui è possibile scegliere il tipo di analisi (segnali d'azione tecnici o rilevamento delle riprese) da una singola chiamata API. Per informazioni sulla chiamata di operazioni asincrone, consulta Chiamata delle operazioni Video Amazon Rekognition.

Avvio dell'analisi dei segmenti

Per avviare il rilevamento dei segmenti in una videochiamata memorizzata. StartSegmentDetection I parametri di input sono gli stessi delle altre operazioni Video Amazon Rekognition con l'aggiunta della selezione del tipo di segmento e del filtraggio dei risultati. Per ulteriori informazioni, consulta Avvio di analisi video.

Di seguito è riportato un esempio JSON passato da StartSegmentDetection. La richiesta specifica che vengono rilevati sia i segnali d'azione tecnici che i segmenti di rilevamento delle riprese. Per i segmenti dei segnali d'azione tecnici (90%) e per i segmenti di rilevamento delle riprese (80%) sono richiesti filtri diversi per la sicurezza minima di rilevamento.

{
  "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
      }
  }
}  

Scelta di un tipo di segmento

Utilizzare il parametro di input dell'array SegmentTypes per rilevare segnali d'azione tecnici e/o segmenti di rilevamento delle riprese nel video di input.

Filtraggio dei risultati dell'analisi

È possibile utilizzare il parametro di input Filters (StartSegmentDetectionFilters) per specificare l'affidabilità minima di rilevamento restituita nella risposta. All'internoFilters, utilizzate ShotFilter (StartShotDetectionFilter) per filtrare gli scatti rilevati. Usa TechnicalCueFilter (StartTechnicalCueDetectionFilter) per filtrare i segnali tecnici.

Per il codice di esempio, consulta Esempio: rilevamento di segmenti in un video archiviato.

Recupero dei risultati dell'analisi dei segmenti

Amazon Rekognition per video pubblica lo stato di completamento dell'analisi video in un argomento Amazon Simple Notification Service. Se l'analisi video ha esito positivo, chiama GetSegmentDetectionper ottenere i risultati dell'analisi video.

Di seguito è riportata una richiesta GetSegmentDetection di esempio. JobId è l'identificatore del processo restituito dalla chiamata a StartSegmentDetection. Per informazioni sugli altri parametri di input, consulta Ottenere i risultati dell'analisi di Video Amazon Rekognition.

{
    "JobId": "270c1cc5e1d0ea2fbc59d97cb69a72a5495da75851976b14a1784ca90fc180e3",
    "MaxResults": 10,
    "NextToken": "XfXnZKiyMOGDhzBzYUhS5puM+g1IgezqFeYpv/H/+5noP/LmM57FitUAwSQ5D6G4AB/PNwolrw=="
}

GetSegmentDetection restituisce i risultati per l'analisi richiesta e le informazioni generali sul video archiviato.

Informazioni generali

GetSegmentDection restituisce le seguenti informazioni generali.

Segmenti

I segnali tecnici e le informazioni sulle riprese rilevati in un video vengono restituiti in una serie di oggetti. Segments SegmentDetection La matrice viene ordinata in base ai tipi di segmento (TECHNICAL_CUE o SHOT) specificati nel parametro di input SegmentTypes di StartSegmentDetection. All'interno di ogni tipo di segmento l'array viene ordinato in base ai valori del timestamp. Ogni oggetto SegmentDetection include informazioni sul tipo di segmento rilevato (segnale d'azione tecnico o rilevamento delle riprese) e informazioni generali, quali l'ora di inizio, l'ora di fine e la durata del segmento.

Le informazioni sull'ora vengono restituite in tre formati.

È possibile utilizzare il campo SegmentType per determinare il tipo di segmento restituito da Video Amazon Rekognition.

Di seguito è riportato un esempio di risposta JSON dell'operazione 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
        }
    ]
}

Per il codice di esempio, consulta Esempio: rilevamento di segmenti in un video archiviato.