a11y-public-sample
a11y-public-sample copied to clipboard
Sample project using the Unity Accessibility APIs
LetterSpell: Example of an Accessible Unity Application
LetterSpell is a sample mobile application made with Unity that supports screen readers and responds to system accessibility settings. It is intended to provide an example of using Unity's Accessibility APIs to convert UI made with Unity (using uGUI) into data compatible with screen readers. Additionally, the application reads some system accessibility settings and adapts its UI accordingly.
Thank you for checking out this sample!
System Requirements
You can run this sample project in the Unity Editor:
- Requires Unity 2023.3.0a17 and above.
You can build this sample project for the following platforms:
- Android 8.0 and above.
- iOS 13 and above.
Controls
In the Unity Editor:
- Click and drag the letter card to the desired position.
On mobile devices, without the screen reader:
- Tap and drag the letter card to the desired position.
On mobile devices, with the screen reader:
- Tap a letter card or use swipe gestures to focus on the desired letter card.
- Double tap to select the focused letter card.
- Use swipe gestures to move the letter card forward or backward OR tap another card to move the focused card to that position.
Features Not Implemented
Some UI elements in the Options screen are there only to demonstrate how they can be converted into data compatible with screen readers and are not actually functional. These are:
- The option search field
- The color theme dropdown
- The display size slider
Known Issues
- On iOS, in landscape orientation, the accessibility focus indicator may be displayed with a smaller width than the actual width. This seems to appear for elements with a long width. This is an iOS bug, which we have already reported to Apple.
- The text style of the letter cards does not always update according to the system accessibility settings.
Additional Resources
Check out the documentation of the Accessibility module APIs.
Questions or Issues?
Come talk to us on Unity Discussions!
Acknowledgement
LetterSpell is inspired by the iOS game Letter Rooms.
License
Our intention is for you to be able to use everything in this project as a starting point or as bits and pieces in your own Unity games. For the legal words, see LICENSE.md.