概览

游戏控制器配备了更多功能，显著增强了玩家互动和沉浸感。Android 游戏控制器的触觉、运动传感器和灯光功能尤其有助于加深和丰富游戏体验。每个功能都能独特地刺激玩家的感官，从而在游戏中促进更有意义、更直观的互动。

触觉

Android 游戏控制器中的触觉功能是一项关键技术，可在游戏过程中提供真实的触觉反馈。

触觉技术通过振动或移动向用户传递物理感觉。例如，当游戏中发生爆炸时，控制器会振动，让玩家真实地感受到冲击力。此外，细微的振动可以与角色行走或奔跑的声音同步，提供更逼真的体验。这种触觉反馈使玩家能够在游戏中物理地感受到各种事件的发生。

这项技术最大限度地提高了玩家的沉浸感，放大了情感反应，并丰富了游戏的动态性。Android 游戏控制器中的触觉设置不仅拓宽了游戏开发者的创意可能性，还为玩家提供了比以往任何时候都更逼真的游戏体验。

fun triggerVibrationMultiChannel(
  deviceId: Int, leftIntensity: Int, leftDuration: Int,
  rightIntensity: Int, rightDuration: Int) {
  val inputDevice = InputDevice.getDevice(deviceId)
  val vibratorManager = inputDevice!!.vibratorManager
  if (vibratorManager != null) {
    val vibratorIds = vibratorManager.vibratorIds
    val vibratorCount = vibratorIds.size
    if (vibratorCount > 0) {
      // We have an assumption that game controllers have two vibrators
      // corresponding to a left motor and a right motor, and the left
      // motor will be first.
      updateVibrator(vibratorManager.getVibrator(vibratorIds[0]), leftIntensity, leftDuration)
      if (vibratorCount > 1) {
        updateVibrator(vibratorManager.getVibrator(vibratorIds[1]), rightIntensity, rightDuration)
      }
    }
  }
}

fun updateVibrator(vibrator: Vibrator?, intensity: Int, duration: Int) {
  if (vibrator != null) {
    if (intensity == 0) {
      vibrator.cancel()
    } else if (duration > 0) {
      vibrator.vibrate(VibrationEffect.createOneShot(duration.toLong(), intensity))
    }
  }
}

要使用振动，需要设置功能和权限。

<application ...>
  ...
  <uses-feature android:name="android.hardware.gamepad" android:required="true"/>
  <uses-permission android:name="android.permission.VIBRATE"/>
  ...
</application>

有关 VibratorManager 和应用清单的更多信息。

运动传感器

增强游戏体验的最具创新性的技术之一是配备运动传感器的 Android 游戏控制器。这项技术精确地检测用户的物理动作，并将这些数据转换为游戏中的动作，从而提供更直观、更身临其境的游戏体验。在本介绍中，我们将探讨 Android 游戏控制器中的运动传感器功能的工作原理。

运动传感器通常结合陀螺仪和加速度计来检测用户的移动和方向。

它需要实现加速度和陀螺仪侦听器类，并将这些侦听器注册到控制器的传感器管理器。

fun setIntegratedAccelerometerActive(deviceId: Int) {
  val device = InputDevice.getDevice(deviceId)
  val sensorManager = device?.sensorManager
  val accelerometer = sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER)
  if (accelerometer != null) {
    val accelerometerListener =
      GameControllerAccelerometerListener(accelerometer)
    sensorManager.registerListener(
      accelerometerListener, accelerometer,
      SensorManager.SENSOR_DELAY_GAME
    )
  }
}

fun setIntegratedGyroscopeActive(deviceId: Int) {
  val device = InputDevice.getDevice(deviceId)
  val sensorManager = device?.sensorManager
  val gyroscope = sensorManager?.getDefaultSensor(Sensor.TYPE_GYROSCOPE)
  if (gyroscope != null) {
    val gyroscopeListener = GameControllerGyroscopeListener(gyroscope)
    sensorManager.registerListener(
      gyroscopeListener, gyroscope,
      SensorManager.SENSOR_DELAY_GAME
    )
  }
}

class GameControllerAccelerometerListener(private val listenerAccelerometer: Sensor?) :
  SensorEventListener {
  override fun onSensorChanged(event: SensorEvent) {
    if (listenerAccelerometer != null) {
      synchronized(listenerAccelerometer) {
        if (event.sensor == listenerAccelerometer) {
          Log.d("Accelerometer",
            "onSensorChanged " + event.values[0] + ", "
            + event.values[1] + ", " + event.values[2])
        }
      }
    }
  }

  override fun onAccuracyChanged(sensor: Sensor, accuracy: Int) {
  }
}

class GameControllerGyroscopeListener(private val listenerGyroscope: Sensor?) :
  SensorEventListener {
  override fun onSensorChanged(event: SensorEvent) {
    if (listenerGyroscope != null) {
      synchronized(listenerGyroscope) {
        if (event.sensor == listenerGyroscope) {
          Log.d("Gyroscope",
            "onSensorChanged " + event.values[0] + ", " +
            event.values[1] + ", " + event.values[2])
        }
      }
    }
  }

  override fun onAccuracyChanged(sensor: Sensor, accuracy: Int) {
  }
}

有关运动传感器和 SensorEventListener 的更多信息。

灯光

Android 游戏控制器上的灯光颜色设置通过视觉元素为游戏玩法增添了新的沉浸维度。

灯光颜色功能利用控制器中的内置 LED 灯来显示各种颜色，这些颜色会根据不同的游戏场景动态响应。例如，当玩家的生命值危急时，灯光可能会闪烁红色；完成特定任务后，灯光可能会发出绿光，根据游戏内事件提供视觉反馈。这些灯光颜色设置加深了用户参与度，提高了游戏的悬念和乐趣，并帮助玩家更充分地沉浸在游戏世界中。

Android 游戏控制器中的灯光颜色功能不仅仅是装饰性的——它在设定游戏氛围和改善用户体验方面发挥着重要作用。

fun changeControllerLightColor(deviceId: Int, color: Int) {
  val device = InputDevice.getDevice(deviceId)
  device?.let {
    if (it.sources and InputDevice.SOURCE_JOYSTICK == InputDevice.SOURCE_JOYSTICK) {
      val lightsManager = device.lightsManager
      lightsManager?.let { manager ->
        manager.lights.forEach { light ->
          val stateBuilder = LightState.Builder()
          stateBuilder.setColor(color)
          val requestBuilder = LightsRequest.Builder()
          requestBuilder.addLight(light, stateBuilder.build())
          val lightsSession = lightsManager.openSession()
          lightsSession.requestLights(requestBuilder.build())
        }
      }
    }
  }
}

要使用振动，需要设置功能和权限。

<application ...>
  ...
  <uses-feature android:name="android.hardware.gamepad" android:required="true"/>
  <uses-permission android:name="android.permission.LIGHTS" />
  ...
</application>

有关 LightsManager 和应用清单的更多信息。

控制器触摸板

一些游戏控制器包括一个触摸板，可用于各种游戏内操作，例如以更直观的方式导航菜单或控制游戏角色。

Touchpad on the game controller. — **图 1.** 游戏控制器上的触摸板。

具有集成触摸板的游戏控制器可在 Android 上提供直接的设备控制。触摸触摸板会生成屏幕上的鼠标指针，从而实现直观的鼠标式导航。