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 } 215af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 216af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices.setValueAt(index, inputDevice); 217af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return inputDevice; 218af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 219af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 220af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 221af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 222cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Gets information about the input device with the specified descriptor. 223cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param descriptor The input device descriptor. 224cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @return The input device or null if not found. 225cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @hide 226cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown */ 227cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public InputDevice getInputDeviceByDescriptor(String descriptor) { 228cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (descriptor == null) { 229cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("descriptor must not be null."); 230cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 231cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 232cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown synchronized (mInputDevicesLock) { 233cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown populateInputDevicesLocked(); 234cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 235cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown int numDevices = mInputDevices.size(); 236cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown for (int i = 0; i < numDevices; i++) { 237cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown InputDevice inputDevice = mInputDevices.valueAt(i); 238cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (inputDevice == null) { 239cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown int id = mInputDevices.keyAt(i); 240cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown try { 241cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown inputDevice = mIm.getInputDevice(id); 242cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } catch (RemoteException ex) { 243cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown // Ignore the problem for the purposes of this method. 244cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown continue; 245cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 246cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown mInputDevices.setValueAt(i, inputDevice); 247cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 248cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (descriptor.equals(inputDevice.getDescriptor())) { 249cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown return inputDevice; 250cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 251cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 252cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown return null; 253cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 254cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 255cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 256cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown /** 257af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Gets the ids of all input devices in the system. 258af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @return The input device ids. 259af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 260af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public int[] getInputDeviceIds() { 261af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown synchronized (mInputDevicesLock) { 262af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown populateInputDevicesLocked(); 263af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 264af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int count = mInputDevices.size(); 265af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int[] ids = new int[count]; 266af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < count; i++) { 267af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown ids[i] = mInputDevices.keyAt(i); 268af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 269af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return ids; 270af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 271af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 272af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 273af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 274af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Registers an input device listener to receive notifications about when 275af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * input devices are added, removed or changed. 276af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 277af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param listener The listener to register. 278af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param handler The handler on which the listener should be invoked, or null 279af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * if the listener should be invoked on the calling thread's looper. 280af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 281af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @see #unregisterInputDeviceListener 282af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 283af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public void registerInputDeviceListener(InputDeviceListener listener, Handler handler) { 284af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (listener == null) { 285af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown throw new IllegalArgumentException("listener must not be null"); 286af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 287af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 288af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown synchronized (mInputDevicesLock) { 289af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown int index = findInputDeviceListenerLocked(listener); 290af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (index < 0) { 291af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDeviceListeners.add(new InputDeviceListenerDelegate(listener, handler)); 292af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 293af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 294af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 295af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 296af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 297af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Unregisters an input device listener. 298af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 299af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param listener The listener to unregister. 300af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 301af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @see #registerInputDeviceListener 302af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 303af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public void unregisterInputDeviceListener(InputDeviceListener listener) { 304af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (listener == null) { 305af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown throw new IllegalArgumentException("listener must not be null"); 306af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 307af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 308af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown synchronized (mInputDevicesLock) { 309af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown int index = findInputDeviceListenerLocked(listener); 310af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (index >= 0) { 3119e6d4b035d4f012d23264d3d2bc946b1ca02dba1Jeff Brown InputDeviceListenerDelegate d = mInputDeviceListeners.get(index); 3129e6d4b035d4f012d23264d3d2bc946b1ca02dba1Jeff Brown d.removeCallbacksAndMessages(null); 313af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDeviceListeners.remove(index); 314af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 315af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 316af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 317af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 318af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private int findInputDeviceListenerLocked(InputDeviceListener listener) { 319af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int numListeners = mInputDeviceListeners.size(); 320af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < numListeners; i++) { 321af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (mInputDeviceListeners.get(i).mListener == listener) { 322af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return i; 323af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 324af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 325af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return -1; 326af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 327af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 328af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 3299df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Gets information about all supported keyboard layouts. 3309df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <p> 3319df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * The input manager consults the built-in keyboard layouts as well 3329df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * as all keyboard layouts advertised by applications using a 3339df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * {@link #ACTION_QUERY_KEYBOARD_LAYOUTS} broadcast receiver. 3349df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </p> 3359df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3369df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @return A list of all supported keyboard layouts. 3379f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * 3389df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @hide 3399df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 3409f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public KeyboardLayout[] getKeyboardLayouts() { 3419f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown try { 3429f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return mIm.getKeyboardLayouts(); 3439f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } catch (RemoteException ex) { 3449f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown Log.w(TAG, "Could not get list of keyboard layout informations.", ex); 3459f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return new KeyboardLayout[0]; 3469df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3479df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3489df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 3499df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown /** 3509df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * Gets the keyboard layout with the specified descriptor. 3519df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3529df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @param keyboardLayoutDescriptor The keyboard layout descriptor, as returned by 3539df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * {@link KeyboardLayout#getDescriptor()}. 3549df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @return The keyboard layout, or null if it could not be loaded. 3559df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3569df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @hide 3579df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 3589df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown public KeyboardLayout getKeyboardLayout(String keyboardLayoutDescriptor) { 3599df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown if (keyboardLayoutDescriptor == null) { 3609df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown throw new IllegalArgumentException("keyboardLayoutDescriptor must not be null"); 3619df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3629df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 3639df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown try { 3649f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return mIm.getKeyboardLayout(keyboardLayoutDescriptor); 3659f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } catch (RemoteException ex) { 3669f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown Log.w(TAG, "Could not get keyboard layout information.", ex); 3679df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown return null; 3689df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3699df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3709df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 3719df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown /** 372cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Gets the current keyboard layout descriptor for the specified input device. 3739df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3749df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @param inputDeviceDescriptor The input device descriptor. 375cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @return The keyboard layout descriptor, or null if no keyboard layout has been set. 3769df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3779df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @hide 3789df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 379cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public String getCurrentKeyboardLayoutForInputDevice(String inputDeviceDescriptor) { 3809df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown if (inputDeviceDescriptor == null) { 3819df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown throw new IllegalArgumentException("inputDeviceDescriptor must not be null"); 3829df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3839df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 3849f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown try { 385cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown return mIm.getCurrentKeyboardLayoutForInputDevice(inputDeviceDescriptor); 3869f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } catch (RemoteException ex) { 387cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown Log.w(TAG, "Could not get current keyboard layout for input device.", ex); 3889f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return null; 3899f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } 3909df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 3919df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 3929df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown /** 393cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Sets the current keyboard layout descriptor for the specified input device. 3949df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * <p> 3959df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * This method may have the side-effect of causing the input device in question 3969df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * to be reconfigured. 3979df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * </p> 3989df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 3999df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @param inputDeviceDescriptor The input device descriptor. 400cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param keyboardLayoutDescriptor The keyboard layout descriptor to use, must not be null. 4019df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * 4029df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown * @hide 4039df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown */ 404cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public void setCurrentKeyboardLayoutForInputDevice(String inputDeviceDescriptor, 4059df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown String keyboardLayoutDescriptor) { 4069df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown if (inputDeviceDescriptor == null) { 4079df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown throw new IllegalArgumentException("inputDeviceDescriptor must not be null"); 4089df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 409cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (keyboardLayoutDescriptor == null) { 410cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("keyboardLayoutDescriptor must not be null"); 411cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 412cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 413cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown try { 414cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown mIm.setCurrentKeyboardLayoutForInputDevice(inputDeviceDescriptor, 415cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown keyboardLayoutDescriptor); 416cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } catch (RemoteException ex) { 417cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown Log.w(TAG, "Could not set current keyboard layout for input device.", ex); 418cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 419cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 420cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 421cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown /** 422cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Gets all keyboard layout descriptors that are enabled for the specified input device. 423cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 424cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param inputDeviceDescriptor The input device descriptor. 425cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @return The keyboard layout descriptors. 426cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 427cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @hide 428cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown */ 429cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public String[] getKeyboardLayoutsForInputDevice(String inputDeviceDescriptor) { 430cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (inputDeviceDescriptor == null) { 431cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("inputDeviceDescriptor must not be null"); 432cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 433cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 434cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown try { 435cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown return mIm.getKeyboardLayoutsForInputDevice(inputDeviceDescriptor); 436cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } catch (RemoteException ex) { 437cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown Log.w(TAG, "Could not get keyboard layouts for input device.", ex); 438cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown return ArrayUtils.emptyArray(String.class); 439cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 440cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 441cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 442cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown /** 443cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Adds the keyboard layout descriptor for the specified input device. 444cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * <p> 445cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * This method may have the side-effect of causing the input device in question 446cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * to be reconfigured. 447cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * </p> 448cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 449cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param inputDeviceDescriptor The input device descriptor. 450cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param keyboardLayoutDescriptor The descriptor of the keyboard layout to add. 451cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 452cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @hide 453cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown */ 454cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public void addKeyboardLayoutForInputDevice(String inputDeviceDescriptor, 455cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown String keyboardLayoutDescriptor) { 456cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (inputDeviceDescriptor == null) { 457cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("inputDeviceDescriptor must not be null"); 458cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 459cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (keyboardLayoutDescriptor == null) { 460cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("keyboardLayoutDescriptor must not be null"); 461cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 462cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 463cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown try { 464cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown mIm.addKeyboardLayoutForInputDevice(inputDeviceDescriptor, keyboardLayoutDescriptor); 465cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } catch (RemoteException ex) { 466cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown Log.w(TAG, "Could not add keyboard layout for input device.", ex); 467cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 468cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 469cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 470cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown /** 471cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Removes the keyboard layout descriptor for the specified input device. 472cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * <p> 473cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * This method may have the side-effect of causing the input device in question 474cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * to be reconfigured. 475cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * </p> 476cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 477cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param inputDeviceDescriptor The input device descriptor. 478cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @param keyboardLayoutDescriptor The descriptor of the keyboard layout to remove. 479cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * 480cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * @hide 481cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown */ 482cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public void removeKeyboardLayoutForInputDevice(String inputDeviceDescriptor, 483cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown String keyboardLayoutDescriptor) { 484cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (inputDeviceDescriptor == null) { 485cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("inputDeviceDescriptor must not be null"); 486cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 487cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown if (keyboardLayoutDescriptor == null) { 488cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown throw new IllegalArgumentException("keyboardLayoutDescriptor must not be null"); 489cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown } 4909df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 4919df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown try { 492cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown mIm.removeKeyboardLayoutForInputDevice(inputDeviceDescriptor, keyboardLayoutDescriptor); 4939f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown } catch (RemoteException ex) { 494cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown Log.w(TAG, "Could not remove keyboard layout for input device.", ex); 4959df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 4969df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown } 4979df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown 498ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 499ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Gets the mouse pointer speed. 500ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * <p> 501ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Only returns the permanent mouse pointer speed. Ignores any temporary pointer 502ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * speed set by {@link #tryPointerSpeed}. 503ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * </p> 504ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 5059f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * @param context The application context. 506ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @return The pointer speed as a value between {@link #MIN_POINTER_SPEED} and 507ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #MAX_POINTER_SPEED}, or the default value {@link #DEFAULT_POINTER_SPEED}. 508ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 509ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 510ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 5119f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public int getPointerSpeed(Context context) { 512ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown int speed = DEFAULT_POINTER_SPEED; 513ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown try { 5149f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown speed = Settings.System.getInt(context.getContentResolver(), 515ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown Settings.System.POINTER_SPEED); 516ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } catch (SettingNotFoundException snfe) { 517ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 518ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown return speed; 519ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 520ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 521ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 522ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Sets the mouse pointer speed. 523ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * <p> 524ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Requires {@link android.Manifest.permissions.WRITE_SETTINGS}. 525ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * </p> 526ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 5279f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown * @param context The application context. 528ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @param speed The pointer speed as a value between {@link #MIN_POINTER_SPEED} and 529ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #MAX_POINTER_SPEED}, or the default value {@link #DEFAULT_POINTER_SPEED}. 530ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 531ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 532ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 5339f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public void setPointerSpeed(Context context, int speed) { 534ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown if (speed < MIN_POINTER_SPEED || speed > MAX_POINTER_SPEED) { 535ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown throw new IllegalArgumentException("speed out of range"); 536ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 537ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 5389f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown Settings.System.putInt(context.getContentResolver(), 539ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown Settings.System.POINTER_SPEED, speed); 540ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 541ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 542ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 543ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Changes the mouse pointer speed temporarily, but does not save the setting. 544ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * <p> 545ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Requires {@link android.Manifest.permission.SET_POINTER_SPEED}. 546ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * </p> 547ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 548ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @param speed The pointer speed as a value between {@link #MIN_POINTER_SPEED} and 549ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #MAX_POINTER_SPEED}, or the default value {@link #DEFAULT_POINTER_SPEED}. 550ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 551ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 552ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 553ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public void tryPointerSpeed(int speed) { 554ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown if (speed < MIN_POINTER_SPEED || speed > MAX_POINTER_SPEED) { 555ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown throw new IllegalArgumentException("speed out of range"); 556ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 557ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 558ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown try { 5599f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown mIm.tryPointerSpeed(speed); 560ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } catch (RemoteException ex) { 561ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown Log.w(TAG, "Could not set temporary pointer speed.", ex); 562ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 563ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 564ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 565ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 566ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Queries the framework about whether any physical keys exist on the 567ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * any keyboard attached to the device that are capable of producing the given 568ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * array of key codes. 569ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 570ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @param keyCodes The array of key codes to query. 571ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @return A new array of the same size as the key codes array whose elements 572ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * are set to true if at least one attached keyboard supports the corresponding key code 573ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * at the same index in the key codes array. 574ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 575ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 576ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 5779f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public boolean[] deviceHasKeys(int[] keyCodes) { 578ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown boolean[] ret = new boolean[keyCodes.length]; 579ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown try { 5809f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown mIm.hasKeys(-1, InputDevice.SOURCE_ANY, keyCodes, ret); 581ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } catch (RemoteException e) { 582ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown // no fallback; just return the empty array 583ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 584ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown return ret; 585ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 586ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 587ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 588ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Injects an input event into the event system on behalf of an application. 589ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * The synchronization mode determines whether the method blocks while waiting for 590ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * input injection to proceed. 591ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * <p> 592ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Requires {@link android.Manifest.permission.INJECT_EVENTS} to inject into 593ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * windows that are owned by other applications. 594ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * </p><p> 595ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Make sure you correctly set the event time and input source of the event 596ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * before calling this method. 597ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * </p> 598ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 599ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @param event The event to inject. 600ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @param mode The synchronization mode. One of: 601ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #INJECT_INPUT_EVENT_MODE_ASYNC}, 602ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #INJECT_INPUT_EVENT_MODE_WAIT_FOR_RESULT}, or 603ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * {@link #INJECT_INPUT_EVENT_MODE_WAIT_FOR_FINISH}. 604ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @return True if input event injection succeeded. 605ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * 606ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * @hide 607ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 6089f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown public boolean injectInputEvent(InputEvent event, int mode) { 609ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown if (event == null) { 610ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown throw new IllegalArgumentException("event must not be null"); 611ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 612ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown if (mode != INJECT_INPUT_EVENT_MODE_ASYNC 613ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown && mode != INJECT_INPUT_EVENT_MODE_WAIT_FOR_FINISH 614ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown && mode != INJECT_INPUT_EVENT_MODE_WAIT_FOR_RESULT) { 615ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown throw new IllegalArgumentException("mode is invalid"); 616ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 617ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 618ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown try { 6199f25b7fdf216c9ef0bd2322cd223eeaf0d60f77fJeff Brown return mIm.injectInputEvent(event, mode); 620ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } catch (RemoteException ex) { 621ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown return false; 622ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 623ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown } 624af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 625af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private void populateInputDevicesLocked() { 626af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (mInputDevicesChangedListener == null) { 627af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final InputDevicesChangedListener listener = new InputDevicesChangedListener(); 628af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown try { 629af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mIm.registerInputDevicesChangedListener(listener); 630af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } catch (RemoteException ex) { 631af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown throw new RuntimeException( 632af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown "Could not get register input device changed listener", ex); 633af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 634af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevicesChangedListener = listener; 635af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 636af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 637af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (mInputDevices == null) { 638af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int[] ids; 639af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown try { 640af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown ids = mIm.getInputDeviceIds(); 641af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } catch (RemoteException ex) { 642af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown throw new RuntimeException("Could not get input device ids.", ex); 643af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 644af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 645af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices = new SparseArray<InputDevice>(); 646af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < ids.length; i++) { 647af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices.put(ids[i], null); 648af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 649af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 650af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 651af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 652af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private void onInputDevicesChanged(int[] deviceIdAndGeneration) { 653af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (DEBUG) { 654af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown Log.d(TAG, "Received input devices changed."); 655af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 656af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 657af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown synchronized (mInputDevicesLock) { 658af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = mInputDevices.size(); --i > 0; ) { 659af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int deviceId = mInputDevices.keyAt(i); 660af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (!containsDeviceId(deviceIdAndGeneration, deviceId)) { 661af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (DEBUG) { 662af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown Log.d(TAG, "Device removed: " + deviceId); 663af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 664af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices.removeAt(i); 665af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown sendMessageToInputDeviceListenersLocked(MSG_DEVICE_REMOVED, deviceId); 666af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 667af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 668af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 669af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < deviceIdAndGeneration.length; i += 2) { 670af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int deviceId = deviceIdAndGeneration[i]; 671af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown int index = mInputDevices.indexOfKey(deviceId); 672af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (index >= 0) { 673af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final InputDevice device = mInputDevices.valueAt(index); 674af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (device != null) { 675af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int generation = deviceIdAndGeneration[i + 1]; 676af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (device.getGeneration() != generation) { 677af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (DEBUG) { 678af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown Log.d(TAG, "Device changed: " + deviceId); 679af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 680af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices.setValueAt(index, null); 681af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown sendMessageToInputDeviceListenersLocked(MSG_DEVICE_CHANGED, deviceId); 682af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 683af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 684af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } else { 685af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (DEBUG) { 686af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown Log.d(TAG, "Device added: " + deviceId); 687af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 688af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mInputDevices.put(deviceId, null); 689af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown sendMessageToInputDeviceListenersLocked(MSG_DEVICE_ADDED, deviceId); 690af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 691af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 692af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 693af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 694af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 695af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private void sendMessageToInputDeviceListenersLocked(int what, int deviceId) { 696af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown final int numListeners = mInputDeviceListeners.size(); 697af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < numListeners; i++) { 698af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown InputDeviceListenerDelegate listener = mInputDeviceListeners.get(i); 699af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown listener.sendMessage(listener.obtainMessage(what, deviceId, 0)); 700af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 701af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 702af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 703af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private static boolean containsDeviceId(int[] deviceIdAndGeneration, int deviceId) { 704af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown for (int i = 0; i < deviceIdAndGeneration.length; i += 2) { 705af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown if (deviceIdAndGeneration[i] == deviceId) { 706af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return true; 707af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 708af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 709af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown return false; 710af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 711af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 712af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 713a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown * Gets a vibrator service associated with an input device, assuming it has one. 714a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown * @return The vibrator, never null. 715a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown * @hide 716a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown */ 717a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public Vibrator getInputDeviceVibrator(int deviceId) { 718a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown return new InputDeviceVibrator(deviceId); 719a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 720a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 721a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown /** 722af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Listens for changes in input devices. 723af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 724af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public interface InputDeviceListener { 725af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 726af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Called whenever an input device has been added to the system. 727af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Use {@link InputManager#getInputDevice} to get more information about the device. 728af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 729af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param deviceId The id of the input device that was added. 730af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 731af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown void onInputDeviceAdded(int deviceId); 732af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 733af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 734af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Called whenever an input device has been removed from the system. 735af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 736af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param deviceId The id of the input device that was removed. 737af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 738af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown void onInputDeviceRemoved(int deviceId); 739af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 740af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown /** 741af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * Called whenever the properties of an input device have changed since they 742af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * were last queried. Use {@link InputManager#getInputDevice} to get 743af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * a fresh {@link InputDevice} object with the new properties. 744af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * 745af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown * @param deviceId The id of the input device that changed. 746af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown */ 747af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown void onInputDeviceChanged(int deviceId); 748af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 749af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 750af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private final class InputDevicesChangedListener extends IInputDevicesChangedListener.Stub { 751af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown @Override 752af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public void onInputDevicesChanged(int[] deviceIdAndGeneration) throws RemoteException { 753af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown InputManager.this.onInputDevicesChanged(deviceIdAndGeneration); 754af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 755af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 756af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 757af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown private static final class InputDeviceListenerDelegate extends Handler { 758af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public final InputDeviceListener mListener; 759af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 760af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public InputDeviceListenerDelegate(InputDeviceListener listener, Handler handler) { 761af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown super(handler != null ? handler.getLooper() : Looper.myLooper()); 762af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mListener = listener; 763af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 764af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown 765af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown @Override 766af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown public void handleMessage(Message msg) { 767af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown switch (msg.what) { 768af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown case MSG_DEVICE_ADDED: 769af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mListener.onInputDeviceAdded(msg.arg1); 770af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown break; 771af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown case MSG_DEVICE_REMOVED: 772af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mListener.onInputDeviceRemoved(msg.arg1); 773af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown break; 774af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown case MSG_DEVICE_CHANGED: 775af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown mListener.onInputDeviceChanged(msg.arg1); 776af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown break; 777af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 778af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 779af9e8d38184c6ba4d2d3eb5bde7014a66dd8a78bJeff Brown } 780a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 781a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown private final class InputDeviceVibrator extends Vibrator { 782a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown private final int mDeviceId; 783a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown private final Binder mToken; 784a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 785a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public InputDeviceVibrator(int deviceId) { 786a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown mDeviceId = deviceId; 787a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown mToken = new Binder(); 788a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 789a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 790a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown @Override 791a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public boolean hasVibrator() { 792a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown return true; 793a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 794a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 795a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown @Override 796a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public void vibrate(long milliseconds) { 797a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown vibrate(new long[] { 0, milliseconds}, -1); 798a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 799a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 800a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown @Override 801a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public void vibrate(long[] pattern, int repeat) { 802a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown if (repeat >= pattern.length) { 803a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown throw new ArrayIndexOutOfBoundsException(); 804a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 805a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown try { 806a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown mIm.vibrate(mDeviceId, pattern, repeat, mToken); 807a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } catch (RemoteException ex) { 808a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown Log.w(TAG, "Failed to vibrate.", ex); 809a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 810a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 811a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown 812a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown @Override 813a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown public void cancel() { 814a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown try { 815a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown mIm.cancelVibrate(mDeviceId, mToken); 816a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } catch (RemoteException ex) { 817a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown Log.w(TAG, "Failed to cancel vibration.", ex); 818a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 819a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 820a47425a13c19f95057df78b8bb65bb25657e8753Jeff Brown } 8219df6e7a926ce480baf70e97ee1b9ea387193f6adJeff Brown} 822