Android无障碍服务无障碍按钮不可用问题求助（Android 10 Moto Z4）

问题背景 #

在运行Android 10的Moto Z4设备上，实现无障碍按钮功能时，accessibilityButtonController.isAccessibilityButtonAvailable()始终返回false，但设备实际支持软件导航栏。核心代码如下：

import android.accessibilityservice.AccessibilityButtonController;
import android.accessibilityservice.AccessibilityService;
import android.accessibilityservice.AccessibilityServiceInfo;
import android.util.Log;
import android.view.accessibility.AccessibilityEvent;

public class MyAccessibilityService extends AccessibilityService {
    private AccessibilityButtonController accessibilityButtonController;
    private AccessibilityButtonController
            .AccessibilityButtonCallback accessibilityButtonCallback;
    private boolean mIsAccessibilityButtonAvailable;

    @Override
    protected void onServiceConnected() {
        Log.d("info", "connect");
        accessibilityButtonController = getAccessibilityButtonController();
        mIsAccessibilityButtonAvailable =
                accessibilityButtonController.isAccessibilityButtonAvailable();

        if (!mIsAccessibilityButtonAvailable) {
            Log.d("info", "not supported");
            return;
        }

        AccessibilityServiceInfo serviceInfo = getServiceInfo();
        serviceInfo.flags
                |= AccessibilityServiceInfo.FLAG_REQUEST_ACCESSIBILITY_BUTTON;
        setServiceInfo(serviceInfo);

        accessibilityButtonCallback =
                new AccessibilityButtonController.AccessibilityButtonCallback() {
                    @Override
                    public void onClicked(AccessibilityButtonController controller) {
                        Log.d("MY_APP_TAG", "Accessibility button pressed!");

                        // Add custom logic for a service to react to the
                        // accessibility button being pressed.
                    }

                    @Override
                    public void onAvailabilityChanged(
                            AccessibilityButtonController controller, boolean available) {
                        if (controller.equals(accessibilityButtonController)) {
                            mIsAccessibilityButtonAvailable = available;
                        }
                    }
                };

        if (accessibilityButtonCallback != null) {
            accessibilityButtonController.registerAccessibilityButtonCallback(
                    accessibilityButtonCallback, null);
        }
    }
    @Override
    public void onAccessibilityEvent(AccessibilityEvent event) {
    }

    @Override
    public void onInterrupt() {
    }
}

排查与解决方案 #

• 检查服务启用状态：仅已启用的无障碍服务能获取正确的按钮状态。前往「设置-无障碍」确认你的服务已开启，未启用时isAccessibilityButtonAvailable()会默认返回false。
• 切换导航模式：Android 10及以上支持手势导航，部分设备在此模式下不显示传统无障碍按钮。切换到「三键导航」模式后重新测试。
• 调整配置顺序：原代码先检查可用性再设置FLAG_REQUEST_ACCESSIBILITY_BUTTON，但系统需先知晓服务的按钮请求，才会正确报告状态。修改代码顺序如下：

  @Override
  protected void onServiceConnected() {
      Log.d("info", "connect");
      accessibilityButtonController = getAccessibilityButtonController();
  
      // 先设置请求无障碍按钮的标记
      AccessibilityServiceInfo serviceInfo = getServiceInfo();
      serviceInfo.flags |= AccessibilityServiceInfo.FLAG_REQUEST_ACCESSIBILITY_BUTTON;
      setServiceInfo(serviceInfo);
  
      // 再检查可用性
      mIsAccessibilityButtonAvailable = accessibilityButtonController.isAccessibilityButtonAvailable();
  
      if (!mIsAccessibilityButtonAvailable) {
          Log.d("info", "not supported");
          return;
      }
  
      // 注册回调逻辑...
  }
  

• 验证Manifest配置：确保服务声明包含必要权限与配置：

  <service
      android:name=".MyAccessibilityService"
      android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
      <intent-filter>
          <action android:name="android.accessibilityservice.AccessibilityService" />
      </intent-filter>
      <meta-data
          android:name="android.accessibilityservice"
          android:resource="@xml/accessibility_service_config" />
  </service>
  

  对应的accessibility_service_config.xml需包含基础配置：

  <?xml version="1.0" encoding="utf-8"?>
  <accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
      android:accessibilityEventTypes="typeAllMask"
      android:accessibilityFeedbackType="feedbackGeneric"
      android:accessibilityFlags="flagDefault"
      android:description="@string/accessibility_service_description" />
  

内容的提问来源于stack exchange，提问作者job bot