В некоторых телевизионных приложениях возникают ситуации, когда пользователям, которые полагаются на TalkBack, использование приложения может быть затруднено. Чтобы улучшить работу TalkBack для таких пользователей, ознакомьтесь с каждым разделом этого руководства и внесите необходимые изменения в ваше приложение. Если ваше приложение использует пользовательские представления, вам также следует обратиться к соответствующему руководству , описывающему, как обеспечить доступность для пользователей с пользовательскими представлениями.
Обработка вложенных представлений
Вложенные представления могут быть сложны для навигации пользователям TalkBack. По возможности, делайте фокусируемым для TalkBack либо родительское, либо дочернее представление, но не оба одновременно.
Чтобы сделать элемент доступным для фокусировки в TalkBack, установите атрибуты focusable и focusableInTouchMode в true . Этот шаг необходим, поскольку некоторые телевизоры могут переходить в сенсорный режим и выходить из него, пока TalkBack активен.
Чтобы сделать представление недоступным для фокусировки, достаточно установить атрибут focusable в false . Однако, если представление является интерактивным (то есть, соответствующий ему AccessibilityNodeInfo имеет ACTION_CLICK ), оно всё ещё может быть доступно для фокусировки.
Изменить описания для действий
По умолчанию TalkBack объявляет «Нажмите кнопку выбора для активации» для интерактивных представлений. Для некоторых действий термин «активировать» может быть не совсем точным описанием. Чтобы дать более точное описание, вы можете изменить его:
Котлин
findViewById<View>(R.id.custom_actionable_view).accessibilityDelegate = object : View.AccessibilityDelegate() {
override fun onInitializeAccessibilityNodeInfo(host: View, info: AccessibilityNodeInfo) {
super.onInitializeAccessibilityNodeInfo(host, info)
info.addAction(
AccessibilityAction(
AccessibilityAction.ACTION_CLICK.id,
getString(R.string.custom_label)
)
)
}
}
Java
findViewById(R.id.custom_actionable_view).setAccessibilityDelegate(new AccessibilityDelegate() {
@Override
public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfo info) {
super.onInitializeAccessibilityNodeInfo(host, info);
AccessibilityAction action = new AccessibilityAction(
AccessibilityAction.ACTION_CLICK.getId(), getString(R.string.custom_label));
info.addAction(action);
}
});
Добавить поддержку ползунков
TalkBack на телевизоре имеет специальную поддержку ползунков. Чтобы включить режим ползунка, добавьте ACTION_SET_PROGRESS к представлению вместе с объектом RangeInfo .
Пользователь переходит в режим слайдера, нажав центральную кнопку пульта дистанционного управления телевизора. В этом режиме кнопки со стрелками активируют действия специальных возможностей ACTION_SCROLL_FORWARD и ACTION_SCROLL_BACKWARD .
В следующем примере реализован ползунок регулировки громкости с уровнями от 1 до 10:
Котлин
/**
* This example only provides slider functionality for TalkBack users. Additional logic should
* be added for other users. Such logic may reuse the increase and decrease methods.
*/
class VolumeSlider(context: Context?, attrs: AttributeSet?) : LinearLayout(context, attrs) {
private val min = 1
private val max = 10
private var current = 5
private var textView: TextView? = null
init {
isFocusable = true
isFocusableInTouchMode = true
val rangeInfo =
AccessibilityNodeInfo.RangeInfo(
AccessibilityNodeInfo.RangeInfo.RANGE_TYPE_INT,
min.toFloat(),
max.toFloat(),
current.toFloat()
)
accessibilityDelegate =
object : AccessibilityDelegate() {
override fun onInitializeAccessibilityNodeInfo(host: View, info: AccessibilityNodeInfo) {
super.onInitializeAccessibilityNodeInfo(host, info)
info.addAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_SET_PROGRESS)
info.rangeInfo = rangeInfo
}
override fun performAccessibilityAction(host: View, action: Int, args: Bundle?): Boolean {
if (action == AccessibilityNodeInfo.AccessibilityAction.ACTION_SCROLL_FORWARD.id) {
increase()
return true
}
if (action == AccessibilityNodeInfo.AccessibilityAction.ACTION_SCROLL_BACKWARD.id) {
decrease()
return true
}
return super.performAccessibilityAction(host, action, args)
}
}
}
override fun onFinishInflate() {
super.onFinishInflate()
textView = findViewById(R.id.text)
textView!!.text = context.getString(R.string.level, current)
}
private fun increase() {
update((current + 1).coerceAtMost(max))
}
private fun decrease() {
update((current - 1).coerceAtLeast(min))
}
private fun update(newLevel: Int) {
if (textView == null) {
return
}
val newText = context.getString(R.string.level, newLevel)
// Update the user interface with the new volume.
textView!!.text = newText
// Announce the new volume.
announceForAccessibility(newText)
current = newLevel
}
}
Java
/**
* This example only provides slider functionality for TalkBack users. Additional logic should
* be added for other users. Such logic can reuse the increase and decrease methods.
*/
public class VolumeSlider extends LinearLayout {
private final int min = 1;
private final int max = 10;
private int current = 5;
private TextView textView;
public VolumeSlider(Context context, AttributeSet attrs) {
super(context, attrs);
setFocusable(true);
setFocusableInTouchMode(true);
RangeInfo rangeInfo = new RangeInfo(RangeInfo.RANGE_TYPE_INT, min, max, current);
setAccessibilityDelegate(
new AccessibilityDelegate() {
@Override
public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfo info) {
super.onInitializeAccessibilityNodeInfo(host, info);
info.addAction(AccessibilityAction.ACTION_SET_PROGRESS);
info.setRangeInfo(rangeInfo);
}
@Override
public boolean performAccessibilityAction(View host, int action, Bundle args) {
if (action == AccessibilityAction.ACTION_SCROLL_FORWARD.getId()) {
increase();
return true;
}
if (action == AccessibilityAction.ACTION_SCROLL_BACKWARD.getId()) {
decrease();
return true;
}
return super.performAccessibilityAction(host, action, args);
}
});
}
@Override
protected void onFinishInflate() {
super.onFinishInflate();
textView = findViewById(R.id.text);
textView.setText(getContext().getString(R.string.level, current));
}
private void increase() {
update(Math.min(current + 1, max));
}
private void decrease() {
update(Math.max(current - 1, min));
}
private void update(int newLevel) {
if (textView == null) {
return;
}
String newText = getContext().getString(R.string.level, newLevel);
// Update the user interface with the new volume.
textView.setText(newText);
// Announce the new volume.
announceForAccessibility(newText);
current = newLevel;
}
}