界面已本地化;技能介绍与说明文档按所选语言由 AI 自动翻译,代码、命令、路径和专业术语保留原文,以原作者文档为准。
探索技能
开发与工程 · SKILL.md

unity-input-system

unity-input-system

【开发与工程】Unity New Input System configuration skill for action maps, device bindings, control schemes, and cross-platform input handling.

独立 GitHub 快照 · 自动分类 · 以原作者文档为准

技能说明

GitHub

name: unity-input-system description: Unity New Input System configuration skill for action maps, device bindings, control schemes, and cross-platform input handling. allowed-tools: Read, Grep, Write, Bash, Edit, Glob, WebFetch graph: domains: [domain:gaming] specializations: [specialization:game-development] skillAreas: [skill-area:gameplay-programming, skill-area:game-engines] roles: [role:game-developer]

Unity Input System Skill

New Input System configuration and implementation for Unity.

Overview

This skill provides capabilities for implementing Unity's New Input System, including action maps, device support, and cross-platform input handling.

Capabilities

Action Configuration

  • Create Input Action Assets
  • Define action maps and actions
  • Configure bindings and interactions
  • Set up action types (value, button, passthrough)

Device Support

  • Configure gamepad support
  • Implement keyboard/mouse handling
  • Set up touch controls
  • Handle XR controllers

Control Schemes

  • Define control schemes
  • Implement scheme switching
  • Support local multiplayer
  • Configure device requirements

Runtime Handling

  • Generate C# input classes
  • Handle input events
  • Implement rebinding UI
  • Manage device changes

Prerequisites

  • Unity 2021.3+
  • Input System package installed

Usage Patterns

Input Actions Asset

// Generated PlayerInput class usage
public class PlayerController : MonoBehaviour
{
    private PlayerInputActions inputActions;

    void Awake()
    {
        inputActions = new PlayerInputActions();
    }

    void OnEnable()
    {
        inputActions.Gameplay.Enable();
        inputActions.Gameplay.Jump.performed += OnJump;
        inputActions.Gameplay.Move.performed += OnMove;
    }

    void OnDisable()
    {
        inputActions.Gameplay.Disable();
    }

    void OnJump(InputAction.CallbackContext ctx)
    {
        // Handle jump
    }

    void OnMove(InputAction.CallbackContext ctx)
    {
        Vector2 movement = ctx.ReadValue<Vector2>();
    }
}

Rebinding

public void StartRebinding(InputAction action)
{
    action.PerformInteractiveRebinding()
        .WithControlsExcluding("Mouse")
        .OnComplete(operation => {
            operation.Dispose();
            SaveBindings();
        })
        .Start();
}

Best Practices

  1. Use Input Action Assets over direct polling
  2. Implement rebinding for accessibility
  3. Test all supported devices
  4. Handle device disconnection gracefully
  5. Save custom bindings to PlayerPrefs

References

我的收藏