Repository navigation
Releases: em-rezende/Android-ArkZ-ARModelViewer
Release list
ArkZ ARModelViewer v1.0.0
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.
- Baixe o APK e abra o arquivo no aparelho.
- Autorize a instalação de fontes desconhecidas para o app que abrir o arquivo
(navegador ou gerenciador de arquivos). - Instale, abra e conceda a permissão de câmera; aponte para um marcador
impresso — as folhas prontas estão emtools/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.apkSem 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,.stle.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:assembleDebugInstale 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 (.glb65.628 B,.obj48.711 B,.ply19.342 B e
.stl74.984 B) e a casaHouse.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
- README —
requisitos, compilação, gestos, formatos, solução de problemas. - Folhas de impressão dos marcadores
(marker_a_print.pngemarker_b_print.png, prontas para imprimir em 100%).
Licença e autoria
- Autor: Ark-Z Arquitetura Ltda
- Desenvolvedor: Ezequiel M. Rezende
- Website: https://em-rezende.github.io/
- E-mail: emrezende@gmail.com
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.



