Merge "Readme for AccessibilityMenu" into udc-dev am: 0474d293 am: e5ec8f62

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.