기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
JoinStorageSession
참고
이를 API 사용하기 전에 를 GetSignalingChannelEndpoint API 호출하여 WEBRTC 엔드포인트를 요청해야 합니다. 그런 다음 JoinStorageSession API 요청에서 엔드포인트와 리전을 지정합니다.
진행 중인 단방향 비디오 및/또는 다방향 오디오 웹 RTC 세션에 입력 채널용 비디오 제작 장치로 참여하십시오. 채널에 대한 기존 세션이 없는 경우 새 스트리밍 세션을 만들고 신호 채널의 Amazon 리소스 이름 (ARN) 을 제공하십시오.
현재 이 SINGLE_MASTER 유형의 비디오 제작 디바이스는 오디오 및 비디오 미디어를 스트림으로 인제스트할 수 있습니다. 비디오 제작 장치만 세션에 참여하고 미디어를 녹화할 수 있습니다.
중요
현재 웹 RTC 통합에는 오디오 트랙과 비디오 트랙 모두 필요합니다.
현재 요구 사항:
-
비디오 트랙: H.264
-
오디오 트랙: 오푸스
Kinesis 비디오 스트림의 결과 인제스트된 비디오는 H.264 비디오 및 오디오와 같은 매개 변수를 가집니다. AAC
마스터 참가자가 RTC 웹을 통해 연결을 협상하고 나면 수집된 미디어 세션이 Kinesis 비디오 스트림에 저장됩니다. 그러면 여러 시청자가 재생을 통해 실시간 미디어를 재생할 수 있습니다. APIs
또한 재생, 이미지 생성 HLS 등과 같은 DASH 기존 Kinesis Video Streams 기능을 인제스트된 GetImagesRTC웹 미디어와 함께 사용할 수 있습니다.
참고
S3 이미지 전송 및 알림은 현재 지원되지 않습니다.
참고
채널의 세션에 비디오 제작 디바이스 클라이언트를 하나만 연결할 수 있다고 가정해 보겠습니다. 한 명 이상의 클라이언트가 특정 채널의 세션에 동영상 제작 장치로 참여하는 경우 가장 최근의 클라이언트 요청이 우선합니다.
추가 정보
-
무력화 - 무력한 것은 아닙니다. API
-
재시도 동작 - 새 통화로 간주됩니다. API
-
동시 통화 - 동시 통화가 허용됩니다. 제안은 각 호출당 한 번씩 전송됩니다.
Request Syntax
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "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]+$필수 여부: 예
응답 구문
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
