Criar aplicativos para o estágio de reunião do Teams
O compartilhamento no estágio permite que os usuários compartilhem um aplicativo para o estágio de reunião do painel do lado da reunião em uma reunião em andamento. Esse compartilhamento é interativo e colaborativo em comparação ao compartilhamento passivo de tela.
Para invocar o compartilhamento para o estágio, os usuários podem selecionar o ícone Compartilhar para Estágio no lado superior direito do painel lateral da reunião. O ícone Compartilhar para Estágio é nativo do cliente do Teams e selecioná-lo compartilha todo o aplicativo para o estágio de reunião.
Configurações de manifesto de aplicativo para aplicativos em estágio de reunião
Para compartilhar um aplicativo no estágio de reunião, você deve configurar o contexto e as permissões RSC no manifesto do aplicativo:
Atualize a
contextpropriedade no manifesto do aplicativo da seguinte maneira:"context": [ "meetingSidePanel", "meetingStage" ]Obtenha as permissões RSC configurando a
authorizationpropriedade e onameetypeno campo daresourceSpecificseguinte maneira:"authorization": { "permissions": { "resourceSpecific": [ { "name": "MeetingStage.Write.Chat", "type": "Delegated" } ] } }
Compartilhamento avançado para APIs de estágio
Há muitos cenários em que o compartilhamento de todo o aplicativo para o estágio de reunião não é tão útil quanto compartilhar partes específicas do aplicativo:
Para um aplicativo de brainstorming ou whiteboard, um usuário pode querer compartilhar um quadro específico em uma reunião versus todo o aplicativo com todos os quadros.
Para um aplicativo médico, um médico pode querer compartilhar apenas o Raio-X na tela com o paciente versus compartilhar todo o aplicativo com todos os registros ou resultados dos pacientes e assim por diante.
Um usuário pode querer compartilhar conteúdo de um único provedor de conteúdo por vez (por exemplo, YouTube) em vez de compartilhar um catálogo de vídeo inteiro no palco.
Para ajudar os usuários nesses cenários, lançamos APIs na biblioteca de clientes JavaScript do Microsoft Teams (TeamsJS) que permitem invocar programaticamente o compartilhamento para o estágio para partes específicas do aplicativo a partir de um botão no painel lateral da reunião.
A imagem a seguir mostra a opção compartilhar para o estágio no cliente da área de trabalho do Teams:
Use as seguintes APIs para compartilhar parte específica do aplicativo:
| Método | Descrição | Source |
|---|---|---|
| Compartilhar Conteúdo do Aplicativo na Janela de Conteúdo Compartilhado | Compartilhe partes específicas do aplicativo para o estágio de reunião do painel do lado da reunião em uma reunião. | Biblioteca do TeamsJS |
| Obter Estado de Compartilhamento da Janela de Conteúdo | Busque informações sobre o estado de compartilhamento do aplicativo no estágio da reunião. | Biblioteca do TeamsJS |
| Obter Recursos de Compartilhamento da Janela de Conteúdo | Busque os recursos do aplicativo para compartilhar com o estágio da reunião. | Biblioteca do TeamsJS |
Compartilhar conteúdo do aplicativo para preparar a API
A API shareAppContentToStage permite que você compartilhe partes específicas do seu aplicativo no estágio da reunião. A API está disponível por meio da biblioteca do TeamsJS.
Pré-requisito
appContentUrl deve ser permitido por validDomains matriz dentro de manifest.json, caso contrário, a API retorna um erro 501.
Parâmetro de consulta
A tabela a seguir inclui os parâmetros de consulta:
| Valor | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| callback | Cadeia de caracteres | Sim | O retorno de chamada contém dois parâmetros, erro e resultado. O erro pode conter um erro do tipo SdkError ou nulo quando o compartilhamento for bem-sucedido. O resultado pode conter um valor verdadeiro se houver um compartilhamento bem-sucedido ou nulo quando o compartilhamento falhar. |
| appContentURL | Cadeia de caracteres | Sim | A URL que será compartilhada no estágio. |
Exemplo
const appContentUrl = "https://www.bing.com/";
microsoftTeams.meeting.shareAppContentToStage((err, result) => {
if (result) {
// handle success
}
if (err) {
// handle error
}
}, appContentUrl);
Códigos de resposta
A tabela a seguir fornece os códigos de resposta:
| Código da resposta | Descrição |
|---|---|
| 500 | Erro interno. |
| 501 | A API não tem suporte no contexto atual. |
| 1.000 | O aplicativo não tem permissões adequadas para permitir que o compartilhamento seja estágio. |
Obter API de estado de compartilhamento do estágio de conteúdo do aplicativo
A getAppContentStageSharingState API permite buscar informações sobre o compartilhamento de aplicativos no estágio de reunião.
Parâmetro de consulta
A tabela a seguir inclui o parâmetro de consulta:
| Valor | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| callback | Cadeia de caracteres | Sim | O retorno de chamada contém dois parâmetros, erro e resultado. O erro pode conter um erro do tipo SdkError no caso de um erro ou nulo quando o compartilhamento for bem-sucedido. O resultado pode conter um IAppContentStageSharingState objeto quando o compartilhamento é bem-sucedido ou nulo no caso de um erro. |
Exemplo
microsoftTeams.meeting.getAppContentStageSharingState((err, result) => {
if (result.isAppSharing) {
// Indicates if app is sharing content on the meeting stage.
}
});
O corpo da resposta JSON para getAppContentStageSharingState API é:
{
"isAppSharing": true
}
Códigos de resposta
A tabela a seguir fornece os códigos de resposta:
| Código da resposta | Descrição |
|---|---|
| 500 | Erro interno. |
| 501 | A API não tem suporte no contexto atual. |
| 1.000 | O aplicativo não tem permissões adequadas para permitir que o compartilhamento seja estágio. |
Obter a API de recursos de compartilhamento do estágio de conteúdo do aplicativo
A getAppContentStageSharingCapabilities API permite que você busque os recursos do aplicativo para compartilhar o conteúdo do aplicativo para o estágio de reunião. Os aplicativos precisam chamar a getAppContentStageSharingCapabilities API para habilitar ou desabilitar o compartilhamento personalizado no botão de estágio para um participante da reunião no painel lateral da reunião. O botão compartilhar no estágio deve ser desabilitado ou oculto se um participante da reunião não tiver permissão para compartilhar o conteúdo do aplicativo para o estágio de reunião.
Os recursos de compartilhamento de aplicativo dependem do tipo de usuário locatário e das funções participantes em uma reunião.
Tipo de usuário: os participantes do tipo de usuário interno, convidado e externo podem compartilhar o aplicativo para o estágio e também ver e interagir com o aplicativo que está sendo compartilhado no palco. O usuário anônimo não pode ver, compartilhar ou interagir com o aplicativo que está sendo compartilhado no palco. Para obter mais informações, consulte tipos de usuário em uma reunião.
Funções de usuário: participantes com funções de usuário de apresentador e organizador em uma reunião podem compartilhar o aplicativo para o palco. O participante não terá o botão compartilhamento para estágio habilitado e a capacidade de compartilhar o aplicativo para o estágio. Para obter mais informações, confira funções de usuário na reunião do Teams.
Parâmetro de consulta
A tabela a seguir inclui o parâmetro de consulta:
| Valor | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| callback | Cadeia de caracteres | Sim | O retorno de chamada contém dois parâmetros, erro e resultado. O erro pode conter um erro do tipo SdkError ou nulo quando o compartilhamento for bem-sucedido. O resultado pode conter um IAppContentStageSharingCapabilities objeto, quando o compartilhamento é bem-sucedido ou nulo em caso de erro. |
Exemplo
microsoftTeams.meeting.getAppContentStageSharingCapabilities((err, result) => {
if (result.doesAppHaveSharePermission) {
// Indicates if the meeting participant has permission to share content to the meeting stage.
}
});
O corpo da resposta JSON para getAppContentStageSharingCapabilities API é:
{
"doesAppHaveSharePermission":true
}
Códigos de resposta
A tabela a seguir fornece os códigos de resposta:
| Código da resposta | Descrição |
|---|---|
| 500 | Erro interno. |
| 501 | A API não tem suporte no contexto atual. |
| 1.000 | O aplicativo não tem permissões para permitir que o compartilhamento seja estágio. |
Criar um aplicativo de assinatura de documento em reunião
Você pode criar um aplicativo em reunião para permitir que os participantes da reunião assinem documentos em tempo real. Ele facilita a revisão e a assinatura de documentos em uma única sessão. Os participantes podem assinar os documentos usando sua identidade de locatário atual.
Você pode usar um aplicativo de assinatura na reunião para:
- Adicione documentos a serem revisados durante uma reunião.
- Compartilhe documentos a serem revisados para main estágio.
- Assine documentos usando a identidade do signatário.
Os participantes podem examinar e assinar documentos, como contratos de compra e pedidos de compra.
As seguintes funções participantes podem estar envolvidas durante a reunião:
- Criador de documentos: essa função pode adicionar seus próprios documentos a serem revisados e assinados.
- Signatário: essa função pode assinar documentos revisados.
- Leitor: essa função pode exibir os documentos adicionados à reunião.
Compatibilidade de recursos por tipos de usuário
A tabela a seguir fornece os tipos de usuário e lista os recursos que cada usuário pode acessar em reuniões:
| Tipo de usuário | Reunião agendada ou reunião de calendário instantâneo | Chamada um-a-um | Chamada de grupo | Reunião de canal agendada |
|---|---|---|---|---|
| In-tenant | O apresentador ou organizador pode iniciar, exibir e interagir com o aplicativo no estágio de reunião. O participante só pode exibir e interagir. |
O apresentador ou organizador pode iniciar, exibir e interagir com o aplicativo no palco da reunião. O participante só pode exibir e interagir. |
O apresentador ou organizador pode iniciar, exibir e interagir com o aplicativo no palco da reunião. O participante só pode exibir e interagir. |
O apresentador ou organizador pode iniciar, exibir e interagir com o aplicativo no palco da reunião. O participante só pode exibir e interagir. |
| Guest | O apresentador ou organizador pode iniciar, exibir e interagir com o aplicativo no estágio de reunião. O participante só pode exibir e interagir. |
O apresentador ou organizador pode iniciar, exibir e interagir com o aplicativo no palco da reunião. O participante só pode exibir e interagir. |
O apresentador ou organizador pode iniciar, exibir e interagir com o aplicativo no palco da reunião. O participante só pode exibir e interagir. |
O apresentador ou organizador pode iniciar, exibir e interagir com o aplicativo no palco da reunião. O participante só pode exibir e interagir. |
| Federado ou Externo | O apresentador pode iniciar, exibir e interagir com o aplicativo no estágio de reunião. O participante só pode exibir e interagir. |
Não disponível | Não disponível | O apresentador pode iniciar, exibir e interagir com o aplicativo no estágio de reunião. O participante só pode exibir e interagir. |
| Anônimo | O apresentador pode iniciar, exibir e interagir com o aplicativo no estágio de reunião. O participante só pode exibir e interagir. |
Não disponível | Não disponível | Não disponível |
Exemplo de código
| Nome do exemplo | Descrição | .NET | Node.js | Manifesto |
|---|---|---|---|---|
| Exemplo de estágio de reunião | Este aplicativo de exemplo mostra uma guia no estágio de reunião para colaboração. Este exemplo também usa o sdk de compartilhamento ao vivo para o Stageview colaborativo. | View | View | View |
| Notificação na reunião | Demonstra como implementar notificações em reunião usando bot. | View | View | View |
| Assinatura de documento em reunião | Este aplicativo de exemplo mostra como implementar um aplicativo de assinatura de documentos do Teams. Inclui o compartilhamento de conteúdo de aplicativo específico para estágio, SSO do Teams e Stageview específico do usuário. | View | NA | NA |
Guias passo a passo
Siga o guia passo a passo para criar um aplicativo de assinatura de documentos em reunião.
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de