本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用儲存的影片分析操作
<a name="video"></a>

Amazon Rekognition Video 為可用於分析影片的 API。使用 Amazon Rekognition Video，您可以偵測儲存於 Amazon Simple Storage Service (Amazon S3) 儲存貯體的影片中之標籤、人臉、人物、名人以及成人內容 (包括暗示與露骨)。您可以在媒體/娛樂與公共安全等類別使用 Amazon Rekognition Video。在過去，掃描影片中的物件或人員可能必須耗費數小時的人工檢視，且容易發生錯誤。若專案貫穿影片各處，Amazon Rekognition Video 可對專案執行自動化偵測。

本節涵蓋 Amazon Rekognition Video 可執行的分析類型、API 概觀以及使用 Amazon Rekognition Video 的範例。

**Topics**
+ [分析類型](#video-recognition-types)
+ [Amazon Rekognition Video API 概觀](#video-api-overview)
+ [呼叫 Amazon Rekognition Video 操作](api-video.md)
+ [設定 Amazon Rekognition Video](api-video-roles.md)
+ [使用 Java 或 Python (SDK) 分析儲存於 Amazon S3 儲存貯體中的影片](video-analyzing-with-sqs.md)
+ [使用 分析影片 AWS Command Line Interface](video-cli-commands.md)
+ [參考：影片分析結果通知](video-notification-payload.md)
+ [對 Amazon Rekognition Video 進行疑難排解](video-troubleshooting.md)

## 分析類型
<a name="video-recognition-types"></a>

您可以使用 Amazon Rekognition Video 來分析影片中的下列資訊：
+ [影片區段](segments.md)
+ [標籤](labels.md)
+ [暗示與露骨的成人內容](moderation.md)
+ [Text (文字)](text-detection.md)
+ [名人](celebrities.md)
+ [臉部](faces.md)
+ [人物](persons.md)

如需詳細資訊，請參閱 [Amazon Rekognition 的運作方式](how-it-works.md)。

## Amazon Rekognition Video API 概觀
<a name="video-api-overview"></a>

Amazon Rekognition Video 會處理存放在 Amazon S3 儲存貯體中的影片。設計模式為一組非同步的操作。呼叫如 [StartLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartLabelDetection.html) 的 `Start` 操作來開始影片分析。請求的完成狀態會發佈至 Amazon Simple Notification Service (Amazon SNS) 主題。若要從 Amazon SNS 主題取得完成狀態，您可以使用 Amazon Simple Queue Service (Amazon SQS) 佇列或 AWS Lambda 函數。在獲得完成狀態後，可呼叫如 [GetLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetLabelDetection.html) 的 `Get` 操作來取得請求結果。

下圖顯示在儲存於 Amazon S3 儲存貯體的影片中偵測標籤的程序。在圖表內，佇列將自 Amazon SNS 主題取得完成狀態。或者，您可以使用 AWS Lambda 函數。

![流程圖說明使用 Amazon Rekognition Video、Amazon SNS 和 Amazon SQS 進行影片分析的步驟，以及 StartLabelDetection、GetLabelDetection 任務等元件，並將完成狀態發佈至個別佇列。](http://docs.aws.amazon.com/zh_tw/rekognition/latest/dg/images/VideoRekognition.png)


其他 Amazon Rekognition Video 操作的過程是相同的。下表列出每個非儲存體 Amazon Rekognition 操作的 `Start` 與 `Get` 操作。


| 偵測 | 開始操作 | 取得操作 | 
| --- | --- | --- | 
| 影片區段 | [StartSegmentDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartSegmentDetection.html) | [GetSegmentDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetSegmentDetection.html) | 
| 標籤 | [StartLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartLabelDetection.html) | [GetLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetLabelDetection.html) | 
| 露骨或暗示性的成人內容 | [StartContentModeration](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartContentModeration.html) | [GetContentModeration](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetContentModeration.html) | 
| 文字 | [StartTextDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartTextDetection.html) | [GetTextDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetTextDetection.html) | 
| 名人 | [StartCelebrityRecognition](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartCelebrityRecognition.html) | [GetCelebrityRecognition](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetCelebrityRecognition.html) | 
| 臉部 | [StartFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceDetection.html) | [GetFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetFaceDetection.html) | 
| 人物 | [StartPersonTracking](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartPersonTracking.html) | [GetPersonTracking](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetPersonTracking.html) | 

對於 `Get` 以外的 `GetCelebrityRecognition` 操作，Amazon Rekognition Video 將傳回追蹤資訊，說明將在影片輸入檔的哪個部分偵測到實體。

如需使用 Amazon Rekognition Video 影片的詳細資訊，請參閱 [呼叫 Amazon Rekognition Video 操作](api-video.md)。如需使用 Amazon SQS 執行影片分析的範例，請參閱 [使用 Java 或 Python (SDK) 分析儲存於 Amazon S3 儲存貯體中的影片](video-analyzing-with-sqs.md)。如需 AWS CLI 範例，請參閱 [使用 分析影片 AWS Command Line Interface](video-cli-commands.md)。

### 影片格式和儲存體
<a name="video-storage-formats"></a>

Amazon Rekognition 操作可分析儲存於 Amazon S3 儲存貯體的影片。如需影片分析作業的所有限制清單，請參閱 [Amazon Rekognition 中的準則和配額](limits.md)。

影片需使用 H.264 編解碼器來編碼。支援的檔案格式為 MPEG-4 與 MOV。

編解碼器為壓縮資料讓傳遞更快速並將收到的資料解壓縮為原始格式的軟體或硬體工具。The H.264 編解碼器通常用於記錄、壓縮和發佈影片內容。影片檔案格式可包含一個或多個編解碼器。若您的 MOV 或 MPEG-4 格式影片檔案不適用於 Amazon Rekognition Video，請確認用於影片編碼的編解碼器為 H.264。

任何可分析音訊資料的 Amazon Rekognition Video API 只支援 AAC 音訊轉碼器。

可儲存影片的檔案大小上限為 10 GB。

### 搜尋人物
<a name="video-searching-persons-overview"></a>

您可以使用儲存在集合中的臉部中繼資料來搜尋影片中的人物。例如，您可以在封存的影片中搜尋特定人物或多個人物。使用 [IndexFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_IndexFaces.html) 操作從集合中的原始映像儲存人臉中繼資料。接著可以使用 [StartFaceSearch](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceSearch.html) 以於集合中啟動非同步人臉搜尋。可使用 [GetFaceSearch](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GeFaceSearch.html) 來取得搜尋結果。如需詳細資訊，請參閱 [在儲存的影片中搜尋人臉](procedure-person-search-videos.md)。搜尋人物為以儲存體為基礎的 Amazon Rekognition 操作之範例。如需詳細資訊，請參閱 [以儲存為基礎的 API 操作](how-it-works-storage-non-storage.md#how-it-works-storage-based)。

您也可以在串流影片中搜尋人物。如需詳細資訊，請參閱 [處理串流影片事件](streaming-video.md)。