기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
SendAlexaOfferToMaster
참고
이 API를 사용하기 전에 API를 호출하여 엔드포인트를 가져와야 합니다. GetSignalingChannelEndpoint 그런 다음 SendAlexaOfferToMaster API 요청에서 엔드포인트와 리전을 지정합니다.
이 API를 사용하면 WebRTC 지원 디바이스를 Alexa 디스플레이 디바이스와 연결할 수 있습니다. 호출되면 Alexa SDP (세션 설명 프로토콜) 오퍼가 마스터 피어에 전송됩니다. 마스터가 지정된 신호 채널에 연결되는 즉시 오퍼가 전달됩니다. 이 API는 연결된 마스터로부터 SDP 응답을 반환합니다. 마스터가 시그널링 채널에 연결되지 않은 경우 메시지가 만료될 때까지 재배송 요청이 이루어집니다.
Request Syntax
POST /v1/send-alexa-offer-to-master HTTP/1.1
Content-type: application/json
{
"ChannelARN": "string",
"MessagePayload": "string",
"SenderClientId": "string"
}URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- ChannelARN
-
Alexa와 마스터 피어가 통신하는 데 사용하는 신호 채널의 Amazon 리소스 이름 (ARN).
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 1024입니다.
패턴:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+필수 사항 여부: Yes
- MessagePayload
-
base64로 인코딩된 SDP는 콘텐츠를 제공합니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 10,000개입니다.
패턴:
[a-zA-Z0-9+/=]+필수 사항 여부: Yes
- SenderClientId
-
발신자 클라이언트의 고유 식별자입니다.
유형: 문자열
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.
패턴:
[a-zA-Z0-9_.-]+필수 항목 여부: 예
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"Answer": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- Answer
-
base64로 인코딩된 SDP 응답 콘텐츠.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 10,000개입니다.
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- ClientLimitExceededException
-
허용된 클라이언트 통화 한도를 초과했기 때문에 요청이 병목 현상이 발생했습니다. 나중에 전화를 걸어 보세요.
HTTP 상태 코드: 400
- InvalidArgumentException
-
이 입력 매개변수의 값이 유효하지 않습니다.
HTTP 상태 코드: 400
- NotAuthorizedException
-
호출자는 이 작업을 수행할 권한이 없습니다.
HTTP 상태 코드: 401
- ResourceNotFoundException
-
지정된 리소스를 찾을 수 없습니다.
HTTP 상태 코드: 404
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
