Promociona un complemento para los usuarios

Los desarrolladores pueden aumentar la visibilidad de sus complementos promocionándolos a través del chat de la llamada de Meet y de la función de compartir pantalla de Meet.

Chat de la llamada

Los complementos de Google Meet se promocionan automáticamente para los usuarios en el chat de la llamada de Meet cuando un mensaje contiene vínculos asociados con un complemento. El desarrollador no necesita realizar ninguna acción para promocionar complementos en el chat. El equipo de revisión determina qué vínculos asociar con un complemento, según el URI del panel lateral y los orígenes del complemento establecidos en el manifiesto de implementación.

Cuando los usuarios envían un mensaje a través de un chat de la llamada asociado con un complemento, ocurre una de estas dos situaciones:

1. Si el complemento no está instalado, una tarjeta le solicita al usuario que lo instale.
2. Si el complemento ya está instalado, un botón le recuerda al usuario que lo abra.

Compartir 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 permite que el sitio envíe información a Meet cuando se comparte la pantalla de su pestaña.exposeToMeetWhenScreensharing() Esta información se usa en la experiencia del complemento con Meet cuando el usuario hace clic en "Iniciar actividad" en el banner de presentación si tiene instalado el complemento. Si el usuario no tiene instalado el complemento cuando comparte la pantalla de una pestaña, se le solicita que lo instale.

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

• additionalData: Es la información que el complemento puede usar para inicializarse. Solo se puede configurar si la propiedad startActivityOnOpen es verdadera y se puede acceder a ella con ActivityStartingState. Para obtener más información, consulta Obtén el estado inicial de la actividad.

• cloudProjectNumber: Es obligatorio. Es el número de proyecto de tu proyecto de Google Cloud.

• mainStageUrl: Es la URL que se abre en el escenario principal una vez que se inicia el complemento, como https://www.example.com. La URL debe pertenecer al mismo origen que las URLs especificadas en el manifiesto del complemento.

• sidePanelUrl: Es la URL que se abre en el panel lateral una vez que se inicia el complemento, como https://www.example.com. La URL debe pertenecer al mismo origen que las URLs especificadas en el manifiesto del complemento.

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

Instala e importa el SDK

Puedes acceder al SDK con npm o gstatic.

npm install @googleworkspace/meet-addons

import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';

<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>

Ejemplo: Carga en el panel lateral sin iniciar una actividad

En la siguiente muestra de código, un usuario comparte la pantalla de una página con un complemento que debe ajustar los permisos de recursos antes de que se pueda iniciar la actividad. Debido a este requisito, el complemento debe iniciarse en el panel lateral, sin que se inicie la actividad para todos.

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

Reemplaza lo siguiente:

• CLOUD_PROJECT_NUMBER: Es una cadena. Es el número de proyecto de tu proyecto de Cloud.
• SIDE_PANEL_URL: Es una cadena. Es la URL del panel lateral.

Cuando el usuario en la pantalla de llamada de Meet comparte la pantalla de la página, ve un banner de presentación en Meet. Si hace clic en el botón del banner, se abre el complemento para el número de proyecto de Cloud determinado en el panel lateral. Como la startActivityOnOpen propiedad se estableció en falso, el botón de inicio de actividad está inhabilitado hasta que se establece la ActivityStartingState. Para obtener más información, consulta Usa el estado inicial de la actividad.

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

El complemento de muestra "Animation" en GitHub incluye este ejemplo como parte de un complemento completo. Cuando se presenta la página de índice de la app web asociada con el complemento, se le solicita al usuario que presenta que instale o configure el complemento.

Ejemplo: Carga en el escenario principal

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

<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: Es una cadena. Es el número de proyecto de tu proyecto de Google Cloud.
• MAIN_STAGE_URL: Es una cadena. Es la URL del escenario principal.

Cuando el usuario en la pantalla de llamada de Meet comparte la pantalla de la página, ve un banner de presentación en Meet. Si hace clic en el botón del banner, se abre el complemento para el número de proyecto de Cloud determinado en el escenario principal. Se carga la propiedad mainStageUrl y se usa la propiedad additionalData para establecer el estado inicial de la actividad del complemento. Se les solicita de inmediato a los demás usuarios de la llamada que instalen o inicien el complemento.

Ejemplo: Carga en el panel lateral

En la siguiente muestra de código, un usuario comparte la pantalla de una página con un complemento que quiere iniciar en el panel lateral en lugar del escenario principal:

<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: Es una cadena. Es el número de proyecto de tu proyecto de Cloud.
• SIDE_PANEL_URL: Es una cadena. Es la URL del panel lateral.

Cuando el usuario en la pantalla de llamada de Meet comparte la pantalla de la página, ve un banner de presentación en Meet. Si hace clic en el botón del banner, se abre el complemento para el número de proyecto de Cloud determinado en el panel lateral. Se carga la propiedad sidePanelUrl y se usa la propiedad additionalData para establecer el estado inicial de la actividad del complemento. Se les solicita de inmediato a los demás usuarios de la llamada que instalen o inicien el complemento.

Coincidencia de origen

Los orígenes proporcionados en la mainStageUrl propiedad y la sidePanelUrl propiedad se comparan con los orígenes en el manifiesto del complemento 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 el uso compartido de pantalla debe aparecer en el campo addOnOrigins del manifiesto del complemento.

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

Temas relacionados

• Colabora con un complemento de Meet
• Seguridad de los complementos