Usar um complemento do Meet

Este guia fornece uma visão geral de como as pessoas iniciam e trabalham com um complemento do Google Meet.

Iniciar um complemento no painel "Atividades"

Em uma chamada do Google Meet, um usuário pode clicar no botão "Atividades". Isso abre o painel "Atividades", que mostra uma lista de recursos integrados do Meet e todos os complementos instalados pelo usuário. Ao clicar em um ícone, a visualização do painel lateral do complemento é aberta.

A janela principal e o painel lateral do SDK de complementos do Google Meet.
Figura 1. A janela principal e o painel lateral do SDK de complementos do Google Meet.

Colaborar com outros usuários

Para permitir que os usuários colaborem, o complemento pode definir o ActivityStartingState. Para mais informações, consulte Colaborar usando um complemento do Meet.

Depois de abrir um complemento, os usuários do painel lateral podem começar a trabalhar juntos assim que o complemento invocar o método startActivity().

Por exemplo, um complemento pode querer permitir que os usuários colaborem em um documento, mas não sabe qual documento. Nesse caso, o documento precisa ser selecionado na visualização do painel lateral. Depois de garantir que o documento pode ser compartilhado com outras pessoas, o complemento pode definir ActivityStartingState com outros identificadores de documento necessários.

Colaborar na tela principal

As atividades colaborativas podem ser feitas no painel lateral ou na tela principal. Se um mainStageUrl estiver listado no manifesto do complemento, invocar o método startActivity() abre automaticamente o complemento no palco principal e inicia a atividade.

Quando a janela principal estiver aberta, um complemento poderá fechar o painel lateral chamando o método unloadSidePanel(). Para estender o exemplo anterior, um painel lateral que escolhe um documento pode não ser mais relevante e pode ser fechado.

Para reabrir a visualização do painel lateral, o complemento pode chamar o método loadSidePanel(). Por exemplo, um complemento que cria enquetes para usuários pode reabrir o painel lateral para mostrar as taxas de resposta às perguntas.

Iniciar um complemento no compartilhamento de tela

Os usuários podem iniciar complementos durante o compartilhamento de tela. Se um usuário estiver compartilhando a tela de um site com um complemento, esse site poderá promover o complemento para o usuário usando o método exposeToMeetWhenScreensharing(). Isso mostra ao usuário um banner de notificação na chamada do Meet solicitando que ele instale ou inicie o complemento. Para mais informações, consulte Promover um complemento para usuários por compartilhamento de tela.

Como informações adicionais podem ser fornecidas ao estado inicial do complemento no site que o usuário está compartilhando a tela, o complemento pode pular o painel lateral e iniciar a atividade no palco principal imediatamente após o lançamento. Se o complemento precisar realizar outras etapas, como mudar permissões em um documento para compartilhar, ele poderá ser aberto no painel lateral e seguir o fluxo descrito em Colaborar com outros usuários.