SDK do Live Share
O Live Share é um SDK projetado para transformar aplicativos do Teams em experiências colaborativas de vários usuários sem escrever nenhum código de back-end dedicado. Com o Live Share, seus usuários podem co-watch, cocriar e co-editar durante as reuniões.
Às vezes, o compartilhamento de tela simplesmente não é suficiente, e é por isso que a Microsoft criou ferramentas como PowerPoint Live e Whiteboard diretamente no Teams. Ao trazer seu aplicativo Web diretamente para o estágio central na interface da reunião, seus usuários podem colaborar perfeitamente durante reuniões e chamadas.
Visão geral dos recursos
O Live Share tem três pacotes primários que dão suporte a cenários colaborativos ilimitados. Esses pacotes expõem um conjunto de DDS (estruturas de dados distribuídas), incluindo blocos de construção primitivos e cenários de chave de turno.
O Live Share integra perfeitamente as reuniões ao Fluid Framework. Fluid Framework é uma coleção de bibliotecas de cliente para distribuir e sincronizar o estado compartilhado. Live Share fornece uma versão gratuita, totalmente gerenciada e pronta para usar o Azure Fluid Relay suportado pela segurança e escala global do Teams.
Núcleo do Live Share
O Live Share permite conectar-se a um contêiner fluido especial associado a cada reunião em algumas linhas de código. Além das estruturas de dados fornecidas pelo Fluid Framework, o Live Share também dá suporte a um novo conjunto de classes DDS para simplificar a sincronização do estado do aplicativo em reuniões.
Os recursos compatíveis com o pacote principal do Live Share incluem:
- Participe da sessão live share de uma reunião com
LiveShareClient. - Acompanhe a presença da reunião e sincronize metadados do usuário com
LivePresence. - Coordenar o estado do aplicativo que desaparece quando os usuários saem da sessão com
LiveState. - Sincronizar um temporizador de contagem regressiva com
LiveTimer. - Enviar eventos em tempo real para outros clientes na sessão com
LiveEvent. - Apresentar e seguir outros usuários com
LiveFollowMode. - Aproveite qualquer recurso do Fluid Framework, como
SharedMapeSharedString.
Você pode encontrar mais informações sobre esse pacote na página de recursos principais.
Mídia de compartilhamento ao vivo
Vídeo e áudio são partes fundamentais do local de trabalho e do mundo modernos. A mídia Live Share permite a sincronização de mídia para qualquer player de mídia com apenas algumas linhas de código. Ao sincronizar a mídia na camada de controles de transporte e estado do jogador, você pode atribuir exibições individualmente, fornecendo a mais alta qualidade possível disponível por meio do aplicativo. Como a Microsoft não está retransmitindo seu conteúdo de mídia, seus requisitos de licenciamento e acesso são mantidos intactos.
Os recursos compatíveis com a mídia live share incluem:
- Sincronizar o estado do player de mídia e acompanhar com
MediaPlayerSynchronizer. - Ajustes inteligentes no volume de mídia à medida que os usuários conversam durante a reunião.
- Limite quais usuários podem modificar o estado do jogador.
- Suspender e retomar a sincronização de mídia em tempo real ou em pontos de espera agendados.
Você pode encontrar mais informações sobre esse pacote na página de mídia do Live Share.
Observação
O Live Share não retransmissão de conteúdo de mídia. Ele foi projetado para uso com jogadores web inseridos, como HTML5 <video> ou Azure Media Player.
Tela live share
Ao colaborar em reuniões, é essencial que os usuários possam apontar e enfatizar o conteúdo na tela. A tela Live Share facilita a adição de ponteiros, ponteiros laser e cursores ao seu aplicativo para colaboração contínua.
Os recursos compatíveis com a tela do Live Share incluem:
- Adicione um colaborativo
<canvas>ao seu aplicativo comLiveCanvas. - Transmita ideias usando as ferramentas caneta, marcador, linha e seta.
- Apresente efetivamente usando o ponteiro laser.
- Siga com cursores de mouse em tempo real.
- Configurar configurações para dispositivos variáveis e exibir estados.
- Use entradas de mouse, toque e caneta totalmente compatíveis.
Você pode encontrar mais informações sobre esse pacote na página de tela do Live Share.
Por que criar aplicativos com o Live Share?
Criar aplicativos colaborativos pode ser difícil, demorado, caro e inclui requisitos complexos de conformidade em escala. Os usuários do Teams passam um tempo significativo revisando o trabalho com colegas de equipe, assistindo vídeos juntos e debatendo novas ideias através do compartilhamento de telas. O SDK do Live Share permite transformar seu aplicativo em algo mais colaborativo com o mínimo de investimento.
Aqui estão alguns dos principais benefícios do SDK do Live Share:
- Gerenciamento e segurança de sessão sem complicações.
- Estruturas de dados distribuídos com e sem estado.
- Extensões de mídia para sincronizar facilmente vídeo e áudio.
- Incrustação de chave de turno, ponteiros laser e cursores.
- Respeitar os privilégios de reunião usando a verificação de função.
- Serviço gratuito e totalmente gerenciado com baixa latência.
Para entender se o Live Share é adequado para seu cenário colaborativo, é útil entender as diferenças entre o Live Share e outras estruturas colaborativas, incluindo:
Soquetes da Web
Os soquetes da Web são uma tecnologia onipresente para comunicação em tempo real na Web, e alguns aplicativos podem preferir usar seu próprio back-end de soquete web personalizado. Ao contrário das APIs REST, os soquetes Web mantêm uma conexão aberta entre um servidor e clientes em uma sessão.
Como outros serviços de API personalizados, os requisitos normalmente incluem sessões de autenticação, mapeamento regional, manutenção e escala. Muitos cenários colaborativos também exigem a manutenção do estado da sessão no servidor, o que requer infraestrutura de armazenamento, resoluções de conflitos e muito mais.
Usando o Live Share, você obtém todo o poder dos soquetes da Web sem nenhuma sobrecarga.
Retransmissão de Fluido do Azure
O Azure Fluid Relay é uma oferta gerenciada para o Fluid Framework que ajuda os desenvolvedores a criar experiências colaborativas em tempo real e replicar o estado entre clientes JavaScript conectados. Microsoft Whiteboard, Loop e OneNote são todos exemplos de aplicativos criados com o Fluid Framework hoje.
Assim como outros serviços do Azure, o Azure Fluid Relay foi projetado para adaptar suas necessidades individuais de projeto com complexidade mínima. Os requisitos incluem o desenvolvimento de uma história de autenticação para seus contêineres Fluid e conformidade regional. Depois de configurados, os desenvolvedores podem se concentrar em fornecer experiências colaborativas de alta qualidade.
Serviço hospedado do Live Share
O Live Share fornece um serviço de retransmissão de fluidos do Azure com suporte na segurança das reuniões do Microsoft Teams. Os contêineres do Live Share são restritos aos participantes da reunião, mantêm os requisitos de residência do locatário e podem ser acessados em algumas linhas de código do cliente.
import { LiveShareClient, LivePresence } from "@microsoft/live-share";
import { LiveShareHost } from "@microsoft/teams-js";
// Join the Fluid container
const host = LiveShareHost.create();
const liveShare = new LiveShareClient(host);
const schema = {
initialObjects: { presence: LivePresence },
};
const { container } = await liveShare.joinContainer(schema);
// ... ready to start app sync logic
Importante
Todos os dados enviados ou armazenados por meio do serviço de Retransmissão de Fluidos do Azure hospedado do SDK do Live Share estão acessíveis até 24 horas. Para obter mais informações, consulte as perguntas frequentes do Live Share.
Usando um serviço personalizado de Retransmissão de Fluidos do Azure
Embora a maioria de vocês ache preferível usar nosso serviço hospedado gratuito, ainda há situações em que é benéfico usar seu próprio serviço de Retransmissão de Fluidos do Azure para seu aplicativo Live Share.
Considere usar um serviço personalizado se você:
- Exigir o armazenamento de dados em contêineres Fluid além do tempo de vida de uma reunião.
- Transmita dados confidenciais por meio do serviço que requer uma política de segurança personalizada.
- Desenvolva recursos por meio do Fluid Framework, por exemplo,
SharedMap, para seu aplicativo fora do Teams.
Para obter mais informações, consulte o guia de instruções do serviço de retransmissão de Fluidos do Azure personalizado.
integração React
O Live Share tem uma integração de React dedicada, tornando os recursos do Live Share ainda mais fáceis de integrar em aplicativos React. Em vez de usar LiveShareClient diretamente, você pode usar o LiveShareProvider componente para ingressar em uma sessão do Live Share quando o componente for montado pela primeira vez. Cada LiveDataObject um tem um gancho de React correspondente, projetado para tornar o uso do Live Share incrivelmente fácil. Para obter mais informações, consulte Live Share para React página do GitHub para obter mais informações.
Cenários de usuário
| Cenário | Exemplo |
|---|---|
| Durante uma revisão de marketing, um usuário deseja coletar comentários sobre sua edição de vídeo mais recente. | O usuário compartilha o vídeo para o estágio de reunião e inicia o vídeo. Conforme necessário, o usuário pausa o vídeo para discutir a cena e os participantes desenham partes da tela para enfatizar pontos-chave. |
| Um gerente de projeto joga Agile Poker com sua equipe durante o planejamento. | O gerente compartilha um aplicativo Agile Poker para a fase de reunião que permite jogar o jogo de planejamento até que a equipe tenha consenso. |
| Um consultor financeiro examina documentos PDF com clientes antes de assinar. | O consultor financeiro compartilha o contrato PDF para a fase de reunião. Todos os participantes podem ver os cursores uns dos outros e o texto realçado no PDF, após o qual ambas as partes assinam o contrato. |
Importante
O Live Share é licenciado sob a Licença de SDK do Microsoft Live Share. Para usar esses recursos em seu aplicativo, primeiro você deve ler e concordar com esses termos.
Próxima etapa
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