StartSelector - Amazon Kinesis Video Streams

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.