Compilación de aplicaciones para la fase de reunión de 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. 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.

Configuración del manifiesto de aplicación para aplicaciones en la fase de reunión

Para compartir una aplicación en la fase de reunión, debe configurar el contexto y los permisos de RSC en el manifiesto de la aplicación:

1. Actualice la context propiedad en el manifiesto de la aplicación de la siguiente manera:

   "context": [
     "meetingSidePanel",
     "meetingStage"
   ]
   

2. 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"
         }
       ]
     }
   }
   

Uso compartido avanzado para las API de fase

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:

1. 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.

2. 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.

3. 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, hemos publicado las API dentro de la biblioteca cliente JavaScript de Microsoft Teams (TeamsJS) que 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

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

Móvil

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

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

Compartir contenido de la aplicación para API de fase

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.

Requisito previo

appContentUrl la matriz debe permitirse validDomains dentro de manifest.json; de lo contrario, la API devuelve un error 501.

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 compartirá en la fase.

Ejemplo

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

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

Códigos de respuesta

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

Código de respuesta	Descripción
500	Error interno.
501	La API no se admite en el contexto actual.
1 000	La aplicación no tiene los permisos adecuados para permitir que el recurso compartido se almacene en fase.

Obtención de la API de estado de uso compartido de la fase de contenido de la aplicación

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

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 en caso de 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 en caso de error.

Ejemplo

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
}

Códigos de respuesta

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

Código de respuesta	Descripción
500	Error interno.
501	La API no se admite en el contexto actual.
1 000	La aplicación no tiene los permisos adecuados para permitir que el recurso compartido se almacene en fase.

API de obtención de funcionalidades de uso compartido de la fase de contenido de la aplicación

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 asistente no tendrá habilitado el botón compartir en fase y la capacidad de compartir la aplicación para realizar la fase. Para obtener más información, consulte Roles de usuario en la reunión de Teams.

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 en caso de error.

Ejemplo

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
} 

Códigos de respuesta

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

Código de respuesta	Descripción
500	Error interno.
501	La API no se admite en el contexto actual.
1 000	La aplicación no tiene permisos para permitir que el recurso compartido se almacene provisionalmente.

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.

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.

Compatibilidad de características por tipos de usuario

En la tabla siguiente se proporcionan los tipos de usuario y se enumeran las características a las que cada usuario puede acceder en las reuniones:

Tipo de usuario	Reunión programada o reunión de calendario instantáneo	Llamada uno a uno	Llamada de grupo	Reunión programada del canal
En el inquilino	El moderador o organizador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.	El moderador o organizador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.	El moderador o organizador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.	El moderador o organizador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.
Guest	El moderador o organizador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.	El moderador o organizador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.	El moderador o organizador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.	El moderador o organizador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.
Federado o externo	El moderador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.	No disponible	No disponible	El moderador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.
Anónimo	El moderador puede iniciar, ver e interactuar con la aplicación en la fase de reunión. El asistente solo puede ver e interactuar.	No disponible	No disponible	No disponible

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 recursos compartidos en vivo 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 de Teams y Stageview específico del usuario.	View	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.

Vea también

• Aplicaciones para reuniones de Teams
• Habilitación de la autenticación mediante un proveedor de OAuth de terceros
• Consentimiento específico de recursos para permisos delegados
• Crear vínculos profundos
• API de aplicaciones de reunión
• Escenas personalizadas del Modo conferencia
• SDK de Live Share