Starts asynchronous detection of segment detection in a stored video
Starts asynchronous detection of segment detection in a stored video.
Amazon Rekognition Video can detect segments in a video stored in an
Amazon S3 bucket. Use Video to specify the bucket name and the filename
of the video.
start_segment_detection
returns
a job identifier (JobId
) which you use to get the results of the
operation. When segment detection is finished, Amazon Rekognition Video
publishes a completion status to the Amazon Simple Notification Service
topic that you specify in NotificationChannel
.
You can use the Filters
(StartSegmentDetectionFilters) input parameter
to specify the minimum detection confidence returned in the response.
Within Filters
, use ShotFilter
(StartShotDetectionFilter) to filter
detected shots. Use TechnicalCueFilter
(StartTechnicalCueDetectionFilter) to filter technical cues.
To get the results of the segment detection operation, first check that
the status value published to the Amazon SNS topic is SUCCEEDED
. if
so, call get_segment_detection
and pass the job identifier (JobId
) from the initial call to
start_segment_detection
.
For more information, see Detecting Video Segments in Stored Video in the Amazon Rekognition Developer Guide.
rekognition_start_segment_detection(Video, ClientRequestToken, NotificationChannel, JobTag, Filters, SegmentTypes)
Video |
[required] |
ClientRequestToken |
Idempotent token used to identify the start request. If you use the same
token with multiple
|
NotificationChannel |
The ARN of the Amazon SNS topic to which you want Amazon Rekognition Video to publish the completion status of the segment detection operation. |
JobTag |
An identifier you specify that's returned in the completion notification
that's published to your Amazon Simple Notification Service topic. For
example, you can use |
Filters |
Filters for technical cue or shot detection. |
SegmentTypes |
[required] An array of segment types to detect in the video. Valid values are TECHNICAL_CUE and SHOT. |
A list with the following syntax:
list( JobId = "string" )
svc$start_segment_detection( Video = list( S3Object = list( Bucket = "string", Name = "string", Version = "string" ) ), ClientRequestToken = "string", NotificationChannel = list( SNSTopicArn = "string", RoleArn = "string" ), JobTag = "string", Filters = list( TechnicalCueFilter = list( MinSegmentConfidence = 123.0 ), ShotFilter = list( MinSegmentConfidence = 123.0 ) ), SegmentTypes = list( "TECHNICAL_CUE"|"SHOT" ) )
Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.