Documentação

Documentação técnica do aplicativo NexoForge para Samsung Smart TV (Tizen). Esta página reúne requisitos de sistema, arquitetura, limitações e informações de operação. Última revisão em 1 de outubro de 2026 (versão 1.1.1 do aplicativo).

1. Requisitos de sistema

1.1. TV compatível

• Sistema operacional: Samsung Tizen 5.0 ou superior
• Modelos: todas as Samsung Smart TV QLED, Neo QLED e Crystal UHD lançadas a partir de 2020
• Modelos específicos testados: QN50QN90C, QN55QN85C, Q60B, Q70A, Q80A, Q90A, QN900B, TU8000, CU7000, AU8000, The Frame LS03B, The Serif LS01B
• Memória disponível: mínimo 256 MB de RAM livres
• Armazenamento: aplicativo ocupa 18–25 MB após instalação; cache local pode crescer até 300 MB

1.2. Rede

• Conexão: Wi-Fi 2.4/5 GHz ou Ethernet cabeada
• Largura de banda mínima: 5 Mbps para FHD; 15 Mbps para 4K; 40 Mbps para 4K HDR
• Latência máxima aceitável: 300ms para o servidor do provedor (medida pelo aplicativo e reportada em caso de erro)
• DNS: funciona com DNS da TV / roteador (não força DNS específico)

1.3. Controle remoto

• Samsung Smart Remote (One Remote, Solar Cell Remote)
• Controles de TV convencionais com botões direcionais
• Apps de controle remoto (SmartThings / Samsung TV Remote) via infravermelho emulado

2. Arquitetura do aplicativo

2.1. Camada de apresentação

A interface é construída em TypeScript puro com React 18 e Vite 5 para bundling. Renderização via DOM nativo do Tizen (Chromium 76+ em Tizen 5.0+). Nenhum framework pesado de UI é usado — a biblioteca de componentes é interna, otimizada para TV.

• Navegação espacial: Norigin Spatial Navigation (motor de foco D-pad com cutoff geométrico)
• Code splitting: React.lazy + Suspense em granularidade de rota
• Imagens: createImageBitmap otimizado para Tizen (colorSpaceConversion:none pra evitar conversão ICC de 7,5s)
• Bundle tamanho: <120 KB gzipped para o entry

2.2. Camada de reprodução

Vídeo é reproduzido via webapis.avplay, a API nativa de reprodução da Samsung Tizen. Isso dá acesso ao decodificador de hardware da TV, resultando em:

• CPU em menos de 5% durante reprodução 4K
• Latência de startup <800ms após resolução de redirect
• Compatibilidade com HDR10 e Dolby Vision passthrough
• Áudio processado pela placa Dolby Atmos / DTS:X da TV quando disponível

2.3. Camada de dados

Catálogos (lista de títulos, categorias, metadata) são cacheados em IndexedDB com estratégia stale-while-revalidate:

• Primeira abertura: fetch + persist + render (3–8 segundos)
• Aberturas seguintes: render de cache em <800ms + revalidate em background
• Chunking: catálogos grandes (14 MB+) são divididos em chunks de 1000 itens para evitar bloqueio da main thread
• Parse streaming: JSON é parseado via Response.body.getReader() + yieldToMain() cooperativo

2.4. Credenciais

As credenciais que o usuário digita (fornecidas pelo provedor que contratou) ficam armazenadas em localStorage do WebView Tizen, isolado por app. Nunca passam pelos servidores da Artemis em texto puro. A autenticação é feita diretamente entre a TV do usuário e o servidor do provedor.

3. Fluxo de uso

1. Usuário instala o aplicativo pela Samsung Apps
2. Primeira abertura: tela pedindo código do provedor(ex: um nome curto em minúsculas, sem espaços nem acentos)
3. Aplicativo faz uma requisição a nossa API de configuração (config.nexoforgeoficial.com) para buscar o branding (logo, cores, nome a exibir) desse provedor
4. Tela de login pedindo usuário e senha fornecidos pelo provedor
5. Autenticação é enviada diretamente ao servidor do provedor
6. Em caso de sucesso, o aplicativo baixa o catálogo e exibe a tela inicial com destaques, "continuar assistindo", categorias e grid de posters

4. Interface

4.1. Estrutura

• Barra lateral: logo + 5 ícones (Home, Filmes, Séries, Ao Vivo, Buscar) + botão de ajustes
• Hero rotativo: carrossel de destaques do catálogo do provedor, com título, sinopse, botão "Assistir"
• Linhas horizontais: "Continuar Assistindo", "Em alta", "Novidades" e categorias
• Tela de detalhe: poster, backdrop, sinopse, classificação, duração, ano, botões Play/Trailer/Favoritar
• Player: controles mínimos sobre o vídeo — play/pause, barra de progresso, duração, opções de áudio e legenda

4.2. Navegação por D-pad

• Setas ← → navegam entre elementos horizontalmente alinhados
• Setas ↑ ↓ pulam entre linhas e seções
• OK confirma / abre
• Back retorna à tela anterior
• Home da TV sai do aplicativo (padrão Samsung)

4.3. Teclado virtual

Para campos de texto (código do provedor, usuário, senha, busca), o aplicativo usa o teclado virtual nativo da TV Samsung — nunca um teclado customizado por cima do nosso. Isso garante consistência e suporte a métodos de entrada alternativos (voz, SmartThings).

5. Reprodução de mídia

5.1. Formatos suportados

• Vídeo: H.264 (AVC) High Profile L4.1 até 4K60; H.265 (HEVC) Main10 até 4K60; VP9 Profile 2 até 4K60 (modelos 2021+)
• Áudio: AAC-LC, HE-AAC v1/v2, Dolby Digital (AC-3), Dolby Digital Plus (E-AC-3), DTS passthrough
• Containers: MP4, TS, MKV, HLS (m3u8), MPEG-DASH
• Legendas: SRT, VTT, WebVTT inline, EIA-608/708 embutidas no stream

5.2. HDR

• HDR10 passthrough em modelos QLED e Neo QLED
• HDR10+ em modelos 2020+
• Dolby Vision em modelos 2022+ (quando TV e firmware suportam)

5.3. Adaptive bitrate

Para streams HLS, o AVPlay seleciona automaticamente a melhor qualidade conforme largura de banda disponível. O aplicativo não força resolução fixa — isso é delegado ao decodificador.

6. Privacidade e segurança

• Todas as requisições HTTPS/TLS 1.2+
• Credenciais nunca enviadas aos servidores da Artemis em texto puro
• Nenhum tracker publicitário embutido
• Nenhum fingerprint persistente além do DUID exigido pelo Tizen
• Logs técnicos retidos no máximo 12 meses

Veja detalhes completos na Política de Privacidade.

7. Limitações conhecidas

• Em TVs Tizen 5.0 e 5.5, o startup inicial do app pode levar até 4 segundos (hardware limitado)
• Reprodução simultânea com Picture-in-Picture do sistema Samsung não é suportada (limitação do AVPlay)
• Downloads para visualização offline não são oferecidos (o aplicativo é estritamente streaming)
• Transmissão para outros dispositivos (Chromecast, AirPlay) não é suportada — a reprodução acontece sempre na TV onde o app está instalado

8. Suporte a controle parental

O aplicativo oferece bloqueio por PIN de 4 dígitos. Quando ativo, o PIN é solicitado antes de abrir categorias classificadas como adultas no catálogo do provedor. PIN padrão: 0000. Alteração em Configurações → Controle Parental.

9. Versões suportadas

A Artemis mantém atualizações da versão atual e da anterior (N e N-1). Correções de segurança podem ser aplicadas também a versões mais antigas em casos críticos. Veja o histórico de versões.

10. Contato técnico

• Suporte geral: contato@artemiscorporation.com.br
• Reporte de bug: inclua modelo da TV, versão do app (visível em Configurações → Sobre), hora do incidente e, se possível, foto da tela