SceneView: 구글 Sceneform 계승한 Jetpack Compose 기반 3D·AR 오픈소스 SDK
무거운 게임 엔진 없이 안드로이드 Jetpack Compose와 웹 환경에서 3D 렌더링(Filament)과 증강현실(ARCore)을 구현하는 오픈소스 SDK SceneView를 소개합니다. glTF/GLB 및 USDZ 지원, 최신 빌드 요구사항과 AI 코딩 어시스턴트 연동 구조를 정리
모바일 애플리케이션에 입체 3D 그래픽이나 증강현실(AR, Augmented Reality) 기능을 넣으려면 유니티(Unity)나 언리얼(Unreal) 같은 게임 엔진을 임베드하거나, 로우레벨 그래픽스 API를 직접 다루어야 하는 부담이 따랐습니다. 구글이 과거 제공하던 공식 3D 라이브러리인 '씬폼(Sceneform)'이 개발 중단된 이후 안드로이드 생태계에서는 순수 네이티브 UI와 매끄럽게 결합되는 경량 3D 도구를 찾기 어려웠습니다. 오픈소스 프로젝트 SceneView는 구글 씬폼의 설계를 계승하여 최신 안드로이드 UI 툴킷인 젯팩 컴포즈(Jetpack Compose)와 웹 환경에 맞게 재구축된 3D 및 AR 전문 SDK입니다.

이미지 출처: https://github.com/sceneview/sceneview
SceneView는 아파치 2.0(Apache 2.0) 라이선스로 배포되는 공개 저장소 기반 소프트웨어입니다. 구글의 고성능 물리 기반 렌더링(PBR) 엔진인 필라멘트(Filament)와 공간 인식 프레임워크인 ARCore를 코어 엔진으로 삼아, 별도의 대형 런타임 설치 없이도 표준 모바일 뷰 계층 안에서 안정적인 3D 렌더링과 카메라 추적 기능을 구현합니다.
구글 Sceneform의 중단과 SceneView의 아키텍처
구글이 씬폼 개발을 중단했을 때 많은 개발팀이 3D 모델 뷰어나 가상 가구 배치 같은 가벼운 AR 기능을 유지보수하는 데 큰 난관을 겪었습니다. SceneView는 이 공백을 메우기 위해 씬폼의 익숙한 노드(Node) 기반 씬 그래프 구조를 유지하면서도, 현대적인 안드로이드 아키텍처에 맞추어 뼈대를 전면 현대화했습니다.
핵심 렌더러로 채택된 구글 필라멘트는 안드로이드 OS 내부에서도 널리 쓰이는 모바일 특화 실시간 렌더링 엔진입니다. 모바일 기기의 GPU 자원을 적게 소모하면서도 금속성, 거칠기, 환경광 반사 같은 물리 기반 질감을 사실적으로 묘사합니다. SceneView는 이 필라멘트 엔진 위에 고수준 래퍼(Wrapper) 계층을 얹어 복잡한 그래픽스 파이프라인 설정 작업을 젯팩 컴포즈 컴포넌트 호출 하나로 단순화했습니다.
3D 표준 포맷 지원도 탄탄합니다. 웹과 모바일 생태계 표준인 glTF(GL Transmission Format) 및 압축 바이너리 규격인 GLB 파일은 물론, 애플 생태계에서 널리 쓰이는 USDZ(Universal Scene Description Zipped) 포맷의 렌더링을 처리합니다. 이를 통해 이커머스 상품 뷰어나 공간 시각화 앱 개발 시 플랫폼별 모델 파일을 번거롭게 다시 변환할 필요가 줄어듭니다.
Jetpack Compose 중심의 선언형 3D·AR 워크플로
SceneView의 가장 큰 장점은 안드로이드의 최신 UI 개발 표준인 젯팩 컴포즈의 선언형 상태 관리 흐름과 완벽히 동기화된다는 점입니다. 기존 명령형 그래픽스 코드는 생명주기 관리, 렌더 루프 제어, 뷰 갱신을 수동으로 처리해야 했으나 SceneView에서는 상태(State) 값의 변화에 따라 3D 장면이 자연스럽게 재구성됩니다.
3D 씬을 렌더링할 때는 SceneView 컴포저블 블록 안에 궤도 카메라 제어와 기본 조명이 자동으로 세팅됩니다. 여기에 rememberModelInstance 함수를 사용해 로컬 에셋 폴더에 위치한 3D 모델(models/helmet.glb)을 비동기로 로드하고, 로드가 완료되면 컴포지션을 다시 트리거하여 화면에 노드를 띄우는 직관적인 패턴을 취합니다. 이때 필라멘트 엔진의 네이티브 호출은 반드시 안드로이드 메인 스레드에서 실행되어야 하므로, SceneView는 자체 수명주기 헬퍼를 통해 코루틴 백그라운드 스레드와의 경합을 방지하고 메모리 릭(Memory Leak)을 미연에 방지합니다.
AR 기능 역시 마찬가지입니다. arsceneview 모듈을 연동하면 카메라 피드와 ARCore 세션이 결합된 ARSceneView를 즉시 사용할 수 있습니다. 프레임 갱신 시 바닥이나 벽면 같은 수평·수직 평면(Plane)을 탐지하고, 사용자가 선택한 위치에 앵커(Anchor)를 지정하면 코틀린의 mutableStateOf 상태 객체에 좌표가 기록됩니다. 이 앵커 상태가 갱신되는 즉시 컴포즈가 재구성(Recomposition)을 수행하여 현실 공간의 지정된 위치에 1:1 실제 축척으로 3D 모델을 배치합니다.
코딩 에이전트를 위한 MCP 서버와 LLM 친화적 SDK 설계
SceneView는 최근 개발자 도구 트렌드에 발맞추어 'AI 우선(AI-first)' 개발 접근법을 SDK 설계에 도입했습니다. 대규모 언어 모델(LLM)을 기반으로 동작하는 코딩 어시스턴트(Claude Code, Cursor 등)가 SceneView API를 학습하거나 인지하지 못한 채 구버전 씬폼 코드나 환각(Hallucination) 코드를 작성하는 문제를 해결하기 위한 조치입니다.
저장소 루트에는 AI 모델이 SDK의 최신 아키텍처와 호출 규격을 기계 친화적으로 빠르게 파싱할 수 있도록 llms.txt와 AGENTS.md 가이드라인이 명시되어 있습니다. 또한 앤트로픽이 제안한 도구 연동 표준인 모델 컨텍스트 프로토콜(MCP, Model Context Protocol) 서버인 sceneview-mcp 패키지를 npm을 통해 제공합니다.
개발자가 자신의 코딩 환경에 이 MCP 서버를 등록해 두면, 코딩 에이전트가 SceneView의 정확한 최신 컴포저블 문법, 필수 빌드 설정, 올바른 노드 추가 방식, 파라미터 규격을 실시간으로 조회하여 첫 번째 시도에서 바로 컴파일되는 코드를 생성합니다. 프로젝트 측은 에이전트가 정상 동작하는 코드를 생성하지 못할 경우 이를 버그로 간주하고 문서와 API 구조를 고치겠다는 명확한 유지보수 원칙을 밝히고 있습니다.
프로덕션 도입 사례와 빌드 요구사항 및 지원 범위
SceneView는 실험용 토이 프로젝트에 머무르지 않고 실제 상용 서비스 검증을 거쳤습니다. 깃허브 기준 1,300개 이상의 스타와 500개 이상의 공개 프로젝트 의존성을 확보했으며, 이케아(IKEA), 렌즈카트(Lenskart), 메달(Medal), 세이피(Safie) 등 글로벌 기업의 구글 플레이 출시 앱에 적용되었습니다. 블록(Block)의 오픈소스 하드웨어 지갑 비트키(Bitkey) 앱과 나이언틱(Niantic) 스페셜 SDK 샘플에서도 3D 및 공간 시각화 라이브러리로 활용되고 있습니다.
다만 실제 프로젝트에 SceneView 최신 릴리즈(4.69.x)를 도입하기 전에는 까다로운 빌드 도구 체인을 면밀히 확인해야 합니다. 최신 모듈은 성능 최적화와 최신 코틀린 언어 스펙을 위해 다음 사양을 강제합니다.
- 필수 빌드 툴체인:
compileSdk = 37,minSdk = 24이상, 안드로이드 그레이들 플러그인(AGP) 9.4.0 이상, Kotlin 2.3 이상, JVM 타깃 21(자바 및 코틀린 모두 해당) 환경을 요구합니다. 이는 SDK가 자바 21 바이트코드와 인라인 함수를 배포하기 때문입니다. - 하위 호환성 기준: 레거시 환경인 AGP 8, compileSdk 36, Kotlin 2.2 빌드 환경에 머물러 있는 프로젝트라면 최신 버전을 사용할 수 없으며, 해당 환경을 지원하는 최종 버전인
4.18.0으로 버전을 고정해야 합니다. - 크로스 플랫폼 지원 범위 개편: 안드로이드(Jetpack Compose)와 웹(Filament.js 기반
sceneview-web), 코틀린/컴포즈 멀티플랫폼(sceneview-compose)은 활발히 유지보수되고 있습니다. 반면 애플 플랫폼 전용인 SwiftUI(SceneViewSwift), 플러터(flutter_sceneview), 리액트 네이티브(@sceneview-sdk/react-native) 브리지 모듈은 4.68.0 버전을 끝으로 공식 지원이 중단(Deprecated)되었습니다. 저장소 내 소스 코드는 남아 있으나 추가 기능 개발이나 버전 업데이트는 제공되지 않습니다.
가벼운 3D 뷰어나 AR 가구 배치 기능이 필요한 안드로이드 팀이라면, 방대한 게임 엔진을 얹는 대신 선언형 UI 규격을 따르며 최신 그래픽스 엔진을 지원하는 SceneView가 훌륭한 선택지가 될 수 있습니다.
출처
- SceneView GitHub 공식 저장소: sceneview/sceneview
- 별똥별 X 소식 (@stellargent_lab): 2026-11-15 SceneView 오픈소스 SDK 소개