Checklist for VoiceView Implementation
Use the following checklists to ensure that your Amazon Fire TV app interacts with the VoiceView screen reader to meet the standards recommended by Amazon.Technical Implementation Recommendations
Your app should implement the following aspects of VoiceView:- Verify that your app’s UI is compatible with the Android Accessibility Framework.
- Implement Content Descriptions so that VoiceView can read descriptions for images, buttons, and other on-screen objects.
- Add Usage Hints to list and grid content so that VoiceView can help guide the interactions of visually impaired users.
- Implement Described By for static content, so that VoiceView can read that content when the associated object gains focus.
User Experience (UX) Recommendations
Your app should implement the following UX recommendations for VoiceView:- VoiceView reads the content for items that gain focus, including all information that is visually represented onscreen, such as a title or episode number.
- VoiceView reads Orientation Text and Usage Hints to help users learn how to navigate the screen UI.
- VoiceView reads static content either automatically through Described By text, manually when a user either presses the Menu button, or manually when a user enters Review Mode and steps through on-screen items.
- VoiceView reads setup information, including activation URLs and codes.
- VoiceView supports features and tasks such as program selection, program information, playback, and CC settings.
Overview of VoiceView Behavior
Users can navigate the Amazon Fire TV user interface and VoiceView-enabled apps using the Menu and other buttons.Using the Menu button with VoiceView
Use the following conventions for the Menu button when VoiceView is enabled:- To enable or disable VoiceView, press the Back and Menu buttons at the same time for two seconds.
- When VoiceView is enabled, VoiceView controls the Menu button and the Play/Pause button (when VoiceView is speaking).
- The system or app receives double-press events from the Menu button.
-
Single-pressing the Menu button initiates the reading of information from the screen in the following order:
- Usage Hints
- Orientation Text
- Described By text
- All other static content
Using the Play/Pause, Rewind, and Fast Forward buttons to control speech
Use the following navigation conventions when VoiceView is enabled:- When VoiceView reads Usage Hints, Orientation Text, Described By text, and all other static content, the user can control navigation using the Rewind and Fast Forward buttons.
- When a user accesses a screen for the first time, VoiceView automatically reads the Orientation Text.
- When a user moves focus to a control after pausing, VoiceView reads Usage Hints and Described By text.
-
When speaking, the Play/Pause button silences VoiceView.
- If a movie or music is playing and VoiceView is speaking, pressing Play/Pause one time silences VoiceView.
- After VoiceView is silenced, pressing Play/Pause a second time pauses the playing media.
- VoiceView does not read Described By content as part of static content when a user presses the Menu button.
Navigating with Review Mode
VoiceView’s Review Mode allows a user to explore the grid layout of an Amazon Fire TV screen in detail — similar to using linear navigation with a screen reader on a tablet. Use the following conventions for using Review Mode in your app:- Press-and-hold the Menu button to enter Review Mode, which will be announced by VoiceView.
- The Left and Right buttons on the directional controller control linear navigation.
- If a user presses Select when a non-actionable item is in focus, VoiceView speaks “Item not selectable.”
- Press-and-hold the Menu button to exit Review Mode.
- After exiting Review Mode, the focus for accessibility returns to the previous cached location of keyboard focus, and VoiceView repeats an announcement of that focus.
Using Review Mode with WebViews
A WebView can represent a complex UI within an application, containing both actionable items, such as links, and non-actionable items, such as static text and images. VoiceView supports WebViews because they are frequently used by many apps in the Amazon Appstore. In a VoiceView-enabled WebView, a user can use Review Mode to navigate all items on-screen including actionable items and gauge the context of static content items. Described By content is not available in WebViews.Navigating Focus Granularity Options in Review Mode
When you first enable Review Mode, the level of granularity defaults to moving by individual controls. Press Up or Down to cycle through the available granularity options, such as character, word, control, or window. Granularity options in web content include link, list, or heading. These reading granularities allow the user to do things like spell the name of an actress, or navigate more efficiently through web content. Use the following conventions to navigate the various granularity options:- Press Left to return to the previous item at the currently selected granularity.
- Press Right to move to the next item.
- The granularity level is reset to “control” when you enter Review Mode.
Implementing VoiceView
This section discusses guidelines for implementing VoiceView for the following types of content:- Static/non-focusable content
- Orientation text
- Usage hints
Implementing support for VoiceView on Static (Non-focusable) Content
VoiceView provides two mechanisms to navigate static (non-focusable) content so that visually impaired users can access this content: (1) using the Menu, Fast Forward, and Rewind buttons, and (2) Review Mode (discussed below). VoiceView supports markup that apps can use to associate this static (non-focusable) content with a focusable item. Use Described By when a focused item has additional details on the screen that are not included in the items content description. These details will be spoken after the user pauses briefly on that item. Continuous moving between items would not speak the details until the user pauses on an item. The following examples explain how a user would navigate static content in two different scenarios: To associate a piece or container of static content with a focusable View:-
Set the key for
com.amazon.accessibility.describedByin theextrasbundle from theAccessibilityNodeInfofor that View. -
Set the value to be a string containing a space-delimited list of the view Ids of the containers or views which contain the description of this item.
When VoiceView encounters an item with the
com.amazon.accessibility.describedBykey set, it will request a list ofAccessibilityNodeInfoobjects for the view Ids specified by thecom.amazon.accessibility.describedByvalue. VoiceView then reads the appropriate text or content descriptions, depending on your verbosity settings.
Implementing Orientation Text for VoiceView
To help new users understand how Amazon Fire TV screens are laid out, VoiceView supports Orientation Text, which is localized text that VoiceView reads the first time a container with that text is seen, or when the user pressed the Menu button. Apply orientation text on the container View of a region in which a high level description of the general layout will be useful to the user when first encountered. The key for thecom.amazon.accessibility.orientationText extra configures the Orientation Text for an AccessibilityNodeInfo.
- The first time a user encounters an
AccessibilityNodeInfocontaining Orientation Text, VoiceView reads the text. - On subsequent visits, users can request context information by pressing the Menu button, which causes VoiceView to read the Orientation Text.

