NAME
Paws::KinesisVideoMedia::StartSelector
USAGE
This class represents one of two things:
Arguments in a call to a service
Use the attributes of this class as arguments to methods. You shouldn't make instances of this class. Each attribute should be used as a named argument in the calls that expect this type of object.
As an example, if Att1 is expected to be a Paws::KinesisVideoMedia::StartSelector object:
$service_obj->Method(Att1 => { AfterFragmentNumber => $value, ..., StartTimestamp => $value });
Results returned from an API call
Use accessors for each attribute. If Att1 is expected to be an Paws::KinesisVideoMedia::StartSelector object:
$result = $service_obj->Method(...);
$result->Att1->AfterFragmentNumber
DESCRIPTION
Identifies the chunk on the Kinesis video stream where you want the GetMedia
API to start returning media data. You have the following options to identify the starting chunk:
Choose the latest (or oldest) chunk.
Identify a specific chunk. You can identify a specific chunk either by providing a fragment number or timestamp (server or producer).
Each chunk's metadata includes a continuation token as a Matroska (MKV) tag (
AWS_KINESISVIDEO_CONTINUATION_TOKEN
). If your previousGetMedia
request terminated, you can use this tag value in your nextGetMedia
request. The API then starts returning chunks starting where the last API ended.
ATTRIBUTES
AfterFragmentNumber => Str
Specifies the fragment number from where you want the GetMedia
API to start returning the fragments.
ContinuationToken => Str
Continuation token that Kinesis Video Streams returned in the previous GetMedia
response. The GetMedia
API then starts with the chunk identified by the continuation token.
REQUIRED StartSelectorType => Str
Identifies the fragment on the Kinesis video stream where you want to start getting the data from.
NOW - Start with the latest chunk on the stream.
EARLIEST - Start with earliest available chunk on the stream.
FRAGMENT_NUMBER - Start with the chunk after a specific fragment. You must also specify the
AfterFragmentNumber
parameter.PRODUCER_TIMESTAMP or SERVER_TIMESTAMP - Start with the chunk containing a fragment with the specified producer or server timestamp. You specify the timestamp by adding
StartTimestamp
.CONTINUATION_TOKEN - Read using the specified continuation token.
If you choose the NOW, EARLIEST, or CONTINUATION_TOKEN as the startSelectorType
, you don't provide any additional information in the startSelector
.
StartTimestamp => Str
A timestamp value. This value is required if you choose the PRODUCER_TIMESTAMP or the SERVER_TIMESTAMP as the startSelectorType
. The GetMedia
API then starts with the chunk containing the fragment that has the specified timestamp.
SEE ALSO
This class forms part of Paws, describing an object used in Paws::KinesisVideoMedia
BUGS and CONTRIBUTIONS
The source code is located here: https://github.com/pplu/aws-sdk-perl
Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues