Added #

• 👥 Multi-User AR Experiences - Complete shared AR system
  • Real-time collaborative AR sessions with multiple participants
  • Session management with create, join, leave operations
  • Participant management with roles (host, participant, observer) and permissions
  • Object synchronization across all participants in a session
  • Real-time participant position and rotation tracking
  • Session capabilities (spatial sharing, object sync, real-time collaboration, voice chat, gesture sharing, avatar display)
  • Private sessions with password protection
  • Configurable maximum participants per session

New Features #

• ARMultiUserSession Model: Complete session data structure with participants, capabilities, and state
• MultiUserParticipant Model: Participant information with position, rotation, role, and status
• MultiUserSharedObject Model: Synchronized object data across all session participants
• MultiUserSessionStatus Model: Real-time status updates for multi-user operations
• MultiUserConnectionState Enum: Connection states (disconnected, connecting, connected, reconnecting, failed)
• MultiUserRole Enum: Participant roles (host, participant, observer)
• MultiUserCapability Enum: Session capabilities for different multi-user features

Enhanced Controller #

• Multi-User Methods: Complete multi-user API with 10+ new methods
  • isMultiUserSupported() - Check multi-user support
  • createMultiUserSession() - Create new shared AR session
  • joinMultiUserSession() - Join existing session
  • leaveMultiUserSession() - Leave current session
  • getMultiUserSession() - Get current session info
  • getMultiUserParticipants() - Get all participants
  • shareObject() - Share AR object with all participants
  • unshareObject() - Remove shared object
  • updateSharedObject() - Update shared object properties
  • getMultiUserSharedObjects() - Get all shared objects
  • setParticipantRole() - Change participant role
  • kickParticipant() - Remove participant from session
  • updateParticipantDisplayName() - Update participant name

New Streams #

• multiUserSessionStream: Real-time session updates
• multiUserParticipantsStream: Real-time participant updates
• multiUserSharedObjectsStream: Real-time shared object updates
• multiUserSessionStatusStream: Real-time multi-user status updates

Enhanced Documentation #

• Multi-User AR Section: Complete guide in Documentation.md
  • Session setup and configuration
  • Creating and joining sessions
  • Managing participants and roles
  • Sharing and synchronizing objects
  • Monitoring session status
  • Best practices and examples

Testing #

• 37 New Unit Tests: Comprehensive test coverage for all multi-user features
• Total Tests: 368 passing tests (increased from 331)
• Test Coverage: 100% coverage maintained
• Multi-User Integration Tests: Ready for device testing

Documentation Updates #

• Added Multi-User AR section to complete documentation
• Updated README.md with multi-user features
• Added multi-user examples and best practices
• Updated API reference with all new methods

Added #

• ⚛️ Physics Simulation for AR Objects - Complete physics system
  • Dynamic, static, and kinematic physics bodies with realistic interactions
  • Physics materials with density, friction, restitution, and damping properties
  • Physics constraints including hinge, ball socket, fixed, slider, cone twist, and 6DOF joints
  • Physics world configuration with gravity, time step, and collision settings
  • Real-time physics body and constraint monitoring via streams
  • Cross-platform physics support (ARCore/ARKit)
  • Physics status tracking and error handling

New Features #

• ARPhysicsBody Model: Complete physics body data structure with position, rotation, velocity, mass, and material properties
• PhysicsMaterial Model: Configurable material properties for realistic physics interactions
• PhysicsConstraint Model: Joint and constraint system for connecting physics bodies
• PhysicsWorldConfig Model: Physics world configuration with gravity, time step, and collision settings
• PhysicsStatus Model: Real-time status updates for physics operations
• PhysicsBodyType Enum: Support for static, dynamic, and kinematic body types
• PhysicsConstraintType Enum: Support for various constraint types (hinge, ball socket, fixed, slider, cone twist, 6DOF)

Enhanced Controller #

• Physics Methods: Complete physics API with 15+ new methods
  • isPhysicsSupported() - Check physics support
  • initializePhysics(config) - Initialize physics world
  • startPhysics() / stopPhysics() / pausePhysics() / resumePhysics() - Physics control
  • createPhysicsBody() / removePhysicsBody() - Body management
  • applyForce() / applyImpulse() - Force application
  • setVelocity() / setAngularVelocity() - Velocity control
  • createPhysicsConstraint() / removePhysicsConstraint() - Constraint management
  • getPhysicsBodies() / getPhysicsConstraints() - Data retrieval
  • getPhysicsWorldConfig() / updatePhysicsWorldConfig() - Configuration management

New Streams #

• physicsBodiesStream: Real-time physics body updates
• physicsConstraintsStream: Real-time constraint updates
• physicsStatusStream: Real-time physics status updates

Enhanced Example App #

• Physics Tab: Complete physics demonstration interface
• Physics Controls: Support checking, physics toggling, body creation, force application
• Real-time Monitoring: Live physics body and constraint display
• Physics Information: Educational content about physics body types and materials
• Status Integration: Physics status in main status view

Enhanced Integration Tests #

• Physics Integration Test: Complete physics workflow testing
• Physics Support Detection: Automatic physics capability testing
• Physics World Initialization: Configuration and startup testing
• Physics Body Creation: Dynamic body creation and management testing
• Physics Force Application: Force and impulse application testing
• Physics Stream Monitoring: Real-time physics data stream testing
• Physics Control Testing: Start, pause, resume physics testing

Documentation Updates #

• Physics Simulation Section: Complete physics guide in Documentation.md
• Physics API Reference: Detailed physics method documentation
• Physics Examples: Comprehensive physics usage examples
• Physics Best Practices: Performance and implementation guidelines
• Physics Tutorial: Step-by-step physics setup and usage guide

Testing #

• 51 New Unit Tests: Complete physics model and controller testing
• Physics Model Tests: ARPhysicsBody, PhysicsMaterial, PhysicsConstraint, PhysicsWorldConfig, PhysicsStatus testing
• Physics Controller Tests: All physics methods and streams testing
• Physics Integration Tests: End-to-end physics workflow testing
• Test Coverage: 100% coverage maintained with 331 total tests

Performance Improvements #

• Efficient Physics Updates: Optimized physics body and constraint streaming
• Physics Status Monitoring: Real-time physics operation tracking
• Memory Management: Proper physics resource cleanup and disposal
• Cross-Platform Optimization: Platform-specific physics optimizations

Breaking Changes #

• None

Bug Fixes #

• Fixed velocity magnitude calculation in example app
• Fixed physics stream subscription management
• Fixed physics body creation parameter validation
• Fixed physics constraint anchor handling

Dependencies #

• No new dependencies added
• All existing dependencies maintained

Added #

• 👁️ Occlusion for Realistic Rendering - Complete occlusion system
  • Depth-based occlusion using depth maps for realistic object hiding
  • Person occlusion using person segmentation for human-aware AR
  • Plane occlusion using detected planes for surface-aware AR
  • Real-time occlusion status monitoring and management
  • Cross-platform occlusion support (ARCore/ARKit)
  • Occlusion configuration and capabilities detection
  • Comprehensive occlusion data models and streams

New Features #

• AROcclusion Model: Complete occlusion data structure with position, rotation, scale, confidence, and metadata
• OcclusionType Enum: Support for depth, person, plane, and none occlusion types
• OcclusionStatus Model: Real-time status updates for occlusion operations
• Occlusion Methods: Full CRUD operations for occlusion management
• Occlusion Streams: Real-time updates for active occlusions and status changes
• Occlusion Configuration: Flexible setup for different occlusion types
• Occlusion Capabilities: Device capability detection and reporting

Enhanced Examples #

• Occlusion Tab: Complete occlusion demonstration in example app
• Occlusion Controls: Enable/disable occlusion with visual feedback
• Occlusion Management: Create, monitor, and manage active occlusions
• Occlusion Statistics: Real-time occlusion count and status display
• Occlusion Integration Tests: Comprehensive test coverage for occlusion features

Documentation Updates #

• Occlusion Guide: Complete documentation with examples and best practices
• Occlusion API Reference: Detailed method and model documentation
• Occlusion Examples: Code samples for all occlusion features
• Occlusion Best Practices: Performance optimization and error handling guides

Testing #

• 50 New Unit Tests: Comprehensive test coverage for all occlusion features
• Occlusion Integration Tests: Full integration test suite for occlusion functionality
• 280 Total Tests: All tests passing with 100% coverage
• Occlusion Model Tests: Complete serialization, deserialization, and equality testing
• Occlusion Controller Tests: Full method and stream testing

Technical Improvements #

• Occlusion Stream Management: Proper subscription handling and cleanup
• Occlusion Error Handling: Comprehensive error management and user feedback
• Occlusion Type Safety: Full type safety for all occlusion operations
• Occlusion Performance: Optimized occlusion operations and memory management
• Occlusion Documentation: Complete inline documentation and examples

Fixed #

• Fixed Dart formatting issues in core files
• Improved code formatting consistency across the package
• Updated example app formatting
• Enhanced test file formatting

Technical Improvements #

• Applied dart format to all source files
• Maintained 255 passing tests after formatting
• Improved code readability and maintainability
• Ensured consistent code style across the entire codebase

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Added #

• ☁️ Cloud Anchors for Persistent AR - Complete cloud anchor system
  • Create persistent AR experiences that survive app restarts
  • Share AR experiences between multiple users
  • Cross-platform cloud anchor support (ARCore/ARKit)
  • Real-time cloud anchor status monitoring
  • Session-based cloud anchor sharing
  • Automatic cloud anchor resolution and tracking

New Cloud Anchor Models

• ARCloudAnchor - Represents cloud anchors with position, rotation, scale, and state
• CloudAnchorState - Enum for cloud anchor states (creating, created, resolving, resolved, failed, expired)
• CloudAnchorStatus - Real-time status updates for cloud anchor operations

New Cloud Anchor Methods

• createCloudAnchor(String localAnchorId) - Convert local anchor to cloud anchor
• resolveCloudAnchor(String cloudAnchorId) - Resolve cloud anchor by ID
• getCloudAnchors() - Get all cloud anchors in current session
• getCloudAnchor(String cloudAnchorId) - Get specific cloud anchor by ID
• deleteCloudAnchor(String cloudAnchorId) - Delete cloud anchor
• isCloudAnchorsSupported() - Check if cloud anchors are supported
• setCloudAnchorConfig() - Configure cloud anchor settings
• shareCloudAnchor(String cloudAnchorId) - Share cloud anchor session
• joinCloudAnchorSession(String sessionId) - Join shared session
• leaveCloudAnchorSession() - Leave current session

New Cloud Anchor Streams

• cloudAnchorsStream - Stream of cloud anchor updates
• cloudAnchorStatusStream - Stream of cloud anchor status updates

Enhanced Example App

• Added Cloud Anchors tab with full cloud anchor management
• Cloud anchor support detection and configuration
• Create, share, and join cloud anchor sessions
• Real-time cloud anchor status monitoring
• Cloud anchor list with state information
• Session management UI

Updated Documentation

• Added comprehensive Cloud Anchors section to Documentation.md
• Complete cloud anchor setup and usage guide
• Best practices for cloud anchor implementation
• Example code for all cloud anchor features
• Updated README.md with cloud anchor features and examples

Testing

• Added 13 new cloud anchor unit tests
• Comprehensive testing of all cloud anchor models and methods
• Updated integration tests to include cloud anchor workflows
• Total test count: 243 passing tests

Technical Details #

• Cloud anchors enable persistent AR experiences across app sessions
• Multi-user AR support through session sharing
• Real-time status monitoring for cloud anchor operations
• Cross-platform compatibility with ARCore and ARKit
• Automatic cloud anchor resolution and tracking
• Session-based sharing for collaborative AR experiences

Added #

• 👤 Face Tracking and Recognition - Complete face tracking system
  • Real-time detection and tracking of human faces
  • Multiple simultaneous face tracking support
  • High accuracy position, rotation, and scale tracking
  • Confidence scoring for tracking reliability
  • Automatic content anchoring to tracked faces
  • Cross-platform support (ARCore/ARKit)

New Face Tracking Models

• ARFace - Represents tracked faces with position, rotation, scale, and landmarks
• FaceLandmark - Represents specific facial feature points (eyes, nose, mouth, etc.)
• FaceTrackingState - Enum for face tracking states (tracked, notTracked, paused, failed)

New Face Tracking Methods

• setFaceTrackingEnabled(bool enabled) - Enable/disable face tracking
• isFaceTrackingEnabled() - Check if face tracking is enabled
• getTrackedFaces() - Get all currently tracked faces
• addNodeToTrackedFace(String nodeId, String faceId, ARNode node) - Add content to tracked face
• removeNodeFromTrackedFace(String nodeId, String faceId) - Remove content from tracked face
• getFaceLandmarks(String faceId) - Get facial landmarks for a specific face
• setFaceTrackingConfig(...) - Configure face tracking parameters

New Face Tracking Streams

• facesStream - Stream of tracked faces with real-time updates

Enhanced Example App

• Added comprehensive face tracking demonstration
• Interactive face tracking controls
• Real-time face tracking statistics
• Face landmark visualization
• Content anchoring to faces

Enhanced Documentation

• Complete face tracking guide in Documentation.md
• Face tracking API reference
• Face tracking best practices
• Face tracking examples and use cases

Enhanced #

• Example App: Added face tracking tab with full feature demonstration
• Integration Tests: Added comprehensive face tracking integration tests
• Documentation: Updated with face tracking features and examples
• Test Coverage: Added 14 new face tracking tests (230 total tests)

Technical Details #

• Face tracking uses ARCore's face detection on Android
• Face tracking uses ARKit's face tracking on iOS
• Supports multiple faces simultaneously
• Provides detailed facial landmarks (eyes, nose, mouth, ears, etc.)
• Real-time confidence scoring for tracking reliability
• Automatic content positioning relative to face features

Added #

• 🖼️ Image Tracking and Recognition - Complete image tracking system
  • Real-time detection and tracking of specific images
  • Multiple simultaneous image target support
  • High accuracy position and orientation tracking
  • Confidence scoring for tracking reliability
  • Automatic content anchoring to tracked images
  • Cross-platform support (ARCore/ARKit)

New Image Tracking Models

• ARImageTarget - Represents image targets for tracking
• ARTrackedImage - Represents currently tracked images
• ImageTargetSize - Physical dimensions of image targets
• ImageTrackingState - Tracking state enumeration

New Controller Methods

• addImageTarget() - Register image targets for tracking
• removeImageTarget() - Remove image targets
• getImageTargets() - Get all registered targets
• getTrackedImages() - Get currently tracked images
• setImageTrackingEnabled() - Enable/disable image tracking
• isImageTrackingEnabled() - Check tracking status
• addNodeToTrackedImage() - Anchor content to tracked images
• removeNodeFromTrackedImage() - Remove anchored content

New Streams

• imageTargetsStream - Real-time image target updates
• trackedImagesStream - Real-time tracked image updates

Testing

• 21 new image tracking model tests
• 10 new controller method tests
• 2 new stream tests
• Total test count: 208 tests (all passing)

Documentation

• Complete Image Tracking section in Documentation.md
• API reference for all new methods and models
• Best practices and performance optimization guide
• Real-world examples and usage patterns
• Updated README with image tracking features

Changed #

• Updated test count from 177 to 208 tests
• Enhanced documentation with comprehensive image tracking guide

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

• AnimationBlend and AnimationBlendSet - Complex animation blending
• AnimationTransition and CrossfadeTransition - Smooth transitions
• AnimationStateMachine and AnimationState - State-based animation workflow
• AnimationBlendTree and various blend tree nodes - Parameter-driven animation
• TransitionStatus and StateMachineStatus - 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 progress
• stateMachineStatusStream - 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.md consolidating all guides (3,500+ lines)
• Advanced animation blending guide with real-world examples
• Performance tips and best practices
• Troubleshooting guide

Changed #

• AugenController extended with 18 new animation methods
• Enhanced ARNode support for complex animation workflows
• Updated README.md with v0.4.0 and consolidated documentation links
• Fixed BuildContext across 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

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

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 control
  • pauseAnimation() - Pause animation playback
  • stopAnimation() - Stop and reset animation
  • resumeAnimation() - Resume paused animation
  • seekAnimation() - Jump to specific time in animation
  • getAvailableAnimations() - Query available animations
  • setAnimationSpeed() - Change playback speed dynamically
• New ARAnimation model class with full configuration
• New AnimationStatus class for animation state tracking
• New enums: AnimationState, AnimationLoopMode
• animationStatusStream for real-time animation updates
• Comprehensive animation tests (25 new tests)
• ANIMATIONS_GUIDE.md - Complete animation documentation

Changed #

• ARNode now supports animations parameter
• ARNode.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

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

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 constructor
  • addModelFromAsset() and addModelFromUrl() helper methods
• New ModelFormat enum (gltf, glb, obj, usdz)
• Comprehensive test coverage for model loading (10 new tests)
• CUSTOM_MODELS_GUIDE.md comprehensive documentation
• Enhanced README with model loading examples

Changed #

• ARNode now supports modelPath and modelFormat parameters
• 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

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.