Skip to content

intro.mdx

Latest commit

 

History

History
82 lines (61 loc) · 3.49 KB

intro.mdx

File metadata and controls

82 lines (61 loc) · 3.49 KB
sidebar_position 1
title Introduction
slug /intro
description VeltoKit — unofficial BLE motion SDK for iOS games

import Link from '@docusaurus/Link'; import SkillDownloads from '@site/src/components/SkillDownloads';

VeltoKit

Experimental Swift layer: reverse-engineered BLE cap controller → GameInput. Learn how tilt, throw gestures, and button edges become game-ready fields every frame.

Use Search in the navbar (⌘K / Ctrl+K) to find topics. AI assistants: start with Context for AI or repo root AGENTS.md — then download skills below or on For Cursor Claude.

:::info Po polsku — wyszukiwarka i skille Wyszukiwarka: pole Search w prawym górnym rogu nawigacji — skrót ⌘K (Mac) lub Ctrl+K (Windows/Linux).
Pobranie skilli Cursor / Claude: sekcja Download AI skills na tej stronie, menu AI Skills w navbarze, albo strona For Cursor Claude. :::

:::caution Independent project Unofficial implementation for education and development. Not affiliated with any hardware manufacturer or brand. :::

Test hardware

We developed against a generic BLE motion cap (IMU + button). Any source that exposes similar gyro bytes + a button packet works — or use the sample Platform adapter as-is.

Generic BLE motion cap — top view

Pipeline

BLE notify  →  enqueueBLE / parse  →  MotionSDK.updateFrame()  →  GameInput  →  your game

Sample games

Each demo documents VeltoKit mode, GameInput fields, and source files in the repo.

Game MotionMode (sample) Main GameInput
Pong .paddle posX
Dart .pointer + throw FSM posX, posY, sensors
Bowling .gesture posX, shotTriggered, throwPower
Quiz .paddle posX, primaryAction

Documentation map

I want to… Start here
Run the sample app on iPhone Getting started
Copy SDK into my project Installation → SDK overview
Minimal Swift loop Quick start
See games + videos Demo
API reference VeltoKit SDK
Fix jitter / weak throws Configuration
Connect controller in one call Quick start (connect() + pollInput())
Wire my own BLE stack BLE integration
Help — app, controller, TV Help
Search all docs Use the Search box in the top bar (⌘K / Ctrl+K)
AI assistant confused by docs Context for AI · AGENTS.md in repo root
Calibrate cap + Triki menu (like Quiz) Triki UI — calibration & simple menu
Download Cursor / Claude skills Download AI skills on this page

Download AI skills {#download-ai-skills}

Repo layout

VeltoKit/     MotionSDK.connect(), BLEManager, GameInput
app/          Sample iOS app (open app/gametriki.xcodeproj)
  Platform/   TrikiInputAdapter (optional calibration UI)
  Engine/     Game loop
  Games/      Pong, Dart, Bowling, Quiz
website/      This documentation (Docusaurus)

Quick start · SDK overview · Demo