AccessibilityService.java revision 005b83b0c62d3d0538f0d566b08bd457015ec661
1/* 2 * Copyright (C) 2009 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17package android.accessibilityservice; 18 19import android.app.Service; 20import android.content.Context; 21import android.content.Intent; 22import android.content.res.Configuration; 23import android.os.IBinder; 24import android.os.Looper; 25import android.os.Message; 26import android.os.RemoteException; 27import android.util.LocaleUtil; 28import android.util.Log; 29import android.view.View; 30import android.view.accessibility.AccessibilityEvent; 31import android.view.accessibility.AccessibilityInteractionClient; 32import android.view.accessibility.AccessibilityNodeInfo; 33 34import com.android.internal.os.HandlerCaller; 35 36import java.util.Locale; 37 38/** 39 * An accessibility service runs in the background and receives callbacks by the system 40 * when {@link AccessibilityEvent}s are fired. Such events denote some state transition 41 * in the user interface, for example, the focus has changed, a button has been clicked, 42 * etc. Such a service can optionally request the capability for querying the content 43 * of the active window. Development of an accessibility service requires extending this 44 * class and implementing its abstract methods. 45 * 46 * <div class="special reference"> 47 * <h3>Developer Guides</h3> 48 * <p>For more information about creating AccessibilityServices, read the 49 * <a href="{@docRoot}guide/topics/ui/accessibility/index.html">Accessibility</a> 50 * developer guide.</p> 51 * </div> 52 * 53 * <h3>Lifecycle</h3> 54 * <p> 55 * The lifecycle of an accessibility service is managed exclusively by the system and 56 * follows the established service life cycle. Additionally, starting or stopping an 57 * accessibility service is triggered exclusively by an explicit user action through 58 * enabling or disabling it in the device settings. After the system binds to a service it 59 * calls {@link AccessibilityService#onServiceConnected()}. This method can be 60 * overriden by clients that want to perform post binding setup. 61 * </p> 62 * <h3>Declaration</h3> 63 * <p> 64 * An accessibility is declared as any other service in an AndroidManifest.xml but it 65 * must also specify that it handles the "android.accessibilityservice.AccessibilityService" 66 * {@link android.content.Intent}. Failure to declare this intent will cause the system to 67 * ignore the accessibility service. Following is an example declaration: 68 * </p> 69 * <pre> <service android:name=".MyAccessibilityService"> 70 * <intent-filter> 71 * <action android:name="android.accessibilityservice.AccessibilityService" /> 72 * </intent-filter> 73 * . . . 74 * </service></pre> 75 * <h3>Configuration</h3> 76 * <p> 77 * An accessibility service can be configured to receive specific types of accessibility events, 78 * listen only to specific packages, get events from each type only once in a given time frame, 79 * retrieve window content, specify a settings activity, etc. 80 * </p> 81 * <p> 82 * There are two approaches for configuring an accessibility service: 83 * </p> 84 * <ul> 85 * <li> 86 * Providing a {@link #SERVICE_META_DATA meta-data} entry in the manifest when declaring 87 * the service. A service declaration with a meta-data tag is presented below: 88 * <pre> <service android:name=".MyAccessibilityService"> 89 * <intent-filter> 90 * <action android:name="android.accessibilityservice.AccessibilityService" /> 91 * </intent-filter> 92 * <meta-data android:name="android.accessibilityservice" android:resource="@xml/accessibilityservice" /> 93 * </service></pre> 94 * <p class="note"> 95 * <strong>Note:</strong> This approach enables setting all properties. 96 * </p> 97 * <p> 98 * For more details refer to {@link #SERVICE_META_DATA} and 99 * <code><{@link android.R.styleable#AccessibilityService accessibility-service}></code>. 100 * </p> 101 * </li> 102 * <li> 103 * Calling {@link AccessibilityService#setServiceInfo(AccessibilityServiceInfo)}. Note 104 * that this method can be called any time to dynamically change the service configuration. 105 * <p class="note"> 106 * <strong>Note:</strong> This approach enables setting only dynamically configurable properties: 107 * {@link AccessibilityServiceInfo#eventTypes}, 108 * {@link AccessibilityServiceInfo#feedbackType}, 109 * {@link AccessibilityServiceInfo#flags}, 110 * {@link AccessibilityServiceInfo#notificationTimeout}, 111 * {@link AccessibilityServiceInfo#packageNames} 112 * </p> 113 * <p> 114 * For more details refer to {@link AccessibilityServiceInfo}. 115 * </p> 116 * </li> 117 * </ul> 118 * <h3>Retrieving window content</h3> 119 * <p> 120 * A service can specify in its declaration that it can retrieve the active window 121 * content which is represented as a tree of {@link AccessibilityNodeInfo}. Note that 122 * declaring this capability requires that the service declares its configuration via 123 * an XML resource referenced by {@link #SERVICE_META_DATA}. 124 * </p> 125 * <p> 126 * For security purposes an accessibility service can retrieve only the content of the 127 * currently active window. The currently active window is defined as the window from 128 * which was fired the last event of the following types: 129 * {@link AccessibilityEvent#TYPE_WINDOW_STATE_CHANGED}, 130 * {@link AccessibilityEvent#TYPE_VIEW_HOVER_ENTER}, 131 * {@link AccessibilityEvent#TYPE_VIEW_HOVER_EXIT}, 132 * In other words, the last window that was shown or the last window that the user has touched 133 * during touch exploration. 134 * </p> 135 * <p> 136 * The entry point for retrieving window content is through calling 137 * {@link AccessibilityEvent#getSource() AccessibilityEvent.getSource()} of the last received 138 * event of the above types or a previous event from the same window 139 * (see {@link AccessibilityEvent#getWindowId() AccessibilityEvent.getWindowId()}). Invoking 140 * this method will return an {@link AccessibilityNodeInfo} that can be used to traverse the 141 * window content which represented as a tree of such objects. 142 * </p> 143 * <p class="note"> 144 * <strong>Note</strong> An accessibility service may have requested to be notified for 145 * a subset of the event types, thus be unaware that the active window has changed. Therefore 146 * accessibility service that would like to retrieve window content should: 147 * <ul> 148 * <li> 149 * Register for all event types with no notification timeout and keep track for the active 150 * window by calling {@link AccessibilityEvent#getWindowId()} of the last received event and 151 * compare this with the {@link AccessibilityNodeInfo#getWindowId()} before calling retrieval 152 * methods on the latter. 153 * </li> 154 * <li> 155 * Prepare that a retrieval method on {@link AccessibilityNodeInfo} may fail since the 156 * active window has changed and the service did not get the accessibility event yet. Note 157 * that it is possible to have a retrieval method failing even adopting the strategy 158 * specified in the previous bullet because the accessibility event dispatch is asynchronous 159 * and crosses process boundaries. 160 * </li> 161 * </ul> 162 * </p> 163 * <h3>Notification strategy</h3> 164 * <p> 165 * For each feedback type only one accessibility service is notified. Services are notified 166 * in the order of registration. Hence, if two services are registered for the same 167 * feedback type in the same package the first one wins. It is possible however, to 168 * register a service as the default one for a given feedback type. In such a case this 169 * service is invoked if no other service was interested in the event. In other words, default 170 * services do not compete with other services and are notified last regardless of the 171 * registration order. This enables "generic" accessibility services that work reasonably 172 * well with most applications to coexist with "polished" ones that are targeted for 173 * specific applications. 174 * </p> 175 * <p class="note"> 176 * <strong>Note:</strong> The event notification timeout is useful to avoid propagating 177 * events to the client too frequently since this is accomplished via an expensive 178 * interprocess call. One can think of the timeout as a criteria to determine when 179 * event generation has settled down.</p> 180 * <h3>Event types</h3> 181 * <ul> 182 * <li>{@link AccessibilityEvent#TYPE_VIEW_CLICKED} 183 * <li>{@link AccessibilityEvent#TYPE_VIEW_LONG_CLICKED} 184 * <li>{@link AccessibilityEvent#TYPE_VIEW_FOCUSED} 185 * <li>{@link AccessibilityEvent#TYPE_VIEW_SELECTED} 186 * <li>{@link AccessibilityEvent#TYPE_VIEW_TEXT_CHANGED} 187 * <li>{@link AccessibilityEvent#TYPE_WINDOW_STATE_CHANGED} 188 * <li>{@link AccessibilityEvent#TYPE_NOTIFICATION_STATE_CHANGED} 189 * <li>{@link AccessibilityEvent#TYPE_TOUCH_EXPLORATION_GESTURE_START} 190 * <li>{@link AccessibilityEvent#TYPE_TOUCH_EXPLORATION_GESTURE_END} 191 * <li>{@link AccessibilityEvent#TYPE_VIEW_HOVER_ENTER} 192 * <li>{@link AccessibilityEvent#TYPE_VIEW_HOVER_EXIT} 193 * <li>{@link AccessibilityEvent#TYPE_VIEW_SCROLLED} 194 * <li>{@link AccessibilityEvent#TYPE_VIEW_TEXT_SELECTION_CHANGED} 195 * <li>{@link AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED} 196 * </ul> 197 * <h3>Feedback types</h3> 198 * <ul> 199 * <li>{@link AccessibilityServiceInfo#FEEDBACK_AUDIBLE} 200 * <li>{@link AccessibilityServiceInfo#FEEDBACK_HAPTIC} 201 * <li>{@link AccessibilityServiceInfo#FEEDBACK_AUDIBLE} 202 * <li>{@link AccessibilityServiceInfo#FEEDBACK_VISUAL} 203 * <li>{@link AccessibilityServiceInfo#FEEDBACK_GENERIC} 204 * </ul> 205 * @see AccessibilityEvent 206 * @see AccessibilityServiceInfo 207 * @see android.view.accessibility.AccessibilityManager 208 */ 209public abstract class AccessibilityService extends Service { 210 211 /** 212 * The user has performed a swipe up gesture on the touch screen. 213 */ 214 public static final int GESTURE_SWIPE_UP = 1; 215 216 /** 217 * The user has performed a swipe down gesture on the touch screen. 218 */ 219 public static final int GESTURE_SWIPE_DOWN = 2; 220 221 /** 222 * The user has performed a swipe left gesture on the touch screen. 223 */ 224 public static final int GESTURE_SWIPE_LEFT = 3; 225 226 /** 227 * The user has performed a swipe right gesture on the touch screen. 228 */ 229 public static final int GESTURE_SWIPE_RIGHT = 4; 230 231 /** 232 * The user has performed a swipe left and right gesture on the touch screen. 233 */ 234 public static final int GESTURE_SWIPE_LEFT_AND_RIGHT = 5; 235 236 /** 237 * The user has performed a swipe right and left gesture on the touch screen. 238 */ 239 public static final int GESTURE_SWIPE_RIGHT_AND_LEFT = 6; 240 241 /** 242 * The user has performed a swipe up and down gesture on the touch screen. 243 */ 244 public static final int GESTURE_SWIPE_UP_AND_DOWN = 7; 245 246 /** 247 * The user has performed a swipe down and up gesture on the touch screen. 248 */ 249 public static final int GESTURE_SWIPE_DOWN_AND_UP = 8; 250 251 /** 252 * The user has performed a clockwise circle gesture on the touch screen. 253 */ 254 public static final int GESTURE_CLOCKWISE_CIRCLE = 9; 255 256 /** 257 * The user has performed a counter clockwise circle gesture on the touch screen. 258 */ 259 public static final int GESTURE_COUNTER_CLOCKWISE_CIRCLE = 10; 260 261 /** 262 * The user has performed a left and up gesture on the touch screen. 263 */ 264 public static final int GESTURE_SWIPE_LEFT_AND_UP = 11; 265 266 /** 267 * The user has performed a left and down gesture on the touch screen. 268 */ 269 public static final int GESTURE_SWIPE_LEFT_AND_DOWN = 12; 270 271 /** 272 * The user has performed a right and up gesture on the touch screen. 273 */ 274 public static final int GESTURE_SWIPE_RIGHT_AND_UP = 13; 275 276 /** 277 * The user has performed a right and down gesture on the touch screen. 278 */ 279 public static final int GESTURE_SWIPE_RIGHT_AND_DOWN = 14; 280 281 /** 282 * The user has performed an up and left gesture on the touch screen. 283 */ 284 public static final int GESTURE_SWIPE_UP_AND_LEFT = 15; 285 286 /** 287 * The user has performed an up and right gesture on the touch screen. 288 */ 289 public static final int GESTURE_SWIPE_UP_AND_RIGHT = 16; 290 291 /** 292 * The user has performed an down and left gesture on the touch screen. 293 */ 294 public static final int GESTURE_SWIPE_DOWN_AND_LEFT = 17; 295 296 /** 297 * The user has performed an down and right gesture on the touch screen. 298 */ 299 public static final int GESTURE_SWIPE_DOWN_AND_RIGHT = 18; 300 301 /** 302 * The {@link Intent} that must be declared as handled by the service. 303 */ 304 public static final String SERVICE_INTERFACE = 305 "android.accessibilityservice.AccessibilityService"; 306 307 /** 308 * Name under which an AccessibilityService component publishes information 309 * about itself. This meta-data must reference an XML resource containing an 310 * <code><{@link android.R.styleable#AccessibilityService accessibility-service}></code> 311 * tag. This is a a sample XML file configuring an accessibility service: 312 * <pre> <accessibility-service 313 * android:accessibilityEventTypes="typeViewClicked|typeViewFocused" 314 * android:packageNames="foo.bar, foo.baz" 315 * android:accessibilityFeedbackType="feedbackSpoken" 316 * android:notificationTimeout="100" 317 * android:accessibilityFlags="flagDefault" 318 * android:settingsActivity="foo.bar.TestBackActivity" 319 * android:canRetrieveWindowContent="true" 320 * . . . 321 * /></pre> 322 */ 323 public static final String SERVICE_META_DATA = "android.accessibilityservice"; 324 325 /** 326 * Action to go back. 327 */ 328 public static final int GLOBAL_ACTION_BACK = 1; 329 330 /** 331 * Action to go home. 332 */ 333 public static final int GLOBAL_ACTION_HOME = 2; 334 335 /** 336 * Action to open the recents. 337 */ 338 public static final int GLOBAL_ACTION_RECENTS = 3; 339 340 /** 341 * Action to open the notifications. 342 */ 343 public static final int GLOBAL_ACTION_NOTIFICATIONS = 4; 344 345 private static final int UNDEFINED = -1; 346 347 private static final String LOG_TAG = "AccessibilityService"; 348 349 interface Callbacks { 350 public void onAccessibilityEvent(AccessibilityEvent event); 351 public void onInterrupt(); 352 public void onServiceConnected(); 353 public void onSetConnectionId(int connectionId); 354 public void onGesture(int gestureId); 355 } 356 357 private int mConnectionId; 358 359 private AccessibilityServiceInfo mInfo; 360 361 private int mLayoutDirection; 362 363 /** 364 * Callback for {@link android.view.accessibility.AccessibilityEvent}s. 365 * 366 * @param event An event. 367 */ 368 public abstract void onAccessibilityEvent(AccessibilityEvent event); 369 370 /** 371 * Callback for interrupting the accessibility feedback. 372 */ 373 public abstract void onInterrupt(); 374 375 /** 376 * This method is a part of the {@link AccessibilityService} lifecycle and is 377 * called after the system has successfully bound to the service. If is 378 * convenient to use this method for setting the {@link AccessibilityServiceInfo}. 379 * 380 * @see AccessibilityServiceInfo 381 * @see #setServiceInfo(AccessibilityServiceInfo) 382 */ 383 protected void onServiceConnected() { 384 385 } 386 387 /** 388 * Called by the system when the user performs a specific gesture on the 389 * touch screen. 390 * 391 * @param gestureId The unique id of the performed gesture. 392 * 393 * @see #GESTURE_SWIPE_UP 394 * @see #GESTURE_SWIPE_DOWN 395 * @see #GESTURE_SWIPE_LEFT 396 * @see #GESTURE_SWIPE_RIGHT 397 * @see #GESTURE_SWIPE_UP_AND_DOWN 398 * @see #GESTURE_SWIPE_DOWN_AND_UP 399 * @see #GESTURE_SWIPE_LEFT_AND_RIGHT 400 * @see #GESTURE_SWIPE_RIGHT_AND_LEFT 401 * @see #GESTURE_CLOCKWISE_CIRCLE 402 * @see #GESTURE_COUNTER_CLOCKWISE_CIRCLE 403 */ 404 protected void onGesture(int gestureId) { 405 // TODO: Describe the default gesture processing in the javaDoc once it is finalized. 406 407 // Global actions. 408 switch (gestureId) { 409 case GESTURE_SWIPE_DOWN_AND_LEFT: { 410 performGlobalAction(GLOBAL_ACTION_BACK); 411 } return; 412 case GESTURE_SWIPE_DOWN_AND_RIGHT: { 413 performGlobalAction(GLOBAL_ACTION_HOME); 414 } return; 415 case GESTURE_SWIPE_UP_AND_LEFT: { 416 performGlobalAction(GLOBAL_ACTION_RECENTS); 417 } return; 418 case GESTURE_SWIPE_UP_AND_RIGHT: { 419 performGlobalAction(GLOBAL_ACTION_NOTIFICATIONS); 420 } return; 421 } 422 423 // Cache the id to avoid locking 424 final int connectionId = mConnectionId; 425 if (connectionId == UNDEFINED) { 426 throw new IllegalStateException("AccessibilityService not connected." 427 + " Did you receive a call of onServiceConnected()?"); 428 } 429 AccessibilityNodeInfo root = AccessibilityInteractionClient.getInstance() 430 .findAccessibilityNodeInfoByAccessibilityId(connectionId, 431 AccessibilityNodeInfo.ACTIVE_WINDOW_ID, AccessibilityNodeInfo.ROOT_NODE_ID, 432 AccessibilityNodeInfo.FLAG_PREFETCH_DESCENDANTS); 433 if (root == null) { 434 return; 435 } 436 AccessibilityNodeInfo current = root.findFocus(AccessibilityNodeInfo.FOCUS_ACCESSIBILITY); 437 if (current == null) { 438 current = root; 439 } 440 441 // Local actions. 442 AccessibilityNodeInfo next = null; 443 switch (gestureId) { 444 case GESTURE_SWIPE_UP: { 445 next = current.focusSearch(View.ACCESSIBILITY_FOCUS_OUT); 446 } break; 447 case GESTURE_SWIPE_DOWN: { 448 next = current.focusSearch(View.ACCESSIBILITY_FOCUS_IN); 449 } break; 450 case GESTURE_SWIPE_LEFT: { 451 if (mLayoutDirection == View.LAYOUT_DIRECTION_LTR) { 452 next = current.focusSearch(View.ACCESSIBILITY_FOCUS_BACKWARD); 453 } else { // LAYOUT_DIRECTION_RTL 454 next = current.focusSearch(View.ACCESSIBILITY_FOCUS_FORWARD); 455 } 456 } break; 457 case GESTURE_SWIPE_RIGHT: { 458 if (mLayoutDirection == View.LAYOUT_DIRECTION_LTR) { 459 next = current.focusSearch(View.ACCESSIBILITY_FOCUS_FORWARD); 460 } else { // LAYOUT_DIRECTION_RTL 461 next = current.focusSearch(View.ACCESSIBILITY_FOCUS_BACKWARD); 462 } 463 } break; 464 case GESTURE_SWIPE_UP_AND_DOWN: { 465 next = current.focusSearch(View.ACCESSIBILITY_FOCUS_UP); 466 } break; 467 case GESTURE_SWIPE_DOWN_AND_UP: { 468 next = current.focusSearch(View.ACCESSIBILITY_FOCUS_DOWN); 469 } break; 470 case GESTURE_SWIPE_LEFT_AND_RIGHT: { 471 next = current.focusSearch(View.ACCESSIBILITY_FOCUS_LEFT); 472 } break; 473 case GESTURE_SWIPE_RIGHT_AND_LEFT: { 474 next = current.focusSearch(View.ACCESSIBILITY_FOCUS_RIGHT); 475 } break; 476 } 477 if (next != null && !next.equals(current)) { 478 next.performAction(AccessibilityNodeInfo.ACTION_ACCESSIBILITY_FOCUS); 479 } 480 } 481 482 /** 483 * Performs a global action. Such an action can be performed 484 * at any moment regardless of the current application or user 485 * location in that application. For example going back, going 486 * home, opening recents, etc. 487 * 488 * @param action The action to perform. 489 * @return Whether the action was successfully performed. 490 * 491 * @see #GLOBAL_ACTION_BACK 492 * @see #GLOBAL_ACTION_HOME 493 * @see #GLOBAL_ACTION_NOTIFICATIONS 494 * @see #GLOBAL_ACTION_RECENTS 495 */ 496 public final boolean performGlobalAction(int action) { 497 IAccessibilityServiceConnection connection = 498 AccessibilityInteractionClient.getInstance().getConnection(mConnectionId); 499 if (connection != null) { 500 try { 501 return connection.perfromGlobalAction(action); 502 } catch (RemoteException re) { 503 Log.w(LOG_TAG, "Error while calling performGlobalAction", re); 504 } 505 } 506 return false; 507 } 508 509 /** 510 * Gets the an {@link AccessibilityServiceInfo} describing this 511 * {@link AccessibilityService}. This method is useful if one wants 512 * to change some of the dynamically configurable properties at 513 * runtime. 514 * 515 * @return The accessibility service info. 516 * 517 * @see AccessibilityNodeInfo 518 */ 519 public final AccessibilityServiceInfo getServiceInfo() { 520 IAccessibilityServiceConnection connection = 521 AccessibilityInteractionClient.getInstance().getConnection(mConnectionId); 522 if (connection != null) { 523 try { 524 return connection.getServiceInfo(); 525 } catch (RemoteException re) { 526 Log.w(LOG_TAG, "Error while getting AccessibilityServiceInfo", re); 527 } 528 } 529 return null; 530 } 531 532 /** 533 * Sets the {@link AccessibilityServiceInfo} that describes this service. 534 * <p> 535 * Note: You can call this method any time but the info will be picked up after 536 * the system has bound to this service and when this method is called thereafter. 537 * 538 * @param info The info. 539 */ 540 public final void setServiceInfo(AccessibilityServiceInfo info) { 541 mInfo = info; 542 sendServiceInfo(); 543 } 544 545 /** 546 * Sets the {@link AccessibilityServiceInfo} for this service if the latter is 547 * properly set and there is an {@link IAccessibilityServiceConnection} to the 548 * AccessibilityManagerService. 549 */ 550 private void sendServiceInfo() { 551 IAccessibilityServiceConnection connection = 552 AccessibilityInteractionClient.getInstance().getConnection(mConnectionId); 553 if (mInfo != null && connection != null) { 554 try { 555 connection.setServiceInfo(mInfo); 556 mInfo = null; 557 AccessibilityInteractionClient.getInstance().clearCache(); 558 } catch (RemoteException re) { 559 Log.w(LOG_TAG, "Error while setting AccessibilityServiceInfo", re); 560 } 561 } 562 } 563 564 @Override 565 public void onCreate() { 566 Locale locale = getResources().getConfiguration().locale; 567 mLayoutDirection = LocaleUtil.getLayoutDirectionFromLocale(locale); 568 } 569 570 @Override 571 public void onConfigurationChanged(Configuration configuration) { 572 super.onConfigurationChanged(configuration); 573 mLayoutDirection = LocaleUtil.getLayoutDirectionFromLocale(configuration.locale); 574 } 575 576 /** 577 * Implement to return the implementation of the internal accessibility 578 * service interface. 579 */ 580 @Override 581 public final IBinder onBind(Intent intent) { 582 return new IAccessibilityServiceClientWrapper(this, getMainLooper(), new Callbacks() { 583 @Override 584 public void onServiceConnected() { 585 AccessibilityService.this.onServiceConnected(); 586 } 587 588 @Override 589 public void onInterrupt() { 590 AccessibilityService.this.onInterrupt(); 591 } 592 593 @Override 594 public void onAccessibilityEvent(AccessibilityEvent event) { 595 AccessibilityService.this.onAccessibilityEvent(event); 596 } 597 598 @Override 599 public void onSetConnectionId( int connectionId) { 600 mConnectionId = connectionId; 601 } 602 603 @Override 604 public void onGesture(int gestureId) { 605 AccessibilityService.this.onGesture(gestureId); 606 } 607 }); 608 } 609 610 /** 611 * Implements the internal {@link IAccessibilityServiceClient} interface to convert 612 * incoming calls to it back to calls on an {@link AccessibilityService}. 613 */ 614 static class IAccessibilityServiceClientWrapper extends IAccessibilityServiceClient.Stub 615 implements HandlerCaller.Callback { 616 617 static final int NO_ID = -1; 618 619 private static final int DO_SET_SET_CONNECTION = 10; 620 private static final int DO_ON_INTERRUPT = 20; 621 private static final int DO_ON_ACCESSIBILITY_EVENT = 30; 622 private static final int DO_ON_GESTURE = 40; 623 624 private final HandlerCaller mCaller; 625 626 private final Callbacks mCallback; 627 628 public IAccessibilityServiceClientWrapper(Context context, Looper looper, 629 Callbacks callback) { 630 mCallback = callback; 631 mCaller = new HandlerCaller(context, looper, this); 632 } 633 634 public void setConnection(IAccessibilityServiceConnection connection, int connectionId) { 635 Message message = mCaller.obtainMessageIO(DO_SET_SET_CONNECTION, connectionId, 636 connection); 637 mCaller.sendMessage(message); 638 } 639 640 public void onInterrupt() { 641 Message message = mCaller.obtainMessage(DO_ON_INTERRUPT); 642 mCaller.sendMessage(message); 643 } 644 645 public void onAccessibilityEvent(AccessibilityEvent event) { 646 Message message = mCaller.obtainMessageO(DO_ON_ACCESSIBILITY_EVENT, event); 647 mCaller.sendMessage(message); 648 } 649 650 public void onGesture(int gestureId) { 651 Message message = mCaller.obtainMessageI(DO_ON_GESTURE, gestureId); 652 mCaller.sendMessage(message); 653 } 654 655 public void executeMessage(Message message) { 656 switch (message.what) { 657 case DO_ON_ACCESSIBILITY_EVENT : 658 AccessibilityEvent event = (AccessibilityEvent) message.obj; 659 if (event != null) { 660 AccessibilityInteractionClient.getInstance().onAccessibilityEvent(event); 661 mCallback.onAccessibilityEvent(event); 662 event.recycle(); 663 } 664 return; 665 case DO_ON_INTERRUPT : 666 mCallback.onInterrupt(); 667 return; 668 case DO_SET_SET_CONNECTION : 669 final int connectionId = message.arg1; 670 IAccessibilityServiceConnection connection = 671 (IAccessibilityServiceConnection) message.obj; 672 if (connection != null) { 673 AccessibilityInteractionClient.getInstance().addConnection(connectionId, 674 connection); 675 mCallback.onSetConnectionId(connectionId); 676 mCallback.onServiceConnected(); 677 } else { 678 AccessibilityInteractionClient.getInstance().removeConnection(connectionId); 679 mCallback.onSetConnectionId(AccessibilityInteractionClient.NO_ID); 680 } 681 return; 682 case DO_ON_GESTURE : 683 final int gestureId = message.arg1; 684 mCallback.onGesture(gestureId); 685 return; 686 default : 687 Log.w(LOG_TAG, "Unknown message type " + message.what); 688 } 689 } 690 } 691} 692