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:
AddonScreenshareInfo.additionalData
: informações que o complemento pode usar para se inicializar. Só pode ser definido seAddonScreenshareInfo.startActivityOnOpen
for verdadeiro e puder ser acessado usando oCollaborationStartingState
. Para mais informações, consulte Usar o estado inicial da colaboração.AddonScreenshareInfo.cloudProjectNumber
: obrigatório. O número do projeto do Google Cloud do complemento.AddonScreenshareInfo.mainStageUrl
: o URL que o cenário principal abre quando o complemento é iniciado, comohttps://www.example.com
. O URL precisa pertencer à mesma origem dos URLs especificados no manifesto do complemento.AddonScreenshareInfo.sidePanelUrl
: o URL que o painel lateral abre quando o complemento é iniciado, comohttps://www.example.com
. O URL precisa pertencer à mesma origem dos URLs especificados no manifesto do complemento.AddonScreenshareInfo.startActivityOnOpen
: obrigatório. Indica se a experiência do complemento colaborativo no Meet será iniciada imediatamente quando o usuário iniciar o complemento no banner da apresentação. Precisa ser verdadeiro seAddonScreenshareInfo.mainStageUrl
for usado.
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.