diff --git a/.lovable/plan.md b/.lovable/plan.md index 7ad5ab7..b311a67 100644 --- a/.lovable/plan.md +++ b/.lovable/plan.md @@ -1,46 +1,44 @@ -## Contexto +# Plano: Mini-menu de Captura (Foto + Vídeo) no Modo AR -O grid vermelho/azul que aparece perto de paredes/objetos é o **Space Sense / Guardian** do Quest 3 — renderizado pelo runtime da Meta, não pelo app. O app não consegue desligá-lo por código. Porém, **a sensibilidade desse sistema aumenta** quando a WebXR session pede features como `mesh-detection`, `depth-sensing`, `anchors`, etc. Hoje o app usa `createXRStore({...})` sem lista explícita de features, então a lib `@react-three/xr` solicita o conjunto default — que inclui várias features que não usamos. +## Objetivo +Adicionar dentro do HUD flutuante do modo AR um pequeno menu de captura com: +- **📸 Foto** — screenshot do canvas (já existe lógica, expor no AR) +- **● Gravar / ⏸ Pausar / ▶ Retomar / ■ Parar** — gravação de vídeo do canvas WebXR -## O que vou fazer (Onda 2, sem quebrar nada) +## O que será implementado -**Auditoria do `createXRStore` em `src/pages/XRSession.tsx`** para pedir só o que realmente usamos: +### 1. Novo hook `useCanvasRecorder` (`src/hooks/useCanvasRecorder.ts`) +- Usa `canvas.captureStream(30)` + `MediaRecorder` (codec `video/webm;codecs=vp9` com fallback p/ vp8). +- Estados expostos: `status` (`idle | recording | paused`), `elapsedMs`. +- Métodos: `start()`, `pause()`, `resume()`, `stop()`. +- Ao parar: monta `Blob` webm, gera `URL.createObjectURL`, dispara download automático (`tracksteel-AR-.webm`) e também salva uma referência opcional para galeria futura. +- Captura screenshot via `canvas.toDataURL('image/png')` reutilizando o store (`addScreenshot`) — mesma lógica já presente em `XRHud.tsx`. -- **Manter (usado):** - - `hit-test` — usado por `XRHitTestPlacement` - - `plane-detection` — usado por `XRHitTestPlacement` (snap) e `XRPlaneOverlay` - - `local-floor` — reference space padrão - - `hand-tracking` — usado -- **Remover do request (não usado):** - - `mesh-detection` — não há leitor de meshes no código - - `anchors` — não criamos âncoras persistentes - - `depth-sensing` — não usado - - `light-estimation` — não usado +### 2. Nova aba "Captura" no HUD 3D (`src/components/three/XRHudInWorld.tsx`) +- Adicionar tab `capture` (ícone 🎥) na barra de tabs (junto com Cena, Ferram., Inspeção, Compart., WebXR). +- Componente `CaptureTab` com botões 3D (`XR3DButton`): + - **📸 Foto** — chama screenshot, mostra toast "Foto capturada". + - **● REC** (vermelho quando gravando) — inicia/para gravação. + - **⏸ Pause / ▶ Resume** — alterna pausa (desabilitado quando idle). + - **■ Stop** — finaliza e baixa o arquivo. + - Texto de status: `● 00:12` em vermelho enquanto grava, amarelo quando pausado. +- Indicador visual flutuante (pequeno círculo vermelho pulsante) visível mesmo com painel fechado quando estiver gravando — anexado ao `headLockRef`. -Configuração proposta (passada para `createXRStore`): +### 3. Integração +- O hook recebe o `` via `document.querySelector('canvas')` (mesmo padrão usado em `XRHud.tsx`/`handleScreenshot`). +- Nenhuma mudança no store global é necessária — o estado de gravação vive no hook, instanciado no nível do `XRSession.tsx` e passado por props ao `XRHudInWorld`, OU mantido dentro do próprio `CaptureTab` via singleton simples. -```ts -const store = createXRStore({ - hand: { left: true, right: true }, - controller: { left: true, right: true }, - sessionInit: { - requiredFeatures: ['local-floor'], - optionalFeatures: ['hit-test', 'plane-detection', 'hand-tracking'], - }, -}); -``` +## Detalhes técnicos +- `MediaRecorder` com `canvas.captureStream(30)` funciona dentro de sessão WebXR no Quest 3 (Chromium-based browser do Quest suporta). +- Áudio do microfone **não** será incluído (pode ser adicionado depois se solicitado). +- Vídeo gerado é `.webm`; o usuário pode converter para `.mp4` fora do app se quiser. +- O download é feito ao parar a gravação — o arquivo aparece no armazenamento do Quest (pasta Downloads do browser). -Tudo continua como `optionalFeatures`, então se o Quest não suportar algum, a sessão ainda inicia. Nenhuma ferramenta atual (hit-test, snap em planos, mãos, grip, joystick, medição, screenshot, inspeção, compartilhamento) depende das features removidas. +## Arquivos afetados +- `src/hooks/useCanvasRecorder.ts` (novo) +- `src/components/three/XRHudInWorld.tsx` (nova tab + CaptureTab + indicador REC) -## O que NÃO faço - -- Não mexo em `useModelStore`, `XRHud`, `XRHudInWorld`, `XRHitTestPlacement`, `XRPlaneOverlay` — comportamento das ferramentas fica igual. -- Não adiciono botão de "desligar Guardian" — impossível por código. - -## Resultado esperado - -Reduz a chance de o Space Sense ativar o grid de segurança perto de objetos, porque a sessão XR não pede mais permissões além das necessárias. Se o grid continuar aparecendo, é configuração do headset (Settings → Segurança → Space Sense) e o usuário precisa desligar lá — posso adicionar depois um painel "Ajuda" com o passo-a-passo se quiser. - -## Arquivo alterado - -- `src/pages/XRSession.tsx` (apenas o objeto passado para `createXRStore`) \ No newline at end of file +## Fora do escopo +- Galeria de vídeos dentro do app (apenas download direto por enquanto). +- Áudio/microfone na gravação. +- Streaming/upload para nuvem.