Android TV의 맞춤 뷰 접근성 지원

많은 Android TV 앱이 기본 Android 구성요소로 제작되지만 서드 파티 쿠키의 접근성을 고려하는 것도 (특히 맞춤 뷰를 사용하는 경우) 프레임워크 또는 구성요소를 관리할 수 있습니다.

OpenGL 또는 캔버스와 직접 상호작용하는 맞춤 뷰 구성요소가 제대로 작동하지 않을 수 있음 TalkBack, 스위치 제어와 같은 접근성 서비스와 함께

TalkBack이 전환될 때 발생할 수 있는 다음 문제를 고려하세요. 날짜:

• 앱에서 접근성 포커스 (녹색 직사각형)가 사라질 수 있습니다.
• 접근성 포커스가 전체 화면의 경계를 선택할 수도 있습니다.
• 접근성 포커스를 이동하지 못할 수 있습니다.
• D패드의 4개 방향 키는 코드에서 처리 중이더라도 아무런 영향을 미치지 않을 수 있습니다.

앱에서 이러한 문제가 발견되면 앱이 AccessibilityNodeInfo를 노출함 트리를 접근성 서비스에 추가합니다.

이 가이드의 나머지 부분에서는 이러한 문제를 해결하기 위한 몇 가지 솔루션과 권장사항을 제공합니다.

접근성 서비스에서 사용하는 D패드 이벤트

이 문제의 근본 원인은 주요 이벤트를 접근성이 사용하기 때문입니다. 제공합니다

그림 1. TalkBack을 사용 설정하거나 사용 중지한 상태에서 시스템이 작동하는 방식을 보여주는 다이어그램

그림 1과 같이 TalkBack이 켜져 있으면 D패드 이벤트 개발자가 정의한 D패드 핸들러로 전달되지 않습니다. 대신 접근성 서비스는 주요 이벤트를 수신하여 접근성에 중점을 두고 있습니다. 맞춤 Android 구성요소는 기본적으로 맞춤 Android 구성요소를 접근성 서비스에 화면상의 위치에 관한 정보 접근성 서비스에서 해당 기능을 강조표시하기 위해 접근성 포커스를 이동할 수 없습니다.

다른 접근성 서비스도 마찬가지로 영향을 받습니다. D패드 이벤트도 100%는 소비됩니다.

D패드 이벤트가 접근성 서비스에 제출되고 서비스는 맞춤 뷰에서 UI 구성요소가 어디에 있는지 알지 못하지만 앱에서 다음을 전달하도록 AccessibilityNodeInfo를 구현해야 합니다. 정확하게 파악할 수 있습니다

접근성 서비스에 정보 노출

접근성 서비스에 맞춤 뷰의 위치 및 설명, AccessibilityNodeInfo 구현 각 구성요소의 세부정보를 표시합니다 접근성 서비스가 포커스 관리, ExploreByTouchHelper 구현 로 설정하고 ViewCompat.setAccessibilityDelegate(View, AccessibilityDelegateCompat) 사용할 수 있습니다.

ExploreByTouchHelper를 구현할 때 네 가지 추상 메서드를 재정의합니다.

Kotlin

// Return the virtual view ID whose view is covered by the input point (x, y).
protected fun getVirtualViewAt(x: Float, y: Float): Int

// Fill the virtual view ID list into the input parameter virtualViewIds.
protected fun getVisibleVirtualViews(virtualViewIds: List<Int>)

// For the view whose virtualViewId is the input virtualViewId, populate the
// accessibility node information into the AccessibilityNodeInfoCompat parameter.
protected fun onPopulateNodeForVirtualView(virtualViewId: Int, @NonNull node: AccessibilityNodeInfoCompat)

// Set the accessibility handling when perform action.
protected fun onPerformActionForVirtualView(virtualViewId: Int, action: Int, @Nullable arguments: Bundle): Boolean

자바

// Return the virtual view ID whose view is covered by the input point (x, y).
protected int getVirtualViewAt(float x, float y)

// Fill the virtual view ID list into the input parameter virtualViewIds.
protected void getVisibleVirtualViews(List<Integer> virtualViewIds)

// For the view whose virtualViewId is the input virtualViewId, populate the
// accessibility node information into the AccessibilityNodeInfoCompat parameter.
protected void onPopulateNodeForVirtualView(int virtualViewId, @NonNull AccessibilityNodeInfoCompat node)

// Set the accessibility handling when perform action.
protected boolean onPerformActionForVirtualView(int virtualViewId, int action, @Nullable Bundle arguments)

자세한 내용은 Google I/O 2013 - 시각 장애인 및 저시력 지원하기 Android의 접근성 또는 접근성 이벤트 채우기에 대해 자세히 알아보세요.

권장사항

• 필수: AccessibilityNodeInfo.getBoundsInScreen() 구성요소의 위치를 정의해야 합니다.

• 필수: AccessibilityNodeInfo.setVisibleToUser() 구성요소의 공개 상태를 반영해야 합니다.

• 필수: AccessibilityNodeInfo.getContentDescription() TalkBack에서 발표할 콘텐츠 설명을 지정해야 합니다.

• AccessibilityNodeInfo.setClassName() 지정 서비스가 구성요소 유형을 구분할 수 있도록 하기 위함입니다.

• performAction() 구현 시 상응하는 AccessibilityEvent를 사용하여 작업을 반영합니다.

• ACTION_CLICK와 같은 추가 작업 유형을 구현하려면 다음을 호출합니다. AccessibilityNodeInfo.addAction(ACTION_CLICK) performAction()의 해당 로직을 사용하여 함수를 만들 수 있습니다

• 해당하는 경우 setFocusable()의 구성요소 상태를 반영합니다. setClickable(), setScrollable(), 사용할 수 있습니다.

• AccessibilityNodeInfo 문서 검토 접근성 서비스가 더욱 효과적으로 상호작용할 수 있는 구성할 수 있습니다.

샘플

다음에 관한 권장사항을 보려면 Android TV용 맞춤 보기 접근성 샘플을 참조하세요. 맞춤 뷰를 사용하여 앱에 접근성 지원을 추가합니다.