// Godot 4 Integration

This is a basic Godot 4 demo showing how to use the Ollo SDK with its internal camera capture system.

Ollo SDK for Godot 4 ships as a GDExtension C++ bridge. The SDK handles video input and blink detection automatically.

This example is ideal for quick integration or standalone setups where camera control is not required from the engine.

Features

• Uses Ollo's internal camera access
• Connects blink detection signal to scene logic
• Updates a 3D material and label on blink event

Requirements

• Godot 4.4 or later, on Windows x64
• The Ollo SDK for Godot, from your dashboard: ollo-godot-windows-x86_64-v<version>.zip

Add the SDK

1. Extract the zip into your project's folder. It adds addons/ollo/: the plugin and its scripts, and in bin/ the SDK, its model and the DLLs it needs.
2. Enable the plugin: Project > Project Settings > Plugins, tick Ollo.
3. In the Ollo panel, press Sign in and approve the code in your browser (SDK Activation). Until then, the running game shows Ollo's evaluation watermark.

Exporting

Nothing to set up: every export is stamped, so the exported game runs without the watermark on any machine, offline. Each stamp names your game by its App ID, which you can change in the Ollo panel or under Project Settings > Ollo > App Id.

On a build server, set OLLO_BUILD_TOKEN to a build token from your dashboard; exports made there are stamped with it. An export that can't be stamped still completes, and the output says why its game will show the watermark.

Overview

• ollo.gd: Initializes and runs the Ollo SDK (autoload)
• Demo.tscn: The main scene with 3D mesh and UI
• demo.gd: Reacts to blink events and updates visuals

The ollo.gd script is autoloaded as a global singleton to manage the SDK lifecycle.

Run

1. Open the project in Godot 4
2. Run the Demo.tscn scene
3. Ensure your webcam is not in use by other apps (configurable via camera_index)

Error codes

Error	Fix
2–3	Check model file bundled with plugin
4–5	Ensure webcam access is not blocked by OS
6	Internal exception (rare; report if seen)

Licensing never stops Ollo from starting: without a license it runs with the evaluation watermark.