Compartir sus comentarios:
Nos gustaría recibir sus comentarios sobre los documentos para desarrolladores de Microsoft Teams. Responda a nuestra breve encuesta de tres preguntas.Realizar la encuesta
Este explorador ya no se admite.
Actualice a Microsoft Edge para aprovechar las características y actualizaciones de seguridad más recientes, y disponer de soporte técnico.
Compilación de aplicaciones para la fase de reunión de Teams
Artículo
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
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:
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.
En la imagen siguiente se muestra la opción compartir para almacenar provisionalmente en el cliente de escritorio de Teams:
En la imagen siguiente se muestra la opción compartir para almacenar provisionalmente en el cliente móvil de Teams:
Si usa un recurso compartido avanzado para almacenar provisionalmente la API, puede personalizar el texto en el botón. Estas son las directrices para la personalización:
Usa Compartir y no presentar o compartir pantalla, si tu experiencia ofrece un uso compartido sencillo del contenido de la aplicación en la fase. Esto establece la expectativa adecuada para los usuarios, ya que Compartir significa de forma coherente compartir para realizar la fase en las reuniones de Teams.
Use texto más específico para proporcionar un contexto significativo del escenario. Por ejemplo, puedes usar texto como Ver juntos o Jugar juntos si la aplicación ofrece vídeos o juegos casuales.
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.
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:
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.
Compartir contenido de pantalla en reuniones
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.
En Teams, no puede compartir la pantalla y compartirla en la fase al mismo tiempo.
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:
// 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.
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.
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.
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.
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.
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.
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.
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Comentarios de Platform Docs
Platform Docs es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: