InputManager.java revision 8f124842dd16125062f048257889c85380879b68
19df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown/* 29df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Copyright (C) 2012 The Android Open Source Project 39df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 49df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Licensed under the Apache License, Version 2.0 (the "License"); 59df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * you may not use this file except in compliance with the License. 69df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * You may obtain a copy of the License at 79df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 89df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * http://www.apache.org/licenses/LICENSE-2.0 99df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 109df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Unless required by applicable law or agreed to in writing, software 119df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * distributed under the License is distributed on an "AS IS" BASIS, 129df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * See the License for the specific language governing permissions and 149df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * limitations under the License. 159df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 169df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 179df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brownpackage android.hardware.input; 189df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 19cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brownimport com.android.internal.util.ArrayUtils; 20cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 219df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brownimport android.annotation.SdkConstant; 229df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brownimport android.annotation.SdkConstant.SdkConstantType; 239df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brownimport android.content.Context; 24a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brownimport android.os.Binder; 25af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brownimport android.os.Handler; 26ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brownimport android.os.IBinder; 27af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brownimport android.os.Looper; 28af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brownimport android.os.Message; 29ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brownimport android.os.RemoteException; 30ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brownimport android.os.ServiceManager; 31a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brownimport android.os.Vibrator; 32ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brownimport android.provider.Settings; 33ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brownimport android.provider.Settings.SettingNotFoundException; 349df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brownimport android.util.Log; 359f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brownimport android.util.SparseArray; 36ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brownimport android.view.InputDevice; 37ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brownimport android.view.InputEvent; 389df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 39af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brownimport java.util.ArrayList; 40af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 419df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown/** 429df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Provides information about input devices and available key layouts. 439df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <p> 449df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Get an instance of this class by calling 459df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * {@link android.content.Context#getSystemService(java.lang.String) 469df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Context.getSystemService()} with the argument 479df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * {@link android.content.Context#INPUT_SERVICE}. 489df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </p> 499df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 509df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brownpublic final class InputManager { 519df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown private static final String TAG = "InputManager"; 52af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private static final boolean DEBUG = false; 53af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 54af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private static final int MSG_DEVICE_ADDED = 1; 55af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private static final int MSG_DEVICE_REMOVED = 2; 56af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private static final int MSG_DEVICE_CHANGED = 3; 579df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 589f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown private static InputManager sInstance; 599df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 609f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown private final IInputManager mIm; 61af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 62af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown // Guarded by mInputDevicesLock 63af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private final Object mInputDevicesLock = new Object(); 64af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private SparseArray<InputDevice> mInputDevices; 65af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private InputDevicesChangedListener mInputDevicesChangedListener; 66af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private final ArrayList<InputDeviceListenerDelegate> mInputDeviceListeners = 67af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown new ArrayList<InputDeviceListenerDelegate>(); 689df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 699df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown /** 709df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Broadcast Action: Query available keyboard layouts. 719df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <p> 729df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * The input manager service locates available keyboard layouts 739df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * by querying broadcast receivers that are registered for this action. 749df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * An application can offer additional keyboard layouts to the user 759df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * by declaring a suitable broadcast receiver in its manifest. 769df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </p><p> 779df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Here is an example broadcast receiver declaration that an application 789df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * might include in its AndroidManifest.xml to advertise keyboard layouts. 799df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * The meta-data specifies a resource that contains a description of each keyboard 809df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * layout that is provided by the application. 819df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <pre><code> 82d9fec5d317c09da6bcc7a54df4e0190a76d21eaeJeff Brown * <receiver android:name=".InputDeviceReceiver" 83d9fec5d317c09da6bcc7a54df4e0190a76d21eaeJeff Brown * android:label="@string/keyboard_layouts_label"> 849df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <intent-filter> 859df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <action android:name="android.hardware.input.action.QUERY_KEYBOARD_LAYOUTS" /> 869df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </intent-filter> 879df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <meta-data android:name="android.hardware.input.metadata.KEYBOARD_LAYOUTS" 889df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * android:resource="@xml/keyboard_layouts" /> 899df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </receiver> 909df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </code></pre> 919df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </p><p> 929df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * In the above example, the <code>@xml/keyboard_layouts</code> resource refers to 939df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * an XML resource whose root element is <code><keyboard-layouts></code> that 949df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * contains zero or more <code><keyboard-layout></code> elements. 959df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Each <code><keyboard-layout></code> element specifies the name, label, and location 96d9fec5d317c09da6bcc7a54df4e0190a76d21eaeJeff Brown * of a key character map for a particular keyboard layout. The label on the receiver 97d9fec5d317c09da6bcc7a54df4e0190a76d21eaeJeff Brown * is used to name the collection of keyboard layouts provided by this receiver in the 98d9fec5d317c09da6bcc7a54df4e0190a76d21eaeJeff Brown * keyboard layout settings. 999df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <pre></code> 1009df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <?xml version="1.0" encoding="utf-8"?> 1019df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <keyboard-layouts xmlns:android="http://schemas.android.com/apk/res/android"> 1029df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <keyboard-layout android:name="keyboard_layout_english_us" 1039df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * android:label="@string/keyboard_layout_english_us_label" 1042f0957607411b99810226ad38d59cf18718b86d0Jeff Brown * android:keyboardLayout="@raw/keyboard_layout_english_us" /> 1059df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </keyboard-layouts> 1069df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </p><p> 1079df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * The <code>android:name</code> attribute specifies an identifier by which 1089df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * the keyboard layout will be known in the package. 1099df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * The <code>android:label</code> attributes specifies a human-readable descriptive 1109df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * label to describe the keyboard layout in the user interface, such as "English (US)". 1112f0957607411b99810226ad38d59cf18718b86d0Jeff Brown * The <code>android:keyboardLayout</code> attribute refers to a 1129df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <a href="http://source.android.com/tech/input/key-character-map-files.html"> 1139df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * key character map</a> resource that defines the keyboard layout. 1149df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </p> 1159df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 1169df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1179df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown public static final String ACTION_QUERY_KEYBOARD_LAYOUTS = 1189df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown "android.hardware.input.action.QUERY_KEYBOARD_LAYOUTS"; 1199df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 1209df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown /** 1219df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Metadata Key: Keyboard layout metadata associated with 1229df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * {@link #ACTION_QUERY_KEYBOARD_LAYOUTS}. 1239df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <p> 1249df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Specifies the resource id of a XML resource that describes the keyboard 1259df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * layouts that are provided by the application. 1269df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </p> 1279df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 1289df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown public static final String META_DATA_KEYBOARD_LAYOUTS = 1299df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown "android.hardware.input.metadata.KEYBOARD_LAYOUTS"; 1309df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 131ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 132ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Pointer Speed: The minimum (slowest) pointer speed (-7). 133ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 134ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 135ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public static final int MIN_POINTER_SPEED = -7; 136ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 137ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 138ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Pointer Speed: The maximum (fastest) pointer speed (7). 139ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 140ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 141ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public static final int MAX_POINTER_SPEED = 7; 142ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 143ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 144ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Pointer Speed: The default pointer speed (0). 145ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 146ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 147ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public static final int DEFAULT_POINTER_SPEED = 0; 148ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 149ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 150ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Input Event Injection Synchronization Mode: None. 151ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Never blocks. Injection is asynchronous and is assumed always to be successful. 152ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 153ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 154ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public static final int INJECT_INPUT_EVENT_MODE_ASYNC = 0; // see InputDispatcher.h 155ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 156ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 157ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Input Event Injection Synchronization Mode: Wait for result. 158ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Waits for previous events to be dispatched so that the input dispatcher can 159ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * determine whether input event injection will be permitted based on the current 160ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * input focus. Does not wait for the input event to finish being handled 161ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * by the application. 162ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 163ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 164ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public static final int INJECT_INPUT_EVENT_MODE_WAIT_FOR_RESULT = 1; // see InputDispatcher.h 165ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 166ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 167ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Input Event Injection Synchronization Mode: Wait for finish. 168ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Waits for the event to be delivered to the application and handled. 169ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 170ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 171ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public static final int INJECT_INPUT_EVENT_MODE_WAIT_FOR_FINISH = 2; // see InputDispatcher.h 172ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 1739f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown private InputManager(IInputManager im) { 1749f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown mIm = im; 175ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 176ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 1779f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown /** 1789f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * Gets an instance of the input manager. 1799f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * 1809f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * @return The input manager instance. 1819f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * 1829f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * @hide 1839f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown */ 1849f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public static InputManager getInstance() { 1859f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown synchronized (InputManager.class) { 1869f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown if (sInstance == null) { 1879f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown IBinder b = ServiceManager.getService(Context.INPUT_SERVICE); 1889f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown sInstance = new InputManager(IInputManager.Stub.asInterface(b)); 1899f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } 1909f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return sInstance; 1919f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } 1929df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 1939df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 1949df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown /** 195af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Gets information about the input device with the specified id. 196af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param id The device id. 197af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @return The input device or null if not found. 198af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 199af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public InputDevice getInputDevice(int id) { 200af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown synchronized (mInputDevicesLock) { 201af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown populateInputDevicesLocked(); 202af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 203af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown int index = mInputDevices.indexOfKey(id); 204af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (index < 0) { 205af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return null; 206af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 207af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 208af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown InputDevice inputDevice = mInputDevices.valueAt(index); 209af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (inputDevice == null) { 210af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown try { 211af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown inputDevice = mIm.getInputDevice(id); 212af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } catch (RemoteException ex) { 213af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown throw new RuntimeException("Could not get input device information.", ex); 214af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 2158f124842dd16125062f048257889c85380879b68Jeff Brown if (inputDevice != null) { 2168f124842dd16125062f048257889c85380879b68Jeff Brown mInputDevices.setValueAt(index, inputDevice); 2178f124842dd16125062f048257889c85380879b68Jeff Brown } 218af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 219af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return inputDevice; 220af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 221af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 222af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 223af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 224cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Gets information about the input device with the specified descriptor. 225cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param descriptor The input device descriptor. 226cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @return The input device or null if not found. 227cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @hide 228cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown */ 229cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public InputDevice getInputDeviceByDescriptor(String descriptor) { 230cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (descriptor == null) { 231cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("descriptor must not be null."); 232cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 233cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 234cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown synchronized (mInputDevicesLock) { 235cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown populateInputDevicesLocked(); 236cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 237cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown int numDevices = mInputDevices.size(); 238cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown for (int i = 0; i < numDevices; i++) { 239cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown InputDevice inputDevice = mInputDevices.valueAt(i); 240cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (inputDevice == null) { 241cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown int id = mInputDevices.keyAt(i); 242cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown try { 243cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown inputDevice = mIm.getInputDevice(id); 244cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } catch (RemoteException ex) { 245cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown // Ignore the problem for the purposes of this method. 2468f124842dd16125062f048257889c85380879b68Jeff Brown } 2478f124842dd16125062f048257889c85380879b68Jeff Brown if (inputDevice == null) { 248cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown continue; 249cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 250cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown mInputDevices.setValueAt(i, inputDevice); 251cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 252cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (descriptor.equals(inputDevice.getDescriptor())) { 253cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown return inputDevice; 254cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 255cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 256cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown return null; 257cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 258cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 259cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 260cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown /** 261af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Gets the ids of all input devices in the system. 262af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @return The input device ids. 263af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 264af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public int[] getInputDeviceIds() { 265af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown synchronized (mInputDevicesLock) { 266af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown populateInputDevicesLocked(); 267af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 268af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int count = mInputDevices.size(); 269af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int[] ids = new int[count]; 270af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < count; i++) { 271af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown ids[i] = mInputDevices.keyAt(i); 272af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 273af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return ids; 274af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 275af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 276af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 277af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 278af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Registers an input device listener to receive notifications about when 279af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * input devices are added, removed or changed. 280af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 281af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param listener The listener to register. 282af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param handler The handler on which the listener should be invoked, or null 283af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * if the listener should be invoked on the calling thread's looper. 284af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 285af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @see #unregisterInputDeviceListener 286af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 287af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public void registerInputDeviceListener(InputDeviceListener listener, Handler handler) { 288af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (listener == null) { 289af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown throw new IllegalArgumentException("listener must not be null"); 290af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 291af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 292af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown synchronized (mInputDevicesLock) { 293af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown int index = findInputDeviceListenerLocked(listener); 294af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (index < 0) { 295af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDeviceListeners.add(new InputDeviceListenerDelegate(listener, handler)); 296af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 297af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 298af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 299af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 300af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 301af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Unregisters an input device listener. 302af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 303af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param listener The listener to unregister. 304af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 305af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @see #registerInputDeviceListener 306af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 307af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public void unregisterInputDeviceListener(InputDeviceListener listener) { 308af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (listener == null) { 309af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown throw new IllegalArgumentException("listener must not be null"); 310af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 311af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 312af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown synchronized (mInputDevicesLock) { 313af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown int index = findInputDeviceListenerLocked(listener); 314af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (index >= 0) { 3159e6d4b035d4f012d23264d3d2bc946b1ca02dba1Jeff Brown InputDeviceListenerDelegate d = mInputDeviceListeners.get(index); 3169e6d4b035d4f012d23264d3d2bc946b1ca02dba1Jeff Brown d.removeCallbacksAndMessages(null); 317af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDeviceListeners.remove(index); 318af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 319af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 320af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 321af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 322af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private int findInputDeviceListenerLocked(InputDeviceListener listener) { 323af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int numListeners = mInputDeviceListeners.size(); 324af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < numListeners; i++) { 325af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (mInputDeviceListeners.get(i).mListener == listener) { 326af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return i; 327af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 328af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 329af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return -1; 330af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 331af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 332af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 3339df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Gets information about all supported keyboard layouts. 3349df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <p> 3359df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * The input manager consults the built-in keyboard layouts as well 3369df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * as all keyboard layouts advertised by applications using a 3379df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * {@link #ACTION_QUERY_KEYBOARD_LAYOUTS} broadcast receiver. 3389df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </p> 3399df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3409df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @return A list of all supported keyboard layouts. 3419f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * 3429df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @hide 3439df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 3449f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public KeyboardLayout[] getKeyboardLayouts() { 3459f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown try { 3469f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return mIm.getKeyboardLayouts(); 3479f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } catch (RemoteException ex) { 3489f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown Log.w(TAG, "Could not get list of keyboard layout informations.", ex); 3499f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return new KeyboardLayout[0]; 3509df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3519df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3529df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 3539df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown /** 3549df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Gets the keyboard layout with the specified descriptor. 3559df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3569df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @param keyboardLayoutDescriptor The keyboard layout descriptor, as returned by 3579df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * {@link KeyboardLayout#getDescriptor()}. 3589df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @return The keyboard layout, or null if it could not be loaded. 3599df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3609df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @hide 3619df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 3629df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown public KeyboardLayout getKeyboardLayout(String keyboardLayoutDescriptor) { 3639df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown if (keyboardLayoutDescriptor == null) { 3649df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown throw new IllegalArgumentException("keyboardLayoutDescriptor must not be null"); 3659df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3669df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 3679df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown try { 3689f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return mIm.getKeyboardLayout(keyboardLayoutDescriptor); 3699f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } catch (RemoteException ex) { 3709f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown Log.w(TAG, "Could not get keyboard layout information.", ex); 3719df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown return null; 3729df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3739df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3749df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 3759df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown /** 376cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Gets the current keyboard layout descriptor for the specified input device. 3779df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3789df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @param inputDeviceDescriptor The input device descriptor. 379cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @return The keyboard layout descriptor, or null if no keyboard layout has been set. 3809df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3819df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @hide 3829df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 383cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public String getCurrentKeyboardLayoutForInputDevice(String inputDeviceDescriptor) { 3849df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown if (inputDeviceDescriptor == null) { 3859df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown throw new IllegalArgumentException("inputDeviceDescriptor must not be null"); 3869df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3879df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 3889f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown try { 389cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown return mIm.getCurrentKeyboardLayoutForInputDevice(inputDeviceDescriptor); 3909f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } catch (RemoteException ex) { 391cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown Log.w(TAG, "Could not get current keyboard layout for input device.", ex); 3929f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return null; 3939f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } 3949df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3959df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 3969df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown /** 397cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Sets the current keyboard layout descriptor for the specified input device. 3989df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <p> 3999df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * This method may have the side-effect of causing the input device in question 4009df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * to be reconfigured. 4019df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </p> 4029df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 4039df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @param inputDeviceDescriptor The input device descriptor. 404cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param keyboardLayoutDescriptor The keyboard layout descriptor to use, must not be null. 4059df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 4069df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @hide 4079df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 408cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public void setCurrentKeyboardLayoutForInputDevice(String inputDeviceDescriptor, 4099df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown String keyboardLayoutDescriptor) { 4109df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown if (inputDeviceDescriptor == null) { 4119df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown throw new IllegalArgumentException("inputDeviceDescriptor must not be null"); 4129df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 413cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (keyboardLayoutDescriptor == null) { 414cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("keyboardLayoutDescriptor must not be null"); 415cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 416cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 417cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown try { 418cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown mIm.setCurrentKeyboardLayoutForInputDevice(inputDeviceDescriptor, 419cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown keyboardLayoutDescriptor); 420cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } catch (RemoteException ex) { 421cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown Log.w(TAG, "Could not set current keyboard layout for input device.", ex); 422cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 423cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 424cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 425cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown /** 426cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Gets all keyboard layout descriptors that are enabled for the specified input device. 427cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 428cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param inputDeviceDescriptor The input device descriptor. 429cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @return The keyboard layout descriptors. 430cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 431cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @hide 432cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown */ 433cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public String[] getKeyboardLayoutsForInputDevice(String inputDeviceDescriptor) { 434cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (inputDeviceDescriptor == null) { 435cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("inputDeviceDescriptor must not be null"); 436cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 437cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 438cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown try { 439cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown return mIm.getKeyboardLayoutsForInputDevice(inputDeviceDescriptor); 440cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } catch (RemoteException ex) { 441cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown Log.w(TAG, "Could not get keyboard layouts for input device.", ex); 442cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown return ArrayUtils.emptyArray(String.class); 443cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 444cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 445cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 446cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown /** 447cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Adds the keyboard layout descriptor for the specified input device. 448cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * <p> 449cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * This method may have the side-effect of causing the input device in question 450cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * to be reconfigured. 451cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * </p> 452cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 453cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param inputDeviceDescriptor The input device descriptor. 454cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param keyboardLayoutDescriptor The descriptor of the keyboard layout to add. 455cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 456cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @hide 457cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown */ 458cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public void addKeyboardLayoutForInputDevice(String inputDeviceDescriptor, 459cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown String keyboardLayoutDescriptor) { 460cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (inputDeviceDescriptor == null) { 461cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("inputDeviceDescriptor must not be null"); 462cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 463cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (keyboardLayoutDescriptor == null) { 464cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("keyboardLayoutDescriptor must not be null"); 465cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 466cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 467cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown try { 468cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown mIm.addKeyboardLayoutForInputDevice(inputDeviceDescriptor, keyboardLayoutDescriptor); 469cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } catch (RemoteException ex) { 470cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown Log.w(TAG, "Could not add keyboard layout for input device.", ex); 471cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 472cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 473cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 474cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown /** 475cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Removes the keyboard layout descriptor for the specified input device. 476cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * <p> 477cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * This method may have the side-effect of causing the input device in question 478cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * to be reconfigured. 479cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * </p> 480cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 481cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param inputDeviceDescriptor The input device descriptor. 482cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param keyboardLayoutDescriptor The descriptor of the keyboard layout to remove. 483cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 484cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @hide 485cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown */ 486cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public void removeKeyboardLayoutForInputDevice(String inputDeviceDescriptor, 487cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown String keyboardLayoutDescriptor) { 488cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (inputDeviceDescriptor == null) { 489cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("inputDeviceDescriptor must not be null"); 490cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 491cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (keyboardLayoutDescriptor == null) { 492cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("keyboardLayoutDescriptor must not be null"); 493cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 4949df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 4959df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown try { 496cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown mIm.removeKeyboardLayoutForInputDevice(inputDeviceDescriptor, keyboardLayoutDescriptor); 4979f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } catch (RemoteException ex) { 498cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown Log.w(TAG, "Could not remove keyboard layout for input device.", ex); 4999df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 5009df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 5019df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 502ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 503ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Gets the mouse pointer speed. 504ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * <p> 505ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Only returns the permanent mouse pointer speed. Ignores any temporary pointer 506ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * speed set by {@link #tryPointerSpeed}. 507ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * </p> 508ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 5099f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * @param context The application context. 510ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @return The pointer speed as a value between {@link #MIN_POINTER_SPEED} and 511ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #MAX_POINTER_SPEED}, or the default value {@link #DEFAULT_POINTER_SPEED}. 512ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 513ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 514ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 5159f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public int getPointerSpeed(Context context) { 516ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown int speed = DEFAULT_POINTER_SPEED; 517ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown try { 5189f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown speed = Settings.System.getInt(context.getContentResolver(), 519ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown Settings.System.POINTER_SPEED); 520ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } catch (SettingNotFoundException snfe) { 521ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 522ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown return speed; 523ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 524ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 525ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 526ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Sets the mouse pointer speed. 527ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * <p> 528ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Requires {@link android.Manifest.permissions.WRITE_SETTINGS}. 529ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * </p> 530ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 5319f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * @param context The application context. 532ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @param speed The pointer speed as a value between {@link #MIN_POINTER_SPEED} and 533ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #MAX_POINTER_SPEED}, or the default value {@link #DEFAULT_POINTER_SPEED}. 534ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 535ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 536ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 5379f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public void setPointerSpeed(Context context, int speed) { 538ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown if (speed < MIN_POINTER_SPEED || speed > MAX_POINTER_SPEED) { 539ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown throw new IllegalArgumentException("speed out of range"); 540ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 541ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 5429f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown Settings.System.putInt(context.getContentResolver(), 543ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown Settings.System.POINTER_SPEED, speed); 544ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 545ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 546ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 547ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Changes the mouse pointer speed temporarily, but does not save the setting. 548ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * <p> 549ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Requires {@link android.Manifest.permission.SET_POINTER_SPEED}. 550ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * </p> 551ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 552ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @param speed The pointer speed as a value between {@link #MIN_POINTER_SPEED} and 553ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #MAX_POINTER_SPEED}, or the default value {@link #DEFAULT_POINTER_SPEED}. 554ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 555ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 556ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 557ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public void tryPointerSpeed(int speed) { 558ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown if (speed < MIN_POINTER_SPEED || speed > MAX_POINTER_SPEED) { 559ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown throw new IllegalArgumentException("speed out of range"); 560ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 561ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 562ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown try { 5639f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown mIm.tryPointerSpeed(speed); 564ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } catch (RemoteException ex) { 565ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown Log.w(TAG, "Could not set temporary pointer speed.", ex); 566ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 567ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 568ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 569ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 570ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Queries the framework about whether any physical keys exist on the 571ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * any keyboard attached to the device that are capable of producing the given 572ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * array of key codes. 573ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 574ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @param keyCodes The array of key codes to query. 575ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @return A new array of the same size as the key codes array whose elements 576ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * are set to true if at least one attached keyboard supports the corresponding key code 577ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * at the same index in the key codes array. 578ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 579ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 580ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 5819f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public boolean[] deviceHasKeys(int[] keyCodes) { 582ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown boolean[] ret = new boolean[keyCodes.length]; 583ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown try { 5849f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown mIm.hasKeys(-1, InputDevice.SOURCE_ANY, keyCodes, ret); 585ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } catch (RemoteException e) { 586ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown // no fallback; just return the empty array 587ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 588ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown return ret; 589ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 590ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 591ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 592ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Injects an input event into the event system on behalf of an application. 593ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * The synchronization mode determines whether the method blocks while waiting for 594ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * input injection to proceed. 595ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * <p> 596ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Requires {@link android.Manifest.permission.INJECT_EVENTS} to inject into 597ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * windows that are owned by other applications. 598ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * </p><p> 599ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Make sure you correctly set the event time and input source of the event 600ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * before calling this method. 601ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * </p> 602ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 603ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @param event The event to inject. 604ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @param mode The synchronization mode. One of: 605ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #INJECT_INPUT_EVENT_MODE_ASYNC}, 606ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #INJECT_INPUT_EVENT_MODE_WAIT_FOR_RESULT}, or 607ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #INJECT_INPUT_EVENT_MODE_WAIT_FOR_FINISH}. 608ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @return True if input event injection succeeded. 609ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 610ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 611ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 6129f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public boolean injectInputEvent(InputEvent event, int mode) { 613ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown if (event == null) { 614ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown throw new IllegalArgumentException("event must not be null"); 615ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 616ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown if (mode != INJECT_INPUT_EVENT_MODE_ASYNC 617ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown && mode != INJECT_INPUT_EVENT_MODE_WAIT_FOR_FINISH 618ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown && mode != INJECT_INPUT_EVENT_MODE_WAIT_FOR_RESULT) { 619ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown throw new IllegalArgumentException("mode is invalid"); 620ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 621ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 622ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown try { 6239f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return mIm.injectInputEvent(event, mode); 624ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } catch (RemoteException ex) { 625ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown return false; 626ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 627ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 628af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 629af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private void populateInputDevicesLocked() { 630af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (mInputDevicesChangedListener == null) { 631af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final InputDevicesChangedListener listener = new InputDevicesChangedListener(); 632af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown try { 633af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mIm.registerInputDevicesChangedListener(listener); 634af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } catch (RemoteException ex) { 635af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown throw new RuntimeException( 636af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown "Could not get register input device changed listener", ex); 637af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 638af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevicesChangedListener = listener; 639af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 640af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 641af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (mInputDevices == null) { 642af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int[] ids; 643af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown try { 644af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown ids = mIm.getInputDeviceIds(); 645af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } catch (RemoteException ex) { 646af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown throw new RuntimeException("Could not get input device ids.", ex); 647af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 648af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 649af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices = new SparseArray<InputDevice>(); 650af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < ids.length; i++) { 651af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices.put(ids[i], null); 652af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 653af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 654af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 655af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 656af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private void onInputDevicesChanged(int[] deviceIdAndGeneration) { 657af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (DEBUG) { 658af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown Log.d(TAG, "Received input devices changed."); 659af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 660af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 661af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown synchronized (mInputDevicesLock) { 662af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = mInputDevices.size(); --i > 0; ) { 663af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int deviceId = mInputDevices.keyAt(i); 664af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (!containsDeviceId(deviceIdAndGeneration, deviceId)) { 665af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (DEBUG) { 666af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown Log.d(TAG, "Device removed: " + deviceId); 667af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 668af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices.removeAt(i); 669af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown sendMessageToInputDeviceListenersLocked(MSG_DEVICE_REMOVED, deviceId); 670af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 671af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 672af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 673af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < deviceIdAndGeneration.length; i += 2) { 674af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int deviceId = deviceIdAndGeneration[i]; 675af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown int index = mInputDevices.indexOfKey(deviceId); 676af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (index >= 0) { 677af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final InputDevice device = mInputDevices.valueAt(index); 678af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (device != null) { 679af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int generation = deviceIdAndGeneration[i + 1]; 680af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (device.getGeneration() != generation) { 681af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (DEBUG) { 682af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown Log.d(TAG, "Device changed: " + deviceId); 683af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 684af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices.setValueAt(index, null); 685af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown sendMessageToInputDeviceListenersLocked(MSG_DEVICE_CHANGED, deviceId); 686af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 687af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 688af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } else { 689af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (DEBUG) { 690af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown Log.d(TAG, "Device added: " + deviceId); 691af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 692af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices.put(deviceId, null); 693af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown sendMessageToInputDeviceListenersLocked(MSG_DEVICE_ADDED, deviceId); 694af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 695af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 696af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 697af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 698af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 699af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private void sendMessageToInputDeviceListenersLocked(int what, int deviceId) { 700af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int numListeners = mInputDeviceListeners.size(); 701af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < numListeners; i++) { 702af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown InputDeviceListenerDelegate listener = mInputDeviceListeners.get(i); 703af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown listener.sendMessage(listener.obtainMessage(what, deviceId, 0)); 704af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 705af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 706af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 707af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private static boolean containsDeviceId(int[] deviceIdAndGeneration, int deviceId) { 708af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < deviceIdAndGeneration.length; i += 2) { 709af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (deviceIdAndGeneration[i] == deviceId) { 710af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return true; 711af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 712af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 713af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return false; 714af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 715af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 716af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 717a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown * Gets a vibrator service associated with an input device, assuming it has one. 718a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown * @return The vibrator, never null. 719a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown * @hide 720a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown */ 721a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public Vibrator getInputDeviceVibrator(int deviceId) { 722a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown return new InputDeviceVibrator(deviceId); 723a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 724a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 725a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown /** 726af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Listens for changes in input devices. 727af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 728af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public interface InputDeviceListener { 729af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 730af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Called whenever an input device has been added to the system. 731af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Use {@link InputManager#getInputDevice} to get more information about the device. 732af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 733af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param deviceId The id of the input device that was added. 734af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 735af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown void onInputDeviceAdded(int deviceId); 736af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 737af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 738af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Called whenever an input device has been removed from the system. 739af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 740af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param deviceId The id of the input device that was removed. 741af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 742af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown void onInputDeviceRemoved(int deviceId); 743af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 744af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 745af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Called whenever the properties of an input device have changed since they 746af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * were last queried. Use {@link InputManager#getInputDevice} to get 747af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * a fresh {@link InputDevice} object with the new properties. 748af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 749af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param deviceId The id of the input device that changed. 750af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 751af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown void onInputDeviceChanged(int deviceId); 752af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 753af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 754af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private final class InputDevicesChangedListener extends IInputDevicesChangedListener.Stub { 755af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown @Override 756af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public void onInputDevicesChanged(int[] deviceIdAndGeneration) throws RemoteException { 757af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown InputManager.this.onInputDevicesChanged(deviceIdAndGeneration); 758af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 759af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 760af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 761af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private static final class InputDeviceListenerDelegate extends Handler { 762af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public final InputDeviceListener mListener; 763af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 764af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public InputDeviceListenerDelegate(InputDeviceListener listener, Handler handler) { 765af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown super(handler != null ? handler.getLooper() : Looper.myLooper()); 766af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mListener = listener; 767af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 768af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 769af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown @Override 770af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public void handleMessage(Message msg) { 771af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown switch (msg.what) { 772af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown case MSG_DEVICE_ADDED: 773af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mListener.onInputDeviceAdded(msg.arg1); 774af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown break; 775af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown case MSG_DEVICE_REMOVED: 776af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mListener.onInputDeviceRemoved(msg.arg1); 777af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown break; 778af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown case MSG_DEVICE_CHANGED: 779af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mListener.onInputDeviceChanged(msg.arg1); 780af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown break; 781af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 782af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 783af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 784a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 785a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown private final class InputDeviceVibrator extends Vibrator { 786a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown private final int mDeviceId; 787a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown private final Binder mToken; 788a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 789a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public InputDeviceVibrator(int deviceId) { 790a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown mDeviceId = deviceId; 791a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown mToken = new Binder(); 792a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 793a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 794a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown @Override 795a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public boolean hasVibrator() { 796a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown return true; 797a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 798a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 799a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown @Override 800a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public void vibrate(long milliseconds) { 801a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown vibrate(new long[] { 0, milliseconds}, -1); 802a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 803a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 804a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown @Override 805a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public void vibrate(long[] pattern, int repeat) { 806a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown if (repeat >= pattern.length) { 807a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown throw new ArrayIndexOutOfBoundsException(); 808a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 809a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown try { 810a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown mIm.vibrate(mDeviceId, pattern, repeat, mToken); 811a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } catch (RemoteException ex) { 812a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown Log.w(TAG, "Failed to vibrate.", ex); 813a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 814a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 815a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 816a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown @Override 817a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public void cancel() { 818a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown try { 819a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown mIm.cancelVibrate(mDeviceId, mToken); 820a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } catch (RemoteException ex) { 821a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown Log.w(TAG, "Failed to cancel vibration.", ex); 822a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 823a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 824a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 8259df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown} 826