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 propriedadestartActivityOnOpen
for verdadeira e puder ser acessados usando oActivityStartingState
. 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, comohttps://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, comohttps://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 propriedademainStageUrl
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.