Obsah · Kapitola 10 · Kinect 360 – Windows 11

Kinect Xbox 360 – příprava PC (Windows 11)

← Kapitola 10: Technické požadavky · Varianty avatara

Varianty kin1.php (kostra z 20 kloubů) a kin2.php (digitální postava z depth bodů) používají senzor Microsoft Kinect pro Xbox 360. Prohlížeč s exponátem nemluví se senzorem přímo – mezi Kinectem a webovou stránkou běží lokální služba tools/kinect360-bridge (WebSocket na stejném PC).

Shrnutí: Kinect + napájení + USB adaptér → Windows 11 → SDK 1.8 → Kinect360Bridge.exe → Chrome/Edge s kin1.php nebo kin2.php. Nastavení v administraci → Avatary → Kinect 360.

1. Co potřebujete (hardware)

Položka Poznámka
Kinect senzor Xbox 360 Černý model s vlastním napájecím kabelem (ne Kinect One / Xbox One)
USB adaptér pro PC Originál „Kinect for Windows“ nebo kvalitní náhrada; senzor nemá standardní USB-A konec
Napájecí adaptér Kinectu Součást sady; bez něj senzor na PC nefunguje
PC s Windows 11 (64 bit) Mini PC nebo kiosk; stejný počítač jako prohlížeč s exponátem
USB 2.0 port Pro Kinect 360 stačí USB 2; připojte přímo do PC (ne přes hub bez napájení)
Prostor před kioskem Návštěvník 1,5–2,5 m od senzoru, celé tělo v záběru

Kinect 360 nefunguje na Linuxu, Raspberry Pi ani v prohlížeči bez bridge služby. Pro kiosk bez legacy senzoru použijte jinou variantu avatara (Rive, Live2D, Gaze…).

2. 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.

3. Software ke stažení – přehled a důvody

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

Software Odkaz ke stažení Proč je potřeba
Kinect for Windows SDK 1.8 Microsoft Download – Kinect SDK 1.8 Jediný oficiální ovladač a runtime pro Kinect Xbox 360 na Windows; bez něj bridge senzor nevidí
.NET Framework 4.8 .NET Framework 4.8 Runtime pro Kinect360Bridge.exe; na Windows 11 obvykle už nainstalovaný
.NET SDK (volitelně) .NET SDK Pouze pro sestavení bridge z projektu (dotnet build); na kiosku stačí hotové .exe
Google Chrome google.com/chrome Doporučený prohlížeč – nejlepší Web Speech API (STT) a stabilní kiosk režim --kiosk
Microsoft Edge Předinstalovaný ve Windows 11 Alternativa k Chrome; parametr --edge-kiosk-type=fullscreen pro celou obrazovku
Kinect360Bridge Součást projektu tools/kinect360-bridge Překladač mezi Kinectem a webem – WebSocket JSON pro kin1.php / kin2.php

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

4. Instalace Kinect for Windows SDK 1.8

Oficiální ovladače a rozhraní pro vývojáře jsou v balíku Kinect for Windows SDK 1.8 (Microsoft Download Center). Na Windows 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 vypnout dočasně antivirus. Cesta k DLL po instalaci: C:\Program Files\Microsoft SDKs\Kinect\v1.8\

5. Sestavení a spuštění Kinect360Bridge

Služba je ve složce projektu tools/kinect360-bridge. Čte skeleton i depth body a posílá je na ws://127.0.0.1:8765 (výchozí port).

Požadavky pro sestavení:

  • .NET Framework 4.8 (součást Windows 11, případně doinstalovat)
  • .NET SDK (pro příkaz dotnet build) nebo Visual Studio Build Tools

PowerShell Sestavení bridge

cd C:\inetpub\wwwroot\AI-MODE\tools\kinect360-bridge
dotnet build -c Release

Chybí .NET SDK? (No .NET SDKs were found)

Pokud příkaz dotnet build skončí chybou „No .NET SDKs were found“, na PC není nainstalované vývojové SDK. To je běžné – .NET Framework 4.8 (runtime pro spuštění .exe) a .NET SDK (pro sestavení z kódu) jsou dvě různé věci.

Komponenta K čemu slouží Potřebujete při…
.NET Framework 4.8 Runtime – spuštění hotového Kinect360Bridge.exe Provoz na kiosku (na Win 11 obvykle už je)
.NET SDK Nástroje dotnet build, kompilátor Sestavení bridge na tomto PC (jednorázově při přípravě)

Postup instalace .NET SDK (Windows 11, 64 bit)

  1. Otevřete dotnet.microsoft.com/download.
  2. V sekci .NET SDK stáhněte aktuální LTS verzi pro Windows (x64) – např. .NET 8 SDK nebo novější. Nestahujte jen „Runtime“ ani „ASP.NET Core Runtime“ – potřebujete právě SDK.
  3. Spusťte stažený instalátor (dotnet-sdk-*-win-x64.exe), projděte průvodce, dokončete instalaci.
  4. Zavřete všechna okna PowerShell / CMD a otevřete nové (aby se načetla systémová PATH).
  5. Ověřte: 
    dotnet --version
    Mělo by vypsat číslo verze (např. 8.0.4xx). Když příkaz dotnet stále neexistuje, restartujte PC.
  6. Znovu sestavte bridge (každý řádek zvlášť): 
    cd C:\inetpub\wwwroot\AI-MODE\tools\kinect360-bridge
dotnet build -c Release
  7. Po úspěšném buildu spusťte: 
    .\bin\Release\net48\Kinect360Bridge.exe

Tip: Na provozním kiosku SDK po sestavení nepotřebujete – stačí zkopírovat celou složku bin\Release\net48\ s Kinect360Bridge.exe. SDK instalujte jen na PC, kde bridge poprvé kompilujete. Stejný postup platí i pro Orbbec Astra+ / AstraBridge.

Častá chyba v PowerShellu: nepište \cd ani cd cd C:\…. Správně je jen cd C:\inetpub\wwwroot\AI-MODE\tools\kinect360-bridge (jeden příkaz cd).

PowerShell Spuštění (nechte běžet)

.\bin\Release\net48\Kinect360Bridge.exe

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

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

Volitelně vlastní port: Kinect360Bridge.exe 8766 – stejnou adresu nastavte v adminu u pole WebSocket.

6. Nastavení v AI-MODE

  1. Otevřete administraci → Avatary → Kinect 360.
  2. Zkontrolujte WebSocket adresu (ws://127.0.0.1:8765).
  3. Pro test bez senzoru nechte zapnutý Demo režim; s reálným Kinectem ho vypněte.
  4. Uložte nastavení.
  5. V prohlížeči na stejném PC otevřete kin1.php nebo kin2.php a obnovte stránku (Ctrl+F5).
Exponát Co zobrazuje
kin1.php Kostra – čáry mezi 20 klouby
kin2.php Point cloud – tisíce depth bodů tvořících digitální siluetu

Společná nastavení (zrcadlení, vyhlazení, demo) platí pro oba exponáty. Hlasový dialog (mikrofon, AI, TTS) funguje stejně jako u Rive nebo základního SVG avatara.

7. Spuštění kiosku přes .bat (Chrome / Edge, skrytí plochy)

Pro veřejný provoz nestačí ručně otevřít prohlížeč. Doporučený postup: jeden bat soubor po přihlášení kiosk účtu spustí bridge, ukončí explorer.exe (zmizí plocha a hlavní panel) a otevře exponát v kiosk režimu prohlížeče na celé obrazovce.

Proč skrýt explorer.exe?

  • Samotný --kiosk skryje lištu prohlížeče, ale návštěvník může stisknout Win nebo Alt+Tab a dostat se na plochu.
  • taskkill /f /im explorer.exe ukončí Průzkumník Windows – zůstane jen fullscreen exponát.
  • Kiosk účet bez admin práv – návštěvník nemůže snadno měnit systém.

Proč kiosk režim prohlížeče?

  • Žádné záložky, adresní řádek ani tlačítko Zavřít – vhodné pro dotykový vertikální monitor.
  • --autoplay-policy=no-user-gesture-required – TTS (hlas AI) může začít po klepnutí na Start bez dalšího gesta.
  • Parametry --disable-session-crashed-bubble a --noerrdialogs potlačí rušivé dialogy po pádu nebo aktualizaci.

Hotové šablony jsou ve složce projektu tools/kiosk/: start-kinect-kiosk-chrome.bat a start-kinect-kiosk-edge.bat. Před nasazením upravte URL exponátu a cestu k Kinect360Bridge.exe.

.bat start-kinect-kiosk-chrome.bat (zkrácený vzor)

@echo off
rem UPRAVTE: URL kin1.php nebo kin2.php, cesta k bridge a Chrome
set "EXHIBIT_URL=http://localhost/kin1.php"
set "BRIDGE_EXE=C:\inetpub\wwwroot\AI-MODE\tools\kinect360-bridge\bin\Release\net48\Kinect360Bridge.exe"
set "CHROME_EXE=C:\Program Files\Google\Chrome\Application\chrome.exe"

rem Počkat na síť a IIS
timeout /t 10 /nobreak

rem Bridge MUSÍ běžet před prohlížečem (WebSocket :8765)
start "" /MIN "%BRIDGE_EXE%"
timeout /t 4 /nobreak

rem Skrýt plochu Windows
taskkill /f /im explorer.exe 2>nul

rem Kiosk Chrome
start "" "%CHROME_EXE%" --kiosk --no-first-run --no-default-browser-check --disable-infobars --disable-session-crashed-bubble --disable-restore-session-state --noerrdialogs --disable-notifications --autoplay-policy=no-user-gesture-required "%EXHIBIT_URL%"

.bat Microsoft Edge – stejný postup, jiný exe a parametr

set "EDGE_EXE=C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
start "" "%EDGE_EXE%" --kiosk --edge-kiosk-type=fullscreen --no-first-run --disable-session-crashed-bubble --autoplay-policy=no-user-gesture-required "%EXHIBIT_URL%"

Autostart bat souboru

  1. Upravte bat a otestujte dvojklikem pod kiosk účtem – měl by naběhnout bridge, zmizet plocha a otevřít kin1/kin2.
  2. Zástupce bat vložte do složky Po spuštění: Win+R → shell:startup.
  3. Nebo Plánovač úloh → při přihlášení uživatele Kiosk → akce: spustit váš .bat.
  4. Volitelně v nastavení Windows zapněte automatické přihlášení kiosk účtu (jen u fyzicky hlídaného PC).

Údržba – návrat plochy (pro obsluhu, ne návštěvníka):

  • Ctrl+Shift+Esc → Správce úloh → Soubor → Spustit nový úkol → explorer.exe
  • Administraci exponátu otevírejte z jiného PC v síti – neukončujte kiosk klávesou před návštěvníkem

Kompletní přehled parametrů Chrome/Edge: Hardware – parametry kiosk režimu. Obecné zabezpečení kiosku: Skrytí explorer.exe.

8. Autostart pouze bridge (doplňkově)

Bridge musí běžet dříve nebo současně s prohlížečem. Doporučený postup na Windows 11:

Metoda A – Plánovač úloh (doporučeno)

  1. Vytvořte zástupce na Kinect360Bridge.exe.
  2. Otevřete Plánovač úloh → Vytvořit úlohu.
  3. Spouštěč: Při přihlášení uživatele kiosku.
  4. Akce: spustit program – cesta k Kinect360Bridge.exe, počáteční adresář ...\tools\kinect360-bridge\bin\Release\net48\.
  5. Podmínky: spustit i při napájení z baterie (u notebooku), bez nutnosti hesla pokud je to kiosk účet.

Metoda B – Složka Po spuštění

Zástupce do shell:startup – bridge se spustí po přihlášení. V start-exponat.bat nechte před Chrome krátké timeout /t 3, aby měl bridge čas naběhnout.

Pokud používáte start-kinect-kiosk-*.bat z kapitoly 7, bridge se spouští už v bat – samostatný autostart bridge v Plánovači úloh nepotřebujete (jinak by běžel dvakrát). Kiosk URL může být kin1.php nebo kin2.php.

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

  1. Bridge konzole – po přiblížení osoby k senzoru nehlásí jen „čekám“; klient se připojí po otevření kin1/kin2.
  2. kin1.php – badge „Kinect připojen“, pohybující se kostra (nebo demo bez senzoru).
  3. kin2.php – mrak bodů tvořící postavu; u reálného Kinectu potřebuje aktualizovaný bridge s depth streamem.
  4. AI dialog – klepněte Start, zeptejte se, uslyšíte odpověď; ústa u hlavy reagují při mluvení.

10. Řešení problémů

Problém Řešení
Po restartu vidím plochu místo kiosku Bat není v shell:startup nebo Plánovači; špatná cesta k exe; testujte pod kiosk účtem
Černá obrazovka, žádný prohlížeč Špatná cesta k Chrome/Edge; opravte CHROME_EXE v bat; spusťte bat z cmd a čtěte chyby
dotnet build – No .NET SDKs were found Nainstalujte .NET SDK, zavřete a znovu otevřete PowerShell, ověřte dotnet --version
Kinect není v Správci zařízení Jiný USB port, kontrola napájení, jiný adaptér, reinstalace SDK 1.8
Bridge: „Kinect senzor nebyl nalezen“ Senzor odpojen, ovladač chybí, jiná aplikace drží Kinect – ukončete ji
Web: „Kinect bridge není spuštěný“ Spusťte Kinect360Bridge.exe na stejném PC jako prohlížeč
Postava zrcadlená / špatný směr Admin → Zrcadlit horizontálně (osa X)
Žádné tělo v záběru Vzdálenost 1,5–2,5 m, celá postava viditelná, méně rušivého pozadí v záběru
kin2 bez bodů, kin1 kostra OK Znovu sestavte bridge po aktualizaci projektu (depth stream); restart služby
Pořád demo animace V adminu vypněte Demo režim; bridge musí běžet a WebSocket URL musí sedět

11. Kontrolní seznam před provozem

  1. Kinect Xbox 360 + napájení + USB adaptér
  2. Windows 11, Kinect SDK 1.8 nainstalované, senzor v Device Manageru
  3. Kinect360Bridge.exe sestavený
  4. start-kinect-kiosk-chrome.bat nebo -edge.bat upravený a v autostartu
  5. Admin: WebSocket URL, demo vypnuto pro produkci
  6. Po přihlášení kiosk účtu: žádná plocha, jen kin1/kin2 na celé obrazovce
  7. Mikrofon a reproduktory otestované (stejně jako u ostatních variant)
  8. Návštěvník v optimální vzdálenosti od senzoru

Související: Hardware kiosk, Kontrolní seznam serveru, Varianty avatara – Kinect.