Compartir pantalla para promocionar un complemento entre los usuarios

Promoción de un complemento a través de la pantalla para compartir.

En esta página, se describe cómo promocionar un complemento entre los usuarios mientras compartes la pantalla de una pestaña con Google Meet colocando una pequeña cantidad de código en otra página web.

El exposeToMeetWhenScreensharing() permite que el sitio envíe información a Meet cuando la pestaña se comparte en pantalla. Esta información se usa en el de complementos con Meet cuando el usuario hace clic en “Iniciar actividad” en el banner de la presentación el complemento instalado. Si el usuario no tiene el complemento instalado cuando comparten la pantalla de una pestaña, están que se te solicite instalar el complemento.

El AddonScreenshareInfo contiene cinco propiedades que se pueden agregar según el caso de uso:

  • additionalData: Información que el complemento puede usar para inicializarse. Lata solo se puede establecer si la propiedad startActivityOnOpen es verdadera y se puede a los que se accede mediante ActivityStartingState Para obtener más información, consulta Cómo usar la actividad inicial estado.

  • cloudProjectNumber: Obligatorio. El número de tu proyecto de Google Cloud.

  • mainStageUrl: La URL que abre la etapa principal una vez que se agrega el complemento de inicio de sesión, como https://www.example.com. La URL debe pertenecer a la misma origin como las URLs especificadas en el del complemento.

  • sidePanelUrl: La URL que se abre en el panel lateral una vez que se agrega el complemento de inicio de sesión, como https://www.example.com. La URL debe pertenecer a la misma origin como las URLs especificadas en el del complemento.

  • startActivityOnOpen: Obligatorio. Indica si se debe iniciar la experiencia del complemento de actividad en Meet de inmediato cuando el usuario inicia el complemento desde el banner de presentación. Debe ser verdadero si se usa la propiedad mainStageUrl.

Ejemplo: Carga en la etapa principal

En la siguiente muestra de código, un usuario que comparte una página web en Meet que contenga el siguiente código, se le solicitará que inicie el 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>

Reemplaza lo siguiente:

  • CLOUD_PROJECT_NUMBER: Cadena. El número de proyecto de tu proyecto de Google Cloud.
  • MAIN_STAGE_URL: Cadena. Es la URL del escenario principal.

Cuando el usuario en la pantalla de la llamada de Meet comparte la página, ve un mensaje de de la presentación en Meet. Si haces clic en el botón del banner, se abrirá el complemento del número de proyecto de Cloud determinado en el escenario principal. Se carga la propiedad mainStageUrl, y la Se usa la propiedad additionalData para establecer la actividad que se iniciará estado del complemento. Los demás usuarios de la llamada le solicitará de inmediato que instale o inicie 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 un complemento que quiere comenzar en el panel lateral en lugar de que en la etapa 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>

Reemplaza lo siguiente:

  • CLOUD_PROJECT_NUMBER: Cadena. El número de proyecto de tu proyecto de Cloud.
  • SIDE_PANEL_URL: Cadena. La URL del panel lateral.

Cuando el usuario de la pantalla de llamada de Meet comparte la página, ve un banner de presentación en Meet. Hacer clic en el botón del banner abre el complemento para el número de proyecto de la nube determinado en el panel lateral. Se carga la propiedad sidePanelUrl, y la Se usa la propiedad additionalData para establecer la actividad que se iniciará estado del complemento. Los demás usuarios de la llamada le solicitará de inmediato que instale o inicie el complemento.

Ejemplo: Cómo cargar el panel lateral sin iniciar una actividad

En la siguiente muestra de código, la pantalla de un usuario comparte una página con un un complemento que debe ajustar los permisos de los recursos antes de cómo se puede iniciar la actividad. Debido a este requisito, el complemento se debe iniciar en el panel lateral, sin que se inicie la actividad 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>

Reemplaza lo siguiente:

  • CLOUD_PROJECT_NUMBER: Cadena. El número de proyecto de tu proyecto de Cloud.
  • 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 mensaje de de la presentación en Meet. Hacer clic en el botón del banner abre el complemento para el número de proyecto de la nube determinado en el panel lateral. Ya que el startActivityOnOpen se configuró como false, el botón de inicio de actividad se inhabilitará hasta que la Se estableció ActivityStartingState. Para obtener más información, consulta Cómo usar la actividad estado inicial.

Una vez que se inicia la actividad, se les indica a los demás usuarios de la llamada que hagan lo siguiente: iniciar o instalar el complemento.

Coincidencia de origen

Los origenes proporcionados en la propiedad mainStageUrl y la propiedad sidePanelUrl se comparan con los orígenes del manifiesto del complemento del número de proyecto de Cloud proporcionado. Si todo coincide, el usuario tiene permitido iniciar el complemento.

Además, el origen del sitio que inicia la función de compartir pantalla debe aparecer en el campo addOnOrigins del manifiesto del complemento.

Para obtener más información, consulta Complementos seguridad.