Method: spaces.connectActiveConference

공간의 활성 회의에 WebRTC 연결을 브로커링합니다.

성공하면 클라이언트는 결과 SDP (세션 설명 프로토콜) 응답을 사용하여 WebRTC 연결을 설정해야 합니다. 연결되면 WebRTC 데이터 채널에서 추가 기능을 사용할 수 있습니다.

HTTP 요청

POST https://meet.googleapis.com/v2beta/{name=spaces/*}:connectActiveConference

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 공간의 리소스 이름입니다. 형식: spaces/{spaceId}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "offer": string
}
필드
offer

string

필수 항목입니다. 클라이언트의 WebRTC SDP (세션 설명 프로토콜) 오퍼입니다.

이 형식은 RFC 8829에 정의된 필수 키와 함께 RFC 8866에 정의되어 있습니다. 이는 피어 연결의 createOffer() 및 createAnswer() 메서드에 의해 생성되는 표준 SDP 형식입니다.

응답 본문

spaces.connectActiveConference 메서드의 응답입니다.

성공 응답은 회의에 완전히 참여했음을 나타내지 않습니다. WebRTC를 통해 추가 통신이 이루어져야 합니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "answer": string,
  "traceId": string
}
필드
answer

string

제안에 대한 WebRTC SDP 응답입니다.

traceId

string

디버깅을 위한 트레이스 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를 참고하세요.