> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adoraone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remote Control

> Controle uma apresentação ativa pelo celular — avance slides, apague a tela e salte entre hinos.

Use o **celular como controle remoto** da apresentação enquanto o culto rola no projetor. Conecte com um código de sessão de 6 caracteres de uma apresentação ativa e avance linhas, salte hinos ou apague a tela do corredor.

<Frame>
  <img src="https://mintcdn.com/adoraplan-b5f8a5a4/Q7eIYf4z4qB2WPTX/images/remote-control/code-entry.png?fit=max&auto=format&n=Q7eIYf4z4qB2WPTX&q=85&s=f4727e28926e24f6f91b57378686be54" alt="Diálogo Presentation Mode com QR code Mobile Remote e código de sessão" width="1440" height="900" data-path="images/remote-control/code-entry.png" />
</Frame>

## Quick Start

1. Inicie uma apresentação a partir de **Hymns**, **Playlists** ou **Programs** (veja [Presentation](/pt/adoraplan/presentation)).
2. No launcher, expanda **Use my phone as a remote**.
3. Escaneie o QR code ou anote o código de 6 caracteres.
4. No celular, abra o link ou vá a `/present/remote` e informe o código.
5. Toque em **NEXT LINE** / **PREV LINE** ou deslize para controlar slides.

***

## Guia passo a passo

### Obter código de sessão

Com apresentação em execução, o host vê:

* **QR code** com link para `/present/remote?session=XXXXXX`
* Botões **Copy link** e **Copy code**
* Instruções para digitar o código manualmente em `/present/remote`

O código é gerado ao iniciar a sessão e sincroniza via Supabase Realtime (e abas do mesmo navegador via `BroadcastChannel`).

### Conectar o celular

**Opção A — QR code (recomendado):** Após iniciar a apresentação, expanda **Use my phone as a remote** no launcher. Escaneie o QR code com a câmera do celular.

**Opção B — Entrada manual:** Abra `/present/remote` no celular, digite o código de 6 caracteres abaixo do QR code e toque em **Connect**.

### Controles remotos

Conectado, o remote mostra:

| Controle                      | Ação                                 |
| ----------------------------- | ------------------------------------ |
| **PREV LINE** / **NEXT LINE** | Mover um slide de letra              |
| **PREV HYMN** / **NEXT HYMN** | Ir ao hino anterior ou próximo       |
| **BLACK** / **WHITE**         | Apagar o projetor (preto ou branco)  |
| **SONGS**                     | Abrir lista para ir direto a um hino |

**Gestos de deslizar:** esquerda/direita para linhas, cima/baixo para hinos. Dispositivos móveis recebem feedback háptico leve a cada comando.

O cabeçalho mostra status da conexão (**Live**, **Connecting…** ou **Disconnected**) e o código de sessão ativo. O card do slide atual exibe título da música, seção, posição hino/slide e prévia da letra.

### O que o remote controla

O remote espelha o que o host iniciou — seleção de hinos, playlist ou program completo (incluindo custom slides). Não escolhe a lista de músicas; só controla a sessão ativa.

<Note>
  O remote exige uma **sessão de apresentação ativa** no computador host. Se o apresentador encerrar a sessão ou fechar o navegador, o remote desconecta.
</Note>

<Tip>
  Mantenha o notebook no Wi‑Fi com a janela de apresentação aberta. A janela de exibição (`/present`) e o launcher funcionam como host.
</Tip>

***

## Relacionados

<CardGroup cols={2}>
  <Card title="Presentation" icon="monitor" href="/pt/adoraplan/presentation">
    Inicie uma sessão e gere o QR code do remote.
  </Card>

  <Card title="Playlists" icon="list-music" href="/pt/adoraplan/playlists">
    Apresente um conjunto ordenado de hinos com um clique.
  </Card>

  <Card title="Settings" icon="gear" href="/pt/adoraplan/settings">
    Configurações de exibição de Presentation e Karaoke.
  </Card>

  <Card title="Programs" icon="calendar-check" href="/pt/adoraplan/programs">
    Apresente o service order completo no editor do program.
  </Card>
</CardGroup>