augen 0.4.0
augen: ^0.4.0 copied to clipboard
A Flutter plugin for building AR applications using ARCore on Android and RealityKit on iOS. Enables pure Dart AR development without native code.
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.4.0 - 2025-10-14 #
Added #
- 🚀 Advanced Animation Blending and Transitions - Professional-grade animation system
- Animation blending with weighted combinations
- Smooth crossfade transitions with customizable curves
- Animation state machines with conditional transitions
- Blend trees (1D, 2D, conditional, selector nodes)
- Layered and additive animations
- Bone masking for selective animation
- Real-time transition and state machine status updates
New Animation Models
AnimationBlendandAnimationBlendSet- Complex animation blendingAnimationTransitionandCrossfadeTransition- Smooth transitionsAnimationStateMachineandAnimationState- State-based animation workflowAnimationBlendTreeand various blend tree nodes - Parameter-driven animationTransitionStatusandStateMachineStatus- Real-time status tracking
New Controller Methods
- Blending:
playBlendSet(),updateBlendWeights(),blendAnimations() - Transitions:
startCrossfadeTransition(),crossfadeToAnimation() - State Machines:
startStateMachine(),updateStateMachineParameters() - Blend Trees:
startBlendTree(),updateBlendTreeParameters() - Layered:
playAdditiveAnimation(),setAnimationLayerWeight(),getBoneHierarchy()
New Streams
transitionStatusStream- Monitor transition progressstateMachineStatusStream- Monitor state machine updates
Comprehensive Testing
- 90 new tests for animation blending features
- Total test count increased from 87 to 177 tests
- 100% test coverage maintained
Documentation
- Complete
Documentation.mdconsolidating all guides (3,500+ lines) - Advanced animation blending guide with real-world examples
- Performance tips and best practices
- Troubleshooting guide
Changed #
AugenControllerextended with 18 new animation methods- Enhanced
ARNodesupport for complex animation workflows - Updated README.md with v0.4.0 and consolidated documentation links
- Fixed
BuildContextacross async gaps in example app (8 fixes)
Merged Documentation #
- All individual documentation files merged into single
Documentation.md - Improved navigation with comprehensive table of contents
- Consolidated examples and best practices
Platform Support #
- Animation blending API ready for native implementation
- Data structures optimized for ARCore Filament and RealityKit
0.3.1 - 2025-10-14 #
Changed #
- Updated README.md dependency version to ^0.3.0
- Added comprehensive community feedback section in README
- Added bug reporting, testing feedback, and feature request links
- Improved call-to-action for community involvement
0.3.0 - 2025-10-14 #
Added #
- 🎬 Model Animation and Skeletal Animation Support
- Full animation playback control
- Skeletal (bone-based) animations
- Morph target animations
- Multiple animations per model
- New animation control methods:
playAnimation()- Play animations with speed and loop mode controlpauseAnimation()- Pause animation playbackstopAnimation()- Stop and reset animationresumeAnimation()- Resume paused animationseekAnimation()- Jump to specific time in animationgetAvailableAnimations()- Query available animationssetAnimationSpeed()- Change playback speed dynamically
- New
ARAnimationmodel class with full configuration - New
AnimationStatusclass for animation state tracking - New enums:
AnimationState,AnimationLoopMode animationStatusStreamfor real-time animation updates- Comprehensive animation tests (25 new tests)
ANIMATIONS_GUIDE.md- Complete animation documentation
Changed #
ARNodenow supportsanimationsparameterARNode.fromModel()accepts animations list- Updated Android implementation with animation methods
- Updated iOS implementation with RealityKit animation support
- Test count increased from 62 to 87 tests
- Enhanced README with animation examples
Platform Support #
- Android: Skeletal animations via Filament Animator
- iOS: Native animation support via RealityKit AnimationResource
0.2.1 - 2025-10-14 #
Fixed #
- Formatted all Dart files to match Dart formatter standards
- Fixed formatting issues in
augen_method_channel.dart - Fixed formatting issues in
ar_node.dart
0.2.0 - 2025-10-13 #
Added #
- ✨ Custom 3D model loading support
- Load models from Flutter assets
- Load models from URLs
- Support for GLTF, GLB, OBJ, and USDZ formats
- Auto-detection of model format from file extension
ARNode.fromModel()factory constructoraddModelFromAsset()andaddModelFromUrl()helper methods
- New
ModelFormatenum (gltf, glb, obj, usdz) - Comprehensive test coverage for model loading (10 new tests)
CUSTOM_MODELS_GUIDE.mdcomprehensive documentation- Enhanced README with model loading examples
Changed #
ARNodenow supportsmodelPathandmodelFormatparameters- Updated Android (Kotlin) implementation for custom 3D models
- Updated iOS (Swift) implementation for custom 3D models
- Test count increased from 52 to 62 tests
- Version bumped to 0.1.1
- Updated all documentation with model loading information
Fixed #
- Unused variable lint in example app
- Import issues in controller tests
0.1.0 - 2025-10-13 #
Added #
- Initial release of Augen AR plugin
- AR session management (initialize, pause, resume, reset)
- Plane detection (horizontal and vertical)
- 3D object rendering (sphere, cube, cylinder)
- AR anchors management
- Hit testing for surface detection
- Light estimation
- Depth data support
- Auto-focus capability
- Cross-platform support (Android ARCore and iOS RealityKit)
- Comprehensive documentation and examples
- Full test coverage (52 tests)
Platform Support #
- Android: ARCore (API level 24+)
- iOS: RealityKit and ARKit (iOS 13.0+)
For more details about each release, visit the GitHub releases page.