Modo Desktop

1 Ativação e Acesso

O Modo Desktop pode ser ativado de várias formas:

• Quick Tool: toque no ícone do Desktop nas Quick Tools da Home.
• Atalho na gaveta: use o atalho kwiq_desktop.
• Giro para paisagem: se configurado, girar o dispositivo para paisagem abre automaticamente o Desktop.
• Display externo: ao conectar uma tela HDMI, o Kwiq pode iniciar o Desktop automaticamente.

A activity abre em paisagem com densidade de tela reduzida (escala 0.78x) e escala de fonte em 0.92x, criando um espaço de trabalho mais amplo.

2 Taskbar

A taskbar fica na parte inferior da tela e oferece:

• Menu Iniciar: ícone do Kwiq no canto esquerdo para abrir o menu.
• Janelas abertas: ícones das janelas ativas no centro.
• Relógio: data e hora no canto direito.
• Quick Tools: ferramentas rápidas (busca, wallpaper, gravação, etc.) ao lado do relógio.
• Sair do Desktop: controle dedicado para voltar ao modo normal.

3 Menu Iniciar

O Menu Iniciar segue o estilo clássico do Windows, com:

• Apps: lista de aplicativos organizados pelas categorias já criadas no Kwiq (se houver).
• Ordenação alfabética: apps listados em ordem alfabética dentro de cada categoria.
• Busca: campo de busca para encontrar apps rapidamente.
• Contatos: acesso rápido a contatos favoritos.
• Arquivos: atalho para abrir o File Manager.
• Power: opções como "Sair do Desktop", "Bloquear Tela", "Desligar" (quando suportado).

O menu segue as mesmas categorias que você configurou no launcher, mantendo consistência.

4 Janelas Flutuantes

O Desktop gerencia janelas internas que podem ser:

• Movidas: arraste pela barra de título para reposicionar.
• Redimensionadas: arraste as bordas ou cantos para alterar o tamanho.
• Minimizadas: recolhidas para a taskbar, ocupando menos espaço.
• Maximizadas: expandidas para ocupar toda a tela.
• Empilhadas: cada janela tem um zIndex para controle de sobreposição.

Tipos de janela suportados:

Para apps que não são do Kwiq, o comportamento de janela segue o suporte do Android a múltiplas janelas (split-screen, freeform).

5 Densidade da Tela

O Modo Desktop aplica uma densidade de tela reduzida para maximizar o espaço útil:

• Escala de densidade: 0.78x do tamanho normal — elementos ficam menores, mas cabem mais na tela.
• Escala de fonte: 0.92x do tamanho normal — textos ligeiramente menores para melhor aproveitamento.

Isso é aplicado via DesktopDensity composable, que ajusta a configuração de densidade apenas para o Modo Desktop, sem afetar o resto do sistema.

6 Display Externo

O Kwiq suporta telas secundárias conectadas via HDMI (USB-C para HDMI) ou Miracast:

• SecondaryDisplayActivity: gerencia o conteúdo exibido no display externo.
• SecondaryDisplayPresentation: usa a API Presentation do Android para renderizar em outra tela.

Modos de exibição:

• Normal: espelha o launcher no display externo.
• Desktop: exibe o Modo Desktop na tela externa.
• Gaming: exibe o Modo Gaming na tela externa.

• Auto-reconnect: se o app perder o foco, ele tenta se reconectar automaticamente ao display externo.
• Cursor secundário: um cursor independente para a tela externa, gerenciado por KwiqSecondaryCursorState.

Para configurar, conecte o display e escolha o modo desejado nas configurações do Kwiq > "Tela Externa".

7 Cursor Bluetooth (Pointer)

O KwiqPointerAccessibilityService é um serviço de acessibilidade que permite controlar o dispositivo com um cursor, ideal para uso com mouse Bluetooth no Modo Desktop.

Ativação

• Conecte um mouse Bluetooth ao dispositivo Android.
• Ative o "Kwiq Pointer" em: Configurações do Android > Acessibilidade > Kwiq Pointer.
• No Modo Desktop, o cursor aparecerá e responderá aos movimentos do mouse.

Funcionalidades

• Clique: botão esquerdo (toque de 48ms) e direito (toque de 520ms).
• Scroll: scroll vertical e horizontal em qualquer direção.
• Teclado: injeção de teclas via keyPress/keyRelease.
• Texto: copiar, recortar, colar e colar texto via injectText (clipboard + ACTION_PASTE).
• Bloquear tela: GLOBAL_ACTION_LOCK_SCREEN.
• Selecionar tudo: atalho de teclado para seleção completa.

Este serviço é o que permite ao mouse Bluetooth controlar o Modo Desktop com ponteiro real, botão direito e rolagem.

8 Uso com scrcpy

Para usar o Modo Desktop a partir do computador, você pode espelhar um display virtual com o scrcpy:

1. Conecte o dispositivo ao computador via USB.
2. Crie um display virtual com scrcpy:
3. No dispositivo, o display virtual aparece como uma tela secundária.
4. Abra o Modo Desktop do Kwiq e arraste a janela para o display virtual (ou configure o Kwiq para abrir o Desktop no display externo).
5. No computador, a janela do scrcpy mostra o Desktop em ação com performace nativa.

Para uma configuração sem fio com scrcpy:

9 Dicas e Atalhos