StartSelector

Kinesis 비디오 스트림에서 GetMedia API가 미디어 데이터 반환을 시작하도록 하려는 청크를 식별합니다. 다음과 같은 옵션을 사용하여 시작 청크를 식별할 수 있습니다.

• 최신 (또는 가장 오래된) 청크를 선택합니다.

• 특정 청크를 식별하십시오. 프래그먼트 번호나 타임스탬프 (서버 또는 프로듀서) 를 제공하여 특정 청크를 식별할 수 있습니다.

• 각 청크의 메타데이터에는 연속 토큰이 Matroska (MKV) 태그 () 로 포함되어 있습니다. AWS_KINESISVIDEO_CONTINUATION_TOKEN 이전 GetMedia 요청이 종료된 경우 다음 요청에서 이 태그 값을 사용할 수 있습니다. GetMedia 그러면 API는 마지막 API가 종료된 지점부터 청크를 반환하기 시작합니다.

내용

StartSelectorType

Kinesis 비디오 스트림에서 데이터 가져오기를 시작하려는 프래그먼트를 식별합니다.

• 지금 - 스트림의 최신 청크부터 시작하세요.

• 가장 빠른 시간 - 스트림에서 사용할 수 있는 가장 빠른 청크부터 시작합니다.

• FRAGMENT_NUMBER - 특정 프래그먼트 뒤에 오는 청크부터 시작합니다. AfterFragmentNumber 파라미터도 지정해야 합니다.

• PRODUCER_TIMESTAMP 또는 SERVER_TIMESTAMP - 지정된 프로듀서 또는 서버 타임스탬프가 있는 프래그먼트가 포함된 청크부터 시작합니다. 를 추가하여 StartTimestamp 타임스탬프를 지정합니다.

• CONTINUATION_TOKEN - 지정된 연속 토큰을 사용하여 읽습니다.

참고

현재, 가장 빠른 또는 CONTINUATION_TOKEN을 로 선택하면 에 추가 startSelectorType 정보가 제공되지 않습니다. startSelector

타입: 문자열

유효 값: FRAGMENT_NUMBER | SERVER_TIMESTAMP | PRODUCER_TIMESTAMP | NOW | EARLIEST | CONTINUATION_TOKEN

필수 사항 여부: 예

AfterFragmentNumber

GetMediaAPI에서 프래그먼트 반환을 시작할 프래그먼트 번호를 지정합니다.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이 128.

패턴: ^[0-9]+$

Required: No

ContinuationToken

Kinesis Video Streams가 이전 응답에서 반환한 연속 토큰입니다GetMedia. 그런 다음 연속 토큰으로 식별된 청크로 GetMedia API가 시작됩니다.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이 128.

패턴: ^[a-zA-Z0-9_\.\-]+$

Required: No

StartTimestamp

타임스탬프 값. 이 값은 PRODUCER_TIMESTAMP 또는 SERVER_TIMESTAMP를 로 선택하는 경우 필요합니다. startSelectorType 그런 다음 GetMedia API는 지정된 타임스탬프가 있는 프래그먼트가 포함된 청크로 시작합니다.

유형: 타임스탬프

필수 여부: 아니요

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.

• AWS SDK for C++

• AWS Java V2용 SDK

• AWS 루비 V3용 SDK