Sincronia e o protocolo de comunicação
A versão para usuários é Como a sincronia funciona. Aqui está a política por trás dela, com os números.
Sincronia
-
O servidor é o relógio. Cada cliente estima o próprio deslocamento (offset) com 5 idas e voltas de ping/pong (vence o menor RTT), repetidas a cada 60 s e sempre que uma conexão peer-to-peer é estabelecida.
-
O líder envia um heartbeat com a posição a cada 5 s enquanto o vídeo está tocando.
-
Cada cliente compara a posição local com a posição esperada da sala a cada 250 ms:
desvio (drift) ação < 250 ms nada 250–1500 ms ajuste de playbackRate, mantido até < 100 ms≥ 1500 ms salto forçado (hard seek) O ajuste cresce com o desvio (
|drift|/4000, limitado entre 3 % e 20 %) em vez de ser fixo em 3 %: 3 % não conseguem corrigir 800 ms dentro dos 8 s que os testes permitem (levaria ~22 s). Abaixo de ~200 ms de desvio, é um suave 3 %. -
As posições ficam na linha do tempo do próprio episódio. Uma cópia com extras antes do episódio os pula: o
episodeStartda sala diz onde o episódio começa em uma cópia de determinada duração, e uma cópia que corresponde a ela (com margem de 5 s) soma esse valor na entrada e o subtrai na saída, sem nunca transmitir uma posição antes de 0. -
Os comandos que aplicamos vindos da sala são marcados para que os ecos de
play/pause/seekingque eles mesmos geram não sejam retransmitidos (500 ms, por tipo de evento — uma ação genuína do usuário de outro tipo dentro dessa janela ainda se propaga).
Intervalos comerciais
Nos planos com anúncios, os intervalos caem em pontos diferentes para cada pessoa,
então currentTime não é comparável entre os membros da sala durante um intervalo.
A extensão não pula, esconde, silencia nem encurta anúncios — eles tocam exatamente
como o serviço os entrega —, então não há correção; a sala volta a convergir depois
do intervalo. Duas pequenas proteções impedem que um intervalo cause algo pior que
perder a sincronia: um elemento cuja duração termina muito antes da posição da sala
(um clipe de anúncio) nunca pausa a sala quando termina, e um ended só é
transmitido se o elemento ainda for o atual um segundo depois (os players trocam o
elemento logo após um anúncio).
Anúncios costurados na própria linha do tempo do episódio, em vez de tocados em um elemento separado, o alongariam de vez a cada intervalo. O início do episódio não ajuda: ele descreve extras antes do episódio, não dentro dele.
Protocolo de comunicação
Veja packages/shared/src/protocol.ts. Sete frames que vale a pena conhecer além dos
óbvios: welcome é o primeiro frame do servidor em todo socket e leva a versão dele
(a extensão a compara com a própria, já que os dois são lançados sob um único
número, e diz ao usuário qual lado atualizar; nada é negociado), join leva create: true quando o cliente está criando a sala (o servidor
rejeita colisões com ROOM_EXISTS e o cliente tenta de novo com um código novo),
playback pode levar reason: 'stall' para que o pop-up diga quem travou carregando
(buffering), um frame media leva o estado de microfone/câmera informado pelo
próprio par (repassado aos outros e guardado para quem entra depois, para que os
quadros mostrem quem está mudo), um frame duration faz o mesmo com a duração da
cópia que um par tem do episódio da sala, episodeStart define ou limpa onde o
episódio começa na cópia mais longa (estado da sala, descartado se citar um conteúdo
que a sala já deixou, limpo por uma troca de conteúdo), e um frame leader anuncia
uma reatribuição depois do período de tolerância de 60 s concedido a um líder
desconectado (quem volta com o mesmo peer id dentro desse período mantém a
liderança; o servidor despeja o socket antigo).
Peer ids que começam com obs: são observadores sem mídia (o harness) e nunca entram
em negociação.