Google 对讲 API 以获取 android 中的当前焦点项目
Google talkback API to get current focus item in android
我的应用程序支持辅助功能,并且应用程序同时具有纵向和横向模式。
在我的屏幕上,我有一些视图,例如按钮、文本视图、带有自定义行的列表视图。
我面临的问题是,当用户在纵向模式下聚焦任何项目并旋转屏幕时,应用程序不会在横向模式下聚焦同一元素。有人可以建议如何将焦点设置到在纵向模式下 select 到横向模式的项目吗?
我什至对现有应用程序进行了一些研究,例如本机设置应用程序-wifi 页面和 "ES file explore",在这些应用程序中,当用户将方向更改为横向模式时,也无法保持可访问性。系统正在 select 将横向的一些随机元素转换为纵向,反之亦然。
下面是代码片段
accessibility_sample.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" >
<TextView
android:id="@+id/name_text"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:contentDescription="Name"
android:focusableInTouchMode="true"
android:text="Name" />
<TextView
android:id="@+id/email_text"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:contentDescription="Email"
android:focusableInTouchMode="true"
android:text="Email" />
<Button
android:id="@+id/sample_button"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:contentDescription="Button description"
android:text="ButtonText" />
<CheckBox
android:id="@+id/checkbox"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:contentDescription="Checkbox description"
android:text="Checkbox Text" />
<ListView
android:id="@+id/sample_list"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:fadeScrollbars="false" >
</ListView>
</LinearLayout>
sample_list_row.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal"
>
<CheckBox
android:id="@+id/list_row_cb"
android:layout_width="wrap_content"
android:layout_height="wrap_content" >
</CheckBox>
<TextView
android:id="@+id/list_row_name"
android:layout_width="match_parent"
android:focusableInTouchMode="true"
android:focusable="true"
android:layout_height="wrap_content" />
</LinearLayout>
AccessibilitySampleActivity.java
public class AccessibilitySampleActivity 扩展 Activity {
private String TAG = AccessibilitySampleActivity.class.getSimpleName();
ListView sampleList;
Button myButton;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.accessibility_sample);
sampleList = (ListView) findViewById(R.id.sample_list);
myButton = (Button) findViewById(R.id.sample_button);
ArrayList<String> countriesList = new ArrayList<String>();
countriesList.add("India");
countriesList.add("America");
countriesList.add("China");
countriesList.add("Swis");
countriesList.add("Paries");
countriesList.add("Pak");
countriesList.add("Aus");
countriesList.add("Afg");
countriesList.add("Nedharnalds");
countriesList.add("Bangladhesh");
countriesList.add("Srilanka");
countriesList.add("France");
countriesList.add("Japan");
countriesList.add("SouthAfrica");
countriesList.add("Iran");
countriesList.add("Malaysia");
countriesList.add("Nepal");
sampleList.setAdapter(new CustomArrayAdapter(this, R.layout.sample_list_row, countriesList));
}
class CustomArrayAdapter extends ArrayAdapter<String> {
Context context;
int resource;
ArrayList<String> countriesList;
class ViewHolder {
TextView name;
}
public CustomArrayAdapter(Context context, int resource, ArrayList<String> countriesList) {
super(context, resource, countriesList);
this.context = context;
this.resource = resource;
this.countriesList = countriesList;
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
ViewHolder holder = null;
if (convertView == null) {
LayoutInflater vi = (LayoutInflater) getSystemService(Context.LAYOUT_INFLATER_SERVICE);
convertView = vi.inflate(resource, null);
holder = new ViewHolder();
holder.name = (TextView) convertView.findViewById(R.id.list_row_name);
convertView.setTag(holder);
} else {
holder = (ViewHolder) convertView.getTag();
}
holder.name.setText(getItem(position));
return convertView;
}
@Override
public int getCount() {
return super.getCount();
}
}
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
public static View findAccessibilityFocus(View view) {
if (view == null)
return view;
if (view.isAccessibilityFocused())
return view;
if (view instanceof ViewGroup) {
ViewGroup viewGroup = (ViewGroup) view;
for (int i = 0; i < viewGroup.getChildCount(); i++) {
View childView = viewGroup.getChildAt(i);
View result = findAccessibilityFocus(childView);
if (result != null)
return result;
}
}
return null;
}
@Override
public void onConfigurationChanged(Configuration newConfig) {
super.onConfigurationChanged(newConfig);
Log.d(TAG, "onConfigurationChanged");
AccessibilityManager am = (AccessibilityManager) getSystemService(ACCESSIBILITY_SERVICE);
boolean isAccessibilityEnabled = am.isEnabled();
boolean isExploreByTouchEnabled = am.isTouchExplorationEnabled();
Log.d(TAG, "isAccessibilityEnabled:" + isAccessibilityEnabled + " isExploreByTouchEnabled:"
+ isExploreByTouchEnabled);
if (isAccessibilityEnabled) {
View activityView = this.findViewById(android.R.id.content);
Log.d(TAG, "activityView:" + activityView);
View selectedView = findAccessibilityFocus(activityView);
if (selectedView != null) {
Log.d(TAG, "selectedView:" + selectedView);
selectedView.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
}
}
}
}
对于普通视图,如 TextView、Button、Checkbox,它能够在用户旋转屏幕时保持状态。
如果下面的用户 select 列表视图是我面临的问题
- 如果在纵向和旋转屏幕中select编辑了任何视图,则在横向 中不会保持焦点。有时如果 selected 视图能够在不滚动的情况下显示(比如如果用户 select India 和 rotate India 将在不滚动的情况下可见)它保持状态
- 当用户将屏幕从纵向旋转到横向、应用滚动和select任何视图(如日本)并将方向从横向更改为纵向模式时,我们可以看到它总是select 第一行复选框即印度的复选框.
WCAG 当前未指定在动态(当您的应用程序处于 运行 时)方向更改后焦点应该发生什么。它确实讨论了方向变化,但没有讨论如何处理这种背景变化,这是有充分理由的。焦点管理不是这里的核心问题!事实上,如果有的话,WCAG 会阻止您尝试使用您正在尝试的解决方案,因为它可能被视为干扰辅助技术的默认操作。想一想,在您的问题中,您指出大多数应用 "don't do" 您正在尝试做的事情。如果你要完成这件事,而世界上所有其他应用程序都没有,那么谁真的无法访问? "expected behavior"不是有好处吗?
其中无法访问的部分是令人惊讶的方向变化,而不是完全屏幕后焦点发生的变化 RE-DRAW!在我看来,这样做的动机可能是对 WCAG 2.0 3.2.# 下指南的误导解释。如果用户有时在关心焦点在哪里时意外地导致方向改变......这确实是一个问题!您只是抓住了问题的错误部分。
焦点控制对于可访问性非常重要,但方向变化不同于其他上下文变化。在方向改变时,屏幕可能完全不同。当然,屏幕上会有类似的元素,但不能保证焦点元素仍然存在。与其尝试跟踪焦点并将其移动到适当的(现在可能是屏幕外的元素),不如让 AT 来做这件事,并且在方向发生变化时更具选择性。此处的最佳做法:
- 切勿将用户锁定在特定方向。请记住,用户可能会将他们的设备安装在他们面前,因此需要一个方向是非常糟糕的。 Mobile Guidelines 4.1.
- 然而,话虽这么说,一旦您确定用户(当使用触摸探索的辅助技术是其中之一)处于他们熟悉的方向时,锁定方向,并为他们提供另一种机制来手动更改方向.通过这种方式,用户可以自由地做一些事情,比如将 phone 放在耳边,而不用担心意外触发方向改变。 WCAG 2.0 - 3.2.5
- 如果方向发生变化,允许默认行为。即使在您看来它无法访问,只要用户没有意外触发方向更改,也不会那么令人沮丧。如果您正确解决了上述问题,那将不是问题。
- 最后,请记住,当您开发可访问性时,TalkBack 只是一种辅助技术,而盲人只是该技术用户的一个子集。虽然,您可能正在改善盲人 TalkBack 用户的用户体验,但您必须考虑您正在为使用对讲来支持他们的身体残疾的 TalkBacks 用户、BrailleBack 用户或 SwitchAccess 用户做些什么。一般来说,支持多个 AT 意味着允许操作系统、AT 和用户代理尽可能频繁地做 default/supported 事情。虽然添加 hack 解决方案可能会改善盲人 TalkBack 用户的体验,但在 TalkBack v#.# 上,它很容易使当前 SwitchAccess 用户的情况变得更糟,甚至会破坏 blink TalkBack v#.#+1 用户的体验。 WCAG 中 WCAG 4.1 下实际上也涵盖了这种 hack 解决方案是坏的概念。
总而言之,从可访问性的角度来看,您尝试做的事情确实有些误入歧途,实际上会使事情变得更糟。话虽如此,在 Android 视图中跟踪可访问性焦点的概念很有趣,我将在下面为您留下代码。但是,在这种情况下,我建议不要使用这种方法。
原始答案:
这很简单。
讲对讲聚焦观点:
View theView = findViewById(R.id.theViewId);
theView.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
就查找当前获得焦点的节点而言,您想在视图层次结构中搜索获得焦点的视图。
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
public static View findAccessibilityFocus(View view) {
if (view == null) return view;
if (view.isAccessibilityFocused()) return view;
if (view instanceof ViewGroup) {
ViewGroup viewGroup = (ViewGroup)view;
for (int i = 0; i < viewGroup.getChildCount(); i++) {
View childView = viewGroup.getChildAt(i);
View result = findAccessibilityFocus(childView);
if (result != null) return result;
}
}
return null;
}
使用此功能需谨慎!当涉及竞争条件时,可访问性焦点可能很难找到。视图不必具有以可访问性为中心的视图。将可访问性委托附加到根视图并跟踪具有可访问性焦点的最后一个元素、跟踪相应的可访问性事件可能会更容易。
我的应用程序支持辅助功能,并且应用程序同时具有纵向和横向模式。
在我的屏幕上,我有一些视图,例如按钮、文本视图、带有自定义行的列表视图。
我面临的问题是,当用户在纵向模式下聚焦任何项目并旋转屏幕时,应用程序不会在横向模式下聚焦同一元素。有人可以建议如何将焦点设置到在纵向模式下 select 到横向模式的项目吗?
我什至对现有应用程序进行了一些研究,例如本机设置应用程序-wifi 页面和 "ES file explore",在这些应用程序中,当用户将方向更改为横向模式时,也无法保持可访问性。系统正在 select 将横向的一些随机元素转换为纵向,反之亦然。
下面是代码片段
accessibility_sample.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical" >
<TextView
android:id="@+id/name_text"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:contentDescription="Name"
android:focusableInTouchMode="true"
android:text="Name" />
<TextView
android:id="@+id/email_text"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:contentDescription="Email"
android:focusableInTouchMode="true"
android:text="Email" />
<Button
android:id="@+id/sample_button"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:contentDescription="Button description"
android:text="ButtonText" />
<CheckBox
android:id="@+id/checkbox"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:contentDescription="Checkbox description"
android:text="Checkbox Text" />
<ListView
android:id="@+id/sample_list"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:fadeScrollbars="false" >
</ListView>
</LinearLayout>
sample_list_row.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal"
>
<CheckBox
android:id="@+id/list_row_cb"
android:layout_width="wrap_content"
android:layout_height="wrap_content" >
</CheckBox>
<TextView
android:id="@+id/list_row_name"
android:layout_width="match_parent"
android:focusableInTouchMode="true"
android:focusable="true"
android:layout_height="wrap_content" />
</LinearLayout>
AccessibilitySampleActivity.java
public class AccessibilitySampleActivity 扩展 Activity {
private String TAG = AccessibilitySampleActivity.class.getSimpleName();
ListView sampleList;
Button myButton;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.accessibility_sample);
sampleList = (ListView) findViewById(R.id.sample_list);
myButton = (Button) findViewById(R.id.sample_button);
ArrayList<String> countriesList = new ArrayList<String>();
countriesList.add("India");
countriesList.add("America");
countriesList.add("China");
countriesList.add("Swis");
countriesList.add("Paries");
countriesList.add("Pak");
countriesList.add("Aus");
countriesList.add("Afg");
countriesList.add("Nedharnalds");
countriesList.add("Bangladhesh");
countriesList.add("Srilanka");
countriesList.add("France");
countriesList.add("Japan");
countriesList.add("SouthAfrica");
countriesList.add("Iran");
countriesList.add("Malaysia");
countriesList.add("Nepal");
sampleList.setAdapter(new CustomArrayAdapter(this, R.layout.sample_list_row, countriesList));
}
class CustomArrayAdapter extends ArrayAdapter<String> {
Context context;
int resource;
ArrayList<String> countriesList;
class ViewHolder {
TextView name;
}
public CustomArrayAdapter(Context context, int resource, ArrayList<String> countriesList) {
super(context, resource, countriesList);
this.context = context;
this.resource = resource;
this.countriesList = countriesList;
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
ViewHolder holder = null;
if (convertView == null) {
LayoutInflater vi = (LayoutInflater) getSystemService(Context.LAYOUT_INFLATER_SERVICE);
convertView = vi.inflate(resource, null);
holder = new ViewHolder();
holder.name = (TextView) convertView.findViewById(R.id.list_row_name);
convertView.setTag(holder);
} else {
holder = (ViewHolder) convertView.getTag();
}
holder.name.setText(getItem(position));
return convertView;
}
@Override
public int getCount() {
return super.getCount();
}
}
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
public static View findAccessibilityFocus(View view) {
if (view == null)
return view;
if (view.isAccessibilityFocused())
return view;
if (view instanceof ViewGroup) {
ViewGroup viewGroup = (ViewGroup) view;
for (int i = 0; i < viewGroup.getChildCount(); i++) {
View childView = viewGroup.getChildAt(i);
View result = findAccessibilityFocus(childView);
if (result != null)
return result;
}
}
return null;
}
@Override
public void onConfigurationChanged(Configuration newConfig) {
super.onConfigurationChanged(newConfig);
Log.d(TAG, "onConfigurationChanged");
AccessibilityManager am = (AccessibilityManager) getSystemService(ACCESSIBILITY_SERVICE);
boolean isAccessibilityEnabled = am.isEnabled();
boolean isExploreByTouchEnabled = am.isTouchExplorationEnabled();
Log.d(TAG, "isAccessibilityEnabled:" + isAccessibilityEnabled + " isExploreByTouchEnabled:"
+ isExploreByTouchEnabled);
if (isAccessibilityEnabled) {
View activityView = this.findViewById(android.R.id.content);
Log.d(TAG, "activityView:" + activityView);
View selectedView = findAccessibilityFocus(activityView);
if (selectedView != null) {
Log.d(TAG, "selectedView:" + selectedView);
selectedView.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
}
}
}
}
对于普通视图,如 TextView、Button、Checkbox,它能够在用户旋转屏幕时保持状态。
如果下面的用户 select 列表视图是我面临的问题
- 如果在纵向和旋转屏幕中select编辑了任何视图,则在横向 中不会保持焦点。有时如果 selected 视图能够在不滚动的情况下显示(比如如果用户 select India 和 rotate India 将在不滚动的情况下可见)它保持状态
- 当用户将屏幕从纵向旋转到横向、应用滚动和select任何视图(如日本)并将方向从横向更改为纵向模式时,我们可以看到它总是select 第一行复选框即印度的复选框.
WCAG 当前未指定在动态(当您的应用程序处于 运行 时)方向更改后焦点应该发生什么。它确实讨论了方向变化,但没有讨论如何处理这种背景变化,这是有充分理由的。焦点管理不是这里的核心问题!事实上,如果有的话,WCAG 会阻止您尝试使用您正在尝试的解决方案,因为它可能被视为干扰辅助技术的默认操作。想一想,在您的问题中,您指出大多数应用 "don't do" 您正在尝试做的事情。如果你要完成这件事,而世界上所有其他应用程序都没有,那么谁真的无法访问? "expected behavior"不是有好处吗?
其中无法访问的部分是令人惊讶的方向变化,而不是完全屏幕后焦点发生的变化 RE-DRAW!在我看来,这样做的动机可能是对 WCAG 2.0 3.2.# 下指南的误导解释。如果用户有时在关心焦点在哪里时意外地导致方向改变......这确实是一个问题!您只是抓住了问题的错误部分。
焦点控制对于可访问性非常重要,但方向变化不同于其他上下文变化。在方向改变时,屏幕可能完全不同。当然,屏幕上会有类似的元素,但不能保证焦点元素仍然存在。与其尝试跟踪焦点并将其移动到适当的(现在可能是屏幕外的元素),不如让 AT 来做这件事,并且在方向发生变化时更具选择性。此处的最佳做法:
- 切勿将用户锁定在特定方向。请记住,用户可能会将他们的设备安装在他们面前,因此需要一个方向是非常糟糕的。 Mobile Guidelines 4.1.
- 然而,话虽这么说,一旦您确定用户(当使用触摸探索的辅助技术是其中之一)处于他们熟悉的方向时,锁定方向,并为他们提供另一种机制来手动更改方向.通过这种方式,用户可以自由地做一些事情,比如将 phone 放在耳边,而不用担心意外触发方向改变。 WCAG 2.0 - 3.2.5
- 如果方向发生变化,允许默认行为。即使在您看来它无法访问,只要用户没有意外触发方向更改,也不会那么令人沮丧。如果您正确解决了上述问题,那将不是问题。
- 最后,请记住,当您开发可访问性时,TalkBack 只是一种辅助技术,而盲人只是该技术用户的一个子集。虽然,您可能正在改善盲人 TalkBack 用户的用户体验,但您必须考虑您正在为使用对讲来支持他们的身体残疾的 TalkBacks 用户、BrailleBack 用户或 SwitchAccess 用户做些什么。一般来说,支持多个 AT 意味着允许操作系统、AT 和用户代理尽可能频繁地做 default/supported 事情。虽然添加 hack 解决方案可能会改善盲人 TalkBack 用户的体验,但在 TalkBack v#.# 上,它很容易使当前 SwitchAccess 用户的情况变得更糟,甚至会破坏 blink TalkBack v#.#+1 用户的体验。 WCAG 中 WCAG 4.1 下实际上也涵盖了这种 hack 解决方案是坏的概念。
总而言之,从可访问性的角度来看,您尝试做的事情确实有些误入歧途,实际上会使事情变得更糟。话虽如此,在 Android 视图中跟踪可访问性焦点的概念很有趣,我将在下面为您留下代码。但是,在这种情况下,我建议不要使用这种方法。
原始答案:
这很简单。
讲对讲聚焦观点:
View theView = findViewById(R.id.theViewId);
theView.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
就查找当前获得焦点的节点而言,您想在视图层次结构中搜索获得焦点的视图。
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
public static View findAccessibilityFocus(View view) {
if (view == null) return view;
if (view.isAccessibilityFocused()) return view;
if (view instanceof ViewGroup) {
ViewGroup viewGroup = (ViewGroup)view;
for (int i = 0; i < viewGroup.getChildCount(); i++) {
View childView = viewGroup.getChildAt(i);
View result = findAccessibilityFocus(childView);
if (result != null) return result;
}
}
return null;
}
使用此功能需谨慎!当涉及竞争条件时,可访问性焦点可能很难找到。视图不必具有以可访问性为中心的视图。将可访问性委托附加到根视图并跟踪具有可访问性焦点的最后一个元素、跟踪相应的可访问性事件可能会更容易。