Esta página descreve como conseguir o objeto cliente que um complemento precisa para se comunicar com o Google Meet.
Primeiro, o complemento precisa estabelecer uma sessão:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
Na sessão, é possível criar dois objetos de cliente:
O
MeetMainStageClient
de um complemento em execução no estágio principal, que pode ser recuperado usandoawait session.createMainStageClient()
.O
MeetSidePanelClient
de um complemento em execução no painel secundário, recuperável usandoawait session.createSidePanelClient()
.
É importante recuperar o objeto de cliente correto para o cenário principal ou o painel lateral. Se o cliente errado for recuperado, o SDK de complementos do Google Meet vai gerar
uma exceção. Para verificar em qual iframe (cenário principal ou painel lateral) o
complemento está sendo executado, use o
método
MeetAddon.getFrameType
.
O exemplo de código a seguir mostra como instanciar o objeto de cliente do estágio principal:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
const mainStageClient = await session.createMainStageClient();
Funcionalidade compartilhada
Algumas funcionalidades estão disponíveis no MeetMainStageClient
e no
MeetSidePanelClient
, enquanto outras são específicas de um determinado
cliente.
Por exemplo, algumas funcionalidades disponíveis nos dois clientes incluem:
- O método
MeetAddonClient.getCollaborationStartingState
, que recebe informações sobre o estado inicial do complemento quando o participante aceita o convite para colaborar. - O método
MeetAddonClient.getMeetingInfo
que recebe detalhes sobre a reunião em que o complemento está sendo executado. - O método
MeetAddonClient.getMeetPlatformInfo
que recebe detalhes sobre a plataforma da reunião em que o complemento está sendo executado. - O
MeetAddonClient.setCollaborationStartingState
, que define o estado inicial do complemento quando o participante aceita o convite para colaborar. - Para uma lista abrangente de funcionalidades em ambos os clientes, consulte o
objeto
MeetAddonClient
.
Funcionalidade específica do cliente
Funcionalidade disponível apenas no
MeetMainStageClient
:
O
MeetMainStageClient.notifySidePanel
envia uma mensagem ao painel lateral. A mensagem pode ser recebida ao se inscrever no callback frameToFrameMessage (link em inglês) no painel lateral.O método
MeetMainStageClient.loadSidePanel
abre o iframe do painel lateral. A origem do iframe é definida como o URL do painel lateral do arquivo de manifesto.O método
MeetMainStageClient.unloadSidePanel
fecha o iframe do painel lateral. O estado do complemento não é mantido no Meet quando o método é chamado. Cabe ao complemento manter qualquer estado antes que esse método seja chamado.
Funcionalidade disponível apenas no
MeetSidePanelClient
:
- O
MeetSidePanelClient.notifyMainStage
envia uma mensagem para o mainStage. A mensagem pode ser recebida ao se inscrever no callback frameToFrameMessage (link em inglês) no cenário principal.