使用 Amazon Rekognition 分段 API

存储视频中 Amazon Rekognition Video 分段检测是一项 Amazon Rekognition Video 异步操作。Amazon Rekognition 分段 API 是一种复合 API，您可以从单个 API 调用中选择分析类型（技术提示或镜头检测）。有关调用异步操作的信息，请参阅调用 Amazon Rekognition Video 操作。

主题

起始段分析
获取分段分析结果

起始段分析

开始检测存储的视频通话中的片段StartSegmentDetection。输入参数与其他 Amazon Rekognition Video 操作相同，但添加了分段类型选择和结果筛选。有关更多信息，请参阅启动视频分析。

以下是 StartSegmentDetection 传递的 JSON 示例。请求同时指定检测技术提示和镜头检测分段。为技术提示分段 (90%) 和镜头检测分段 (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
      }
  }
}

选择分段类型

使用 SegmentTypes 数组输入参数检测输入视频中的技术提示和/或镜头检测分段。

技术提示 — 识别在视频中检测到的技术提示（黑帧、彩条、片头字幕、片尾字幕、工作室徽标和主要节目内容）的开始、结束和持续时间的精确到帧的时间戳。例如，您可以使用技术提示来查找片尾字幕的开始。有关更多信息，请参阅技术提示。
镜头 — 识别镜头的开始、结束和持续时间。例如，您可以使用镜头检测来确定一个视频的最终编辑候选镜头。有关更多信息，请参阅镜头检测。

筛选分析结果

您可以使用 Filters (StartSegmentDetectionFilters) 输入参数来指定响应中返回的最低检测置信度。在内部Filters，使用 ShotFilter (StartShotDetectionFilter) 过滤检测到的镜头。使用 TechnicalCueFilter (StartTechnicalCueDetectionFilter) 筛选技术线索。

有关代码示例，请参阅示例：检测存储视频中的分段。

获取分段分析结果

Amazon Rekognition Video 会将视频分析的完成状态发布到 Amazon Simple Notification Service 主题。如果视频分析成功，请致电GetSegmentDetection以获取视频分析的结果。

以下是一个示例 GetSegmentDetection 请求。JobId 是从对 StartSegmentDetection 的调用中返回的作业标识符。有关其他输入参数的信息，请参阅获取 Amazon Rekognition Video 分析结果。


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

GetSegmentDetection 返回所请求分析的结果以及有关存储的视频的常规信息。

一般信息

GetSegmentDection 返回以下常规信息。

音频信息-响应包括AudioMetadata对象数组中的音频元数据。AudioMetadata可以有多个音频流。每个 AudioMetadata 对象都包含一个音频流的元数据。AudioMetadata 对象中的音频信息包括音频编解码器、音频通道数量、音频流的持续时间和采样率。音频元数据在 GetSegmentDetection 返回的每个信息页面中返回。
视频信息 — 目前，Amazon Rekognition Video 返回数组中的单个对象。VideoMetadataVideoMetadata该对象包含有关 Amazon Rekognition Video 选择分析的输入文件中视频流的信息。VideoMetadata 对象包括视频编解码器、视频格式和其他信息。视频元数据在 GetSegmentDetection 返回的每个信息页面中返回。
分页信息 – 示例显示了分段信息的一页。您可以在 GetSegmentDetection 的 MaxResults 输入参数中指定要返回的元素数量。如果存在的结果的数量超过了 MaxResults，则 GetSegmentDetection 会返回一个令牌 (NextToken)，用于获取下一页的结果。有关更多信息，请参阅获取 Amazon Rekognition Video 分析结果。
请求信息 – 在对 StartSegmentDetection 的调用中请求的分析类型在 SelectedSegmentTypes 字段中返回。

分段

在视频中检测到的技术线索和镜头信息以SegmentDetection对象数组的形式Segments返回。输入按照在 StartSegmentDetection 的 SegmentTypes 输入参数中指定的分段类型（TECHNICAL_CUE 或 SHOT）排序。在每个分段类型中，数组按时间戳值排序。每个 SegmentDetection 对象都包括有关所检测到分段类型的信息（技术提示或镜头检测）以及常规信息，例如分段的开始时间、结束时间和持续时间。

时间信息以三种格式返回。

毫秒

自视频开始以来的毫秒数。字段 DurationMillis、StartTimestampMillis 和 EndTimestampMillis 采用毫秒格式。
时间码

Amazon Rekognition Video 时间码采用 SMPTE 格式，视频的每个帧都有一个唯一的时间码值。格式为 hh:mm:ss:frame。例如，时间码值 01:05:40:07 将被读取为 1 小时 5 分 47 秒第 7 帧。Amazon Rekognition Video 支持丢帧率用例。丢帧率时间码格式为 hh:mm:ss;frame。字段 DurationSMPTE、StartTimecodeSMPTE 和 EndTimecodeSMPTE 采用时间码格式。
帧计数器

每个视频分段的持续时间也用帧数表示。该字段 StartFrameNumber 给出视频分段开头的帧数，EndFrameNumber 给出视频分段末尾的帧数。DurationFrames 给出视频分段的总帧数。这些值是使用以 0 开头的帧索引计算的。

您可以使用 SegmentType 字段确定 Amazon Rekognition Video 返回的分段的类型。

技术线索 — 该TechnicalCueSegment字段是一个包含探测置信度和技术线索类型的TechnicalCueSegment对象。技术提示的类型有 ColorBars、EndCredits、BlackFrames、OpeningCredits、StudioLogo、Slate和Content。
镜头 — 该ShotSegment字段是一个包含检测置信度和视频中镜头片段标识符的ShotSegment对象。

以下示例是 GetSegmentDetection 的 JSON 响应。


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

有关代码示例，请参阅示例：检测存储视频中的分段。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

检测视频分段

示例：检测存储视频中的分段