输入 SDK

输入 SDK 提供了一个统一的界面,允许玩家查看和更改他们希望在 Google Play 游戏在 PC 上玩的所有游戏的鼠标和键盘绑定。在游戏过程中,玩家可以随时召唤 Google Play 游戏在 PC 上的叠加层,如本屏幕截图所示

A screenshot showing the Input SDK rendered over a sample game

此 SDK 对于在 Google Play 游戏在 PC 上使用键盘的游戏是**必需的**,因为 Android 移动游戏是围绕触摸屏进行玩家输入设计的。在为 PC 开发时,游戏需要支持鼠标和键盘。您应该仅在 Google Play 游戏在 PC 上启用此 SDK。

输入 SDK 是让玩家在不同平台上对您的游戏感到满意并参与其中的重要元素。鼠标和键盘提供的体验与触摸屏不同。当您将游戏与输入 SDK 集成时,您将使玩家能够在 Google Play 游戏在 PC 上重新映射默认控件。

为了获得更身临其境的体验,您可以通过为您的菜单、主要游戏和小游戏设置不同的方案控件,或通过更新您的 UI 以匹配用户的自定义控件映射,来更多地利用 Google Play 游戏在 PC 上提供的重新映射功能。您可以禁用或启用单个键或键组的重新映射,或者决定允许在游戏中重新映射哪些键。

使用重新映射功能时,Android 会检测用户何时在文本字段中键入文本并禁用重新映射,因此您的游戏无需手动为这些场景禁用重新映射。

有关更多信息,请参阅输入 SDK 的 最佳实践限制,以帮助为您的游戏构建尽可能好的 PC 体验。

集成指南

有关集成输入 SDK 的信息,请参阅 输入 SDK 入门

示例游戏

有关如何与输入 SDK 集成的示例,请参阅 Kotlin 或 Java 游戏的 AGDK Tunnel 和 Unity 游戏的 Trivial Kart

下载输入 SDK

在下载输入 SDK 之前,请阅读以下 Google 输入 SDK 服务条款和数据收集要求。

Google API 服务条款

您对 Google 输入 SDK 的使用受 Google API 服务条款 约束。

数据收集

Google 输入 SDK 可能会收集性能和稳定性数据以改进我们的产品,包括以下数据

  • 对输入 SDK 方法的调用次数。
  • 对输入 SDK 方法的非成功调用次数。
  • InputMap 聚合信息,例如
    • 已定义的操作和组的数量。
    • 已定义的单键、多键和鼠标操作的数量。
    • 已定义的鼠标操作的数量。
    • 可重新映射的操作和组的数量。
    • 重新映射保留键的数量。
    • InputMap 重新映射选项(启用/禁用)。
  • 游戏的包名称。
  • 游戏的版本号。
  • 游戏的版本名称。
  • 输入 SDK 版本。
  • 客户端变体,例如 Google Play 游戏在 PC 上或其他客户端。

输入 SDK 可在 Google Maven 存储库中获取。有关如何在 Java 或 Kotlin 项目中使用它的说明,请参阅 入门指南

Play Unity 插件存储库 下载适用于 Unity 的输入 SDK。