[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBGE5FJ3HZWHCB7Y2QEWBM":3,"skill-same:01M6CBGE5FJ3HZWHCB7Y2QEWBM":44},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":28,"updatedAt":29,"install":30,"resources":43},"01M6CBGE5FJ3HZWHCB7Y2QEWBM","10-input-manager",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F11-input-system\u002F10-input-manager\u002FSKILL.md",[],[18],"10 input manager","2026-11-10 10:12:30",false,"# 10-input-manager\n\nStatus: ACTIVE\nAppliesTo: v11\nType: Component Specification\n\n## 목적\n\n`InputManager`는 **InputActionAsset 기반 입력 수집\u002F정규화\u002F발행** 시스템이다.\n\n- Unity InputSystem의 InputActionAsset을 직접 참조\n- Move\u002FLook은 Vector2로, 버튼은 ulong bitset으로 정규화\n- 매 프레임 등록된 BaseInputController를 Priority 순으로 직접 호출\n- Game \u002F UI 컨텍스트 전환 지원\n\n---\n\n## 범위\n\n### 포함\n\n- `InputManager` — CompoSingleton, consumer bootstrap\u002Fprefab이 부착하는 입력 관리자\n- `InputFrame` — 한 프레임의 정규화된 입력 스냅샷 (readonly struct)\n- `InputContext` — Game \u002F UI 모드 enum\n- `IInputManager` — InputManager 계약\n- `InputButtonMapBuilder` — key(\"Map\u002FAction\") → button index 맵 빌드 유틸\n\n### 제외\n\n- 오브젝트 부착형 입력 소비 (→ `11-input-controller`)\n- InputSpace 전략 (→ `11-input-controller`)\n- InputAction 바인딩\u002F리매핑 UI\n\n---\n\n## 네임스페이스\n\n```csharp\nnamespace Devian\n```\n\n---\n\n## 핵심 규약 (Hard Rule)\n\n### 1. InputSettings 분리\n\n설정 데이터는 `InputSettings` ScriptableObject로 분리되었다 (→ `12-input-settings`).\nInputManager는 `Resources.Load\u003CInputSettings>(InputSettings.ResourcesPath)`로 고정 경로에서 로드한다.\n\n**InputManager에 남은 SerializedField:**\n\n| 필드 | 기본값 | 용도 |\n|------|--------|------|\n| `_outputEnabled` | `true` | 인스턴스별 런타임 dispatch on\u002Foff |\n\n**InputSettings에 이전된 필드 (기본값):**\n\n| 필드 | 기본값 |\n|------|--------|\n| `_gameplayMapName` | `\"Player\"` |\n| `_uiMapName` | `\"UI\"` |\n| `_moveKey` | `\"Player\u002FMove\"` |\n| `_lookKey` | `\"Player\u002FLook\"` |\n\n### 2. ButtonMap key 포맷\n\n버튼 키는 `\"Map\u002FAction\"` 형식이다. 예: `\"Player\u002FAttack\"`, `\"Player\u002FJump\"`.\n\n### 3. ButtonMap 정렬 및 인덱스\n\n`InputButtonMapBuilder.Build()`는 expectedKeys를 **Ordinal sort** 후 0..63 인덱스를 부여한다.\n\n### 4. 64 버튼 제한\n\nulong bitset이므로 최대 64개 버튼. 초과 시 `InvalidOperationException`.\n\n`InputFrame.IsDown(int)`은 0..63만 유효하며, 범위 밖은 `false`.\n\n### 5. Context 전환\n\n`SetContext(InputContext)` 호출 시:\n- `Game` → Gameplay ActionMap Enable, UI ActionMap Disable\n- `UI` → Gameplay ActionMap Disable, UI ActionMap Enable\n\n### 6. Singleton 등록\n\n- `CompoSingleton\u003CInputManager>` — 타입 등록은 base `Awake()`에서 자동 수행, 초기화 코드는 `onInitAwake()`에서 처리\n- `IInputManager`는 `OnEnable`에서 `Singleton.Register\u003CIInputManager>` (Compo), `OnDisable`에서 `Unregister`\n- BaseApplication은 InputManager를 자동 추가하지 않는다.\n- 입력을 사용하는 소비자 bootstrap\u002Fprefab이 `InputManager`를 미리 부착한다.\n- 런타임 `AddComponent\u003CInputManager>()`는 패턴 위반이다.\n\n### 7. Uninitialized Axis Policy\n\n`_moveKey`\u002F`_lookKey`가 비어 있거나 해당 Action을 찾지 못하면(`_moveAction`\u002F`_lookAction == null`), 해당 축은 \"초기화 안 됨\"으로 간주하여 `NaN`을 InputFrame에 담는다. BaseInputController는 NaN 축에 대해 콜백을 발생시키지 않는다.\n\n### 8. Controller Registry Dispatch\n\n`outputEnabled == true`일 때만 매 프레임:\n1. Move\u002FLook ReadValue + buttons bitset 합산 → `InputFrame` 생성\n2. `_controllersDirty`이면 `_controllers`를 `Priority` 내림차순 정렬\n3. 등록된 `BaseInputController.__Consume(frame)`을 순서대로 호출\n\n- `RegisterController(BaseInputController)` \u002F `UnregisterController(BaseInputController)` — 컨트롤러 등록\u002F해제\n- Bus(IInputBus\u002FInputBus)는 삭제됨 — 직접 호출 방식으로 대체\n\n---\n\n## API 시그니처\n\n```csharp\n\u002F\u002F --- InputContext ---\npublic enum InputContext : byte { Game = 0, UI = 1 }\n\n\u002F\u002F --- InputFrame ---\npublic readonly struct InputFrame\n{\n    public readonly Vector2 Move;\n    public readonly Vector2 Look;\n    public readonly ulong ButtonBits;\n    public readonly InputContext Context;\n    public readonly float Timestamp;\n\n    public InputFrame(Vector2 move, Vector2 look, ulong buttonBits, InputContext context, float timestamp);\n    public bool IsDown(int buttonIndex);\n}\n\n\u002F\u002F --- IInputManager ---\npublic interface IInputManager\n{\n    InputActionAsset Asset { get; }\n    InputContext Context { get; }\n    int GetButtonIndex(string key);\n    IReadOnlyList\u003Cstring> ButtonKeys { get; }\n    void SetContext(InputContext context);\n}\n\n\u002F\u002F --- InputManager ---\npublic sealed class InputManager : CompoSingleton\u003CInputManager>, IInputManager\n{\n    public void RegisterController(BaseInputController controller);\n    public void UnregisterController(BaseInputController controller);\n}\n\n\u002F\u002F --- InputButtonMapBuilder ---\npublic static class InputButtonMapBuilder\n{\n    public static Dictionary\u003Cstring, int> Build(InputActionAsset asset, string[] expectedKeys);\n    public static InputAction TryFindActionByKey(InputActionAsset asset, string key);\n}\n```\n\n---\n\n## Editor 기능\n\n`InputManagerInspector`는 `DrawDefaultInspector()`만 제공한다 (`_settings`, `_outputEnabled` 표시).\n\n내부 버튼 맵 재빌드는 `OnEnable()` 초기화 시 자동 수행된다.\n\nRefresh Expected Button Keys, Install\u002FEnsure VirtualGamepad Bindings 버튼은\n`InputSettingsInspector`에서 제공한다 (→ `12-input-settings`).\n\n**Editor 파일:** `com.devian.foundation\u002FSamples~\u002FMobilePackage\u002FEditor\u002FInput\u002FInputManagerInspector.cs`\n\n---\n\n## 파일 경로\n\n| 타입 | 경로 |\n|------|------|\n| InputContext | `com.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FInput\u002FInputContext.cs` |\n| InputFrame | `com.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FInput\u002FInputFrame.cs` |\n| IInputManager | `com.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FInput\u002FIInputManager.cs` |\n| InputButtonMapBuilder | `com.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FInput\u002FInputButtonMapBuilder.cs` |\n| InputSettings | `com.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FInput\u002FInputSettings.cs` |\n| InputManager | `com.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FInput\u002FInputManager.cs` |\n| InputManagerInspector | `com.devian.foundation\u002FSamples~\u002FMobilePackage\u002FEditor\u002FInput\u002FInputManagerInspector.cs` |\n| InputSettingsInspector | `com.devian.foundation\u002FSamples~\u002FMobilePackage\u002FEditor\u002FInput\u002FInputSettingsInspector.cs` |\n\n---\n\n## DoD (Definition of Done)\n\n- [ ] 모든 파일이 `namespace Devian` 사용\n- [ ] `Devian.Unity.asmdef`에 `Unity.InputSystem` 참조 포함\n- [ ] UPM ↔ UnityExample 동일\n- [ ] ButtonMap key 64개 이하 검증\n- [ ] InputSettings ScriptableObject 분리 (→ `12-input-settings`)\n- [ ] InputManager는 `Resources.Load\u003CInputSettings>(InputSettings.ResourcesPath)`로 설정 접근\n- [ ] InputSettings 기본값: `\"Player\"`, `\"Player\u002FMove\"`, `\"Player\u002FLook\"`\n- [ ] InputSettingsInspector: Refresh \u002F VirtualGamepad 버튼 동작 (→ `12-input-settings`)\n- [ ] `Devian.Unity.Editor.asmdef`에 `Unity.InputSystem` 참조 포함\n- [ ] InputManager: CompoSingleton + onInitAwake() 훅 사용\n- [ ] 입력을 사용하는 consumer bootstrap\u002Fprefab이 InputManager를 미리 부착\n- [ ] IInputBus \u002F InputBus 파일 삭제됨\n- [ ] Update에서 Controller registry dispatch (Priority 순 직접 호출)\n\n---\n\n## Reference\n\n- Parent: `..\u002F00-overview\u002FSKILL.md`\n- 입력 설정: `..\u002F12-input-settings\u002FSKILL.md`\n- 입력 소비: `..\u002F11-input-controller\u002FSKILL.md`\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F11-input-system\u002F10-input-manager","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add devwinsoft\u002Fdevian --skill 10-input-manager",{"tool":36,"command":37},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 10-input-manager",{"tool":39,"command":40},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 10-input-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F11-input-system\u002F10-input-manager\u002FSKILL.md",true,[],[45,51,59,67,76,83],{"skillNo":46,"name":47,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":19},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[47],{"skillNo":52,"name":53,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[57,58],"archive","90 project archive",{"skillNo":60,"name":61,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[65,66],"management","30 env management",{"skillNo":68,"name":69,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[73,74,75],"push","page","19 page push send",{"skillNo":77,"name":78,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[74,82],"18 page savedata",{"skillNo":84,"name":85,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[74,89],"17 page deobfuscate"]