A reference application for PICO OS 6 demonstrating best practices for implementing skeletal and tween animations with the PICO Spatial SDK.
This sample provides a practical guide for developers to explore and implement animation capabilities of the PICO Spatial SDK. Through an interactive 3D environment, users can experience skeletal animations (character bone-based movements), tween animations (smooth transform and material interpolations), and animation playback controls.
The app follows MVVM architecture with stateless utility classes and proper Android lifecycle management for efficient animation resource handling.
Animation Sample highlights the following core animation capabilities of the PICO Spatial SDK:
- 3D Model Integration: load and animate GLB/USDZ models in spatial environments
- Skeletal Animation System: bone-based character animations with multiple animation states
- Tween Animation Framework: smooth interpolation for 3D object transform and material properties
- Animation Control Interface: interactive controls for playback, speed adjustment, and state management
- Animation Resource Management: efficient loading and cleanup of animation resources
- MVVM Architecture: clean separation of concerns with stateless utility classes and ViewModel state management
- Lifecycle Management: proper handling of animation resources during Android lifecycle events
To build and run this project, configure your development environment by following the official PICO Spatial SDK setup guide:
- PICO Spatial SDK Setup Guide (Outside Chinese Mainland)
- PICO Spatial SDK Setup Guide (Chinese Mainland)
git clone <repository-url>
cd AnimationLaunch Android Studio, select Open an Existing Project, and choose the Animation directory.
- Open Device Manager (toolbar or Tools > Device Manager)
- Click Add a new device > Create a PICO Emulator
- Start the emulator from Device Manager
- Click Run 'app' to launch the app
- Connect your PICO device to your development machine
- Enable USB Debugging on the device
- Click Run 'app' to deploy directly to your device
Animation Sample follows a modular architecture to separate application logic from 3D resources:
Animation/
├── app/ # Main application module
│ └── src/main/
│ ├── java/com/pico/spatial/sample/animation/ # Kotlin source files
│ │ ├── Main.kt # App entry point
│ │ ├── data/ # Animation state definitions
│ │ │ └── AnimationModels.kt
│ │ ├── ktx/ # Extension functions
│ │ │ └── Extensions.kt
│ │ ├── manager/ # Event and animation managers
│ │ │ └── EventManager.kt
│ │ ├── platform/ # Platform-specific implementations
│ │ │ ├── LaunchActivity.kt
│ │ │ └── SpatialApplication.kt # App initialization
│ │ ├── ui/ # UI components and pages (Compose)
│ │ │ ├── common/
│ │ │ │ └── AnimationPlayView.kt # Main play view with auto-restart logic
│ │ │ ├── home/ # Home page and navigation
│ │ │ ├── skeletal/ # Skeletal animation UI and ViewModel
│ │ │ └── tween/ # Tween animation UI and ViewModel
│ │ └── util/ # Stateless animation utilities
│ │ ├── SkeletalAnimationUtil.kt # Skeletal animation management
│ │ └── TweenAnimationUtil.kt # Tween animation management
│ ├── assets/ # 3D models and animation assets
│ │ ├── pico_robot_animated.glb # Animated robot model (skeletal)
│ │ └── pico_robot_static.usdz # Static robot model (tween)
│ ├── res/ # Android resources
│ └── AndroidManifest.xml # App manifest with Spatial component declarations
├── gradle/ # Gradle dependencies and scripts
├── build.gradle.kts # Root build configuration
└── settings.gradle.kts # Project settings and SDK configurationTo modify or extend the 3D assets in Animation Sample:
- In Android Studio, navigate to the app/src/main/assets/ directory
- Replace the existing GLB/USDZ files with your animated models
- Update the animation configurations in source code to match your new assets
- Ensure your models contain animation data compatible with the Spatial SDK
To deepen your understanding of spatial app development, explore the resources on our official developer websites:
© 2026 PICO. The project's source code is licensed under the Apache 2.0 License. All assets, including textures, 3D models, audio, and others, are licensed via Creative Commons BY 4.0.
For questions, issues, or feature requests, please contact us through the PICO Developer Support Portal and submit a ticket.
Developed as a reference for spatial application developers
