GameControllerBinder

A Swift framework for easily integrating game controller inputs with UI elements in iOS applications.

Overview

The GameControllerBinder framework simplifies the process of binding game controller inputs to UI elements and actions within your iOS app. With support for various controller types, including PlayStation and Xbox controllers, this framework allows for quick setup and configuration of controller inputs to enhance the gaming experience on iOS devices.

Features

• Bind actions to game controller buttons and triggers
• Support for PlayStation and Xbox controllers
• Easy integration with UI elements
• Customize button actions for press and release states

Installation

Swift Package Manager

To integrate GameControllerBinder into your Xcode project using Swift Package Manager, add it to your package's dependencies:

dependencies: [
    .package(url: "https://github.com/yourusername/GameControllerBinder.git", from: "1.0.0")
]

CocoaPods

GameControllerBinder is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'GameControllerBinder'

Don't forget to run pod install after editing the Podfile.

Usage

Here's a short example of how you can use GameControllerBinder to bind a button action to a controller button:

import GameControllerBinder

let binder = GameControllerBinder()

// Bind the 'A' button to perform an action
binder.bindButtonToAction(buttonName: .buttonA) {
    print("Button A was pressed")
}

To bind a controller's thumbstick to UI navigation:

controllerBinder.bindThumbstickToAction(thumbstickName: .rightThumbstick) { [weak self] (xValue, yValue) in
            //code that handles Thumbsticks movements
        }
    

To bind a controller`s button to UIButton:

controllerBinder.bindButtonToUIElement(buttonName: .buttonMenu, uiElement: searchButton) {
            self.performSearch()  //You can use also @objc functions or @IBAction functions here
        }

License

GameControllerBinder is available under the MIT license. See the LICENSE file for details at

https://github.com/vladshakhtar/GameControllerBinder/blob/main/LICENSE