OKONAONLINE

OkonaInputBridge

OkonaPad.Input.OkonaInputBridge

The main component that receives input from the website and updates Unity Input System devices.

Lifecycle Methods

Called by the website shell via JavaScript SendMessage:

// Called when a phone controller connects or reconnects
public void OnControllerConnected(int controllerId)

// Called when a phone controller temporarily disconnects
public void OnControllerDisconnected(int controllerId)

// Called when a phone controller is permanently removed
public void OnControllerRemoved(int controllerId)

// Called with binary input data (JSON with base64 payload)
// Format: {"controllerId":1,"data":"base64string"}
public void ReceiveControllerMessageBase64(string jsonData)

Events

// New device created for the first time
event Action<int, OkonaPadControllerDevice> OnDeviceConnected;

// Temporary disconnect - device preserved
event Action<int> OnDeviceDisconnected;

// Previously disconnected device has reconnected
event Action<int, OkonaPadControllerDevice> OnDeviceReconnected;

// Permanent removal - device destroyed
event Action<int> OnDeviceRemoved;

Helper Methods

// Get device for a specific controller ID (null if not found)
public OkonaPadControllerDevice GetDevice(int controllerId)

// Get connection state for a controller
public DeviceConnectionState? GetConnectionState(int controllerId)

// Get all controller IDs (connected and disconnected)
public int[] GetAllControllerIds()

// Get only connected controller IDs
public int[] GetConnectedControllerIds()

// Enable/disable debug logging
public void EnableDebugLogging(bool enable)

OkonaPadControllerDevice

OkonaPad.Input.OkonaPadControllerDevice

Custom Unity InputDevice representing a smartphone controller. This is not a Gamepad — it only exposes controls that physically exist on the phone controller.

Controls

Input Binding Paths

Properties

Haptic Feedback

OkonaPadControllerDevice implements IDualMotorRumble. Subscribe to the static event to forward rumble to controllers:

OkonaPadControllerDevice.OnRumbleRequested += (controllerId, lowFreq, highFreq) =>
{
    // Forward haptic feedback to the phone controller
};

Usage Example

using OkonaPad.Input;
using UnityEngine;
using UnityEngine.InputSystem;

public class PlayerController : MonoBehaviour
{
    private OkonaPadControllerDevice controller;

    void Start()
    {
        var bridge = OkonaInputBridge.Instance;
        if (bridge != null)
        {
            bridge.OnDeviceConnected += (id, device) =>
                controller = device;
            bridge.OnDeviceRemoved += (id) =>
            {
                if (controller?.ControllerId == id)
                    controller = null;
            };
        }
    }

    void Update()
    {
        if (controller == null) return;

        // Read button states
        if (controller.ButtonA.wasPressedThisFrame)
            Jump();

        // Read joystick
        Vector2 movement = controller.LeftStick.ReadValue();
        Move(movement);

        // Read D-Pad
        if (controller.DPad.up.isPressed)
            MoveUp();
    }
}

Using PlayerInputManager (Recommended)

For multiplayer, use Unity's PlayerInputManager with "Join Players When Button Is Pressed". Players auto-destroy when their device is removed:

private PlayerInput _playerInput;

void Awake()
{
    _playerInput = GetComponent<PlayerInput>();
    _playerInput.onDeviceLost += (pi) => Destroy(gameObject);
}

BinaryProtocol

OkonaPad.Networking.Binary

Defines the binary message format for controller input. Messages use a length-prefixed format:

[Length: 2 bytes BE] [MessageType: 1 byte] [Payload: variable]

Message Types

Button Codes

D-pad Directions