41 lines
2.1 KiB
Markdown
41 lines
2.1 KiB
Markdown
|
The Accessibility Menu is an accessibility service
|
||
|
|
that presents a large on-screen menu to control your Android device.
|
||
|
|
This service can be enabled from the Accessibility page in the Settings app.
|
||
|
|
You can control gestures, hardware buttons, navigation, and more. From the menu, you can:
|
||
|
|
|
||
|
|
- Take screenshots
|
||
|
|
- Lock your screen
|
||
|
|
- Open the device's voice assistant
|
||
|
|
- Open Quick Settings and Notifications
|
||
|
|
- Turn volume up or down
|
||
|
|
- Turn brightness up or down
|
||
|
|
|
||
|
|
The UI consists of a `ViewPager` populated by multiple pages of shortcut buttons.
|
||
|
|
In the settings for the menu, there is an option to display the buttons in a 3x3 grid per page,
|
||
|
|
or a 2x2 grid with larger buttons.
|
||
|
|
|
||
|
|
Upon activation, most buttons will close the menu while performing their function.
|
||
|
|
The exception to this are buttons that adjust a value, like volume or brightness,
|
||
|
|
where the user is likely to want to press the button multiple times.
|
||
|
|
In addition, touching other parts of the screen or locking the phone through other means
|
||
|
|
should dismiss the menu.
|
||
|
|
|
||
|
|
A majority of the shortcuts correspond directly to an existing accessibility service global action
|
||
|
|
(see `AccessibilityService#performGlobalAction()` constants) that is performed when pressed.
|
||
|
|
Shortcuts that navigate to a different menu, such as Quick Settings, use an intent to do so.
|
||
|
|
Shortcuts that adjust brightness or volume interface directly with
|
||
|
|
`DisplayManager` & `AudioManager` respectively.
|
||
|
|
|
||
|
|
To add a new shortcut:
|
||
|
|
|
||
|
|
1. Add a value for the new shortcut to the `ShortcutId` enum in `A11yMenuShortcut`.
|
||
|
|
2. Put an entry for the enum value into the `sShortcutResource` `HashMap` in `A11yMenuShortcut`.
|
||
|
|
This will require resources for a drawable icon, a color for the icon,
|
||
|
|
the displayed name of the shortcut and the desired text-to-speech output.
|
||
|
|
3. Add the enum value to the `SHORTCUT_LIST_DEFAULT` & `LARGE_SHORTCUT_LIST_DEFAULT` arrays
|
||
|
|
in `A11yMenuOverlayLayout`.
|
||
|
|
4. For functionality, add a code block to the if-else chain in
|
||
|
|
`AccessibilityMenuService.handleClick()`, detailing the effect of the shortcut.
|
||
|
|
If you don't want the shortcut to close the menu,
|
||
|
|
include a return statement at the end of the code block.
|