Compilación de aplicaciones para la fase de reunión de Teams

Artículo
10/29/2024

Microsoft Teams mejora las experiencias de reunión al proporcionar características que facilitan la colaboración y la comunicación sin problemas. La función de uso compartido de pantalla es un ejemplo excelente, lo que permite a los usuarios presentar toda la pantalla, ventanas específicas o incluso sesiones de pizarra. Esta funcionalidad es esencial para presentaciones eficaces y trabajo colaborativo, ya que garantiza que todos los participantes puedan ver e interactuar con el contenido compartido, lo que hace que las reuniones virtuales sean más dinámicas y atractivas.

Además del uso compartido de pantalla, Microsoft Teams ofrece varias herramientas diseñadas para que las interacciones virtuales sean más productivas. Estas herramientas replican la dinámica de las reuniones en persona, lo que permite a los usuarios trabajar juntos de forma eficaz, independientemente de su ubicación física. La integración de estas características en Teams permite a las organizaciones llevar a cabo reuniones más interactivas y fructíferas, lo que impulsa un mejor trabajo en equipo y resultados.

Compartir en fase y compartir contenido en pantalla en reuniones son características que mejoran la experiencia de uso compartido en Teams. Compartir en fase permite a los usuarios compartir una aplicación en la fase de reunión desde el panel lateral de la reunión en una reunión en curso. Compartir contenido en pantalla en reuniones permite a los usuarios compartir contenido en la fase de reunión de Teams mediante la arquitectura de uso compartido de pantalla.

En la tabla siguiente se enumeran los escenarios para usar el recurso compartido de pantalla y el uso compartido para preconfigurar las características:

Característica	Compartir en fase	Compartir contenido de pantalla para la fase
Nivel de interacción	Permite a los asistentes interactuar con el contenido.	Modo de solo visualización de la aplicación o el contenido.
Scenarios	Experiencias de colaboración, como la pizarra.	Escenarios de coconsumption, como la revisión de paneles en una reunión de scrum.
Esfuerzo del desarrollador	Requiere más esfuerzo.	Tiene como objetivo reducir el esfuerzo del desarrollador para llevar la aplicación o el contenido a la fase de reunión.
Lógica de implementación	Adecuado para reuniones más pequeñas.	Adecuado para reuniones más grandes o cuando solo un usuario tiene una licencia Premium.

Compartir en fase permite a los usuarios compartir una aplicación en la fase de reunión desde el panel lateral de la reunión en una reunión en curso. Este uso compartido es interactivo y colaborativo en comparación con el uso compartido de pantalla pasivo.

Para invocar el recurso compartido a la fase, los usuarios pueden seleccionar el icono Compartir en escenario en la parte superior derecha del panel lateral de la reunión. El icono Compartir en fase es nativo del cliente de Teams y al seleccionarlo se comparte toda la aplicación en la fase de reunión.

Manifiesto de la aplicación

Para compartir una aplicación en la fase de reunión, debe configurar el contexto y los permisos de consentimiento específico de recursos (RSC) en el manifiesto de la aplicación:

Actualice la context propiedad en el manifiesto de la aplicación de la siguiente manera:
```
"context": [
  "meetingSidePanel",
  "meetingStage"
]
```

Obtenga los permisos de RSC configurando la authorization propiedad y name y type en el campo de la resourceSpecific siguiente manera:

"authorization": {
  "permissions": {
    "resourceSpecific": [
      {
        "name": "MeetingStage.Write.Chat",
        "type": "Delegated"
      }
    ]
  }
}

Hay muchos escenarios en los que compartir toda la aplicación en la fase de reunión no es tan útil como compartir partes específicas de la aplicación:

Para una aplicación de lluvia de ideas o pizarra, es posible que un usuario quiera compartir un panel específico en una reunión frente a toda la aplicación con todos los paneles.
Para una aplicación médica, es posible que un médico quiera compartir solo los rayos X en la pantalla con el paciente en lugar de compartir toda la aplicación con todos los registros o resultados de los pacientes, etc.
Es posible que un usuario quiera compartir contenido de un único proveedor de contenido a la vez (por ejemplo, YouTube) en lugar de compartir un catálogo de vídeos completo en el escenario.

Para ayudar a los usuarios en estos escenarios, las API de la biblioteca cliente JavaScript de Microsoft Teams (TeamsJS) permiten invocar mediante programación el recurso compartido para realizar la fase de partes específicas de la aplicación desde un botón del panel lateral de la reunión.

Escritorio
Móvil

En la imagen siguiente se muestra la opción compartir para almacenar provisionalmente en el cliente de escritorio de Teams:

Captura de pantalla que muestra el recurso compartido a stageview de reunión.

Use las siguientes API para compartir una parte específica de la aplicación:

Método	Descripción	Origen
Compartir contenido de la aplicación en la fase	Comparta partes específicas de la aplicación en la fase de reunión desde el panel lateral de la reunión en una reunión.	Biblioteca teamsJS
Obtener el estado de uso compartido del contenido de la aplicación	Obtenga información sobre el estado de uso compartido de la aplicación en la fase de reunión.	Biblioteca teamsJS
Obtener funcionalidades de uso compartido de la fase de contenido de la aplicación	Capture las capacidades de la aplicación para compartir en la fase de reunión.	Biblioteca teamsJS

La shareAppContentToStage API le permite compartir partes específicas de la aplicación en la fase de reunión. La API está disponible a través de la biblioteca TeamsJS.

La validDomains matriz debe permitir el appContentUrl manifest.json interno. De lo contrario, la API devuelve un error 501.

El código siguiente es un ejemplo de shareAppContentToStage API:

const appContentUrl = "https://www.bing.com/";

microsoftTeams.meeting.shareAppContentToStage((err, result) => {
    if (result) {
        // handle success
    }
    if (err) {
        // handle error
    }
}, appContentUrl);

Parámetro de consulta

En la tabla siguiente se incluyen los parámetros de consulta:

Valor	Tipo	Obligatorio	Descripción
`callback`	Cadena	Sí	La devolución de llamada contiene dos parámetros, error y resultado. El error puede contener un error de tipo SdkError o null cuando el recurso compartido se realiza correctamente. El resultado puede contener un valor true si hay un recurso compartido correcto o null cuando se produce un error en el recurso compartido.
`appContentURL`	Cadena	Sí	Dirección URL que se comparte en la fase.
`shareOptions`	Objeto	No	Define opciones de uso compartido adicionales.
`shareOptions.sharingProtocol`	Enum	No	Protocolo de uso compartido de pantalla. Los valores admitidos son `Collaborative` y `ScreenShare`. El valor predeterminado es `Collaborative`.

La getAppContentStageSharingState API le permite capturar información sobre el uso compartido de aplicaciones en la fase de reunión.

La tabla siguiente es un ejemplo de getAppContentStageSharingState API:

microsoftTeams.meeting.getAppContentStageSharingState((err, result) => {
    if (result.isAppSharing) {
        // Indicates if app is sharing content on the meeting stage.
    }
});

El cuerpo de la respuesta JSON para la API de getAppContentStageSharingState es:

{
  "isAppSharing": true
}

Parámetro de consulta

En la tabla siguiente se incluye el parámetro de consulta:

Valor	Tipo	Obligatorio	Descripción
callback	Cadena	Sí	La devolución de llamada contiene dos parámetros, error y resultado. El error puede contener un error de tipo SdkError si hay un error o null cuando el recurso compartido se realiza correctamente. El resultado puede contener un `IAppContentStageSharingState` objeto cuando el recurso compartido es correcto o null si se produce un error.

La getAppContentStageSharingCapabilities API le permite capturar las funcionalidades de la aplicación para compartir el contenido de la aplicación en la fase de reunión. Las aplicaciones deben llamar a la getAppContentStageSharingCapabilities API para habilitar o deshabilitar el botón compartir personalizado para realizar la fase de un participante de la reunión en el panel lateral de la reunión. El botón Compartir en fase debe deshabilitarse u ocultarse si un participante de la reunión no tiene permiso para compartir el contenido de la aplicación en la fase de reunión.

Las funcionalidades de uso compartido de aplicaciones dependen del tipo de usuario de inquilino y de los roles de participante en una reunión.

Tipo de usuario: los participantes en el inquilino, invitado y tipo de usuario externo pueden compartir la aplicación para realizar la fase y también ver e interactuar con la aplicación que se comparte en el escenario. El usuario anónimo no puede ver, compartir ni interactuar con la aplicación que se comparte en el escenario. Para obtener más información, vea Tipos de usuario en una reunión.
Roles de usuario: los participantes con roles de usuario moderador y organizador en una reunión pueden compartir la aplicación para realizar la fase. El botón Compartir en fase y la capacidad de compartir la aplicación para la fase no están habilitados para el asistente. Para obtener más información, consulte Roles de usuario en la reunión de Teams.

El código siguiente es un ejemplo de getAppContentStageSharingCapabilities API:

microsoftTeams.meeting.getAppContentStageSharingCapabilities((err, result) => {
    if (result.doesAppHaveSharePermission) {
        // Indicates if the meeting participant has permission to share content to the meeting stage.
    }
});

El cuerpo de respuesta JSON para getAppContentStageSharingCapabilities API es:

{
   "doesAppHaveSharePermission":true
}

Parámetro de consulta

En la tabla siguiente se incluye el parámetro de consulta:

Valor	Tipo	Obligatorio	Descripción
callback	Cadena	Sí	La devolución de llamada contiene dos parámetros, error y resultado. El error puede contener un error de tipo SdkError o null cuando el recurso compartido se realiza correctamente. El resultado puede contener un `IAppContentStageSharingCapabilities` objeto, cuando el recurso compartido es correcto o null cuando se produce un error.

Nota:

Solo los usuarios en el inquilino o invitados y externos con rol de moderador o organizador pueden iniciar una sesión de uso compartido.
No se admite el uso de recursos compartidos de pantalla en Mac, teams clásicos, dispositivos móviles, web y VDI.

Los usuarios pueden compartir contenido en pantalla en la fase de reunión en Teams mediante la arquitectura de uso compartido de pantalla. Cuando un usuario comparte una aplicación en la fase de reunión, la aplicación se representa solo en el dispositivo del moderador y, a continuación, la pantalla se comparte o refleja a todos los demás asistentes en una nueva ventana. Una vez que el contenido de la aplicación se comparte en una reunión, todos los participantes pueden ver el contenido, pero solo el moderador tiene la capacidad de interactuar con el contenido, lo que proporciona una experiencia de visualización de varios jugadores.

El contenido del recurso compartido de pantalla a la fase de reunión simplifica el uso compartido de contenido de la aplicación durante las reuniones y proporciona una experiencia de visualización de varios reproductores sin problemas. Vamos a explorar los casos de uso de la característica:

Para desarrolladores	Para los usuarios
Presentación de contenido coordinada: ahora puede mostrar contenido coordinado a varios participantes en una fase más grande, más allá del panel lateral de ancho fijo. Esta visibilidad ampliada atrae más atención y se integra estrechamente con el ciclo de vida de la reunión.	Uso de herramientas contextuales: los usuarios pueden usar sin problemas sus herramientas favoritas dentro del contexto de comunicación en curso. Esto minimiza el cambio de contexto y mejora los resultados de las reuniones.
Uso compartido de aplicaciones de fábrica: el uso compartido básico de toda la aplicación está disponible de forma inmediata, sin necesidad de realizar ninguna inversión adicional. Este enfoque simplificado simplifica el proceso de uso compartido de contenido.	Visualización de contenido insertado: el contenido aparece alineado dentro de la ventana de reunión, lo que garantiza un fácil acceso para todos los participantes. No es necesario salir de la conversación.
API mejoradas para el uso compartido de contenido específico: las API de uso compartido existente en fase se han mejorado para habilitar el uso compartido de contenido específico a través del protocolo de uso compartido de pantalla. Ahora puede personalizar el uso compartido de contenido para satisfacer casos de uso específicos.	Botón Compartir en paneles del lado de la reunión: los usuarios con estos roles pueden iniciar el uso compartido de contenido directamente desde los paneles laterales de la reunión. Esto permite a los presentadores interactuar con el público de forma eficaz.
Compatibilidad con los botones Deep Link y "Share in Meeting": use el protocolo de uso compartido de pantalla para compartir contenido a través de vínculos profundos o mediante el botón "Compartir en la reunión". Esta flexibilidad garantiza una experiencia perfecta para los usuarios.	Los participantes pueden empezar a compartir contenido a través de un vínculo profundo o mediante el botón "Compartir en la reunión". Ambas opciones las expone usted, lo que permite una experiencia sin problemas.

Los usuarios pueden compartir contenido en pantalla en la fase de reunión en los siguientes escenarios:

Compartir toda la aplicación: al compartir una pestaña en la fase de reunión de una reunión de Teams, el contentUrl asociado a la pestaña aparece en una nueva ventana para la aplicación y la pantalla comparte esa ventana con todos los demás participantes de la reunión. La page.frameContext propiedad del getContext objeto se establece meetingStage en para indicar a la aplicación que se presenta en una superficie grande, lo que permite a la aplicación actualizar su contenido correctamente.

Nota:

Las aplicaciones que especifican MeetingStage en la page.frameContext propiedad del getContext objeto en el manifiesto y declaran MeetingStage.Write.Chat permisos admiten la infraestructura de uso compartido de colaboración en fase. El botón compartir inicia el protocolo de colaboración existente en lugar del protocolo de uso compartido de pantalla.
Comparta partes específicas de la aplicación en la fase de reunión: especifique el protocolo de uso compartido adecuado junto con appContentURL.

El código siguiente es un ejemplo de uso compartido del contenido de la aplicación en la vista de la fase de reunión y el uso compartido de contenido solo en el modo de uso compartido de pantalla:

Compartir contenido de la aplicación
Recurso compartido de pantalla de solo visualización

   // Share the content to meeting stage view.
    const shareSpecificAppContent = (partName) => {
        var appContentUrl = "";
        microsoftTeams.app.getContext().then((context) => {
            appContentUrl = partName == 'todo' ? `${window.location.origin}/todoView?meetingId=${context.meeting.id}` : partName == 'doing' ? `${window.location.origin}/doingView?meetingId=${context.meeting.id}` : `${window.location.origin}/doneView?meetingId=${context.meeting.id}`;
            microsoftTeams.meeting.shareAppContentToStage((err, result) => {
                if (result) {
                    // handle success
                    console.log(result);
                }

                if (err) {
                    // handle error
                    alert(JSON.stringify(err))
                }
            }, appContentUrl);
        });
    };

  // Share the content in view-only screen sharing mode.
      const shareSpecificAppContentScreenShare = (partName) => {
          var appContentUrl = "";
          microsoftTeams.app.getContext().then((context) => {
              appContentUrl = partName == 'todo' ? `${window.location.origin}/todoView?meetingId=${context.meeting.id}` : partName == 'doing' ? `${window.location.origin}/doingView?meetingId=${context.meeting.id}` : `${window.location.origin}/doneView?meetingId=${context.meeting.id}`;
              microsoftTeams.meeting.shareAppContentToStage((err, result) => {
                  if (result) {
                      // handle success
                      console.log(result);
                  }

                  if (err) {
                      // handle error
                      alert(JSON.stringify(err))
                  }
              }, appContentUrl,
                  // Optional shareOptions with sharingProtocol set to ScreenShare
                  {
                      sharingProtocol: microsoftTeams.meeting.SharingProtocol.ScreenShare
                  });
          });
      };

Valor	Tipo	Obligatorio	Descripción
`callback`	Cadena	Sí	La devolución de llamada contiene dos parámetros, error y resultado. El error puede contener un error de tipo SdkError o null cuando el recurso compartido se realiza correctamente. El resultado puede contener un valor true si hay un recurso compartido correcto o null cuando se produce un error en el recurso compartido.
`appContentURL`	Cadena	Sí	Dirección URL que se comparte en la fase.
`shareOptions`	Objeto	No	Define opciones de uso compartido adicionales.
`shareOptions.sharingProtocol`	Enum	No	Protocolo de uso compartido de pantalla. Los valores admitidos son `Collaborative` y `ScreenShare`. El valor predeterminado es `Collaborative`.

Para obtener más información sobre los parámetros, vea shareAppContentToStage.

Nota:

Si el valor de la sharingProtocol propiedad se establece como screenShare, no es necesario establecer MeetingStage en el getContext objeto del manifiesto. se requieren permisos de consentimiento de Resource-Specific (RSC) en el manifiesto de la aplicación para la shareAppContentToStage API, independientemente del sharingProtocol valor usado.

Escenarios

Escenario	Ejemplo
Aplicación de habilitación de ventas	Phoebe, representante de ventas de Contoso, ancla la aplicación de habilitación de ventas a su próxima reunión con Nicolette, la vicepresidenta de RR. HH. en NorthWest. Durante la reunión, Phoebe abre el panel lateral de la aplicación de habilitación de ventas y ve una lista de contenido precuerdado que puede compartir en la reunión para ayudar a su lanzamiento de ventas. Nicolette puede consumir el contenido en su ventana de reunión de Teams y formular preguntas basadas en el contenido que se muestra.
Contoso Cloud Board	Demet, un director técnico de programas de Contoso, ayuda a ejecutar las reuniones diarias de scrum de varios equipos de la organización. Para cada scrum, ancla el panel correspondiente al pod como una pestaña a la reunión de standup. Durante la reunión, abre el panel lateral de la aplicación Contoso y selecciona el botón Compartir proporcionado en el panel lateral. Esto permite que la junta se haga cargo de la fase de reunión para todos los participantes, de modo que todos los usuarios puedan ver la misma tabla. A medida que cada miembro comparte sus actualizaciones, Demet realiza los cambios adecuados en el panel de sprint, que luego se refleja para todos los demás asistentes.

Escenario

Ejemplo

Aplicación de habilitación de ventas

Phoebe, representante de ventas de Contoso, ancla la aplicación de habilitación de ventas a su próxima reunión con Nicolette, la vicepresidenta de RR. HH. en NorthWest. Durante la reunión, Phoebe abre el panel lateral de la aplicación de habilitación de ventas y ve una lista de contenido precuerdado que puede compartir en la reunión para ayudar a su lanzamiento de ventas. Nicolette puede consumir el contenido en su ventana de reunión de Teams y formular preguntas basadas en el contenido que se muestra.

Contoso Cloud Board

Demet, un director técnico de programas de Contoso, ayuda a ejecutar las reuniones diarias de scrum de varios equipos de la organización. Para cada scrum, ancla el panel correspondiente al pod como una pestaña a la reunión de standup. Durante la reunión, abre el panel lateral de la aplicación Contoso y selecciona el botón Compartir proporcionado en el panel lateral. Esto permite que la junta se haga cargo de la fase de reunión para todos los participantes, de modo que todos los usuarios puedan ver la misma tabla. A medida que cada miembro comparte sus actualizaciones, Demet realiza los cambios adecuados en el panel de sprint, que luego se refleja para todos los demás asistentes.

Ventajas

Puede mostrar contenido coordinado a varios participantes en una fase más grande, obtener más atención e integrarse más estrechamente con el ciclo de vida de la reunión.
El uso compartido básico para toda la aplicación está disponible sin inversión adicional.
Los usuarios pueden usar sus herramientas favoritas en el contexto de su comunicación continua, lo que mejora los resultados de las reuniones.
El contenido se muestra en línea dentro de la ventana de reunión.
Un botón de uso compartido está disponible en todos los paneles del lado de la reunión para los usuarios con roles de organizador o moderador.
Los usuarios pueden iniciar el uso compartido a través de un vínculo profundo o el botón Compartir en la reunión.

Obtener contenido de la aplicación en el panel lateral de la reunión

La sharing.history.getContent API le permite capturar el contenido compartido en una reunión y mostrarlo en el panel lateral de la reunión.

Cuando se inicia una reunión, la aplicación, en la que se comparte el contenido, abre automáticamente el panel lateral de la reunión para el usuario que ha compartido el contenido. Puede llamar a la sharing.history.getContent API para capturar una lista de contenido compartido y mostrarlo en el panel lateral, lo que hace que sea fácilmente accesible. Para una próxima reunión periódica, donde la aplicación ya está agregada, los desarrolladores pueden llamar a la API para obtener el contenido más reciente que se mostrará en el panel lateral de la aplicación.

El código siguiente es un ejemplo para capturar contenido compartido en el panel lateral de la reunión:

// Define an async function
async function fetchContentDetails() {
    // Fetches a list of content details that was shared in the meeting
    const contentDetails = await microsoftTeams.sharing.history.getContent();

    // Above content details can be used to hydrate the meeting side panel 
    // to share to meeting stage

}

Parámetros de carga de respuesta

En la tabla siguiente se incluyen los parámetros de carga de respuesta:

Valor	Tipo	Obligatorio	Descripción
`appId`	Cadena	Sí	Identificador de la aplicación que se va a compartir.
`title`	Cadena	Sí	Título del contenido compartido.
`contentReference`	Cadena	Sí	Vínculo de referencia de contenido del contenido compartido.
`threadId`	Cadena	Sí	Identificador de conversación donde se ha compartido el contenido.
`author`	Cadena	Sí	Identificador del usuario que ha compartido el contenido.
`contentType`	Cadena	Sí	Tipo de contenido compartido. Para compartir en escenarios de fase de Teams, este valor debe ser `ShareToStage`.

Códigos de respuesta

En la tabla siguiente se proporcionan los códigos de respuesta:

Código de respuesta	Descripción
200	Los detalles del contenido de la reunión se recuperaron correctamente.
500	Error interno.
501	La API no se admite en el contexto actual.

Para obtener más información, vea sharing.history.getContent.

Creación de una aplicación de firma de documentos en la reunión

Puede crear una aplicación en la reunión para permitir que los participantes de la reunión firmen documentos en tiempo real. Facilita la revisión y firma de documentos en una sola sesión. Los participantes pueden firmar los documentos con su identidad de inquilino actual.

Puede usar una aplicación de firma en reunión para:

Agregar documentos que se revisarán durante una reunión.
Compartir documentos que se van a revisar en la fase principal.
Firmar documentos con la identidad del firmante.

Los participantes pueden revisar y firmar documentos, como contratos de compra y pedidos de compra.

Captura de pantalla que muestra una aplicación de firma de documentos en la reunión

Los siguientes roles de participante pueden estar implicados durante la reunión:

Creador de documentos: este rol puede agregar sus propios documentos para revisarlos y firmarlos.
Firmante: este rol puede firmar documentos revisados.
Lector: este rol puede ver los documentos agregados a la reunión.

Ejemplo de código

Ejemplo de nombre	Descripción	.NET	Node.js	Manifiesto
Ejemplo de fase de reunión	Esta aplicación de ejemplo muestra una pestaña en la fase de reunión para la colaboración. En este ejemplo también se usa el SDK de Live Share para Stageview de colaboración.	View	View	View
Notificación en la reunión	Muestra cómo implementar notificaciones en reuniones mediante bot.	View	View	View
Firma de documentos en la reunión	Esta aplicación de ejemplo muestra cómo implementar una aplicación de Teams de firma de documentos. Incluye el uso compartido de contenido específico de la aplicación para la fase, el inicio de sesión único (SSO) de Teams y Stageview específico del usuario.	View	ND	ND
Compartir contenido de pantalla para la fase	Esta aplicación de ejemplo muestra cómo la pantalla comparte contenido en la fase de reunión en Teams mediante la arquitectura de uso compartido de pantalla.	Ver	ND	ND

Guía paso a paso

Siga la guía paso a paso para crear una aplicación de firma de documentos en la reunión.

Compartir vía

Compilación de aplicaciones para la fase de reunión de Teams

Manifiesto de la aplicación

Escenarios

Ventajas

Obtener contenido de la aplicación en el panel lateral de la reunión

Creación de una aplicación de firma de documentos en la reunión

Ejemplo de código

Guía paso a paso

Vea también

Recursos adicionales

Compartir vía

Compilación de aplicaciones para la fase de reunión de Teams

Compartir en fase

Manifiesto de la aplicación

Uso compartido avanzado para las API de fase

Compartir contenido de pantalla en reuniones

Escenarios

Ventajas

Obtener contenido de la aplicación en el panel lateral de la reunión

Creación de una aplicación de firma de documentos en la reunión

Ejemplo de código

Guía paso a paso

Vea también

Recursos adicionales