Cara Migrasi dari Input Manager Lama Unity ke Input System Tanpa Merusak Kontrol
Ringkasnya
Pelajari cara migrasi proyek Unity 6 dari Input Manager lama ke Input System tanpa merusak kontrol pemain, UI, atau pemanggilan Input tersisa.
Anda menginstal Input System, menekan Play, dan Unity menampilkan error: Anda mencoba membaca input dengan class UnityEngine.Input, tetapi Active Input Handling sudah mengarah ke paket Input System. Atau Play Mode dimulai, dan menu pause tidak lagi menerima satu klik pun.
Artikel ini menunjukkan urutan aman untuk migrasi proyek Unity 6 yang sudah ada dari Input Manager lama ke Input System baru tanpa merusak kontrol atau UI. Aktifkan kedua backend, ganti pemanggilan Input Anda, perbaiki EventSystem, kemudian matikan manager lama hanya ketika semuanya masih berfungsi. Langkah-langkah ini mengikuti dokumentasi Input System resmi per 20 November 2026. Instal paket Input System terbaru dari Package Manager. Jangan tetapkan versi paket dari artikel ini, karena rilis yang lebih baru akan tersedia.
Mengapa migrasi di Unity 6
Manual Unity sekarang memperlakukan Input Manager bawaan sebagai fitur lawas. Ini deprecated, tidak direkomendasikan untuk proyek baru, dan Unity mengatakan akan dihapus di versi editor mendatang. Manager lama tetap tersedia agar proyek yang ada dapat terus berjalan. Peralihan yang direncanakan masih lebih baik daripada menunggu hingga upgrade mendatang menghapus backend lama untuk Anda.
Aktifkan kedua backend saat migrasi
Jika proyek Anda belum menyertakan Input System, buka Window > Package Manager, beralih ke Unity Registry, dan instal paket Input System. Dari Unity 6.1 ke atas, beberapa template proyek sudah menambahkannya. Proyek kosong sering kali tidak.
Selama instalasi, Unity menanyakan apakah akan mengaktifkan backend Input System dan menonaktifkan backend Input Manager. Jika Anda memilih Yes, Editor akan restart dengan hanya sistem baru yang aktif. Setiap pemanggilan Input.GetAxis atau Input.GetButton yang tersisa kemudian akan gagal, dan menu uGUI yang masih menggunakan modul input lama akan gagal bersamanya.
Atur backend sendiri. Buka Edit > Project Settings > Player, buka Other Settings, dan atur Active Input Handling ke Both. Editor akan restart. Dalam mode itu, Unity mendefinisikan ENABLE_LEGACY_INPUT_MANAGER dan ENABLE_INPUT_SYSTEM, sehingga kode lama dan baru dapat berjalan berdampingan.
#if ENABLE_INPUT_SYSTEM
// New Input System backends are enabled.
#endif
#if ENABLE_LEGACY_INPUT_MANAGER
// Old Input Manager backends are enabled.
#endif
Perlakukan Both sebagai jembatan. Biarkan aktif sampai script Anda sendiri, EventSystem dan aset pihak ketiga telah berpindah. Beralih ke Input System Package (New) hanya setelah Play Mode dan build berfungsi tanpa exception dan dengan UI yang berfungsi.
Ganti GetAxis dan GetButton dengan Actions
Workflow yang direkomendasikan adalah membaca action bernama, bukan tombol perangkat mentah. Kecuali Anda membutuhkan lebih dari satu action asset, tetapkan satu asset sebagai action seluruh proyek.
Buka Edit > Project Settings > Input System Package dan buat atau tetapkan action seluruh proyek default jika belum ada yang diatur. Default mencakup map Player dan map UI, dengan action seperti Move (nilai Vector2) dan Jump, sudah terikat untuk keyboard, mouse, gamepad, touch dan XR. Anda mengaksesnya melalui InputSystem.actions. Mereka diaktifkan secara default dan dimuat sebelumnya saat startup, dan di Editor setiap kali Anda memasuki Play Mode.
Temukan setiap action sekali, lalu baca setiap frame. Mencari action berdasarkan nama setiap kali, seperti yang dilakukan Input.GetAxis("Horizontal"), adalah jalur lambat di API baru.
using UnityEngine;
using UnityEngine.InputSystem;
public class PlayerMovement : MonoBehaviour
{
InputAction moveAction;
InputAction jumpAction;
void Start()
{
moveAction = InputSystem.actions.FindAction("Move");
jumpAction = InputSystem.actions.FindAction("Jump");
}
void Update()
{
Vector2 move = moveAction.ReadValue<Vector2>();
if (jumpAction.WasPressedThisFrame())
{
// jump
}
}
}
Nama dalam namespace UnityEngine.InputSystem dipetakan ke pemanggilan lama seperti ini:
Input.GetAxis("Horizontal")danInput.GetAxis("Vertical")menjadimoveAction.ReadValue<Vector2>()Input.GetButton("Jump")menjadijumpAction.IsPressed()Input.GetButtonDownmenjadiWasPressedThisFrame()Input.GetButtonUpmenjadiWasReleasedThisFrame()Input.GetKey(KeyCode.Space)menjadiKeyboard.current.spaceKey.isPressedInput.GetMouseButton(0)menjadiMouse.current.leftButton.isPressedInput.mousePositionmenjadiMouse.current.position.ReadValue()
Dua detail penting jika Anda ingin kontrol terasa sama. Action Move default adalah nilai 2D, jadi axis Horizontal dan Vertical lama menjadi satu vektor, bukan dua float. Dan ReadValue tidak menerapkan smoothing Gravity dan Sensitivity lama, jadi key atau tombol mencapai nilai penuh secara langsung. Jika gerakan Anda bergantung pada ramp itu, Anda perlu membuatnya ulang dengan sengaja. Input.GetAxisRaw tidak memiliki padanan langsung. ReadUnprocessedValue() hanya berbeda dari ReadValue ketika processor dilampirkan ke action.
Pembacaan perangkat langsung seperti Keyboard.current adalah pengganti cepat, bukan workflow jangka panjang, dan perangkat saat ini bisa null ketika hardware itu tidak ada.
Beberapa fitur Input Manager lama masih bergantung pada versi Unity Anda. Dari Unity 6.4 ke atas, fungsi event mouse MonoBehaviour seperti OnMouseDown bekerja dengan Input System. Pada rilis Unity 6 yang lebih awal mereka mungkin tidak melakukan apa pun setelah hanya backend baru yang aktif. Jika proyek Anda menggunakan location, compass atau device orientation, periksa dokumentasi Input System untuk editor Anda sebelum mematikan manager lama. IMGUI (OnGUI) tidak kompatibel dengan Input System, jadi menu debug yang dibangun dengan cara itu mungkin perlu tetap di Both.
Jaga UI tetap berfungsi
Jika Anda menggunakan Unity UI (uGUI), Anda selalu memerlukan modul input pada EventSystem untuk memasukkan Input System ke UI. StandaloneInputModule yang lebih lama masih berkomunikasi dengan Input Manager lawas. Ketika Active Input Handling diatur ke paket baru saja, modul itu adalah sumber umum exception UnityEngine.Input.
Pilih EventSystem di scene. Jika paket Input System terinstal, Inspector menawarkan tombol yang mengganti StandaloneInputModule dengan InputSystemUIInputModule. Modul baru datang telah dikonfigurasi dengan action UI default. Ketika Active Input Handling sudah diatur ke paket baru atau ke Both, Unity juga menambahkan modul baru secara otomatis jika Anda menempatkan elemen uGUI baru di scene.
UI Toolkit berbeda. Dari Unity 2023.2 ke atas, yang mencakup Unity 6, UI Toolkit dapat membaca action UI dari action seluruh proyek tanpa modul tambahan. Anda memerlukan InputSystemUIInputModule ditambah EventSystem ketika UI Toolkit dan uGUI berbagi scene yang sama.
Jika Anda juga menggunakan komponen PlayerInput, tetapkan action asset yang sama ke PlayerInput dan ke InputSystemUIInputModule, dan atur field UI Input Module pada PlayerInput. Kemudian penugasan perangkat yang sama menggerakkan player dan UI. Jika script Anda membaca action saat PlayerInput digunakan, baca PlayerInput.actions, bukan InputSystem.actions, karena PlayerInput menyimpan salinan yang difilter untuk perangkat setiap player.
Exception dan pemanggilan Input yang tersisa
Runtime error biasanya berbunyi: InvalidOperationException: You are trying to read Input using the UnityEngine.Input class, but you have switched active Input handling to Input System package in Player Settings. Ini muncul ketika Active Input Handling diatur ke Input System Package (New) dan sesuatu masih memanggil UnityEngine.Input.
Baca stack trace sebelum Anda mengubah script secara acak. Ini sering dimulai di StandaloneInputModule atau BaseInput.GetButtonDown, bukan di class pergerakan Anda. Setelah Anda memperbaiki EventSystem, cari di kode Anda sendiri Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton dan Input.mousePosition. Kemudian periksa aset dan plugin pihak ketiga. Mengatur Active Input Handling kembali ke Both adalah langkah sementara yang valid. Perbaikan permanen adalah migrasi pemanggil atau update plugin.
Kapan PlayerInput bermanfaat
Komponen PlayerInput bersifat opsional. Tambahkan ketika Anda ingin Send Messages (OnJump, OnMove(InputValue value)), Invoke Unity Events, atau PlayerInputManager untuk multiplayer lokal. Game single-player yang sudah melakukan polling di Update dapat tetap dengan FindAction dan ReadValue.
Checklist migrasi singkat
- Instal paket Input System terbaru dari Package Manager, lalu atur Active Input Handling ke Both.
- Buat atau tetapkan action seluruh proyek default.
- Ganti pemanggilan
InputAnda sendiri. Temukan setiap action sekali, lalu baca setiap frame. - Jika Anda menggunakan uGUI, ganti
StandaloneInputModuledenganInputSystemUIInputModuledan klik melalui menu dengan keyboard dan gamepad. - Periksa event
OnMouse, touch, location, compass dan IMGUI terhadap versi Unity Anda. - Update plugin yang masih memanggil
UnityEngine.Input, atau biarkan Both aktif hingga perbaikan tersedia. - Ketika Play Mode dan build berjalan tanpa exception dan dengan UI yang berfungsi, atur Active Input Handling ke Input System Package (New).
Sebelum Anda mengubah switch terakhir itu, mainkan melalui pergerakan, menu dan tombol di layar. Input adalah topik engine sisi klien. horizOn adalah backend game dengan SDK Unity untuk akun, cloud save, leaderboard dan berita dalam game. Migrasi Input System tidak mengubah cara Anda menggunakan SDK itu, dan tidak menggantikan atau membungkus stack input Unity.