Compartir pantalla para promocionar un complemento entre los usuarios

Promocionar un complemento mediante el uso compartido de pantalla.

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:

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.