[Issue Report]: Accessibility mod-specific issues on Android #8456
Description
Operating System
Windows x64
DevilutionX version
1.5.5
Describe
Tracking Issue: Android-Specific Accessibility Mod Issues
This issue tracks Android-specific problems related to the accessibility mod that are not caused by the TTS implementation (which works correctly through Android's native API), but by Android-specific mod issues.
Context
Android accessibility support has been implemented and is working. The TTS starts correctly, interrupts speech when needed, and uses Android's default text-to-speech engine. However, there are Android-specific mod issues that need to be fixed.
Known Issues
1. Stats Screen Navigation
Description:
When pressing the C key or equivalent controller button to open the stats screen, the focus is placed on "Strength" and it's not possible to navigate through the other attributes (Magic, Vitality, Dexterity, etc.).
Expected Behavior:
Should be able to navigate through all character attributes with audio feedback for each one.
Actual Behavior:
Focus gets stuck on "Strength", preventing access to other attributes.
Priority: High (affects gameplay)
Suggested Investigation:
- Check mod's navigation logic in stats screens
- Compare with Windows/Linux implementation
- Verify if Android-specific handling is needed
2. Tracking Keys Provide Incorrect/Imprecise Directions
Description:
The keys used for tracking (tracking keys) provide incorrect/imprecise directions, making it impossible for the player to navigate to desired locations.
Expected Behavior:
Tracking keys should correctly direct the player to nearest targets, allowing precise navigation through the map.
Actual Behavior:
The directions provided are incorrect, preventing effective navigation. Player cannot reach places they need to go.
Priority: Critical (makes gameplay impossible)
Suggested Investigation:
- Verify direction calculation in tracking code
- Compare with Windows/Linux implementation
- Check for coordinate system issues on Android
- Test with different controller configurations
3. Mod Sounds Not Playing
Description:
Mod-specific sounds (doors, chests, etc.) are not playing on Android version.
Expected Behavior:
All mod sounds should play correctly, including:
- Door opening/closing sounds
- Chest opening sounds
- Other mod sound effects
Actual Behavior:
These sounds don't play on Android.
Priority: Medium (affects experience but doesn't prevent gameplay)
Suggested Investigation:
- Verify audio file paths on Android
- Check if audio assets are included in APK
- Compare with audio system on Windows/Linux
- Check logcat for audio loading errors
Additional Technical Information
Test Environment
- Device: Samsung (S24)
- Android Version: 16
- Build: debug
- TalkBack: Yes (should be suspended after loading game)
Tasks
- Investigate and fix stats screen navigation
- Investigate and fix tracking keys incorrect directions
- Investigate and fix mod sounds not playing
- Test fixes on physical device
- Update documentation if necessary
References
- TTS implementation PR: (to be created)
- Android accessibility documentation: docs/ANDROID_ACCESSIBILITY.md
- Related code:
Source/platform/android/,Source/utils/screen_reader.cpp
Notes
These issues are Android-specific and do not affect basic TTS functionality, which is working correctly. The problem is with the mod logic and its interactions with the Android system.
### To Reproduce
1. install the apk.
2. Load the game data and proceed to play.
3. Suspend the screen reader and test
### Expected Behavior
_No response_
### Additional context
_No response_