Partilhar na reunião

Partilhar em reunião permite que os utilizadores partilhem documentos ou aplicações Web de terceiros na fase da reunião. Os participantes da reunião podem colaborar e interagir com as aplicações Web de terceiros ou editar os documentos em conjunto.

A imagem seguinte mostra o botão Partilhar na reunião na aplicação Web:

Durante a reunião, quando um utilizador seleciona o botão Partilhar na reunião a partir da aplicação Web ou documento de terceiros, inicia uma ligação avançada para a fase da reunião e abre a aplicação como uma vista Web na fase da reunião. Para que os participantes da reunião interajam com documentos ou aplicações Web de terceiros, têm de ter a extensão de reunião da aplicação ou documento instalado no cliente do Teams. Se não tiverem a extensão da reunião, o Teams pede aos participantes para instalarem a extensão da reunião.

Quando seleciona o botão Partilhar na reunião , este inicia uma ligação avançada para a fase da reunião. Segue-se o formato de ligação avançada:

msteams:/l/meeting-share?deeplinkId={GUID}&fqdn={string}&lm=deeplink&appContext={json encoded app context}

Para obter mais informações, veja Gerar uma ligação avançada para partilhar conteúdo para realizar reuniões.

Ativar a partilha na reunião

Seguem-se três métodos diferentes para ativar a partilha na reunião. Pode utilizar um dos métodos consoante a quantidade de controlo que pretende nos botões Partilhar em reunião apresentados na sua página Web:

Método 1

Este método é a forma mais simples de apresentar a partilha em botões de reunião com personalizações mínimas. Pode personalizar os estilos, o tamanho e os idiomas dos botões.

Pode digitalizar a sua página Web para localizar quaisquer elementos HTML com o nome da classe do tipo teams-share-in-meeting-button e gerar dinamicamente os botões Partilhar na reunião na sua página.

1. Adicione o script launcher.js em sua página da Web.

   <script async defer src="https://teams.microsoft.com/share/launcher.js"></script>
   

2. Adicione um elemento HTML na sua página Web com o teams-share-in-meeting-buttonclass no atributo , o ID da aplicação (do manifesto) no data-app-id atributo e a ligação para partilhar no data-href atributo. Também pode incluir os data-entity-name atributos e data-entity-description .

   <div
     class="teams-share-in-meeting-button"
     data-href="https://<link-to-be-shared>"
     data-app-id="<app-id>"
     data-entity-name="<app-name>"
     data-entity-description="<app-content-description>"
     >
   </div>
   

3. Seguem-se os atributos adicionais para personalizar o botão Partilhar na reunião:

   • data-button-type: especifica a cor de fundo do botão (primaryShareInMeeting ou secondaryShareInMeeting).
   • data-button-size: especifica o tamanho do botão em pixel.
   • data-target: especifica se a ligação é aberta na mesma janela, novo separador ou numa nova janela.
   • data-locale: especifica o idioma de utilizador pretendido.

Método 2

Pode utilizar este método para ter algum controlo sobre que botão compor dinamicamente ou quando o script é executado. O script só é executado quando window.shareToMicrosoftTeams.renderButtons() é chamado. Pode transmitir elementos HTML específicos através da renderButtons({elements: [], shareInMeetingElements: [shareInMeetingButton]) API. Pode personalizar os estilos, o tamanho e os idiomas dos botões.

A async shareToMicrosoftTeams.renderButtons(options) API compõe todos os botões de partilha que têm o nome de turma teams-share-button ou teams-share-in-meeting-button na página. Se um options (optional) objeto for fornecido com uma lista de elementos, conforme mostrado no código seguinte, esses elementos são compostos nos botões Partilhar ou partilhar em reuniões .

options (optional): { elements?: HTMLElement[], shareInMeetingElements?: HTMLElement[] }

1. Adicione o script launcher.js em sua página da Web.

   <script async defer src="https://teams.microsoft.com/share/launcher.js" onload="onLoadComplete()"></script>
   

2. Crie um elemento HTML e especifique os atributos necessários. Depois de o script do iniciador estar totalmente carregado, certifique-se de que a lógica de composição é executada.

   async function onLoadComplete() {
      const shareInMeetingButton = document.createElement("div");
      shareInMeetingButton.setAttribute("data-app-id", "<app-id>");
      shareInMeetingButton.textContent = "Share Test App"
      shareInMeetingButton.setAttribute("data-href", "<app-content-url>");
      shareInMeetingButton.setAttribute("data-button-type", "secondaryShareInMeeting");
      shareInMeetingButton.setAttribute("data-locale", "fr-CA");
      await window.shareToMicrosoftTeams.renderButtons({elements: [], shareInMeetingElements: [shareInMeetingButton]});
   }  
   

Método 3

Pode utilizar este método para ter controlo total sobre como o script é chamado e quando gerar o botão com a window.shareToMicrosoftTeams.shareInMeetingClickHandler API. Pode controlar como e onde os botões são gerados. Só tem de anexar a window.shareToMicrosoftTeams.shareInMeetingClickHandler API ao onclick atributo do botão. Pode ser anexado a uma ligação, botão, menu pendente, etc. Tem controlo total sobre a forma como a IU é apresentada.

A async shareInMeetingClickHandler(content: IShareInMeetingContent) API cria um processador de chamadas de retorno para o botão Partilhar na reunião, que pode ser executado ao selecionar um botão ou menu.

1. Adicione o script launcher.js em sua página da Web.

   <script async defer src="https://teams.microsoft.com/share/launcher.js" onload="onLoadComplete()"></script>
   

2. Crie um elemento HTML e adicione o shareToMicrosoftTeams.shareInMeetingClickHandler ao respetivo onClick atributo. Depois de o script do iniciador estar totalmente carregado, certifique-se de que a lógica onclick é criada.

   async function onLoadComplete() {
      var customShareInMeetingButton = document.createElement("a");
      customShareInMeetingButton.onclick = window.shareToMicrosoftTeams.shareInMeetingClickHandler({
      url: "<app-content-url>",
      appId: "<app-id>",
      entityName: "<app-entity-name>",
      entityDescription: "<app-content-description>",
      });
   }
   

Seguem-se as definições de launcher.js:

Propriedade	Atributo HTML	Tipo	Obrigatório	Padrão	Descrição
url	data-href	Cadeia de caracteres	Sim	NA	URL do conteúdo da aplicação a partilhar.
appId	data-app-id	Cadeia de caracteres	Sim	NA	ID da aplicação a partilhar.
entityName	data-entity-name	Cadeia de caracteres	Não	NA	Nome da entidade da aplicação.
entityDescription	data-entity-description	Cadeia de caracteres	Não	NA	Descrição do conteúdo da aplicação a partilhar.
localidade	data-locale	Cadeia de caracteres	Não	en-US	Idioma preferencial do utilizador.
destino	data-target	Cadeia de caracteres	Não	self	Especifica se a ligação é aberta na mesma janela, novo separador ou nova janela.
buttonType	data-button-type	Cadeia de caracteres	Não	primaryShareInMeeting	Especifica a cor de fundo do botão: primaryShareInMeeting ou secondaryShareInMeeting.
tamanho do botão	data-button-size	Cadeia de caracteres	Não	NA	Tamanho do botão em píxeis.

Experiência de utilizador final em aplicações de terceiros

Depois de ativar a opção Partilhar em reunião em aplicações de terceiros, pode partilhar as aplicações na fase da reunião. Para aceder, siga os passos:

Se a extensão da reunião estiver instalada:

1. Abra a aplicação Web no browser e selecione Partilhar em reunião.

   

2. Selecione Iniciar partilha.

   

3. A aplicação Web é partilhada na fase da reunião e todos os participantes podem interagir e editar em conjunto.

   

Se a extensão da reunião não estiver instalada:

1. Abra a aplicação Web no browser e selecione Partilhar em reunião.

   

2. Para instalar a aplicação de extensão da reunião, selecione Adicionar.

   

3. Selecione Iniciar partilha.

   

4. A aplicação Web é partilhada na fase da reunião e todos os participantes podem interagir e editar em conjunto.

   

Gerar uma ligação avançada para partilhar conteúdo para realizar reuniões

Também pode gerar uma ligação avançada para partilhar a aplicação no palco e iniciar ou participar numa reunião. Quando uma ligação avançada é selecionada numa aplicação por um utilizador que faz parte de uma reunião em curso, a aplicação é partilhada no palco e é apresentada uma janela de pop-up de permissão. Os utilizadores podem conceder acesso aos participantes para colaborarem com uma aplicação.

Quando um utilizador não está numa reunião, o utilizador é redirecionado para o calendário do Teams, onde pode participar numa reunião ou iniciar uma reunião instantânea (Reunir agora).

Assim que o utilizador iniciar uma reunião instantânea (Reunir agora), pode adicionar participantes e interagir com a aplicação.

Para adicionar uma ligação avançada para partilhar conteúdo no palco, tem de ter um contexto de aplicação. O contexto da aplicação permite ao cliente do Teams obter o manifesto da aplicação e verificar se a partilha no palco é possível. Segue-se um exemplo de um contexto de aplicação:

{ "appSharingUrl" : "https://teams.microsoft.com/extensibility-apps/meetingapis/view", "appId": "9ec80a73-1d41-4bcb-8190-4b9eA9e29fbb" , "useMeetNow": false }

Os parâmetros de consulta para o contexto da aplicação são:

• appID: este é o ID que pode ser obtido a partir do manifesto da aplicação.
• appSharingUrl: o URL, que tem de ser partilhado no palco, deve ser um domínio válido definido no manifesto da aplicação. Se o URL não for um domínio válido, é apresentada uma caixa de diálogo de erro para fornecer ao utilizador uma descrição do erro.
• useMeetNow: isto inclui um parâmetro Booleano que pode ser verdadeiro ou falso.

  • Verdadeiro: quando o useMeetNow valor for verdadeiro e se não houver uma reunião em curso, será iniciada uma nova reunião Reunir agora. Quando houver uma reunião em curso, este valor será ignorado.

  • Falso: o valor predefinido de useMeetNow é falso, o que significa que, quando uma ligação avançada é partilhada no palco e não há uma reunião em curso, será apresentado um pop-up de calendário. No entanto, pode partilhar diretamente durante uma reunião.

Certifique-se de que todos os parâmetros de consulta estão devidamente codificados com URI e que o contexto da aplicação tem de ser codificado duas vezes no URL final. Segue-se um exemplo:

const appContext= JSON.stringify({ 
  "appSharingUrl" : "https://teams.microsoft.com/extensibility-apps/meetingapis/view",
  "appId": "9cc80a93-1d41-4bcb-8170-4b9ec9e29fbb",
  "useMeetNow": false
});
const encodedContext = encodeURIComponent(appContext).replace(/'/g,"%27").replace(/"/g,"%22");
const encodedAppContext = encodeURIComponent(encodedContext).replace(/'/g,"%27").replace(/"/g,"%22");

Uma ligação avançada pode ser iniciada a partir da Web do Teams ou do cliente de ambiente de trabalho ou móvel do Teams.

• Web do Teams: utilize o seguinte formato para iniciar uma ligação avançada a partir da Web do Teams para partilhar conteúdos em palco:

  msteams:/l/meeting-share?deeplinkId={GUID}&fqdn={string}&lm=deeplink&appContext={json encoded app context}

  Exemplo: https://teams.microsoft.com/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

  Link profundo	Formatar	Exemplo
  Para partilhar a aplicação e abrir o calendário do Teams, quando useMeeetNow for falso, predefinição.	https://teams.microsoft.com/l/meeting-share?deeplinkId={deeplinkid}&fqdn={fqdn}}&lm=deeplink%22&appContext={encoded app context}	https://teams.microsoft.com/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Afalse%257D
  Para partilhar a aplicação e iniciar uma reunião instantânea, quando useMeeetNow é verdade.	https://teams.microsoft.com/l/meeting-share?deeplinkId={deeplinkid}&fqdn={fqdn}}&lm=deeplink%22&appContext={encoded app context}	https://teams.microsoft.com/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

• Cliente móvel ou de ambiente de trabalho do Teams: utilize o seguinte formato para iniciar uma ligação avançada a partir do ambiente de trabalho do Teams ou cliente móvel para partilhar conteúdos em palco:

  msteams:/l/meeting-share?deeplinkId={deeplinkid}&fqdn={fqdn}&lm=deeplink&appContext={encoded app context}

  Exemplo: msteams:/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

  Link profundo	Formatar	Exemplo
  Para partilhar a aplicação e abrir o calendário do Teams, quando useMeeetNow for falso, predefinição.	msteams:/l/meeting-share? deeplinkId={deeplinkid}&fqdn={fqdn}&lm=deeplink%22&appContext={encoded app context}	msteams:/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Afalse%257D
  Para partilhar a aplicação e iniciar uma reunião instantânea, quando useMeeetNow é verdade.	msteams:/l/meeting-share? deeplinkId={deeplinkid}&fqdn={fqdn}&lm=deeplink%22&appContext={encoded app context}	msteams:/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

Os parâmetros de consulta são:

• deepLinkId: Qualquer identificador utilizado para a correlação de telemetria.
• fqdn: fqdn é um parâmetro opcional, que pode ser utilizado para mudar para um ambiente adequado de uma reunião para partilhar uma aplicação no palco. Suporta cenários em que uma partilha de aplicações específica ocorre num ambiente específico. O valor predefinido de fqdn é o URL da empresa e os valores possíveis são Teams.live.com para o Teams for Life, teams.microsoft.comou teams.microsoft.us.

Para partilhar toda a aplicação para testar, no manifesto da aplicação, tem de configurar meetingStage e meetingSidePanel , como contextos de moldura, ver o manifesto da aplicação. Caso contrário, os participantes da reunião poderão não conseguir ver o conteúdo no palco.

Observação

Para que a sua aplicação passe na validação, quando criar uma ligação avançada a partir do seu site, aplicação Web ou Cartão Ajustável, utilize Partilhar na reunião como cadeia ou cópia.

Exemplo de código

Nome de exemplo	Descrição	.NET	Node.js	Manifesto
Descrição da Fase de Reunião	Esta aplicação ajuda a ativar e configurar as suas aplicações para reuniões do Teams. Também demonstra a utilização da partilha na funcionalidade de reunião.	View	View	Exibir

Confira também

• Aplicações para reuniões e chamadas do Teams
• Compartilhar no Teams a partir de aplicativos Web
• Compartilhar com o Teams a partir do aplicativo ou guia pessoal
• Criar links detalhados
• Cartões Adaptáveis