AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Gets the celebrity recognition results for a Amazon Rekognition Video analysis started by StartCelebrityRecognition.
Celebrity recognition in a video is an asynchronous operation. Analysis is started
by a call to StartCelebrityRecognition which returns a job identifier (JobId).
When the celebrity recognition operation finishes, Amazon Rekognition Video publishes
a completion status to the Amazon Simple Notification Service topic registered in
the initial call to StartCelebrityRecognition. To get the results of the celebrity
recognition analysis, first check that the status value published to the Amazon SNS
topic is SUCCEEDED. If so, call GetCelebrityDetection and pass the job
identifier (JobId) from the initial call to StartCelebrityDetection.
For more information, see Working With Stored Videos in the Amazon Rekognition Developer Guide.
GetCelebrityRecognition returns detected celebrities and the time(s) they
are detected in an array (Celebrities) of CelebrityRecognition objects.
Each CelebrityRecognition contains information about the celebrity in a CelebrityDetail
object and the time, Timestamp, the celebrity was detected. This CelebrityDetail
object stores information about the detected celebrity's face attributes, a face bounding
box, known gender, the celebrity's name, and a confidence estimate.
GetCelebrityRecognition only returns the default facial attributes (BoundingBox,
Confidence, Landmarks, Pose, and Quality). The BoundingBox
field only applies to the detected face instance. The other facial attributes listed
in the Face object of the following response syntax are not returned. For more
information, see FaceDetail in the Amazon Rekognition Developer Guide.
By default, the Celebrities array is sorted by time (milliseconds from the
start of the video). You can also sort the array by celebrity by specifying the value
ID in the SortBy input parameter.
The CelebrityDetail object includes the celebrity identifer and additional
information urls. If you don't store the additional information urls, you can get
them later by calling GetCelebrityInfo with the celebrity identifer.
No information is returned for faces not recognized as celebrities.
Use MaxResults parameter to limit the number of labels returned. If there are more
results than specified in MaxResults, the value of NextToken in the
operation response contains a pagination token for getting the next set of results.
To get the next page of results, call GetCelebrityDetection and populate the
NextToken request parameter with the token value returned from the previous
call to GetCelebrityRecognition.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginGetCelebrityRecognition and EndGetCelebrityRecognition.
Namespace: Amazon.Rekognition
Assembly: AWSSDK.Rekognition.dll
Version: 3.x.y.z
public virtual Task<GetCelebrityRecognitionResponse> GetCelebrityRecognitionAsync( GetCelebrityRecognitionRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the GetCelebrityRecognition service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| AccessDeniedException | You are not authorized to perform the action. |
| InternalServerErrorException | Amazon Rekognition experienced a service issue. Try your call again. |
| InvalidPaginationTokenException | Pagination token in the request is not valid. |
| InvalidParameterException | Input parameter violated a constraint. Validate your parameter before calling the API operation again. |
| ProvisionedThroughputExceededException | The number of requests exceeded your throughput limit. If you want to increase this limit, contact Amazon Rekognition. |
| ResourceNotFoundException | The resource specified in the request cannot be found. |
| ThrottlingException | Amazon Rekognition is temporarily unable to process the request. Try your call again. |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer