Controller

Supported platforms:
Available since: Gideros 2014.01
Inherits from: EventDispatcher

Description

The controller interface allows you to use most popular controllers on all supported operating systems under the same interface.

Internally Controller Interface also matches all buttons and controller behavior under the same scheme so you won't have to worry about that anymore.

For a FULL DEMO please see Gideros Studio, Example Projects, Hardware, Controller Plugin Demo

Example

require "controller"

function findKeyCode(code)
	for i, val in pairs(KeyCode) do
		if val == code then return i end
	end
	return "unknown"
end

controller:addEventListener(Event.KEY_DOWN, function(e)
	print("Button Down ", e.playerId, e.keyCode, findKeyCode(e.keyCode))
end)

controller:addEventListener(Event.KEY_UP, function(e)
	print("Button Up ", e.playerId, e.keyCode, findKeyCode(e.keyCode))
end)

controller:addEventListener(Event.RIGHT_JOYSTICK, function(e)
	print("Player: ", e.playerId)
	print("RIGHT_JOYSTICK:", "x:"..e.x, "y:"..e.y, "angle:"..e.angle, "strength:"..e.strength)
end)

controller:addEventListener(Event.LEFT_JOYSTICK, function(e)
	print("Player: ", e.playerId)
	print("LEFT_JOYSTICK:", "x:"..e.x, "y:"..e.y, "angle:"..e.angle, "strength:"..e.strength)
end)

controller:addEventListener(Event.RIGHT_TRIGGER, function(e)
	print("Player: ", e.playerId)
	print("RIGHT_TRIGGER:", "strength:"..e.strength)
end)

controller:addEventListener(Event.LEFT_TRIGGER, function(e)
	print("Player: ", e.playerId)
	print("LEFT_TRIGGER:", "strength:"..e.strength)
end)

controller:addEventListener(Event.CONNECTED, function(e)
	print("Player: ", e.playerId, "connected")
	print("Are there any controllers?", controller:isAnyAvailable())
	print("Controller count", controller:getPlayerCount())
	print("Name of controller "..e.playerId, controller:getControllerName(e.playerId))
	print("players", #controller:getPlayers())
end)

controller:addEventListener(Event.DISCONNECTED, function(e)
	print("Player: ", e.playerId, "disconnected")
end)

Methods Controller:getControllerName gets the name of the controller Controller:getPlayerCount returns the amount of connected controllers Controller:getPlayers returns a table with controller IDs Controller:isAnyAvailable returns true if any controller is connected Controller:vibrate vibrates the controller for provided amount of miliseconds

Events Event.CONNECTED Event.DISCONNECTED Event.KEY_DOWN Event.KEY_UP Event.LEFT_JOYSTICK Event.LEFT_TRIGGER Event.RIGHT_JOYSTICK Event.RIGHT_TRIGGER Constants

---

• Main Page
• Lua API
• Main API
• Plugins