Espelhamento de tela (captura + WebRTC + prévia com retângulo)

Aberta
#1,218 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
40/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
typescript
Domínio
frontend

Direção de pesquisa

Start from index.ts to see how public exports are declared and where a new createScreenCapture entry point would sit, then look at ./map, ./kit and VideoPlayer for the existing component and injection conventions, and at #668 to confirm voice/video rooms are separate. The acceptance criteria in the issue double as the test file: mock getDisplayMedia and RTCPeerConnection, assert video.cursor, setFocusBehavior ordering, NotAllowedError rejection, and addTrack per track. Done means those five checks pass plus a <TrackPreview> whose arrow keys step 1% and whose aria-valuetext reports the region in px. Expect to design the API shape before writing it.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

area:components area:perf enhancement

Versão: @codeatlasdev/ui 4.6.0 · código lido em main (950628f2) · classe: lacuna (migração do AC)

Problema

O AC depende deste comportamento hoje e a lib não o oferece. Sem ele, a migração perde qualidade no desktop, no mobile ou no PWA.

O que a lib já oferece (para não duplicar) e o que falta

(leitura de origin/main, index.ts sem exports de captura) não há getDisplayMedia, WebRTC nem prévia de track. ./map, ./kit e VideoPlayer não cobrem. #668 cobre salas de voz/vídeo (StageGrid, CallControls), mas não captura de tela.

Referência no AC

Caminhos do repo AC (repo privado, só caminho):

apps/web/src/lib/cast/sender.ts:56-104 (CastSender, captureDisplay), :201-205 (new RTCPeerConnection, addTrack), sender-encoder.ts:16-19 (navigator.mediaDevices.getDisplayMedia), sender-encoder.ts:37 (preferH264), constraints.ts:61-65 (1080p, dicas Chromium), capture-controller.ts:36-51 (setFocusBehavior só após getDisplayMedia); components/videowall-cast/cast-area-picker.tsx:115-120, 177-185 (prévia <video> do track, retângulo de 1 px = 1 px da TV).

Defeitos do AC (verificados por leitura do código): (leitura) o retângulo de área só se move com ponteiro (cast-area-picker.tsx:177-179). Há alternativa por rádio (Centro, Esquerda, Direita), mas não por teclado para posição fina.

Proposta

createScreenCapture({ hint: 'motion'|'detail', cursor, maxSize: {w:1920,h:1080} }) (headless, injetável: getDisplayMedia e RTCPeerConnection) e <TrackPreview track bind:region> com retângulo arrastável e teclado. Estatísticas e H.264 como opções.

Critério de aceite (testável)

  • Com getDisplayMedia injetado, createScreenCapture chama a função com video.cursor always quando cursor=true e never quando false.
  • setFocusBehavior é chamado só depois do retorno de getDisplayMedia; se lançar, o stream segue e o motivo vai só para debug.
  • Recusa do usuário (NotAllowedError) rejeita a promessa sem tocar no controlador.
  • <TrackPreview> com retângulo: setas movem em passos de 1% e o aria-valuetext diz a área em px.
  • Em teste, RTCPeerConnection injetado recebe addTrack para cada track do stream.

Mãe: #1089

Linguagem predominante
TypeScript
Estrelas
6
Forks
3
Merge médio
5h 21min
PRs com merge (30d)
378

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de codeatlasdev/ui

Todas as issues de codeatlasdev/ui

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.