Translate
Skip to main content
ExperimentalBLE SDK

Add motion control to your app in minutes

Use Triki with Swift to turn real-world movement into game input via BLE. One GameInput struct per frame — paddle, throw, or pointer.

View Swift docsBuild demo app
posX

Swift

Integrate in minutes

Call connect(), then pollInput() each frame — MotionSDK handles BLE scan and maps packets to GameInput. Or feed your own bytes with enqueueBLE; TrikiInputAdapter in the sample app adds calibration UI.

Open Swift quickstart →
import VeltoKit

let motion = MotionSDK()
motion.setMode(.paddle)

motion.connect()

func update(dt: TimeInterval) {
  let input = motion.pollInput(deltaTime: dt)
  paddle.x = CGFloat(input.posX) * viewWidth
  if input.didShoot { serveBall() }
}

How it works

1

Connect via BLE

Scan for the Triki device, pair once, stream gyro + button bytes.

2

Read motion

Tilt, rotation, press — normalized and smoothed inside VeltoKit.

3

Map to game actions

Read GameInput each frame; drive sprites, UI, or physics.

Game examples

Reference demos in this repo — copy the pattern, swap the art.

…

Pong

You: Tilt left / right

In game: Moves the paddle along the bottom edge

setMode(.paddle)

Open game docs →
…

Dart

You: Pull back, then flick forward

In game: Aims with tilt; throw power sets dart velocity

setMode(.pointer)

Open game docs →
…

Bowling

You: Swing motion + aim tilt

In game: Lane offset from tilt; swing maps to ball power (3D SceneKit demo)

setMode(.gesture)

Open game docs →
…

Quiz

You: Tilt to highlight · press to confirm

In game: Selects answer A–D; button edge submits

setMode(.paddle)

Open game docs →

Motion inputs

Map hardware signals to gameplay with MotionSDK modes or direct fields on GameInput.

Tilt
posX, posY
Aim, paddle, menu highlight
Rotation
rotation, lateral
Fine steering, alternate axis
Gesture throw
shotTriggered, throwPower
Dart, bowling, any powered action
Press
didShoot, primaryAction
Confirm, fire, menu OK

SDK-only path (no adapter):

import VeltoKit

let sdk = MotionSDK()
sdk.enqueueBLE(bleBytes)
sdk.updateFrame(deltaTime: dt)
let input = sdk.input  // posX, throwPower, didShoot, …

SDK roadmap

  • Swift (iOS / macOS)VeltoKit + sample Xcode project
    Available
  • Godot pluginGDExtension bridge
    Coming soon
  • Unity SDKC# wrapper over BLE + input
    Coming soon

Build a demo in Swift

  1. Clone the repo, cd app/, and open gametriki.xcodeproj in Xcode.
  2. Run on a physical iPhone — enable Bluetooth
  3. Connect your Triki device from the Connect screen
  4. Launch Pong, Dart, Bowling, or Quiz from the menu
Download demo projectWatch demos

Docs search & AI skills

Search all documentation from the navbar (⌘K / Ctrl+K). Download ready-made Cursor or Claude prompt files below.

Download AI skills

One-file prompts for Cursor or Claude. In a clone they are at website/static/skills/. Use the docs Search box in the navbar (⌘K / Ctrl+K) to find SDK topics quickly.

PL: Wyszukiwarka — pole Search w prawym górnym rogu (`⌘K` / `Ctrl+K`). Pobranie skilli — przyciski poniżej lub menu AI Skills → ↓ Download Cursor (.md) / ↓ Download Claude (.md).

Cursorcursor-skill.mdDownloadClaudeclaude-skill.mdDownload
Direct links (copy)

Best for understanding the repo: open AGENTS.md at the repo root (already in clone). Cursor: skill is at .cursor/skills/veltokit/SKILL.md or paste downloaded file into chat. Claude: attach AGENTS.md or add Project instructions from the downloaded file.

Open full AI skills hub →

Start building with motion

Swift-first SDK, open sample games, docs you can skim in five minutes.

Read docsGet Swift starter