为聊天室的有效会议中介 WebRTC 连接。
成功后,客户端必须使用生成的 SDP(会话描述协议)回答来建立 WebRTC 连接。连接后,WebRTC 数据通道将提供更多功能。
HTTP 请求
POST https://meet.googleapis.com/v2beta/{name=spaces/*}:connectActiveConference
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
name |
必需。聊天室的资源名称。格式:spaces/{spaceId} |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "offer": string } |
字段 | |
---|---|
offer |
必需。来自客户端的 WebRTC SDP(会话描述协议)方案。 该格式由 RFC 8866 定义,其中包含由 RFC 8829 定义的强制性键。这是由对等连接的 createOffer() 和 createAnswer() 方法生成的标准 SDP 格式。 |
响应正文
spaces.connectActiveConference 方法的响应。
成功响应并不表示已完全加入会议;必须通过 WebRTC 进行进一步通信。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "answer": string, "traceId": string } |
字段 | |
---|---|
answer |
对该提议的 WebRTC SDP 响应。 |
trace |
用于调试的轨迹 ID。在提交 bug 时,请附上此值。 |
授权范围
需要以下 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。