TV アプリで TalkBack をサポートする

TV アプリのユースケースによっては、 TalkBack: アプリを使用します。これらのデバイスで TalkBack をより快適に利用するには、 ユーザーを確認するには、このガイドの各セクションを確認し、 できます。アプリでカスタムビューを使用している場合は、 対応するガイドをご覧ください。 できます。

ネストされたビューを処理する

ネストされたビューは、TalkBack ユーザーが操作しにくいことがあります。可能な限り TalkBack でフォーカス可能な親ビューまたは子ビューのどちらか一方のみです。両方を使用することはできません。

TalkBack でビューをフォーカスできるようにするには、focusablefocusableInTouchMode 属性を true に設定する。このステップが必要なのは、 一部のテレビデバイスでは、TalkBack が有効な場合に、タッチモードに切り替わることがあります。

ビューをフォーカス不可にするには、focusable を設定するだけで十分です。 属性を false に追加します。ただし、ビューが実用的なものである場合(つまり、 対応する AccessibilityNodeInfoACTION_CLICK である場合、 焦点を絞ることができます

アクションの説明の変更

デフォルトでは、TalkBack から「選択を押して有効にしてください」と読み上げられます。実用的なビューも用意しています 一部のアクションでは「有効にする」という言葉が説明として適切ではないかもしれません。宛先 指定すると、その説明を変更できます。

KotlinJava
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)
     
)
   
)
 
}
}
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 は、スライダーに特別な対応を行っています。スライダー モードを有効にするには、 RangeInfo オブジェクトとともにビューに ACTION_SET_PROGRESS を追加します。

ユーザーがテレビのリモコンの中央ボタンを押してスライダー モードに入ります。 このモードでは、矢印ボタンで ACTION_SCROLL_FORWARD が生成され、 ACTION_SCROLL_BACKWARD のユーザー補助アクション。

次の例では、レベル 1 ~ 10 の音量スライダーを実装しています。

KotlinJava
/**
 *   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
 
}
}
/**
 *   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;
 
}
}