Les applications pour téléviseur présentent parfois des cas d'utilisation qui entravent l'utilisation de l'application pour les utilisateurs qui s'appuient sur TalkBack. Pour offrir une meilleure expérience TalkBack à ces utilisateurs, consultez chacune des sections de ce guide et apportez des modifications à votre application si nécessaire. Si votre application utilise des affichages personnalisés, vous devez également consulter le guide correspondant, qui explique comment assurer l'accessibilité avec des vues personnalisées.
Gérer les vues imbriquées
Les vues imbriquées peuvent être difficiles à parcourir pour les utilisateurs de TalkBack. Dans la mesure du possible, faites en sorte que TalkBack puisse sélectionner soit la vue parent, soit la vue enfant, mais pas les deux.
Pour qu'une vue puisse être sélectionnée par TalkBack, définissez focusable et l'attribut focusableInTouchMode sur true. Cette étape est nécessaire, car certains téléviseurs peuvent passer en mode tactile lorsque TalkBack est actif.
Pour qu'une vue ne soit pas sélectionnable, il suffit de définir l'attribut focusable sur false. Toutefois, si la vue est exploitable (c'est-à-dire si son AccessibilityNodeInfo correspondant comporte ACTION_CLICK), elle peut toujours être sélectionnable.
Descriptions des modifications pour les actions
Par défaut, TalkBack énonce "Appuyer pour activer" pour les vues exploitables. Pour certaines actions, le terme "activer" n'est pas forcément une bonne description. Pour fournir une description plus précise, vous pouvez la modifier:
Kotlin
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);
}
});
Ajouter la prise en charge des curseurs
TalkBack sur téléviseur est spécifiquement compatible avec les curseurs. Pour activer le mode curseur, ajoutez ACTION_SET_PROGRESS à une vue avec un objet RangeInfo.
L'utilisateur passe en mode curseur en appuyant sur le bouton central de la télécommande du téléviseur.
Dans ce mode, les boutons fléchés génèrent des actions d'accessibilité ACTION_SCROLL_FORWARD et ACTION_SCROLL_BACKWARD.
L'exemple suivant implémente un curseur de volume avec des niveaux de 1 à 10:
Kotlin
/**
* 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;
}
}