Method: spaces.connectActiveConference

Установите WebRTC-соединение с активной конференцией в виртуальном пространстве.

В случае успеха клиенты должны использовать полученный ответ SDP (Session Description Protocol) для установления соединения WebRTC. После установления соединения становится доступна дополнительная функциональность в каналах передачи данных WebRTC.

Более подробную информацию об этом подключении см. в обзоре API Meet Media .

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Обязательно. Имя ресурса пространства. Формат: spaces/{spaceId}

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "offer": string,
  "config": {
    object (ConnectionConfig)
  }
}
Поля
offer

string

Обязательно. Предложение WebRTC SDP (Session Description Protocol) от клиента.

Формат определен RFC 8866 , а обязательные ключи — RFC 8829. Это стандартный формат SDP, генерируемый методами createOffer() и createAnswer() однорангового соединения.

config

object ( ConnectionConfig )

Необязательно. Дополнительные параметры конфигурации для сессии Media API. Если не задано, будут предоставлены значения по умолчанию для сессии.

Ответный текст

Ответ метода spaces.connectActiveConference.

Успешный ответ не означает, что к встрече подключились все участники; дальнейшая коммуникация должна осуществляться через WebRTC.

Более подробную информацию об этом подключении см. в обзоре API Meet Media .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "answer": string,
  "traceId": string
}
Поля
answer

string

Ответ WebRTC SDP на это предложение.

traceId

string

Идентификатор трассировки используется для отладки. Пожалуйста, указывайте это значение при сообщении об ошибках.

Области полномочий

Требуется один из следующих диапазонов аутентификации 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

Для получения более подробной информации см. руководство по авторизации .

ConnectionConfig

Дополнительные параметры конфигурации для сессий Media API.

JSON-представление 
{
  "confirmationTimeout": string
}
Поля
confirmationTimeout

string ( Duration format)

Необязательный параметр. Время ожидания до отмены действия подтверждения. Если параметр не задан, будет использовано значение по умолчанию. Длительность не может превышать 5 минут. Большие значения времени ожидания и отрицательные значения приведут к сбою RPC.