JoyBattery ( [port] )

Parameters

port (optional) - stable controller slot, 0..15; 0 by default.

Description

Returns remaining battery percentage, 0..100, when reported by the native controller driver. Returns -1 for unknown, wired, absent or unsupported devices. Browsers do not expose controller battery information.

Supported on Windows, macOS, iOS, Android and web, subject to device and platform capabilities. Input requires application focus; device presence and names remain queryable in the background.

See also: Controller guide and button table, JoyType, FlushJoy, Controller playground.

Example

; JoyBattery example
Graphics 800,480,32,2
SetBuffer BackBuffer()
While Not KeyHit(1)
    Cls
    Text 20,20,"Connect a controller, then press a pad button. Esc exits."
    Text 20,60,"JoyBattery: "+JoyBattery()
    Flip
Wend
End

Index