Method: spaces.connectActiveConference

Negocia una conexión WebRTC a la conferencia activa de un espacio.

Si la operación se realiza correctamente, los clientes deben usar la respuesta de SDP (Protocolo de descripción de sesión) resultante para establecer una conexión WebRTC. Una vez que se establece la conexión, se dispone de funciones adicionales en los canales de datos de WebRTC.

Consulta la descripción general de la API de Meet Media para obtener más detalles sobre esta conexión.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. Es el nombre del recurso del espacio. Formato: spaces/{spaceId}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "offer": string,
  "config": {
    object (ConnectionConfig)
  }
}
Campos
offer

string

Obligatorio. Oferta de SDP (Protocolo de descripción de sesión) de WebRTC del cliente.

El formato se define en RFC 8866 con claves obligatorias definidas en RFC 8829. Este es el formato SDP estándar que generan los métodos createOffer() y createAnswer() de una conexión de pares.
config

object (ConnectionConfig)

Opcional. Son opciones de configuración adicionales para una sesión de la API de Media. Si no se configura, se proporcionarán valores predeterminados para la sesión.

Cuerpo de la respuesta

Es la respuesta del método spaces.connectActiveConference.

Una respuesta correcta no indica que se unió a la reunión por completo; debe haber más comunicación a través de WebRTC.

Consulta la descripción general de la API de Meet Media para obtener más detalles sobre esta conexión.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "answer": string,
  "traceId": string
}
Campos
answer

string

Es la respuesta de SDP de WebRTC a la oferta.
traceId

string

Es el ID de seguimiento para fines de depuración. Incluye este valor cuando informes errores.

Permisos de autorización

Se necesita uno de los siguientes permisos de 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

Para obtener más información, consulta la guía de autorización.

ConnectionConfig

Son opciones de configuración adicionales para las sesiones de la API de Media.

Representación JSON 
{
  "confirmationTimeout": string
}
Campos
confirmationTimeout

string (Duration format)

Opcional. Es la cantidad de tiempo que se debe esperar antes de que se cancele una acción de confirmación. Si no se establece, se usará un valor predeterminado. La duración no puede superar los 5 minutos. Los tiempos de espera más largos y las duraciones negativas provocarán una falla de RPC.