여러 게임 컨트롤러 지원

대부분의 게임은 Android 지원 기기당 한 명의 사용자를 지원하도록 설계하지만 동일한 Android 지원 기기에 동시에 연결된 게임 컨트롤러로 여러 사용자를 지원할 수도 있습니다.

이 강의에서는 연결된 여러 컨트롤러에서 단일 기기 멀티 플레이어 게임의 입력을 처리하는 몇 가지 기본 기술을 다룹니다. 여기에는 플레이어 아바타와 각 컨트롤러 기기 간의 매핑을 유지하고 컨트롤러 입력 이벤트를 적절하게 처리하는 작업이 포함됩니다.

플레이어를 컨트롤러 기기 ID에 매핑

게임 컨트롤러가 Android 지원 기기에 연결되면 시스템은 정수로 된 기기 ID를 할당합니다. 게임 컨트롤러가 연결되었는지 확인에 표시된 대로 InputDevice.getDeviceIds()를 호출하여 연결된 게임 컨트롤러의 기기 ID를 가져올 수 있습니다. 그런 다음 각 기기 ID를 게임 플레이어에 연결하고 각 플레이어의 게임 작업을 개별적으로 처리하면 됩니다.

이 코드 스니펫은 SparseArray를 사용하여 플레이어의 아바타를 특정 컨트롤러와 연결하는 방법을 보여줍니다. 이 예에서 mShips 변수는 Ship 객체 모음을 저장합니다. 새 플레이어 아바타는 사용자가 새 컨트롤러를 연결하면 게임 내에서 생성되고 연결된 컨트롤러가 삭제되면 아바타도 없어집니다.

onInputDeviceAdded() 및 onInputDeviceRemoved() 콜백 메서드는 다양한 버전의 Android에서 컨트롤러 지원에 소개된 추상화 레이어의 일부입니다. 이러한 리스너 콜백을 구현하면 컨트롤러가 추가되거나 삭제될 때 게임에서 게임 컨트롤러의 기기 ID를 식별할 수 있습니다. 이 감지 기능은 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)
}

자바

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);
}

여러 컨트롤러 입력 처리

게임에서 여러 컨트롤러의 입력을 처리하려면 다음 루프를 실행해야 합니다.

  1. 입력 이벤트가 발생했는지 감지합니다.
  2. 입력 소스와 기기 ID를 확인합니다.
  3. 입력 이벤트 키 코드 또는 축 값이 나타내는 작업에 따라 기기 ID와 연결된 플레이어 아바타를 업데이트합니다.
  4. 사용자 인터페이스를 렌더링하고 업데이트합니다.

KeyEvent 및 MotionEvent 입력 이벤트에는 이벤트와 연결된 기기 ID가 있습니다. 게임은 이를 이용하여 게임에서 입력 이벤트가 발생한 컨트롤러를 판별하고 컨트롤러와 연결된 플레이어 아바타를 업데이트할 수 있습니다.

다음 코드 스니펫은 게임 컨트롤러의 기기 ID에 대응하는 플레이어 아바타 참조를 가져오고 컨트롤러에서 사용자의 버튼을 눌러 게임을 업데이트하는 방법을 보여줍니다.

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)
}

자바

@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);
}