141 lines
4.3 KiB
Java
141 lines
4.3 KiB
Java
/*
|
|
* Copyright (C) 2013 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package org.godotengine.godot.input;
|
|
|
|
import android.content.Context;
|
|
import android.os.Build;
|
|
import android.os.Handler;
|
|
import android.view.InputDevice;
|
|
import android.view.MotionEvent;
|
|
|
|
public interface InputManagerCompat {
|
|
/**
|
|
* Gets information about the input device with the specified id.
|
|
*
|
|
* @param id The device id
|
|
* @return The input device or null if not found
|
|
*/
|
|
public InputDevice getInputDevice(int id);
|
|
|
|
/**
|
|
* Gets the ids of all input devices in the system.
|
|
*
|
|
* @return The input device ids.
|
|
*/
|
|
public int[] getInputDeviceIds();
|
|
|
|
/**
|
|
* Registers an input device listener to receive notifications about when
|
|
* input devices are added, removed or changed.
|
|
*
|
|
* @param listener The listener to register.
|
|
* @param handler The handler on which the listener should be invoked, or
|
|
* null if the listener should be invoked on the calling thread's
|
|
* looper.
|
|
*/
|
|
public void registerInputDeviceListener(InputManagerCompat.InputDeviceListener listener,
|
|
Handler handler);
|
|
|
|
/**
|
|
* Unregisters an input device listener.
|
|
*
|
|
* @param listener The listener to unregister.
|
|
*/
|
|
public void unregisterInputDeviceListener(InputManagerCompat.InputDeviceListener listener);
|
|
|
|
/*
|
|
* The following three calls are to simulate V16 behavior on pre-Jellybean
|
|
* devices. If you don't call them, your callback will never be called
|
|
* pre-API 16.
|
|
*/
|
|
|
|
/**
|
|
* Pass the motion events to the InputManagerCompat. This is used to
|
|
* optimize for polling for controllers. If you do not pass these events in,
|
|
* polling will cause regular object creation.
|
|
*
|
|
* @param event the motion event from the app
|
|
*/
|
|
public void onGenericMotionEvent(MotionEvent event);
|
|
|
|
/**
|
|
* Tell the V9 input manager that it should stop polling for disconnected
|
|
* devices. You can call this during onPause in your activity, although you
|
|
* might want to call it whenever your game is not active (or whenever you
|
|
* don't care about being notified of new input devices)
|
|
*/
|
|
public void onPause();
|
|
|
|
/**
|
|
* Tell the V9 input manager that it should start polling for disconnected
|
|
* devices. You can call this during onResume in your activity, although you
|
|
* might want to call it less often (only when the gameplay is actually
|
|
* active)
|
|
*/
|
|
public void onResume();
|
|
|
|
public interface InputDeviceListener {
|
|
/**
|
|
* Called whenever the input manager detects that a device has been
|
|
* added. This will only be called in the V9 version when a motion event
|
|
* is detected.
|
|
*
|
|
* @param deviceId The id of the input device that was added.
|
|
*/
|
|
void onInputDeviceAdded(int deviceId);
|
|
|
|
/**
|
|
* Called whenever the properties of an input device have changed since
|
|
* they were last queried. This will not be called for the V9 version of
|
|
* the API.
|
|
*
|
|
* @param deviceId The id of the input device that changed.
|
|
*/
|
|
void onInputDeviceChanged(int deviceId);
|
|
|
|
/**
|
|
* Called whenever the input manager detects that a device has been
|
|
* removed. For the V9 version, this can take some time depending on the
|
|
* poll rate.
|
|
*
|
|
* @param deviceId The id of the input device that was removed.
|
|
*/
|
|
void onInputDeviceRemoved(int deviceId);
|
|
}
|
|
|
|
/**
|
|
* Use this to construct a compatible InputManager.
|
|
*/
|
|
public static class Factory {
|
|
|
|
/**
|
|
* Constructs and returns a compatible InputManger
|
|
*
|
|
* @param context the Context that will be used to get the system
|
|
* service from
|
|
* @return a compatible implementation of InputManager
|
|
*/
|
|
public static InputManagerCompat getInputManager(Context context) {
|
|
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
|
|
return new InputManagerV16(context);
|
|
} else {
|
|
return new InputManagerV9();
|
|
}
|
|
}
|
|
}
|
|
}
|