Articles on: Actions / Outputs

Gamepad Actions — Map Any Input to Virtual Controller Buttons and Sticks

Goal:

Use PlayAbility to emulate a full Xbox-style controller, letting your camera, microphone, or keyboard act as a complete virtual gamepad.


Overview:

When you map an input (like a smile, nod, or key press) to a Gamepad Action, PlayAbility sends a signal through its virtual controller.

This lets any game think a real controller is connected — no extra drivers needed.


Available Actions:

  • Buttons: A, B, X, Y, Start, Back, Guide, LB, RB, D-Pad directions
  • Sticks: Left/Right stick (X and Y axes, full analog range)
  • Triggers: Left and Right trigger (progressive analog from 0.0–1.0)
  • Stick Directions: Quick “flick” mappings like LEFT_STICK_UP or RIGHT_STICK_RIGHT


Examples:

  • mouthSmileLeft → A button
  • yaw (head turn) → Left Stick X-axis
  • raiseBrows → Right Trigger (accelerate)


Tips for Best Results:

  • Start with a template profile (like “Full Gamepad” or “Racing Game”).
  • Adjust deadzones for smoother analog motion.
  • Use Short Press mode for single taps or Hold mode for continuous input.
  • Check your controller connection in Windows Gamepad Tester if unsure.


Updated on: 03/11/2025