Tornseglare.XBoxController
1.0.4
dotnet add package Tornseglare.XBoxController --version 1.0.4
NuGet\Install-Package Tornseglare.XBoxController -Version 1.0.4
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Tornseglare.XBoxController" Version="1.0.4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Tornseglare.XBoxController --version 1.0.4
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Tornseglare.XBoxController, 1.0.4"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Tornseglare.XBoxController as a Cake Addin #addin nuget:?package=Tornseglare.XBoxController&version=1.0.4 // Install Tornseglare.XBoxController as a Cake Tool #tool nuget:?package=Tornseglare.XBoxController&version=1.0.4
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
XBoxController
Using the Vortice.Windows nuget, see https://github.com/amerkoleci/Vortice.Windows for more examples.
For a working and more up-to-date demo, please see the XBoxController_Tests project here: https://github.com/tornseglare/XBoxController/tree/main/XBoxController_Tests
How to use
using Vortice.XInput;
using MASK;
// Starts a task which periodically look for newly connected controllers.
XBoxControllerPoller.StartPolling();
// Somewhere in your game/app:
if (XBoxControllerPoller.xBoxControllers.Count > 0)
{
// Once a controller has been detected and added by the XBoxControllerPoller, it will always remain.
XBoxController controller = XBoxControllerPoller.xBoxControllers[0];
if (controller.Connected)
{
if (controller.Update())
{
if (controller.JustPressedA)
{
// A button just got pressed.
}
if(controller.JustReleasedA)
{
// A button just got released.
}
if (controller.RightTrigger > Gamepad.TriggerThreshold)
{
// Using the Vortice.XInput functionality here.
if (XInput.SetVibration(controller.UserIndex, 0.0f, controller.RightTrigger / 255.0f) == false)
{
Console.WriteLine("Device not connected!");
}
}
}
// Regardless of if Update() returns true or false you can always check the current state.
// (Not with the JustPressed/ReleasedXYZs though, these changes only when Update() has detected a change and returns true, naturally.)
if(controller.A)
{
// The A button is pressed.
}
}
}
// Somewhere in your code during exiting the app you should terminate the polling task.
XBoxControllerPoller.StopPolling();
Use the connected/reconnected event
using Vortice.XInput;
using MASK;
// Somewhere in your setup.
XBoxControllerPoller.XBoxControllerEvent += XBoxControllerPoller_XBoxControllerEvent;
XBoxControllerPoller.StartPolling();
// Your event listener function.
void XBoxControllerPoller_XBoxControllerEvent(XBoxController xBoxController, XBoxControllerEventState state)
{
if(state == XBoxControllerEventState.Connected)
{
Console.WriteLine($"Controller {xBoxController.UserIndex} connected!");
}
else if(state == XBoxControllerEventState.Reconnected)
{
Console.WriteLine($"Controller {xBoxController.UserIndex} reconnected!");
}
else if(state == XBoxControllerEventState.Disconnected)
{
// Player/User has disconnected the controller. Urge them to reconnect it.
Console.WriteLine($"Controller {daController!.UserIndex} disconnected!");
}
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net6.0
- Vortice.XInput (>= 2.4.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
disconnected event added