JoinStorageSessionAsViewer - Amazon Kinesis Video Streams
Request SyntaxURI 요청 파라미터요청 본문응답 구문Response Elements오류참고

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

JoinStorageSessionAsViewer

참고

다중 뷰어 지원(미리 보기)이 포함된 웹RTC 수집은 AWS 서비스 약관에 정의된 대로 미리 보기에서 제공되며 변경될 수 있습니다. 현재 us-east-1()에서만 사용할 수 있습니다IAD.

미리 보기에 참여하려면 kvs-webrtc-multi-view-preview@amazon.com으로 이메일을 보내세요.

참고

이 를 사용하기 전에 를 호출GetSignalingChannelEndpointAPI하여 WEBRTC 엔드포인트를 요청해야 API합니다. 그런 다음 JoinStorageSessionAsViewer API 요청에서 엔드포인트와 리전을 지정합니다.

지속적인 원웨이 비디오 및/또는 멀티웨이 오디오 웹RTC 세션에 입력 채널용 비디오 생성 장치로 참여합니다. 채널에 대한 기존 세션이 없는 경우 새 스트리밍 세션을 생성하고 신호 채널의 Amazon 리소스 이름(ARN)을 입력합니다.

현재 SINGLE_MASTER 유형의 경우 비디오 생성 디바이스는 오디오 및 비디오 미디어를 스트림으로 수집할 수 있습니다.

중요

현재 뷰어는 비디오 트랙을 전송할 수 없습니다. 뷰어는 선택적 오디오 트랙을 보내거나 트랙을 전혀 보내지 않을 수 있습니다.

현재 최종 사용자 참가자 전송 요구 사항:

  • 비디오 트랙: 지원되지 않음

  • 오디오 트랙(선택 사항): Opus

마스터 참가자가 현재 비디오 생성 디바이스에 연결되어 있는 경우 Kinesis 비디오 스트림의 결과 수집 비디오에는 H.264 비디오 및 AAC 오디오 파라미터가 있습니다.

최종 사용자와 마스터를 포함한 모든 참가자는 서로의 말을 들을 수 있습니다. 또한 모든 뷰어는 웹 을 통해 마스터 참가자로부터 미디어를 수신합니다RTC.

참고

뷰어 참가자는 마스터 참가자에게 직접 연결하지 않고 스토리지 세션에 직접 연결합니다. 스토리지 세션은 미디어를 혼합, 복제 및 적절한 대상으로 라우팅하는 작업을 수행합니다.

참고

마스터 참가자가 없는 경우 시청자는 서로 들을 수 없습니다.

최종 사용자 참가자가 웹을 통해 연결을 협상하면 마스터 참가자가 스토리지 세션에 연결되어 있는 한 RTC수집된 오디오 세션이 Kinesis 비디오 스트림에 저장됩니다.

HLS 또는 DASH 재생, 를 통한 이미지 생성 GetImages등과 같은 기존 Kinesis Video Streams 기능을 수집된 웹RTC 미디어에 사용할 수도 있습니다.

참고

S3 이미지 전송 및 알림은 현재 지원되지 않습니다.

참고

하나의 비디오 생성 디바이스 클라이언트만 채널의 세션과 연결할 수 있다고 가정합니다. 둘 이상의 클라이언트가 특정 채널의 세션에 비디오 생성 디바이스로 조인하는 경우 가장 최근의 클라이언트 요청이 우선합니다.

Limits

현재 제한이 적용됩니다.

  • 최대 시청자 수: 3

  • 최종 사용자 참가자가 마스터 참가자 없이 스토리지 세션에 연결된 상태로 유지되는 최대 시간: 3분

중요

최종 사용자가 스토리지 세션에서 연결을 끊는 경우(피어 연결을 닫는 경우) 할당량(최종 사용자 한도)은 1분 동안 소비된 상태로 유지됩니다. 이 1분 동안 최종 사용자는 동일한 클라이언트 IDAPI로 이를 호출하여 추가 최종 사용자 할당량을 소비하지 않고 세션에 다시 참여할 수 있습니다. 1분 후 최종 사용자 할당량이 릴리스되고 다른 최종 사용자가 참여할 수 있습니다.

추가 정보

  • Idempotent - idempotentAPI가 아닙니다.

  • 재시도 동작 - 새 API 호출로 계산됩니다.

  • 동시 호출 - 동시 호출이 허용됩니다. 제안은 각 호출당 한 번씩 전송됩니다.

Request Syntax

POST /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json

{
   "channelArn": "string",
   "clientId": "string"
}

URI 요청 파라미터

요청은 URI 파라미터를 사용하지 않습니다.

요청 본문

요청은 JSON 형식의 다음 데이터를 수락합니다.

channelArn

신호 채널의 Amazon 리소스 이름(ARN)입니다.

중요

이 입력 파라미터의 대문자를 기록해 둡니다.

유형: String

Pattern: ^arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+$

필수 여부: 예

clientId

발신자 클라이언트의 고유 식별자입니다.

유형: 문자열

길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.

Pattern: ^[a-zA-Z0-9_.-]+$

필수 여부: 예

응답 구문

HTTP/1.1 200

Response Elements

작업이 성공하면 서비스가 빈 HTTP 본문과 함께 HTTP 200 응답을 다시 보냅니다.

오류

모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하세요.

AccessDeniedException

이 작업을 수행하는 데 필요한 권한이 없습니다.

HTTP 상태 코드: 403

ClientLimitExceededException

Kinesis Video Streams는 허용된 클라이언트 호출 한도를 초과했기 때문에 요청을 제한했습니다. 나중에 직접 호출해 보세요.

HTTP 상태 코드: 400

InvalidArgumentException

이 입력 파라미터의 값이 유효하지 않습니다.

HTTP 상태 코드: 400

ResourceNotFoundException

지정된 리소스를 찾을 수 없습니다.

HTTP 상태 코드: 404

참고

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