How an-k4/handar works
HandAr is an Android app for recording camera video with hand-tracked AR effects, effect audio, and in-app playback and sharing. The main workflow is camera capture → hand landmark detection and gesture-based effect state → live/recorded rendering → MP4 encoding and muxing → preview, library playback, and sharing. The README documents these responsibilities and interactions; source excerpts are not available, so edges below reflect README-documented relationships rather than inspected call sites. Other UI capabilities are represented where they form meaningful user workflows.
Main entry points: CameraRecordFragment.kt Camera screen · EffectState.kt Effect state · VideoRecorder.kt Video recorder · VideoPlayerFragment.kt Video playback
Components 32
Capture and navigation
- App navigation
app/src/main/java/com/example/handar/MainActivity.kt - Camera screen
app/src/main/java/com/example/handar/ui/camera/CameraRecordFragment.kt - Camera state
app/src/main/java/com/example/handar/ui/camera/CameraRecordViewModel.kt - Effect browsing
app/src/main/java/com/example/handar/ui/effectlist/EffectListFragment.kt - Effect preview
app/src/main/java/com/example/handar/ui/effectpreview/EffectPreviewFragment.kt - Effect picker
app/src/main/java/com/example/handar/ui/effectpicker/EffectPickerFragment.kt
Hand effects
- Hand detection
app/src/main/java/com/example/handar/effect/HandLandmarkerProvider.kt - Gesture recognition
app/src/main/java/com/example/handar/effect/gesture/GestureRecognizer.kt - Effect state
app/src/main/java/com/example/handar/effect/model/EffectState.kt - Effect definitions
app/src/main/java/com/example/handar/effect/EffectRepository.kt - Effect catalog
app/src/main/java/com/example/handar/effect/catalog - Live overlay
app/src/main/java/com/example/handar/OverlayView.kt - Effect backgrounds
app/src/main/java/com/example/handar/effect/background
Recording pipeline
- Effect audio
app/src/main/java/com/example/handar/audio/SoundEffectPlayer.kt - Video recorder
app/src/main/java/com/example/handar/recording/VideoRecorder.kt - Video encoding
app/src/main/java/com/example/handar/recording/VideoEncoderWrapper.kt - Audio mixing
app/src/main/java/com/example/handar/recording/AudioMixer.kt - Effect audio clock
app/src/main/java/com/example/handar/recording/EffectAudioClock.kt - Audio encoding
app/src/main/java/com/example/handar/recording/AudioEncoderWrapper.kt - MP4 muxing
app/src/main/java/com/example/handar/recording/MuxerCoordinator.kt
Video library and sharing
- Recorded videos
app/src/main/java/com/example/handar/ui/videolist/VideoFileRepository.kt - Recorded preview
app/src/main/java/com/example/handar/ui/recordedpreview/RecordedPreviewFragment.kt - Video library
app/src/main/java/com/example/handar/ui/videolist/VideoListFragment.kt - Video playback
app/src/main/java/com/example/handar/ui/player/VideoPlayerFragment.kt - Share screen
app/src/main/java/com/example/handar/ui/share/ShareFragment.kt - Social sharing
app/src/main/java/com/example/handar/utils/SocialShare.kt
Onboarding and preferences
- Onboarding survey
app/src/main/java/com/example/handar/ui/onboarding/Onboarding1Fragment.kt - Settings
app/src/main/java/com/example/handar/ui/settings/SettingsFragment.kt - Language selection
app/src/main/java/com/example/handar/ui/language/LanguageFragment.kt
Other components
- User
- Camera sensor
- Social apps
Connections 34
- User → App navigation: opens app
README.md - User → Camera screen: starts recording
README.md - Camera sensor → Hand detection: supplies frames
README.md - Hand detection → Gesture recognition: provides landmarks
README.md - Gesture recognition → Effect state: selects state
README.md - Effect definitions → Effect catalog: provides definitions
- Camera screen → Effect state: uses selected effect
README.md - Effect state → Live overlay: drives rendering
README.md - Effect state → Effect backgrounds: selects background
README.md - Camera screen → Effect audio: plays effect sounds
README.md - Camera screen → Video recorder: starts recording
README.md - Video recorder → Video encoding: encodes frames
README.md - Video recorder → Effect audio clock: synchronizes audio
README.md - Effect audio clock → Audio mixing: provides timing
README.md - Audio mixing → Audio encoding: mixes PCM
README.md - Video encoding → MP4 muxing: sends video track
README.md - Audio encoding → MP4 muxing: sends audio track
README.md - MP4 muxing → Recorded videos: writes MP4
README.md - Camera screen → Recorded preview: opens after recording
README.md - Recorded preview → Share screen: saves to
README.md - Video library → Recorded videos: lists recordings
README.md - Video library → Video playback: opens video
README.md - Video playback → Recorded videos: plays recording
README.md - Video playback → Share screen: opens sharing
README.md - Share screen → Social sharing: shares video
README.md - Social sharing → Social apps: passes video
README.md - User → Effect browsing: browses effects
README.md - Effect browsing → Effect preview: previews effect
README.md - Effect preview → Camera screen: creates with effect
README.md - Camera screen → Effect picker: changes effect
README.md - Effect picker → Effect preview: previews selection
README.md - User → Onboarding survey: completes onboarding
README.md - User → Settings: opens settings
README.md - Settings → Language selection: chooses language
README.md