공간의 활성 회의에 WebRTC 연결을 브로커링합니다.
성공하면 클라이언트는 결과 SDP (세션 설명 프로토콜) 응답을 사용하여 WebRTC 연결을 설정해야 합니다. 연결되면 WebRTC 데이터 채널에서 추가 기능을 사용할 수 있습니다.
HTTP 요청
POST https://meet.googleapis.com/v2beta/{name=spaces/*}:connectActiveConference
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
name |
필수 항목입니다. 공간의 리소스 이름입니다. 형식: spaces/{spaceId} |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "offer": string } |
필드 | |
---|---|
offer |
필수 항목입니다. 클라이언트의 WebRTC SDP (세션 설명 프로토콜) 오퍼입니다. 이 형식은 RFC 8829에 정의된 필수 키와 함께 RFC 8866에 정의되어 있습니다. 이는 피어 연결의 createOffer() 및 createAnswer() 메서드에 의해 생성되는 표준 SDP 형식입니다. |
응답 본문
spaces.connectActiveConference 메서드의 응답입니다.
성공 응답은 회의에 완전히 참여했음을 나타내지 않습니다. WebRTC를 통해 추가 통신이 이루어져야 합니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
JSON 표현 |
---|
{ "answer": string, "traceId": string } |
필드 | |
---|---|
answer |
제안에 대한 WebRTC SDP 응답입니다. |
trace |
디버깅을 위한 트레이스 ID입니다. 버그를 신고할 때 이 값을 포함하세요. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/meetings.conference.media.readonly
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly
https://www.googleapis.com/auth/meetings.conference.media.video.readonly
자세한 내용은 OAuth 2.0 Overview를 참고하세요.