tree: f6b7aa4ca582f15fe857317cbbd1c812fee6d19f [path history] [tgz]
  1. aconfig/
  2. res/
  3. src/
  4. tests/
  5. Android.bp
  6. AndroidManifest.xml
  7. OWNERS
  8. README.md
  9. TEST_MAPPING
packages/SystemUI/accessibility/accessibilitymenu/README.md

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.