Promover um complemento para os usuários com o compartilhamento de tela

Promover um complemento pelo compartilhamento de tela.

Nesta página, descrevemos como promover um complemento para os usuários enquanto compartilha uma guia com o Google Meet inserindo uma pequena quantidade de código em outra página da Web.

O método MeetAddonScreenshare.exposeToMeetWhenScreensharing permite que o site envie informações para o Meet quando a guia é compartilhada de tela. Essas informações são usadas na experiência do complemento com o Meet quando o usuário clica em "Iniciar atividade" no banner de apresentação se tiver o complemento instalado. Se o usuário não tiver o complemento instalado quando compartilhar a tela de uma guia, ele receberá uma solicitação para instalá-lo.

O objeto AddonScreenshareInfo contém cinco campos que podem ser adicionados com base no caso de uso:

Exemplo: carregamento no cenário principal

No exemplo de código abaixo, um usuário com a tela compartilha uma página da Web no Meet com o código a seguir para iniciar o complemento:

<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Substitua:

  • CLOUD_PROJECT_NUMBER: string. O número do seu projeto na nuvem.
  • MAIN_STAGE_URL: string. É o URL do cenário principal.

Quando o usuário na tela de chamadas do Meet compartilhar a página, ele verá um banner de apresentação no Meet. Clicar no botão do banner abre o complemento para o número fornecido de projeto na nuvem no estágio principal. O AddonScreenshareInfo.mainStageUrl é carregado, e o AddonScreenshareInfo.additionalData é usado para definir o estado inicial da colaboração do complemento. Os outros usuários na chamada recebem uma solicitação imediata para instalar ou iniciar o complemento.

Exemplo: carregar no painel lateral

No exemplo de código abaixo, a tela de um usuário compartilha uma página com um complemento que quer começar no painel lateral, e não no estágio principal:

<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Substitua:

  • CLOUD_PROJECT_NUMBER: string. O número do seu projeto na nuvem.
  • SIDE_PANEL_URL: string. É o URL do painel lateral.

Quando o usuário na tela de chamadas do Meet compartilhar a página, ele verá um banner de apresentação no Meet. Clique no botão do banner para abrir o complemento para o número de projeto na nuvem fornecido no painel lateral. O AddonScreenshareInfo.sidePanelUrl é carregado, e o AddonScreenshareInfo.additionalData é usado para definir o estado inicial da colaboração do complemento. Os outros usuários na chamada recebem uma solicitação imediata para instalar ou iniciar o complemento.

Exemplo: carregar no painel lateral sem iniciar uma colaboração

No exemplo de código abaixo, a tela de um usuário compartilha uma página com um complemento que precisa ajustar as permissões de recursos antes que a atividade de colaboração possa ser iniciada. Devido a esse requisito, o complemento precisa ser iniciado no painel lateral, sem que a colaboração seja iniciada para todos.

<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

Substitua:

  • CLOUD_PROJECT_NUMBER: string. O número do seu projeto na nuvem.
  • SIDE_PANEL_URL: string. É o URL do painel lateral.

Quando o usuário na tela de chamadas do Meet compartilhar a página, ele verá um banner de apresentação no Meet. Clique no botão do banner para abrir o complemento para o número de projeto na nuvem fornecido no painel lateral. Como AddonScreenshareInfo.startActivityOnOpen foi definido como falso, o botão de início de atividade vai ficar desativado até que CollaborationStartingState seja definido. Para mais informações, consulte Usar o estado inicial de colaboração.

Quando a atividade for iniciada, os outros usuários na chamada vão receber uma solicitação para iniciar ou instalar o complemento.

Correspondência de origem

As origens fornecidas em AddonScreenshareInfo.mainStageUrl e AddonScreenshareInfo.sidePanelUrl são comparadas às origens no manifesto de complementos do número de projeto na nuvem fornecido. Se tudo corresponder, o usuário poderá iniciar o complemento.

Além disso, a origem do site que inicia o compartilhamento de tela precisa estar listada no campo addOnOrigins do manifesto de complementos.

Para mais informações, consulte Segurança de complementos.