Nhập liệu từ gamepad | Tài liệu - Trung Tâm Nhà Sáng Tạo Roblox

Roblox chấp nhận đầu vào từ gamepad như điều khiển Xbox và PlayStation. Để đơn giản hóa các đầu vào chéo nền tảng, bao gồm gamepad, Roblox cung cấp Hệ thống Hành động Nhập liệu để định nghĩa hành động như "nhảy," "chạy," hoặc "bắn" và thiết lập liên kết cho nhiều đầu vào phần cứng để thực hiện những hành động đó.

Khi liên kết đầu vào từ gamepad, hãy tham khảo các sơ đồ điều khiển phổ biến để tạo trải nghiệm gamepad nhất quán cho người chơi. Sau khi các đầu vào được thiết lập, bạn có thể nâng cao trải nghiệm của người chơi bằng cách bao gồm phản hồi xúc giác trên các điều khiển hỗ trợ.

Khi bạn xây dựng hỗ trợ cho gamepad, hãy nhớ thử nghiệm thường xuyên bằng cách sử dụng một gamepad đã kết nối hoặc Trình mô phỏng Điều khiển trong Studio.

Phát hiện loại đầu vào

Trong phát triển chéo nền tảng, điều quan trọng là bạn xác định và phản hồi với loại PreferredInput mà người chơi đang sử dụng, thường là để đảm bảo rằng các phần tử UI như nút và menu trên màn hình hoạt động mượt mà và hỗ trợ tương tác trên các thiết bị.

Ví dụ, một máy chơi game giả định rằng gamepad là đầu vào mặc định, nhưng một người chơi trên PC hoặc laptop cũng có thể chọn kết nối một gamepad bluetooth. Trong trường hợp này, chuột/bàn phím vẫn là một đầu vào hợp lệ cho người chơi đó, nhưng bạn có thể giả định rằng họ muốn chuyển sang gamepad đã kết nối như là loại đầu vào chính.

Xem phát hiện loại đầu vào để biết thêm thông tin.

Để biết các phương pháp phát hiện gamepad thay thế, xem thuộc tính UserInputService.GamepadEnabled và các sự kiện GamepadConnected/GamepadDisconnected.

Các sơ đồ điều khiển phổ biến

Khi xem xét các liên kết điều khiển cụ thể cho Hệ thống Hành động Nhập liệu, tốt nhất là thiết lập sự nhất quán giữa các trò chơi khác nhau. Các liên kết nhập liệu sau đây sẽ giúp người chơi cảm thấy quen thuộc và thoải mái ngay lập tức với các điều khiển gamepad.

Đầu vào	Các trường hợp sử dụng phổ biến
ButtonA	Chấp nhận các lời nhắc của người chơi hoặc lựa chọn GUI. Có thể sử dụng cho các hành động chính như nhảy.
ButtonB	Huỷ bỏ lời nhắc của người chơi hoặc lựa chọn GUI. Có thể sử dụng cho các hành động thứ cấp như né tránh, lăn, hoặc chạy.
Thumbstick1	Thường liên kết với chuyển động nhân vật.
Thumbstick2	Thường liên kết với chuyển động camera.
ButtonL2, ButtonR2	Thường được sử dụng cho các hành động chính, chẳng hạn như bắn.
ButtonL1, ButtonR1, ButtonX, ButtonY	Các hành động thứ cấp như nạp lại, nhắm mục tiêu, hoặc truy cập vào kho hoặc minimap.

Phản hồi xúc giác

Nhiều điều khiển gamepad có động cơ tích hợp để cung cấp phản hồi xúc giác. Thêm rung và dao động có thể làm tăng đáng kể trải nghiệm của người chơi và cung cấp phản hồi tinh tế hơn ngoài hình ảnh hoặc âm thanh.

Roblox hỗ trợ haptic cho gamepad PlayStation, gamepad Xbox, và điều khiển Quest Touch. Phản hồi xúc giác được quản lý thông qua các thể hiện HapticEffect có thể được đặt thành một Type cụ thể như GameplayCollision hoặc UIClick.

Khi một HapticEffect đã được thiết lập, bạn có thể khởi động nó thông qua phương thức Play(), ví dụ:


local Workspace = game:GetService("Workspace")

local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Parent = Workspace

-- Chạy hiệu ứng haptic
effect:Play()

Mô phỏng điều khiển

Bộ mô phỏng điều khiển có thể truy cập từ menu Kiểm tra của Studio, cho phép bạn mô phỏng chính xác đầu vào của tay cầm trò chơi ngay trong Studio. Bộ điều khiển mặc định là một tay cầm chung, nhưng bạn có thể chọn các lựa chọn khác từ menu lựa chọn ở góc trên bên trái.

Trong khi kiểm tra trò chơi, bạn có thể điều khiển trò chơi bằng bộ điều khiển ảo bằng cách sử dụng chuột của mình.

Bạn cũng có thể nhấp vào Chỉnh sửa ánh xạ ở góc trên bên phải để xem và chỉnh sửa các ánh xạ phím cho bộ điều khiển ảo, chẳng hạn như E thành ButtonL2 hoặc 9 thành ButtonA. Các ánh xạ này được lưu giống như các cài đặt khác của Studio (theo bộ điều khiển, theo người dùng, theo máy tính) và được chuyển đổi thành các sự kiện tay cầm trong cả cửa sổ mô phỏng và khung nhìn 3D.