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:
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.
Adicione o script
launcher.js
em sua página da Web.<script async defer src="https://teams.microsoft.com/share/launcher.js"></script>
Adicione um elemento HTML na sua página Web com o
teams-share-in-meeting-button
class
no atributo , o ID da aplicação (do manifesto) nodata-app-id
atributo e a ligação para partilhar nodata-href
atributo. Também pode incluir osdata-entity-name
atributos edata-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>
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
ousecondaryShareInMeeting
). -
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.
-
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:
Abra a aplicação Web no browser e selecione Partilhar em reunião.
Selecione Iniciar partilha.
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:
Abra a aplicação Web no browser e selecione Partilhar em reunião.
Para instalar a aplicação de extensão da reunião, selecione Adicionar.
Selecione Iniciar partilha.
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 defqdn
é o URL da empresa e os valores possíveis sãoTeams.live.com
para o Teams for Life,teams.microsoft.com
outeams.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 |