Criar aplicações para a fase de reunião do Teams

O Microsoft Teams melhora as experiências de reunião ao fornecer funcionalidades que facilitam a colaboração e comunicação totalmente integradas. A função de partilha de ecrã é um excelente exemplo, permitindo que os utilizadores apresentem todo o ecrã, janelas específicas ou até sessões de quadro. Esta capacidade é essencial para apresentações eficazes e trabalho colaborativo, uma vez que garante que todos os participantes podem ver e interagir com os conteúdos partilhados, tornando as reuniões virtuais mais dinâmicas e envolventes.

Além da partilha de ecrã, o Microsoft Teams oferece várias ferramentas concebidas para tornar as interações virtuais mais produtivas. Estas ferramentas replicam a dinâmica das reuniões presenciais, permitindo que os utilizadores trabalhem em conjunto de forma eficiente, independentemente da sua localização física. A integração destas funcionalidades no Teams permite que as organizações realizem reuniões mais interativas e frutíferas, impulsionando um melhor trabalho em equipa e resultados.

Partilhar em Fase e Ecrã partilhar conteúdos em reuniões são funcionalidades que melhoram a experiência de partilha no Teams. Partilhar em Fase permite que os utilizadores partilhem uma aplicação na fase da reunião a partir do painel do lado da reunião numa reunião em curso. O conteúdo de partilha de ecrã para reuniões permite que os utilizadores partilhem conteúdos na fase da reunião no Teams através da arquitetura de partilha de ecrã.

A tabela seguinte lista os cenários para utilizar a Partilha de ecrã e Partilhar para testar as funcionalidades:

Partilhar em fase

Partilhar em palco permite que os utilizadores partilhem uma aplicação na fase da reunião a partir do painel do lado da reunião numa reunião em curso. Esta partilha é interativa e colaborativa em comparação com a partilha passiva de ecrã.

Para invocar a partilha no palco, os utilizadores podem selecionar o ícone Partilhar em Fase no canto superior direito do painel do lado da reunião. O ícone Partilhar em Fase é nativo do cliente do Teams e selecioná-lo partilha toda a aplicação com a fase da reunião.

Manifesto do aplicativo

Para partilhar uma aplicação na fase da reunião, tem de configurar as permissões de contexto e consentimento específico do recurso (RSC) no manifesto da aplicação:

1. Atualize a context propriedade no manifesto da aplicação da seguinte forma:

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

2. Obtenha as permissões RSC ao configurar a authorization propriedade e o name e type no campo da resourceSpecific seguinte forma:

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

Partilha avançada para testar APIs

Existem muitos cenários em que partilhar toda a aplicação na fase de reunião não é tão útil como partilhar partes específicas da aplicação:

1. Para uma aplicação de debate de ideias ou quadro, um utilizador poderá querer partilhar um quadro específico numa reunião em comparação com toda a aplicação com todos os quadros.

2. Para uma aplicação médica, um médico pode querer partilhar apenas o Raio-X no ecrã com o paciente versus partilhar toda a aplicação com todos os registos ou resultados dos pacientes e assim por diante.

3. Um utilizador poderá querer partilhar conteúdos de um único fornecedor de conteúdos de cada vez (por exemplo, o YouTube) em vez de partilhar um catálogo de vídeos inteiro em palco.

Para ajudar os utilizadores nestes cenários, as APIs na biblioteca de cliente JavaScript (TeamsJS) do Microsoft Teams permitem-lhe invocar programaticamente a partilha em fase para partes específicas da aplicação a partir de um botão no painel do lado da reunião.

Se utilizar uma partilha avançada para testar a API, pode personalizar o texto no botão. Eis as diretrizes para personalização:

• Utilize Partilhar e não Apresentar ou Partilha de Ecrã, se a sua experiência oferecer uma partilha simples de conteúdos da aplicação para a fase. Isto define a expectativa certa para os utilizadores, uma vez que Partilhar de forma consistente significa Partilhar para realizar reuniões do Teams.
• Utilize texto mais específico para fornecer um contexto significativo do cenário. Por exemplo, pode utilizar texto como Ver em conjunto ou Reproduzir em conjunto se a sua aplicação oferecer vídeos ou jogos casuais.

Utilize as seguintes APIs para partilhar uma parte específica da aplicação:

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

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

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

{
  "isAppSharing": true
}

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

{
   "doesAppHaveSharePermission":true
} 

Conteúdo de partilha de ecrã para reuniões

Os utilizadores podem filtrar conteúdos para a fase da reunião no Teams através da arquitetura de partilha de ecrã. Quando um utilizador partilha uma aplicação na fase da reunião, a aplicação é composta apenas no dispositivo do apresentador e, em seguida, o ecrã é partilhado ou espelhado para todos os outros participantes numa nova janela. Depois de o conteúdo da aplicação ser partilhado numa reunião, todos os participantes podem ver o conteúdo, mas apenas o apresentador tem a capacidade de interagir com o conteúdo, o que proporciona uma experiência de visualização de vários leitores.

O conteúdo da partilha de ecrã na Fase da reunião simplifica a partilha de conteúdos da aplicação durante as reuniões e proporciona uma experiência de visualização multi player totalmente integrada. Vamos explorar os casos de utilização da funcionalidade:

Os utilizadores podem filtrar o conteúdo da partilha para a fase da reunião nos seguintes cenários:

• Partilhar aplicação inteira: quando partilha um separador para a Fase da Reunião numa reunião do Teams, é contentUrl apresentada uma nova janela para a aplicação e partilhas de ecrã com todos os outros participantes da reunião. A page.frameContext propriedade no getContext objeto está definida para meetingStage sinalizar a aplicação de que está a ser apresentada numa superfície grande, permitindo que a aplicação atualize o respetivo conteúdo adequadamente.

  Observação

  As aplicações que especificam na page.frameContext propriedade do getContext objeto no manifesto e declaram MeetingStage.Write.Chat permissões suportam MeetingStage a infraestrutura colaborativa Partilhar em Fase. O botão partilhar inicia o protocolo de colaboração existente em vez do protocolo de partilha de ecrã.

• Partilhar partes específicas da sua aplicação na fase de reunião: especifique o protocolo de partilha adequado juntamente com o appContentURL.

O código seguinte é um exemplo de partilha de conteúdo da aplicação para a vista de palco da reunião e partilhar conteúdo no modo de partilha de ecrã apenas de visualização:

   // 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
                  });
          });
      };

Para obter mais informações sobre parâmetros, veja shareAppContentToStage.

Cenários

Vantagens

• Pode mostrar conteúdos coordenados a vários participantes numa fase maior, a ter mais atenção e a integrar mais estreitamente com o ciclo de vida da reunião.
• A partilha básica para toda a aplicação está disponível sem investimento adicional.
• Os utilizadores podem utilizar as suas ferramentas favoritas no contexto da comunicação contínua, melhorando os resultados da reunião.
• O conteúdo é apresentado inline na janela da reunião.
• Está disponível um botão de partilha em todos os painéis do lado da reunião para utilizadores com funções de organizador ou apresentador.
• Os utilizadores podem iniciar a partilha através de uma ligação avançada ou do botão Partilhar na Reunião.

Obter conteúdo da aplicação no painel do lado da reunião

A sharing.history.getContent API permite-lhe obter o conteúdo partilhado numa reunião e apresentar no painel do lado da reunião.

Quando uma reunião começa, a aplicação, na qual o conteúdo é partilhado, abre automaticamente o painel do lado da reunião para o utilizador que partilhou o conteúdo. Pode chamar a sharing.history.getContent API para obter uma lista de conteúdos partilhados e apresentá-la no painel lateral, tornando-a facilmente acessível. Para uma próxima reunião periódica, onde a aplicação já foi adicionada, os programadores podem ligar para a API para obterem os conteúdos mais recentes a serem apresentados no painel lateral da aplicação.

O código seguinte é um exemplo para obter conteúdo partilhado no painel do lado da reunião:

// 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 payload de resposta

A tabela seguinte inclui os parâmetros de payload de resposta:

Códigos de resposta

A tabela a seguir fornece os códigos de resposta:

Para obter mais informações, consulte sharing.history.getContent.

Criar uma aplicação de assinatura de documentos em reunião

Pode criar uma aplicação em reunião para permitir que os participantes da reunião assinem documentos em tempo real. Facilita a revisão e assinatura de documentos numa única sessão. Os participantes podem assinar os documentos com a identidade atual do inquilino.

Pode utilizar uma aplicação de assinatura na reunião para:

• Adicione documentos a rever durante uma reunião.
• Partilhar documentos a rever para main fase.
• Assine documentos com a identidade do signatário.

Os participantes podem rever e assinar documentos, como contratos de compra e notas de encomenda.

As seguintes funções de participante podem estar envolvidas durante a reunião:

• Criador de documentos: esta função pode adicionar os seus próprios documentos para serem revistos e assinados.
• Signatário: esta função pode assinar documentos revistos.
• Leitor: esta função pode ver os documentos adicionados à reunião.

Exemplo de código

Guias passo a passo

Siga o guia passo a passo para criar uma aplicação de assinatura de documentos em reunião.

Confira também

• Aplicativos para reuniões do Teams
• Habilitar a autenticação usando o provedor OAuth de terceiros
• Consentimento específico do recurso para permissões delegadas
• Criar links detalhados
• APIs da aplicação de reunião
• Cenas personalizadas do Modo Conferência
• SDK do Live Share