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

# 了解 Rekognition 的映像和影片操作
<a name="how-it-works-operations-intro"></a>

Amazon Rekognition 為影像和影片分析提供兩個主要 API 集：
+ Amazon Rekognition Image：此 API 專為分析映像而設計。
+ Amazon Rekognition Video：此 API 著重於分析儲存和串流影片。

兩個 APIs都可以偵測各種實體，例如臉部和物件。如需全面了解支援的比較和偵測類型，請參閱 上的一節[了解 Rekognition 的分析類型](how-it-works-types.md)。

## Amazon Rekognition Image 操作
<a name="how-it-works-operations-images"></a>

Amazon Rekognition Image 操作是同步的。輸入與回應為 JSON 格式。Amazon Rekognition Image 映像操作用於分析 .jpg 或 .png 映像格式的輸入映像檔。傳遞到 Amazon Rekognition Image 操作的映像可儲存於 Amazon S3 儲存貯體中。如果您不是使用 AWS CLI，也可以將 Base64 編碼的影像位元組直接傳遞至 Amazon Rekognition 操作。如需詳細資訊，請參閱[使用映像](https://docs.aws.amazon.com/rekognition/latest/dg/images.html)。

## Amazon Rekognition Video 操作
<a name="how-it-works-operations-video-intro"></a>

Amazon Rekognition Video API 有助於分析存放在 Amazon S3 儲存貯體或透過 Amazon Kinesis Video Streams 串流的影片。

對於儲存的影片操作，請注意下列事項：
+ 操作是非同步的。
+ 分析必須以「開始」操作啟動 （例如，在儲存的影片中偵測臉部的 [StartFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceDetection.html))。
+ 分析的完成狀態會發佈至 Amazon SNS 主題。
+ 若要擷取分析結果，請使用對應的「取得」操作 （例如 [GetFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetFaceDetection.html))。
+ 如需詳細資訊，請參閱[使用儲存的影片分析](https://docs.aws.amazon.com/rekognition/latest/dg/video.html)。

對於串流影片分析：
+ 功能包括 Rekognition Video 集合中的人臉搜尋和標籤 （物件或概念） 偵測。
+ 標籤的分析結果會以 Amazon SNS 和 Amazon S3 通知的形式傳送。
+ 臉部搜尋結果會輸出至 Kinesis 資料串流。
+ 串流影片分析的管理是透過 Amazon Rekognition Video 串流處理器完成 （例如，使用 [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html) 建立處理器）。
+ 如需詳細資訊，請參閱[使用串流視訊事件](https://docs.aws.amazon.com/rekognition/latest/dg/streaming-video.html)。

每個影片分析作業都會傳回正在分析之影片的相關中繼資料，以及工作 ID 和工作標籤。視訊的標籤偵測和內容管制等操作允許依時間戳記或標籤名稱排序，以及依時間戳記或區段彙總結果。

## 非儲存與以儲存為基礎的操作
<a name="how-it-works-operations-video-storage"></a>

Amazon Rekognition 操作將依組分為以下類別。
+ **非儲存 API 操作**：在這些操作中，Amazon Rekognition 將不會保留任何資訊。您提供輸入映像與影片，操作將執行分析並傳回結果，但 Amazon Rekognition 不會儲存任何內容。如需詳細資訊，請參閱 [非儲存操作](how-it-works-storage-non-storage.md#how-it-works-non-storage)。
+ **以儲存為基礎的 API 操作**：Amazon Rekognition 伺服器可將偵測到的人臉資訊儲存在容器中，也就是集合。Amazon Rekognition 提供額外的 API 操作，您可使用這些操作來搜尋保留的人臉資訊並尋找人臉配對。如需詳細資訊，請參閱 [以儲存為基礎的 API 操作](how-it-works-storage-non-storage.md#how-it-works-storage-based)。

## 使用 AWS SDK 或 HTTP 來呼叫 Amazon Rekognition API 操作
<a name="images-java-http"></a>

您可以使用 AWS SDK 或直接使用 HTTP 來呼叫 Amazon Rekognition API 操作。除非有充分理由不使用 AWS 開發套件，否則應一律使用 AWS 開發套件。本節中的 Java 範例使用 [AWS 開發套件](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-install.html)。未提供 Java 專案檔案，但您可以使用 [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/AWSToolkitEclipse/latest/GettingStartedGuide/) 來使用 Java 開發 AWS 應用程式。

本節中的 .NET 範例使用 [適用於 .NET 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/welcome.html)。您可以使用 [AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/welcome.html) 使用 .NET 開發 AWS 應用程式。它包含用於部署應用程式和管理服務的有用範本和 AWS Explorer。

本指南中的 [API 参考](https://docs.aws.amazon.com/rekognition/latest/APIReference/Welcome.html)涵蓋使用 HTTP 呼叫 Amazon Rekognition 操作的方法。如需 Java 參考資訊，請參閱 [適用於 Java 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-java/latest/reference/index.html)。

您可以使用的 Amazon Rekognition 服務端點記錄於 [AWS 區域與端點](https://docs.aws.amazon.com/general/latest/gr/rande.html#rekognition_region)。

以 HTTP 呼叫 Amazon Rekognition 時，請使用 POST HTTP 操作。