Partilhar na reunião

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

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

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>",
      });
   }