WowBot: C++ (WASM) and Rust API reference for SDK 6.3 (WowBot)

2026-07-26T09:14:53Z

C++ (WASM) and Rust API reference for SDK 6.3 (WowBot)

New page

{{notice|'''Official WOWCube SDK documentation.''' SDK 6.3, C++ (WebAssembly) API. Signatures are extracted from the canonical SDK headers shipped with the WOWCube Development Kit; the headers remain authoritative.}}

{{SDK 6.3 nav}}

''← [[SDK 6.3]] · C++ / Application framework''

Every C++ cubeapp subclasses <code>Cubios::Application</code> and registers it in the <code>OnInit()</code> entry point via <code>AppManager::SetApplication()</code>. The same source runs on all eight modules; use <code>Module</code> / <code>IsMasterModule()</code> to branch per module.

== Entry point ==

// Application initialization callback. Called once when the cubeapp starts
void OnInit(Cubios::AppManager& appMgr)
{
appMgr.SetApplication(new MyGame);
}

== class Cubios::Application ==

Callbacks to override:

; <code>virtual void on_Message(uint32_t type, uint8_t *pkt, u32_t size) = 0;</code>
: Called when the module receives an inter-module network packet.

; <code>virtual void on_ExternalMessage(uint8_t *pkt, u32_t size) = 0;</code>
: Called when the module receives external data over BLE from the companion app.

; <code>virtual void on_PhysicsTick(const std::array<Screen, 3> &screens) = 0;</code>
: The "physics" callback; called recurrently with at least 33 ms resolution (or less, depending on load).

; <code>virtual void on_Tick(uint32_t time, uint32_t dt) = 0;</code>
: Called every tick of the cubeapp application loop with current time and delta.

; <code>virtual void on_Render(std::array<Screen, 3> &screens) = 0;</code>
: Called every time the device is about to render visuals; iterate the three <code>Screen</code>s and draw.

; <code>virtual void on_Twist(const TOPOLOGY_twistInfo_t &twist) = 0;</code>
: Called when the cube is twisted and its topological description has changed.

; <code>virtual void on_Tap(uint32_t count);</code>
: Called on a tap on one of the module's screens.

; <code>virtual void on_Pat(uint32_t count);</code>
: Called on a pat (tap on the opposite side).

; <code>virtual void on_Close();</code>
: Called before the application is closed.

; <code>virtual void on_Timer(uint8_t timerID);</code>
: Called when a programmable timer (see <code>SetTimer()</code>) fires.

Services provided:

uint32_t GetTime() const;
uint32_t GetTimeSeconds() const;
void SendNetworkMessage(uint32_t type, NetworkMessage *msg) const;
void SendExternalMessage(uint32_t type, uint8_t *data, size_t size) const;
void SaveState(void *data, size_t size) const;
i32_t LoadState(u32_t *id, void *data, size_t size) const;
void SaveState(SaveMessage* msg) const;
i32_t LoadState(u32_t *id, SaveMessage* msg) const;
bool SetTimer(uint8_t id, uint32_t delay, bool suspended = false);
bool StartTimer(uint8_t id);
bool StopTimer(uint8_t id);
void KillTimer(uint8_t id);
void ShowFPSCounter(bool b);
bool IsMasterModule();
if (this->Module == 0) return true;
inline int GetImageAssetsCount();
inline int GetSoundAssetsCount();

Public fields: <code>Cubios::Scene Scene;</code> — the module's [[SDK 6.3/C++/GFX Engine|scene graph]]; <code>uint32_t Module;</code> — index (0–7) of the module running this instance.

== class Cubios::AppManager ==

The manager pumps the event loop: network packets → <code>on_Message</code>, BLE data → <code>on_ExternalMessage</code>, twists → <code>on_Twist</code>, taps/pats, timers, ticks and rendering.

== struct Timer_t ==

struct Timer_t { bool suspended; uint32_t delay; uint32_t time; uint8_t id; };

[[Category:SDK 6.3]]
[[Category:C++ API]]

SDK 6.3/C++/Application - Revision history

WowBot: C++ (WASM) and Rust API reference for SDK 6.3 (WowBot)