Compartir pantalla para promocionar un complemento entre los usuarios

Promocionar un complemento mediante la función para compartir pantalla.

En esta página, se describe cómo promocionar un complemento entre los usuarios mientras se comparte la pantalla con Google Meet mediante la colocación de 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 su pestaña se comparte en pantalla. 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 lo tiene instalado). Si el usuario no tiene el complemento instalado 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:

Ejemplo: Carga en la etapa principal

En la siguiente muestra de código, se le solicita a un usuario con pantalla que comparte una página web en Meet que contiene el siguiente código que inicie el complemento:

<script src="https://www.gstatic.com/meetjs/addons/0.1.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 proyecto de la nube.
  • MAIN_STAGE_URL: Cadena. La URL de la etapa principal.

Cuando el usuario en la pantalla de la llamada de Meet comparte la página, ve un banner de presentación en Meet. Cuando haces clic en el botón del banner, se abre el complemento correspondiente al número de proyecto de la nube determinado en la etapa principal. Se carga AddonScreenshareInfo.mainStageUrl y AddonScreenshareInfo.additionalData se usa para establecer el estado inicial de colaboración del complemento. A los demás usuarios de la llamada se les solicitará de inmediato que instalen o inicien el complemento.

Ejemplo: Carga en el panel lateral

En la siguiente muestra de código, la pantalla de un usuario comparte una página con un complemento que desea comenzar en el panel lateral en lugar de en la etapa principal:

<script src="https://www.gstatic.com/meetjs/addons/0.1.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 proyecto de la nube.
  • SIDE_PANEL_URL: Cadena. La URL del panel lateral.

Cuando el usuario en la pantalla de la llamada de Meet comparte la página, ve un banner de presentación en Meet. Cuando haces clic en el botón del banner, se abre el complemento correspondiente al número de proyecto de la nube determinado en el panel lateral. Se carga AddonScreenshareInfo.sidePanelUrl y AddonScreenshareInfo.additionalData se usa para establecer el estado inicial de colaboración del complemento. A los demás usuarios de la llamada se les solicitará de inmediato que instalen o inicien el complemento.

Ejemplo: Carga contenido 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 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.1.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 proyecto de la nube.
  • SIDE_PANEL_URL: Cadena. La URL del panel lateral.

Cuando el usuario en la pantalla de la llamada de Meet comparte la página, ve un banner de presentación en Meet. Cuando haces clic en el botón del banner, se abre el complemento correspondiente al número de proyecto de la nube determinado en el panel lateral. Dado que AddonScreenshareInfo.startActivityOnOpen se estableció como falso, el botón de actividad de inicio estará inhabilitado hasta que se establezca CollaborationStartingState. Para obtener más información, consulta Cómo usar el estado de inicio de la colaboración.

Una vez que se inicia la actividad, se les solicita a los otros usuarios de la llamada que inicien o instalen el complemento.

Coincidencia de orígenes

Los orígenes proporcionados en AddonScreenshareInfo.mainStageUrl y AddonScreenshareInfo.sidePanelUrl se comparan con los orígenes en el manifiesto de complementos del número de proyecto de Cloud proporcionado. Si todo coincide, el usuario puede iniciar el complemento.

Además, el origen del sitio que inicia la pantalla compartida debe aparecer en el campo addOnOrigins del manifiesto de complementos.

Para obtener más información, consulta Seguridad de los complementos.