JoinStorageSessionAsViewer - Amazon Kinesis Video Streams

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

JoinStorageSessionAsViewer

참고

멀티뷰어를 지원하는 웹 RTC 인제스트 (미리 보기) 는 AWS 서비스 약관에 정의된 대로 Preview에서 제공되며 변경될 수 있습니다. 현재는 us-east-1 () 에서만 사용할 수 있습니다. IAD

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

참고

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

진행 중인 단방향 비디오 및/또는 다방향 오디오 웹 RTC 세션에 입력 채널용 비디오 제작 장치로 참여하십시오. 채널에 대한 기존 세션이 없는 경우 새 스트리밍 세션을 만들고 신호 채널의 Amazon 리소스 이름 (ARN) 을 제공하십시오.

현재 이 SINGLE_MASTER 유형의 비디오 제작 디바이스는 오디오 및 비디오 미디어를 스트림으로 인제스트할 수 있습니다.

중요

시청자는 현재 비디오 트랙을 전송할 수 없습니다. 시청자는 선택 사항으로 오디오 트랙을 보내거나 트랙을 전혀 보내지 않을 수 있습니다.

현재 시청자 참가자 전송 요구 사항:

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

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

마스터 참가자가 현재 비디오 제작 디바이스에 연결되어 있는 경우 Kinesis 비디오 스트림의 결과 인제스트된 비디오에는 H.264 비디오 및 오디오의 매개 변수가 포함됩니다. AAC

시청자 참여자는 웹을 통해 서로의 목소리를 들을 수 있으며 마스터 참가자로부터 미디어를 수신할 수도 있습니다. RTC

참고

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

참고

마스터 참가자가 없으면 시청자는 서로의 목소리를 들을 수 없습니다.

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

재생, 이미지 생성 HLS 등과 같은 DASH 기존 Kinesis Video Streams 기능을 인제스트된 GetImagesRTC웹 미디어와 함께 사용할 수도 있습니다.

참고

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

참고

채널의 세션에 비디오 제작 디바이스 클라이언트를 하나만 연결할 수 있다고 가정해 보겠습니다. 한 명 이상의 클라이언트가 특정 채널의 세션에 동영상 제작 장치로 참여하는 경우 가장 최근의 클라이언트 요청이 우선합니다.

Limits

현재 한도는 다음과 같습니다.

  • 최대 시청자 수: 3

  • 마스터 참가자가 없는 상태에서 시청자 참가자가 스토리지 세션에 연결된 상태를 유지할 수 있는 최대 시간: 3분

중요

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

추가 정보

  • 무력화 - 무력한 API 것은 아닙니다.

  • 재시도 동작 - 새 통화로 간주됩니다. 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 응답을 다시 보냅니다.

Errors

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

AccessDeniedException

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

HTTP상태 코드: 403

ClientLimitExceededException

허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams가 요청 병목 현상을 일으켰습니다. 나중에 전화를 걸어 보세요.

HTTP상태 코드: 400

InvalidArgumentException

이 입력 매개변수의 값이 유효하지 않습니다.

HTTP상태 코드: 400

ResourceNotFoundException

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

HTTP상태 코드: 404

참고

언어별 사용 방법에 대한 자세한 내용은 AWS SDKs 다음을 참조하십시오. API