Большинство игр рассчитано на одного пользователя на устройство Android, но можно реализовать поддержку нескольких игроков, подключив к одному устройству несколько контроллеров.
В этом уроке рассматриваются некоторые базовые методы обработки ввода в многопользовательской игре на одном устройстве с нескольких подключенных контроллеров. В частности, необходимо сопоставить аватары игроков с контроллерами и правильно обрабатывать события ввода.
Сопоставление игроков с идентификаторами контроллеров
Когда игровой контроллер подключен к устройству на базе Android, система присваивает ему целочисленный идентификатор устройства. Идентификаторы подключенных игровых контроллеров можно получить, вызвав метод InputDevice.getDeviceIds(), как показано в разделе Как проверить, подключен ли игровой контроллер. Затем вы можете связать каждый идентификатор устройства с игроком и обрабатывать игровые действия для каждого игрока отдельно.
В приведенном ниже фрагменте кода показано, как использовать SparseArray, чтобы связать аватар игрока с определенным контроллером. В этом примере переменная mShips хранит коллекцию объектов Ship. Когда пользователь подключает новый контроллер, в игре создается аватар нового игрока, а когда контроллер отключается, аватар удаляется.
Методы обратного вызова onInputDeviceAdded() и onInputDeviceRemoved() являются частью уровня абстракции, описанного в разделе Поддержка контроллеров в разных версиях Android.
Реализовав эти обратные вызовы, вы сможете определять идентификатор устройства при добавлении или удалении контроллера. Эта функция совместима с Android 2.3 (уровень API 9) и более поздними версиями.
Kotlin
private val ships = SparseArray<Ship>()
override fun onInputDeviceAdded(deviceId: Int) {
getShipForID(deviceId)
}
override fun onInputDeviceRemoved(deviceId: Int) {
removeShipForID(deviceId)
}
private fun getShipForID(shipID: Int): Ship {
return ships.get(shipID) ?: Ship().also {
ships.append(shipID, it)
}
}
private fun removeShipForID(shipID: Int) {
ships.remove(shipID)
}
Java
private final SparseArray<Ship> ships = new SparseArray<Ship>();
@Override
public void onInputDeviceAdded(int deviceId) {
getShipForID(deviceId);
}
@Override
public void onInputDeviceRemoved(int deviceId) {
removeShipForID(deviceId);
}
private Ship getShipForID(int shipID) {
Ship currentShip = ships.get(shipID);
if ( null == currentShip ) {
currentShip = new Ship();
ships.append(shipID, currentShip);
}
return currentShip;
}
private void removeShipForID(int shipID) {
ships.remove(shipID);
}
Обработка ввода с нескольких контроллеров
Чтобы обрабатывать входные данные от нескольких контроллеров, в игре должен выполняться следующий цикл:
- Определите, произошло ли событие ввода.
- Определите источник входных данных и идентификатор его устройства.
- Обновите аватар игрока, связанный с идентификатором устройства, в зависимости от действия, указанного кодом клавиши или значением оси входного события.
- Отрисовка и обновление пользовательского интерфейса.
События ввода KeyEvent и MotionEvent имеют связанные с ними идентификаторы устройств. Это позволяет определить, с какого контроллера поступил сигнал, и обновить аватар игрока, связанный с этим контроллером.
В следующем фрагменте кода показано, как получить ссылку на аватар игрока, соответствующую идентификатору устройства игрового контроллера, и обновить игру на основе нажатия пользователем кнопки на этом контроллере.
Kotlin
override fun onKeyDown(keyCode: Int, event: KeyEvent): Boolean {
if (event.source and InputDevice.SOURCE_GAMEPAD == InputDevice.SOURCE_GAMEPAD) {
event.deviceId.takeIf { it != -1 }?.also { deviceId ->
val currentShip: Ship = getShipForID(deviceId)
// Based on which key was pressed, update the player avatar
// (e.g. set the ship headings or fire lasers)
return true
}
}
return super.onKeyDown(keyCode, event)
}
Java
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
if ((event.getSource() & InputDevice.SOURCE_GAMEPAD)
== InputDevice.SOURCE_GAMEPAD) {
int deviceId = event.getDeviceId();
if (deviceId != -1) {
Ship currentShip = getShipForID(deviceId);
// Based on which key was pressed, update the player avatar
// (e.g. set the ship headings or fire lasers)
...
return true;
}
}
return super.onKeyDown(keyCode, event);
}