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

Promover um complemento pela tela compartilhamento.

Esta página descreve como promover um complemento para os usuários enquanto compartilha a tela de uma guia com o Google Meet. Basta inserir uma pequena quantidade de código em outra página da Web.

O 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 instalado quando compartilham a tela de uma guia, uma solicitação para instalar o complemento.

O AddonScreenshareInfo contém cinco propriedades que podem ser adicionadas com base no caso de uso:

  • additionalData: Informações que o complemento pode usar para se inicializar. Pode só vai ser definido se a propriedade startActivityOnOpen for verdadeira e puder ser acessados usando o ActivityStartingState. Para mais informações, consulte Usar o estado de início da atividade.

  • cloudProjectNumber: Obrigatório. O número do seu projeto do Google Cloud.

  • mainStageUrl: o URL que o palco principal abre quando o complemento é iniciado, como https://www.example.com. O URL deve pertencer ao mesmo origin como os URLs especificados na manifesto do complemento.

  • sidePanelUrl: O URL que o painel lateral abre assim que o complemento é iniciado, como https://www.example.com. O URL deve pertencer ao mesmo origin como os URLs especificados na manifesto do complemento.

  • startActivityOnOpen: Obrigatório. Se o complemento de atividades será iniciado no Meet assim que o usuário inicia a do complemento no banner da apresentação. Precisa ser verdadeiro se a propriedade mainStageUrl for usada.

.

Exemplo: carregamento no cenário principal

No exemplo de código a seguir, um usuário que compartilha a tela de uma página da Web O Meet com o código a seguir precisa iniciar o Complemento:

<script src="https://www.gstatic.com/meetjs/addons/1.0.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 projeto projeto do Google Cloud.
  • MAIN_STAGE_URL: string. É o URL do cenário principal.

Quando o usuário na tela de chamada do Meet compartilha a página, ele vê 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 em no palco principal. A propriedade mainStageUrl é carregada, e o A propriedade additionalData é usada para definir o início da atividade estado do complemento. Outros usuários na chamada: será solicitado imediatamente a instalar ou iniciar o complemento.

Exemplo: carregar no painel lateral

No exemplo de código a seguir, a tela de um usuário compartilha uma página com um que queira iniciar no painel lateral, do que na fase principal:

<script src="https://www.gstatic.com/meetjs/addons/1.0.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 projeto do Google Cloud.
  • SIDE_PANEL_URL: string. É o URL do painel lateral.

Quando o usuário na tela de ligações do Meet compartilhar a página, ele verá uma banner de apresentação no Meet. Clicar no botão do banner abre o complemento para o número fornecido de projeto na nuvem em no painel lateral. A propriedade sidePanelUrl é carregada, e o A propriedade additionalData é usada para definir o início da atividade estado do complemento. Outros usuários na chamada: será solicitado imediatamente a instalar ou iniciar o complemento.

Exemplo: carregar no painel lateral sem iniciar uma atividade

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

<script src="https://www.gstatic.com/meetjs/addons/1.0.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 projeto do Google Cloud.
  • SIDE_PANEL_URL: string. É o URL do painel lateral.

Quando o usuário na tela de ligações do Meet compartilhar a página, ele verá uma banner de apresentação no Meet. Clicar no botão no banner abre o complemento para o número do projeto do Cloud no painel lateral. Como o startActivityOnOpen propriedade for definida como falsa, o botão de início de atividade ficará desativado até que a ActivityStartingState foi definido. Para mais informações, consulte Usar a atividade estado inicial.

Quando a atividade for iniciada, os outros usuários na chamada vão precisar iniciar ou instalar o complemento.

Correspondência de origem

As origens fornecidas no mainStageUrl e a propriedade sidePanelUrl são comparadas às origens no complemento, manifesto do número fornecido de projeto na nuvem. Se tudo corresponder, o usuário tem permissão para iniciar o complemento.

Além disso, a origem do site que iniciou o compartilhamento de tela precisa ser listada. no campo addOnOrigins do complemento manifesto do app.

Para mais informações, consulte Complemento segurança dos dados.