Podrobný návod k provozu – Kinect 360 Standalone

Podrobný návod k provozu

← Úvodní stránka produktu · Co je v balíčku · kin3 modely · Kalibrace kin3

Režimy kin1 (kostra z 20 kloubů) a kin2 (postava z depth bodů) používají senzor Microsoft Kinect pro Xbox 360. Aplikace nemluví se senzorem přímo – mezi Kinectem a vizualizací běží lokální služba app\Kinect360Bridge.exe (WebSocket ws://127.0.0.1:8765 na stejném PC). Host KinectKioskHost.exe bridge spustí automaticky.

1. Struktura složky Kinect

Kořen obsahuje dokumentaci (PHP). Vše spustitelné včetně .bat souborů je ve složce app\.

2. Jak aplikace funguje

1. Dvojklik na app\start-kin1.bat (kostra) nebo app\start-kin2.bat (point cloud).
2. Spustí se app\KinectKioskHost.exe, který automaticky naběhne s app\Kinect360Bridge.exe.
3. Bridge čte Kinect senzor a posílá data na WebSocket port 8765.
4. Host otevře celoobrazovkové okno – kostra nebo point cloud se zobrazí hned.

3. Co potřebujete (hardware)

Kinect 360 nefunguje na Linuxu, Raspberry Pi ani bez bridge služby. Pro test bez senzoru zapněte demo režim v kinect.json (kin1_mock_mode / kin2_mock_mode).

4. Zapojení senzoru

1. Připojte napájení Kinectu do zásuvky.
2. Kabel senzoru zapojte do USB adaptéru, adaptér do USB portu PC.
3. Postavte Kinect na stabilní místo ve výšce hrudníku, mírně nakloněný nahoru k návštěvníkovi.
4. Na vertikálním kiosku mějte senzor před nebo vedle monitoru, čočkou k prostoru, kde stojí návštěvník.

5. Software ke stažení

Na kiosk PC s Kinectem potřebujete několik vrstev software. Každá má jiný účel – vizualizace nemluví s Kinectem přímo, proto je mezi nimi bridge a ovladače Microsoftu.

Proč ne stačí jen vizualizace? Kinect SDK běží jen v nativní Windows aplikaci (C#). Z bezpečnostních důvodů nemá přímý přístup k USB senzoru – proto lokální bridge na portu 8765.

6. Instalace Kinect for Windows SDK 1.8

Oficiální ovladače jsou v balíku Kinect for Windows SDK 1.8. Na Windows 10 i 11 obvykle funguje; SDK je ukončené, ale pro Kinect 360 je to jediná podporovaná cesta.

1. Stáhněte a spusťte instalátor KinectSDK-v1.8-Setup.exe (64 bit).
2. Projděte průvodce – nainstalují se ovladače, runtime a knihovna Microsoft.Kinect.dll.
3. Po instalaci restartujte PC.
4. Otevřete Správce zařízení → měl by se objevit Kinect pod kamerami / Xbox NUI (bez žlutého vykřičníku).

Pokud instalátor hlásí chybu, zkuste spustit jako správce a dočasně vypnout antivirus. Cesta k DLL po instalaci: C:\Program Files\Microsoft SDKs\Kinect\v1.8\

Windows 10 / 11 – Integrita paměti a ovladač kinectcamera.sys

Důležité na Windows 11 (a někdy i na Windows 10): výchozí funkce Integrita paměti (součást Izolace jádra / Core isolation) blokuje starý ovladač Kinect SDK 1.8 kinectcamera.sys. Senzor se v USB sice může objevit, ale kamera nebude fungovat – bridge hlásí Kinect stav: NotPowered, na obrazovce uvidíte jen „Čekám na tělo v záběru“, i když demo režim je vypnutý.

Typické příznaky

• Dialog Pomocník s kompatibilitou programů: „Na tomto zařízení nejde načíst určitý ovladač“ – kinectcamera.sys
• Správce zařízení → Kinect for Windows Camera se žlutým vykřičníkem (často chyba ovladače 39)
• Kinect360Bridge.exe: Kinect stav: NotPowered nebo „Kinect senzor nebyl nalezen“, přestože napájení a USB jsou zapojené
• Status „Kinect připojen“, ale žádná kostra ani depth body

Řešení (doporučený postup na kioskovém PC)

1. Otevřete Nastavení → Soukromí a zabezpečení → Zabezpečení Windows → Zabezpečení zařízení.
2. Klikněte na Podrobnosti o izolaci jádra (Core isolation details).
3. Vypněte přepínač Integrita paměti (Memory integrity).
4. Restartujte PC – bez restartu se ovladač nenačte.
5. Po restartu ve Správci zařízení ověřte, že Kinect for Windows Camera nemá chybu.
6. Znovu spusťte exponát – v konzoli bridge má být [Kinect] Senzor spuštěn, ne NotPowered.

Rychlý odkaz: ms-settings:windowsdefender → Zabezpečení zařízení → Izolace jádra.
Ověření ve Správci zařízení (PowerShell): Get-CimInstance Win32_PnPEntity | Where-Object { $_.Name -match 'Kinect.*Camera' } – sloupec ConfigManagerErrorCode má být 0.

Bezpečnost: Integrita paměti chrání proti nekompatibilním ovladačům. Kinect 360 + SDK 1.8 je legacy hardware – na dedikovaném kioskovém PC bez citlivých dat je vypnutí běžné. Na běžném pracovním počítači raději nechte zapnuto a Kinect používejte jen na samostatném stroji.

7. Příprava Windows 10 / 11 pro kiosk

1. Nainstalujte Kinect SDK 1.8 a ověřte senzor ve Správci zařízení (viz kapitola 6).
2. Nainstalujte WebView2 Runtime, pokud chybí (černá obrazovka po spuštění).
3. Zkopírujte celou složku Kinect na kiosk PC (nebo ověřte, že app\ obsahuje všechny soubory).
4. Upravte app\data\kinect.json – pro produkci vypněte demo režim (kin1_mock_mode / kin2_mock_mode = false).
5. Doporučeno: vytvořte samostatný kiosk účet bez admin práv pro veřejný provoz.
6. Volitelně zapněte automatické přihlášení kiosk účtu (jen u fyzicky hlídaného PC).

8. První spuštění – krok za krokem

1. Připojte Kinect 360 podle kapitoly 4 (nebo zapněte demo režim v kinect.json).
2. Ověřte, že ve složce app\ jsou soubory KinectKioskHost.exe, Kinect360Bridge.exe a složka www\.
3. Pro test bez senzoru nastavte v app\data\kinect.json hodnotu "kin1_mock_mode": true (nebo kin2_mock_mode).
4. Dvojklik na app\start-kin1.bat (kostra) nebo app\start-kin2.bat (point cloud).
5. Počkejte několik sekund – host spustí bridge a otevře celoobrazovkové okno.
6. Při živém Kinectu postavte se 1,5–2,5 m od senzoru – měla by se objevit kostra nebo point cloud.
7. Ukončení: Ctrl+Shift+Q.

Test bridge ručně (volitelně)

Pokud potřebujete ověřit senzor odděleně od hostu:

cd C:\cesta\k\Kinect\app
Kinect360Bridge.exe

Při úspěchu uvidíte v konzoli např.:

• [WS] Server běží na portu 8765
• [Kinect] Senzor spuštěn

9. Konfigurace (app\data\kinect.json)

Všechna nastavení Kinect exponátu jsou v jednom souboru app\data\kinect.json. Upravujte ho v libovolném textovém editoru (Poznámkový blok, Notepad++, VS Code). Formát je JSON – dodržujte uvozovky, čárky a hodnoty true / false malými písmeny. Po každé změně restartujte aplikaci (app\start-kin1.bat / app\start-kin2.bat).

Vzorový soubor

{
    "exhibit_title": "Kinect 360 Standalone",
    "kin1_ws_url": "ws://127.0.0.1:8765",
    "kin1_invert_x": false,
    "kin1_invert_y": false,
    "kin1_smooth": 5,
    "kin1_show_labels": false,
    "kin1_mock_mode": false,
    "kin1_line_width": 12,
    "kin2_ws_url": "ws://127.0.0.1:8765",
    "kin2_invert_x": false,
    "kin2_invert_y": false,
    "kin2_smooth": 5,
    "kin2_mock_mode": false,
    "kin2_point_size": 3,
    "kin2_depth_color": true,
    "theme_preset": "amber"
}

Pole s prefixem kin1_ platí pro kostru (app\start-kin1.bat), pole kin2_ pro point cloud (app\start-kin2.bat). Oba režimy mohou mít různé hodnoty – např. jiné zrcadlení nebo vyhlazení.

Obecná pole

Možné hodnoty theme_preset: ocean, emerald, ruby, amber, violet, cyan, lime, rose, slate, copper.

Spojení s bridge (kin1 i kin2)

Nastavení kin1 – kostra

Nastavení kin2 – point cloud

Typické scénáře

Tip: Než nasadíte úpravy na kiosk, uložte si zálohu kinect.json. Při chybném JSON (chybějící čárka, uvozovka) aplikace nenačte config – vraťte zálohu nebo opravte syntaxi.

10. Ověření, že vše funguje

1. Bridge – po přiblížení osoby k senzoru bridge nehlásí jen „čekám“.
2. kin1 – pohybující se kostra (nebo demo animace při zapnutém mock mode).
3. kin2 – mrak bodů tvořící postavu; u reálného Kinectu potřebuje funkční depth stream z bridge.
4. Demo režim – při kin1_mock_mode: true kostra běží i bez senzoru (vhodné pro test PC).

11. Provoz

12. kin3 modely a kalibrace – samostatné kapitoly

Podrobný popis 3D modelů, spuštění bat souborů a vizuální kalibrace mapování kloubů je na samostatných stránkách – nemusíte je hledat v tomto dlouhém návodu.

Rychlé odkazy: GreyFrog Skeleton · KayKit Warrior · Postup kalibrace · Stažení skeleton packů

13. Autostart po přihlášení

Pro veřejný kiosk chcete, aby se exponát spustil sám po zapnutí PC a přihlášení uživatele.

1. Upravte a otestujte app\start-kin1.bat nebo app\start-kin2.bat dvojklikem pod kiosk účtem.
2. Vytvořte zástupce bat souboru a vložte ho do složky Po spuštění: Win+R → shell:startup.
3. Nebo použijte Plánovač úloh → při přihlášení uživatele Kiosk → akce: spustit váš .bat.

Host spouští bridge automaticky – samostatný autostart Kinect360Bridge.exe v Plánovači úloh nepotřebujete (jinak by mohl běžet dvakrát).

14. Aktualizace aplikace

rem Zkopírujte nové soubory z dodaného balíčku do složky Kinect\app\
rem (nepřepisujte app\data\kinect.json ani vlastní GLB modely)

Deploy přepíše soubory v app\, ale nezasáhne do app\data\kinect.json, pokud už existuje.

Řešení problémů (Kinect, kin3, kalibrace) a kontrolní seznam před provozem: kapitola 9 – Řešení problémů.