Skip to content

Releases: em-rezende/Android-ArkZ-ARModelViewer

ArkZ ARModelViewer v1.0.0

Choose a tag to compare

@em-rezende em-rezende released this 20 Sep 19:52

ArkZ ARModelViewer 1.0.0

Primeiro release público do ArkZ ARModelViewer — visualizador de modelos 3D
em Realidade Aumentada para Android, com o modelo ancorado em marcadores de
imagem (QR code)
detectados pelo ARCore (Augmented Images).

Download (APK pronto)

ArkZ-ARModelViewer-1.0.0.apk — 45,8 MB (43,6 MiB) — disponível em Assets, no
fim desta página.

  1. Baixe o APK e abra o arquivo no aparelho.
  2. Autorize a instalação de fontes desconhecidas para o app que abrir o arquivo
    (navegador ou gerenciador de arquivos).
  3. Instale, abra e conceda a permissão de câmera; aponte para um marcador
    impresso — as folhas prontas estão em tools/print/.

Requisitos: Android 7.0 (API 24) ou superior, com ARCore (Google Play
Services for AR).

Integridade

  • SHA-256 do APK: 2ff2546afff64332f06e8a3501e2c0b2d4f94dd67ce3009aeac7a91cb4ad56b4
  • Assinatura: APK Signature Scheme v2, 1 signatário —
    CN=Ark-Z Arquitetura Ltda, OU=ArkZ ARModelViewer, O=Ark-Z Arquitetura Ltda, C=BR
  • SHA-256 do certificado:
    03:6D:8B:55:0B:C0:00:78:09:8F:89:1E:03:30:D4:2F:18:DF:DD:D4:39:D6:06:90:EF:4A:E8:EF:DC:C8:F9:87
apksigner verify --print-certs ArkZ-ARModelViewer-1.0.0.apk
# Windows: Get-FileHash -Algorithm SHA256 ArkZ-ARModelViewer-1.0.0.apk

Sem um APK assinado, você também pode compilar do código-fonte — veja
Instalação (compilando do código-fonte) abaixo. Em qualquer caso é necessário um
aparelho com suporte a ARCore + Google Play Services for AR.

Destaques

  • Modelo ancorado no marcador — renderização com
    SceneView 4.38.0 (Filament) sobre o
    rastreamento de imagem do ARCore 1.54.0.
  • Formatos: .glb, .gltf, .obj, .ply, .stl e .3mf, com detecção
    pelo conteúdo do arquivo (não só pela extensão).
  • Ajuste fino no lugar: painel com rotação X/Y/Z (inclinar/girar/rolar),
    tamanho (maior dimensão) e elevação Z (plano do marcador) — com efeito
    imediato, sem sair da cena de RA.
  • Marcadores: dois embutidos (A e B), marcadores personalizados (imagem do
    aparelho) e um gerador de marcador pseudo-QR dentro do app; o app também
    exporta a folha de impressão do marcador em escala 100%.
  • Captura de tela em três qualidades (Padrão 1280 px / Alta 1920 px / Máxima),
    salva na galeria sem a interface.
  • 8 idiomas (pt-BR, pt-PT, en, es, fr, it, de, zh-CN) com troca de idioma
    dentro do app.
  • Escala automática pela largura do marcador, gestos de câmera (orbitar, zoom,
    pinça), ajuda na primeira execução e diagnóstico copiável para suporte.

Capturas

Tela principal Ajustes do modelo Gerenciar marcador Criar/Carregar marcador

Instalação (compilando do código-fonte)

git clone https://github.com/em-rezende/Android-ArkZ-ARModelViewer.git
cd Android-ArkZ-ARModelViewer
# Windows
gradlew.bat :app:assembleDebug

# macOS / Linux
./gradlew :app:assembleDebug

Instale o APK gerado em app/build/outputs/apk/debug/ (adb install ou copiando
para o aparelho). Requisitos de compilação: Android Studio atual, JDK 21+ e
Android SDK 37 (platforms;android-37.0 + build-tools;37.0.0). Aparelho final:
Android 7.0 (API 24) ou superior, com ARCore.

Modelos 3D para teste

Os cinco arquivos de
3d_models/
também estão anexados aqui em Assets — conteúdo idêntico ao do repositório,
para baixar sem passar pelo raw (que serve o .obj como text/plain e, em alguns
navegadores/gerenciadores, abre em vez de baixar, ou salva com outra extensão —
e o app valida o formato pela extensão).

Asset Bytes SHA-256
ArkZ_logo.glb 65.628 493d580e1b7e27a20fd213d4bec394a4c3c350e546569fa7b53ec99a9e5b8c74
ArkZ_logo.obj 48.711 7015e67af35161ee8b212ca78a1642576c17b89204ea15f83a20dfc123fb9a0c
ArkZ_logo.ply 19.342 db8332541307a8e265de7edde3977a3c4b27759e597982aa9d40eed4f4ce3e5c
ArkZ_logo.stl 74.984 eb86c23eb72f595bd396e979acb547096dfe8322265ea9f6517fb4effce7fb83
House.glb 7.704 596b44540c08e75bdff269454a182c28694ff44bdc7450a3833934be40a8edb1

Se um arquivo baixado ficar menor que o tamanho acima, o download foi cortado
(ou o navegador salvou a página em vez do arquivo): baixe novamente pelos Assets.

Revisão dos modelos (25/09/2026): os anexos foram atualizados para a revisão
atual de
3d_models/
— o logotipo foi reexportado (.glb 65.628 B, .obj 48.711 B, .ply 19.342 B e
.stl 74.984 B) e a casa House.glb (7.704 B) entrou no lugar do antigo edifício
em .glb. Os tamanhos e SHA-256 da tabela acima são os dos anexos atuais.

O que há de novo

Changelog completo: CHANGELOG.md
— esta é a primeira versão pública, com o fluxo completo de RA
(carregar modelo → apontar a câmera → ver o modelo fixo sobre o marcador).

Documentação

Licença e autoria

Distribuído sob a GNU General Public License v3.0 — veja
LICENSE.

Copyright (C) 2026 Ark-Z Arquitetura Ltda.

Este programa é software livre: você pode redistribuí-lo e/ou modificá-lo sob os
termos da GNU General Public License, versão 3, publicada pela Free Software
Foundation. Este programa é distribuído na esperança de ser útil, mas sem
nenhuma garantia
, sem mesmo a garantia implícita de comerciabilidade ou
adequação a um propósito específico. Veja a licença para mais detalhes.