기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# JoinStorageSession
**참고**
이 API를 사용하기 전에 `GetSignalingChannelEndpoint` API를 호출하여 WEBRTC 엔드포인트를 요청해야 합니다. 그런 다음 `JoinStorageSession` API 요청에서 엔드포인트와 리전을 지정합니다.
진행 중인 단방향 비디오 및/또는 다방향 오디오 WebRTC 세션에 입력 채널의 비디오 생성 디바이스로 참여합니다. 채널에 대한 기존 세션이 없는 경우 새 스트리밍 세션을 생성하고 신호 채널의 Amazon 리소스 이름(ARN)을 제공합니다.
현재 `SINGLE_MASTER` 유형의 경우 비디오 생성 디바이스는 오디오 및 비디오 미디어를 모두 스트림으로 수집할 수 있습니다. 비디오 생성 디바이스만 세션에 참여하고 미디어를 레코딩할 수 있습니다.
**중요**
현재 WebRTC 수집에는 오디오 트랙과 비디오 트랙이 모두 필요합니다.
현재 요구 사항:
비디오 트랙: H.264
오디오 트랙: Opus
비디오:
최대 해상도는 SQFHD(1920x1920)입니다.
KVS WebRTC 수집은 현재 특정 H264 프로파일 세트를 지원합니다.
제약 기준
기준
기본
높음
제한-높음
프로그레시브-높음
Kinesis 비디오 스트림의 결과 수집 비디오에는 H.264 비디오 및 AAC 오디오 파라미터가 있습니다.
마스터 참가자가 WebRTC를 통해 연결을 협상하면 수집된 미디어 세션이 Kinesis 비디오 스트림에 저장됩니다. 그러면 여러 뷰어가 재생 APIs.
수집된 WebRTC 미디어에서 `HLS` 또는 `DASH` 재생, [GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html)를 통한 이미지 생성 등과 같은 기존 Kinesis Video Streams 기능을 사용할 수도 있습니다.
**참고**
S3 이미지 전송 및 알림은 현재 지원되지 않습니다.
**참고**
하나의 비디오 생성 디바이스 클라이언트만 채널의 세션과 연결할 수 있다고 가정합니다. 둘 이상의 클라이언트가 특정 채널의 세션에 비디오 생성 디바이스로 조인하는 경우 가장 최근의 클라이언트 요청이 우선합니다.
**추가 정보**
+ **Idempotent** -이 API는 멱등성이 없습니다.
+ **재시도 동작** - 새 API 호출로 계산됩니다.
+ **동시 호출** - 동시 호출이 허용됩니다. 제안은 각 호출당 한 번씩 전송됩니다.
## Request Syntax
```
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "{{string}}"
}
```
## URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [channelArn](#API_webrtc_JoinStorageSession_RequestSyntax) **
신호 채널의 Amazon 리소스 이름(ARN)입니다.
이 입력 파라미터의 대소문자를 기록해 둡니다.
유형: String
패턴: `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 응답을 다시 전송합니다.
## 오류
모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.
** AccessDeniedException **
이 작업을 수행하는 데 필요한 권한이 없습니다.
HTTP 상태 코드: 403
** ClientLimitExceededException **
허용된 클라이언트 호출 한도를 초과했기 때문에 Kinesis Video Streams에서 요청을 제한했습니다. 나중에 호출해 보십시오.
HTTP 상태 코드: 400
** InvalidArgumentException **
이 입력 파라미터의 값이 잘못되었습니다.
HTTP 상태 코드: 400
** ResourceNotFoundException **
지정된 리소스를 찾을 수 없습니다.
HTTP 상태 코드: 404
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)