AccessibilityService onInterrupt

onInterrupt 是实现自定义无障碍服务必须实现的方法,但官方文档和注释中对此方法的描述十分模糊,从字面上可以理解这是无障碍服务中断的回调,但具体是什么样的场景并没有一个明确的示例。

onInterrupt 在官方文档中查到的相关描述是:

onInterrupt() – (required) This method is called when the system wants to interrupt the feedback your service is providing, usually in response to a user action such as moving focus to a different control. This method may be called many times over the lifecycle of your service.

(必需)当系统要中断服务正在提供的反馈(通常是为了响应将焦点移到其他控件等用户操作)时,会调用此方法。此方法可能会在服务的整个生命周期内被调用多次。

onInterrupt 在 AccessibilityService 中定义,是一个抽象方法:

public abstract class AccessibilityService extends Service {
  // ...
  public abstract void onInterrupt();
  // ...
}

AccessibilityService#onInterrupt() 的调用在 AccessibilityService 的 onBind 方法中:

    @Override
    public final IBinder onBind(Intent intent) {
        return new IAccessibilityServiceClientWrapper(this, getMainLooper(), new Callbacks() {
          // ...
            @Override
            public void onInterrupt() {
                AccessibilityService.this.onInterrupt();
            }    
    }
  }

这里返回了一个 IAccessibilityServiceClientWrapper 对象作为 IBinder,IAccessibilityServiceClientWrapper 构造参数有三个:

        public IAccessibilityServiceClientWrapper(Context context, Looper looper,
                Callbacks callback)
 
{
            mCallback = callback;
            mCaller = new HandlerCaller(context, looper, thistrue /*asyncHandler*/);
        }

在构造方法中,通过 Context。和 Looper 构造了一个 HandlerCaller 对象。

而最后的 Callbacks 参数是 AccessibilityService 的内部接口。将其保存到了 mCallback 。

AccessibilityService 中定义 Callbacks 接口:

    public interface Callbacks {
        void onAccessibilityEvent(AccessibilityEvent event);
        void onInterrupt();
        void onServiceConnected();
        void init(int connectionId, IBinder windowToken);
        /** The detected gesture information for different displays */
        boolean onGesture(AccessibilityGestureEvent gestureInfo);
        boolean onKeyEvent(KeyEvent event);
        /** Magnification changed callbacks for different displays */
        void onMagnificationChanged(int displayId, @NonNull Region region,
                float scale, float centerX, float centerY)
;
        void onSoftKeyboardShowModeChanged(int showMode);
        void onPerformGestureResult(int sequence, boolean completedSuccessfully);
        void onFingerprintCapturingGesturesChanged(boolean active);
        void onFingerprintGesture(int gesture);
        /** Accessbility button clicked callbacks for different displays */
        void onAccessibilityButtonClicked(int displayId);
        void onAccessibilityButtonAvailabilityChanged(boolean available);
        /** This is called when the system action list is changed. */
        void onSystemActionsChanged();
    }

AccessibilityService.Callback 接口是 IAccessibilityServiceClientWrapper 用于从其主线程调用 Service 的接口。这里是通过 handler 机制来进行的。

IAccessibilityServiceClientWrapper 在构造时,会构造一个 HandlerCaller :

mCaller = new HandlerCaller(context, looper, thistrue /*asyncHandler*/);

HandlerCaller 是一个 Handler 的包装器:

    public HandlerCaller(Context context, Looper looper, Callback callback,
            boolean asyncHandler)
 
{
        mMainLooper = looper != null ? looper : context.getMainLooper();
        mH = new MyHandler(mMainLooper, asyncHandler);
        mCallback = callback;
    }

HandlerCaller 内部定义了 Callback 接口:

    public interface Callback {
        public void executeMessage(Message msg);
    }

这个 Callback 由 IAccessibilityServiceClientWrapper 实现,并处理了中断相关类型的消息:

        @Override
        public void executeMessage(Message message) {
            switch (message.what) {
              // ...
                case DO_ON_INTERRUPT: {
                    if (mConnectionId != AccessibilityInteractionClient.NO_ID) {
                        mCallback.onInterrupt();
                    }
                    return;
                }
    }

还记得这里 mCallback 吗,就是 IAccessibilityServiceClientWrapper 构造方法中传入的 AccessibilityService 中的 onBind 中构造的匿名对象,从而调用到 AccessibilityService 的 onInterrupt:

    @Override
    public final IBinder onBind(Intent intent) {
        return new IAccessibilityServiceClientWrapper(this, getMainLooper(), new Callbacks() {
          // ...
            @Override
            public void onInterrupt() {
                AccessibilityService.this.onInterrupt();
            }    
    }
  }

IAccessibilityServiceClientWrapper 可以作为 IBinder 对象,是因为实现了  IAccessibilityServiceClient.Stub ,IAccessibilityServiceClient 是 AIDL 接口,内部定义了 onInterrupt() 方法,在这里的实现是通过 Handler 发送了 DO_ON_INTERRUPT 类型的消息。

public static class IAccessibilityServiceClientWrapper extends IAccessibilityServiceClient.Stub
        implements HandlerCaller.Callback 
{
        public void onInterrupt() {
            Message message = mCaller.obtainMessage(DO_ON_INTERRUPT);
            mCaller.sendMessage(message);
        }
}

发送 DO_ON_INTERRUPT 类型的消息,正好回调到了 mCallback.onInterrupt 。而

IAccessibilityServiceClientWrapper 的 onInterrupt 是在哪里调用的呢?

IAccessibilityServiceClientWrapper 的 onInterrupt 方法是 AIDL 实现,说明来自于 Service 调用。查看这个方法的调用,发现来自于 AccessibilityManagerService 。

AccessibilityManagerService 实现了 IAccessibilityManager.Stub:

public class AccessibilityManagerService extends IAccessibilityManager.Stub
        implements AbstractAccessibilityServiceConnection.SystemSupport,
        AccessibilityUserState.ServiceInfoChangeListener,
        AccessibilityWindowManager.AccessibilityEventSender,
        AccessibilitySecurityPolicy.AccessibilityUserManager,
        SystemActionPerformer.SystemActionsChangedListener

IAccessibilityManager.Stub 中定义了 interrupt 方法,AccessibilityManagerService 实现了这个方法,并在这个方法中调用了 IAccessibilityServiceClientWrapper#onInterrupt()

// in IAccessibilityManager
    private static class Proxy implements IAccessibilityManager {
            // ... 

            public void interrupt(int userId) throws RemoteException {
            }
    }
// in AccessibilityManagerService
  @Override
    public void interrupt(int userId) {
        List<IAccessibilityServiceClient> interfacesToInterrupt;
        synchronized (mLock) {
            // We treat calls from a profile as if made by its parent as profiles
            // share the accessibility state of the parent. The call below
            // performs the current profile parent resolution.
            final int resolvedUserId = mSecurityPolicy
                    .resolveCallingUserIdEnforcingPermissionsLocked(userId);
            // This method does nothing for a background user.
            if (resolvedUserId != mCurrentUserId) {
                return;
            }
            List<AccessibilityServiceConnection> services =
                    getUserStateLocked(resolvedUserId).mBoundServices;
            int numServices = services.size();
            interfacesToInterrupt = new ArrayList<>(numServices);
            for (int i = 0; i < numServices; i++) {
                AccessibilityServiceConnection service = services.get(i);
                IBinder a11yServiceBinder = service.mService;
                IAccessibilityServiceClient a11yServiceInterface = service.mServiceInterface;
                if ((a11yServiceBinder != null) && (a11yServiceInterface != null)) {
                    interfacesToInterrupt.add(a11yServiceInterface);
                }
            }
        }
        for (int i = 0, count = interfacesToInterrupt.size(); i < count; i++) {
            try {
                interfacesToInterrupt.get(i).onInterrupt();
            } catch (RemoteException re) {
                Slog.e(LOG_TAG, "Error sending interrupt request to "
                        + interfacesToInterrupt.get(i), re);
            }
        }
    }

AccessibilityManagerService 的 interrupt 方法的注释,仍然让我无法理解:

请求所有无障碍服务的反馈中断。

Requests feedback interruption from all accessibility services.

那么只能继续跟进哪里调用了  AccessibilityManagerService 的 interrupt 方法。

最后在 frameworks/base/core/java/android/view/accessibility/AccessibilityManager.java # interrupt() 方法发现了调用。

AccessibilityManager#interrupt()  备注是:

Requests feedback interruption from all accessibility services.

请求所有无障碍服务的反馈中断。

到了这里彻底断了调用链(没有任何位置调用该方法)。。

但是! 很明显 AccessibilityManager 这个东西是 Framework 层供应用层调用的。就是 Context.getSystemService 可以访问到的 Manager 。

查看 AccessibilityManager 的备注:

AccessibilityManager 是 系统级服务,用作 AccessibilityEvent 的事件调度,并提供用于查询系统无障碍状态的工具方法。

也就是说 ·AccessibilityManager#interrupt()· 可以由开发中手动调用。

手写一个测试代码看看,将下面的代码放在一个点击事件中:

val am = getSystemService(ACCESSIBILITY_SERVICE) as? AccessibilityManager
am?.interrupt()

在无障碍服务的实现类中的 onInterrupt 方法中打印日志

    override fun onInterrupt() {
        Log.i("BaseA11yService""onInterrupt")
    }

运行代码,发现的确打印出了日志:

2022-09-26 15:17:34.375 I/BaseA11yService: onUnbind
2022-09-26 15:17:44.094 I/BaseA11yService: onInterrupt

顺便提一下,在设置中关闭无障碍服务,会回调 AccessibilityService 的 onUnBind 。

总结

所以 onInterrupt 这个抽象方法回调,是应用层可以自行实现打点位置的。

整体的调用逻辑是:

// 从上到下为回调顺序
AccessibilityManager.interrupt()
|
AccessibilityManagerService.interrupt() // 本质是 IAccessibilityManager.Stub.interrupt()
|
IAccessibilityServiceClientWrapper.onInterrupt() // 本质是 IAccessibilityServiceClient.Stub.onInterrupt()

HandlerCaller.sendMessage(message) // DO_ON_INTERRUPT 类型的 message

IAccessibilityServiceClientWrapper.executeMessage(message) // 本质是 HandlerCaller.Callback.executeMessage(message)

AccessibilityService.Callbacks.onInterrupt() // AccessibilityService.onBind 中的匿名对象

AccessibilityService.onInterrupt() // 无障碍服务自己的抽象方法 onInterrupt


原文始发于微信公众号(八千里路山与海):AccessibilityService onInterrupt

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

文章由极客之音整理,本文链接:https://www.bmabk.com/index.php/post/85038.html

(0)
小半的头像小半

相关推荐

发表回复

登录后才能评论
极客之音——专业性很强的中文编程技术网站,欢迎收藏到浏览器,订阅我们!