概览

游戏手柄配备了额外的功能，这些功能显著增强了玩家的交互性和沉浸感。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 上提供直接设备控制。触摸触摸板会在屏幕上生成一个鼠标指针，从而实现直观的类似鼠标的导航。