Method: spaces.connectActiveConference

Negocia uma conexão WebRTC com a conferência ativa de um espaço.

Se a operação for bem-sucedida, os clientes precisarão usar a resposta do SDP (Session Description Protocol) resultante para estabelecer uma conexão WebRTC. Depois de conectado, mais funcionalidades ficam disponíveis nos canais de dados WebRTC.

Consulte a visão geral da API Meet Media para mais detalhes sobre essa conexão.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Nome do recurso do espaço. Formato: spaces/{spaceId}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "offer": string,
  "config": {
    object (ConnectionConfig)
  }
}
Campos
offer

string

Obrigatório. Oferta de SDP (protocolo de descrição de sessão) WebRTC do cliente.

O formato é definido pela RFC 8866 (link em inglês) com chaves obrigatórias definidas pela RFC 8829 (link em inglês). Esse é o formato SDP padrão gerado pelos métodos createOffer() e createAnswer() de uma conexão de mesmo nível.
config

object (ConnectionConfig)

Opcional. Outras opções de configuração para uma sessão da API Media. Se não estiver definido, os valores padrão serão fornecidos para a sessão.

Corpo da resposta

Resposta do método "spaces.connectActiveConference".

Uma resposta de sucesso não indica que a reunião foi totalmente iniciada. É necessário que haja mais comunicação pelo WebRTC.

Consulte a visão geral da API Meet Media para mais detalhes sobre essa conexão.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "answer": string,
  "traceId": string
}
Campos
answer

string

Resposta de SDP do WebRTC à oferta.
traceId

string

ID de rastreamento para fins de depuração. Inclua esse valor ao registrar bugs.

Escopos de autorização

Requer um dos seguintes escopos do 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 mais informações, consulte o guia de autorização.

ConnectionConfig

Outras opções de configuração para sessões da API Media.

Representação JSON 
{
  "confirmationTimeout": string
}
Campos
confirmationTimeout

string (Duration format)

Opcional. O tempo de espera antes que uma ação de confirmação seja cancelada. Se não for definido, um valor padrão será usado. A duração não pode exceder 5 minutos. Timeouts maiores e durações negativas vão resultar em falha de RPC.