En esta página, se describe cómo promocionar un complemento para los usuarios mientras se comparte la pantalla de una pestaña con Google Meet colocando una pequeña cantidad de código en otra página web.
El método MeetAddonScreenshare.exposeToMeetWhenScreensharing
permite que el sitio envíe información a Meet cuando se comparte la pantalla de su pestaña. Esta información se usa en la experiencia del complemento con Meet cuando el usuario hace clic en "Iniciar actividad" en el banner de la presentación si tiene el complemento instalado. Si el usuario no tiene instalado el complemento cuando comparte una pestaña en la pantalla, se le solicita que lo instale.
El objeto AddonScreenshareInfo
contiene cinco campos que se pueden agregar según el caso de uso:
AddonScreenshareInfo.additionalData
: Es la información que el complemento puede usar para inicializarse. Solo se puede configurar siAddonScreenshareInfo.startActivityOnOpen
es verdadero y se puede acceder a él conCollaborationStartingState
. Para obtener más información, consulta Cómo usar el estado inicial de la colaboración.AddonScreenshareInfo.cloudProjectNumber
: Obligatorio. Es el número de proyecto de Google Cloud del complemento.AddonScreenshareInfo.mainStageUrl
: Es la URL que abre la etapa principal una vez que se inicia el complemento, comohttps://www.example.com
. La URL debe pertenecer al mismo origen que las URL especificadas en el manifiesto del complemento.AddonScreenshareInfo.sidePanelUrl
: Es la URL que abre el panel lateral una vez que se inicia el complemento, comohttps://www.example.com
. La URL debe pertenecer al mismo origen que las URL especificadas en el manifiesto del complemento.AddonScreenshareInfo.startActivityOnOpen
: Obligatorio. Indica si se debe iniciar la experiencia del complemento colaborativo en Meet inmediatamente cuando el usuario inicia el complemento desde el banner de la presentación. Debe ser verdadero si se usaAddonScreenshareInfo.mainStageUrl
.
Ejemplo: Carga en la etapa principal
En la siguiente muestra de código, se le solicita a un usuario que comparte en pantalla una página web en Meet que contiene el siguiente código para iniciar el 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>
Reemplaza lo siguiente:
- CLOUD_PROJECT_NUMBER: Cadena. El número de tu proyecto de la nube.
- MAIN_STAGE_URL: Cadena. La URL de la escena principal.
Cuando el usuario en la pantalla de llamadas de Meet comparte la página, ve un banner de presentación en Meet. Cuando se hace clic en el botón del banner, se abre el complemento del número de proyecto de la nube determinado en la etapa principal. Se carga el AddonScreenshareInfo.mainStageUrl
y se usa AddonScreenshareInfo.additionalData
para establecer el estado inicial de la colaboración del complemento. A los demás usuarios de la llamada se les indicará de inmediato que instalen o inicien el complemento.
Ejemplo: Cárgalo en el panel lateral
En la siguiente muestra de código, la pantalla de un usuario comparte una página con un complemento que quiere comenzar en el panel lateral en lugar de la etapa 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>
Reemplaza lo siguiente:
- CLOUD_PROJECT_NUMBER: Cadena. El número de tu proyecto de la nube.
- SIDE_PANEL_URL: Cadena. La URL del panel lateral.
Cuando el usuario en la pantalla de llamadas de Meet comparte la página, ve un banner de presentación en Meet. Si haces clic en el botón del banner, se abrirá el complemento del número de proyecto de la nube determinado en el panel lateral. Se carga el AddonScreenshareInfo.sidePanelUrl
y se usa AddonScreenshareInfo.additionalData
para establecer el estado inicial de la colaboración del complemento. A los demás usuarios de la llamada se les indicará de inmediato que instalen o inicien el complemento.
Ejemplo: Cárgalo en el panel lateral sin iniciar una colaboración
En la siguiente muestra de código, la pantalla de un usuario comparte una página con un complemento que debe ajustar los permisos de los recursos antes de que se pueda iniciar la actividad de colaboración. Debido a este requisito, el complemento debe iniciarse en el panel lateral, sin que se inicie la colaboración 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>
Reemplaza lo siguiente:
- CLOUD_PROJECT_NUMBER: Cadena. El número de tu proyecto de la nube.
- SIDE_PANEL_URL: Cadena. La URL del panel lateral.
Cuando el usuario en la pantalla de llamadas de Meet comparte la página, ve un banner de presentación en Meet. Si haces clic en el botón del banner, se abrirá el complemento del número de proyecto de la nube determinado en el panel lateral. Como se estableció AddonScreenshareInfo.startActivityOnOpen
como falsa, se inhabilita el botón de inicio de actividad hasta que se establezca CollaborationStartingState
. Para obtener más información, consulta Cómo usar el estado inicial de colaboración.
Una vez que se inicia la actividad, se les solicita a los demás usuarios de la llamada que inicien o instalen el complemento.
Coincidencia de origen
Los orígenes proporcionados en AddonScreenshareInfo.mainStageUrl
y AddonScreenshareInfo.sidePanelUrl
se comparan con los orígenes en el manifiesto del complemento del número de proyecto de la nube proporcionado. Si todo coincide, el usuario puede iniciar el complemento.
Además, el origen del sitio que inicia el uso compartido de la pantalla debe aparecer en el campo addOnOrigins
del manifiesto del complemento.
Para obtener más información, consulta Seguridad de complementos.