Een Even Realities G2-plugin bouwen met Even Hub

Hoe bouw je je eerste Even Realities G2-plugin?

Samenvatting

Met plugins voor de [Even Realities G2](https://ai.vr-expert.com/en/ai-glasses/even-realities-g2) kunnen ontwikkelaars eigen applicaties voor de bril maken, in plaats van alleen op de standaardfuncties te moeten rekenen.

Met Even Hub kan een ontwikkelteam een webgebaseerde applicatie bouwen, die bekijken in de simulator, interacties zoals drukken en swipes definiëren en daarna dezelfde workflow testen op een fysieke G2-bril via de Even Realities App.

Voor bedrijven opent dit de deur naar doelgerichte workflows, zoals begeleide onderhoudsstappen, geheugensteuntjes tijdens vergaderingen, taakbevestigingen, CRM-informatie, toegang tot interne kennis en andere lichte applicaties die nuttige informatie rechtstreeks in het gezichtsveld van de drager plaatsen.

Het komt erop aan te ontwerpen voor korte interacties die je in één oogopslag kunt lezen, in plaats van een telefoon- of desktopinterface naar een slimme bril te kopiëren.

Evalueert je organisatie de hardware nog voordat de ontwikkeling start, bekijk dan de productpagina van de Even Realities G2 voor specificaties, prijzen, beschikbaarheid en ondersteuning bij zakelijke uitrol.

Wat is een Even Realities G2-plugin?

Een Even Realities G2-plugin is een eigen applicatie die rond een specifieke behoefte of workflow is gebouwd. Jij bepaalt wat de plugin moet doen, welke informatie hij toont en hoe de gebruiker ermee interageert.

Een bedrijf kan bijvoorbeeld een onderhoudsplugin maken die de volgende taak, de status van de apparatuur en een eenvoudige bevestigingsstap rechtstreeks op de bril toont.

Concreet maakt Even Hub van de G2 een platform voor eigen software. Even Realities omschrijft Even Hub-apps als webapplicaties die gebouwd zijn met HTML, CSS en JavaScript of TypeScript en via de Even Hub SDK met de bril verbonden zijn.

Je code draait in de Even Realities-app op de telefoon; de bril tekent wat de SDK doorstuurt en stuurt drukken en swipes via Bluetooth terug. Officiële Even Hub-documentatie

Wat je nodig hebt voordat je begint

  • Code-editor: Om het pluginproject te openen en te bewerken. Visual Studio Code is een eenvoudige optie voor beginners.
  • Even Realities-account: Wordt gebruikt in de mobiele app en in de Even Hub-ontwikkelomgeving.
  • Even Realities App: Koppelt de G2 aan de telefoon en biedt de ontwikkelaarsomgeving die je voor lokale tests gebruikt.
  • Node.js: Nodig om de Even Hub-ontwikkeltools op je computer te laten draaien.
  • Even Hub SDK: Verbindt je applicatie met het G2-scherm en de invoergebeurtenissen. Het gaat om het npm-pakket @evenrealities/even_hub_sdk, dat je in elk project installeert; de officiële templates bevatten het al.
  • Even Hub Simulator: Een desktopvenster (npm-pakket @evenrealities/evenhub-simulator) dat het canvas van 576 x 288 van de bril tekent en invoer via drukken, dubbel drukken, swipen en lang drukken aanneemt, zodat je kunt itereren zonder de bril te dragen.
  • Even Hub CLI: Het npm-pakket @evenrealities/evenhub-cli. Het heeft drie commando's: evenhub init maakt het app.json-manifest aan, evenhub qr genereert de QR-code om op de bril te testen en evenhub pack verpakt de app als .ehpk-bestand.
  • Fysieke [Even Realities G2](https://ai.vr-expert.com/en/ai-glasses/even-realities-g2): Niet nodig voor de eerste fases in de simulator, maar wel noodzakelijk voor degelijke tests op het toestel zelf vóór de uitrol.

Hoe bouw je je eerste Even Realities G2-plugin?

Stap 1: Installeer een code-editor

Het eerste wat je nodig hebt, is een code-editor. Daarin open, bekijk en wijzig je de bestanden waaruit je G2-plugin bestaat.

Visual Studio Code is een praktisch vertrekpunt, omdat het gratis is en werkt op Windows, macOS en Linux.

Stap 2: Bepaal wat de plugin moet doen

Begin met één duidelijke functie. Je eerste plugin moet een klein probleem oplossen, in plaats van meteen een volledig platform te willen worden.

Het doel is na te gaan of de workflow echt goed werkt op een slimme bril voordat je tijd investeert in extra functies.

· Bepaal wie de gebruiker is en op welk moment precies de bril moet helpen.

· Kies de minimale informatie die op het scherm moet verschijnen.

· Bepaal welke actie de gebruiker daarna moet ondernemen.

· Bepaal hoe succes eruitziet, bijvoorbeeld een taak afronden zonder op een telefoon te kijken.

Stap 3: Stel Even Hub en de ontwikkeltools in

Even Hub is het ontwikkelplatform waarmee je applicaties voor de G2 bouwt, test en publiceert. De kernworkflow gebruikt de SDK, de Simulator en de CLI. Open Even Hub

3.1 Stel je Even Realities-account in

· Installeer de Even Realities App op je smartphone.

· Maak een Even Realities-account aan of meld je aan met je bestaande account.

· Koppel de G2-bril aan de telefoon. Is de bril nieuw, doorloop dan het installatieproces en installeer de nieuwste firmware die de app aanbiedt voordat je met de ontwikkeling begint.

3.2 Bereid je computer voor

De Even Hub-ontwikkeltools vereisen Node.js (de basis waarmee de Even Hub-tools op de computer kunnen draaien).

  • Installeer Node.js op je Windows-, macOS- of Linux-computer (aanbevolen: Node 20 LTS of Node 22 en nieuwer). Controleer met node -v en npm -v.
  • Open de terminal en voer uit:
npm install -g @evenrealities/evenhub-cli @evenrealities/evenhub-simulator

Hiermee installeer je de Even Hub CLI (commando's evenhub of eh) en de Simulator.

De SDK wordt per project toegevoegd, niet globaal; de templates in 3.4 bevatten hem al, en voor een project dat je zelf opbouwt, voer je npm install @evenrealities/even_hub_sdk@latest uit in de projectmap.

Je hoeft de ontwikkeltools maar één keer te installeren. Dezelfde omgeving kun je daarna hergebruiken voor toekomstige G2-pluginprojecten.

3.3 Activeer de ontwikkelaarsfuncties

· Meld je aan op de Even Hub-ontwikkelaarswebsite met hetzelfde Even Realities-account dat je in de mobiele app gebruikt.

Er is nergens een ontwikkelaarsschakelaar: door je aan te melden op de webhub wordt je account als ontwikkelaar gemarkeerd.

· Sluit de Even Realities App op je telefoon volledig af en open hem opnieuw.

· Open het Even Hub-gedeelte van de app en controleer of de ontwikkelaarsfuncties beschikbaar zijn, waaronder de QR-scanner voor lokale tests.

Officiële referentie: Even Hub-supportartikel

3.4 Begin met een officieel starterproject

Vertrek voor een eerste plugin van een officieel Even Hub-starterproject, in plaats van de volledige projectstructuur zelf op te zetten.

Zo maak je minder fouten bij de installatie en kun je je concentreren op de interface en de workflow.

  • Kies een van de vier templates van Even: minimal (de SDK leren kennen), text-heavy (leesapps en lange inhoud), asr (spraaknotities en spraakbesturing) of image (afbeeldingen die je in één oogopslag bekijkt).
  • Neem voor een eerste plugin minimal.
  • Maak in de terminal het project aan op basis van de template en start het:
npx degit even-realities/evenhub-templates/minimal my-first-plugin 
cd my-first-plugin 
npm install
npm run dev
  • Open de projectmap in je code-editor.

Elke template is een Vite- en TypeScript-project met de SDK al geïnstalleerd, een app.json-manifest en een src/main.ts die verbinding maakt met de bril voordat er iets anders draait.

  • Stel in app.json package_id in (in omgekeerde domeinstijl, alleen kleine letters en cijfers), name (maximaal 20 tekens, en het woord Even mag er niet in voorkomen), description en permissions.
  • Vervang public/icon.png door je eigen grijswaardenicoon van 24 x 24.

Stap 4: Ontwerp specifiek voor de G2

De Even Hub SDK bouwt het brilscherm op uit containers: rechthoekige zones die op pixelposities op een canvas van 576 x 288 worden geplaatst en die elk tekst, een scrollbare lijst of een grijswaardenafbeelding bevatten.

Op de bril wordt niets als HTML gerenderd; de telefoon voert je webcode uit en de bril tekent alleen wat de SDK doorstuurt.

Enkele beperkingen waarmee je in je ontwerp rekening moet houden:

één lettertype in één grootte,

16 tinten groen,

maximaal 8 tekst- of lijstcontainers plus 4 afbeeldingscontainers per pagina,

ongeveer 400 tot 500 tekens per volledig scherm,

lijsten van maximaal 20 items van 64 tekens,

afbeeldingen tot 288 x 144 px.

Voor een eerste plugin volstaat één tekstcontainer die het hele canvas vult, zoals in de minimal-template van Even.

Vervang de voorbeeldinhoud door de informatie die je workflow nodig heeft, bepaal waar die moet verschijnen en controleer of elk scherm in één oogopslag te begrijpen is.

Stap 5: Bekijk de plugin in de Even Hub Simulator

Zodra het eerste scherm klaar is, start je het project met npm run dev (het draait op http://localhost:5173) en open je het in de Simulator met evenhub-simulator http://localhost:5173.

De Simulator tekent het canvas van 576 x 288 van de bril in een desktopvenster en laat je drukken, dubbel drukken, swipes en lang drukken versturen via de knoppen of sneltoetsen, zodat je snel kunt itereren voordat je naar de bril overstapt.

Het is geen hardware-emulator: snelheid, Bluetooth-timing en eigenaardigheden van het toestel komen pas aan het licht op de echte G2.

· Controleer of de tekst correct past.

· Controleer of de informatie in één oogopslag te begrijpen is.

· Verwijder overbodige tekst of interface-elementen.

· Controleer of de visuele hiërarchie de volgende actie duidelijk maakt.

Stap 6: Bepaal hoe de gebruiker de plugin bedient

Bepaal vervolgens hoe de invoer van de G2 je plugin aanstuurt.

De SDK levert zes gebeurtenissen van de touchpads op de brillenpoten, en van de optionele R1-ring met een eigen bron, zodat je beide uit elkaar kunt houden: drukken, dubbel drukken, omhoog swipen, omlaag swipen, lang drukken en loslaten na lang drukken.

Twee regels bepalen het ontwerp.

Per pagina ontvangt maar één container invoer (die waarbij isEventCapture op 1 staat), dus bouw elk scherm rond één actief element.

En twee gebaren zijn deels al bezet: een dubbele druk op je eerste scherm moet bridge.shutDownPageContainer(1) aanroepen om het systeemdialoogvenster voor afsluiten te tonen, en tikken gevolgd door lang drukken opent het eigen contextmenu van de bril. Beschouw lang drukken dus als een extraatje en niet als de enige manier om een functie te bereiken.

· Open het pluginproject in je code-editor.

· Zoek de bridge.onEvenHubEvent-handler in src/main.ts (de templates bevatten er een).

· Koppel elk ondersteund gebaar aan één specifieke actie.

· Test de interactie in de Simulator voordat je naar de bril overstapt.

Stap 7: Zet de plugin op de echte G2

Zodra de versie in de Simulator correct werkt, test je dezelfde applicatie op een fysieke G2-bril.

Je smartphone en ontwikkelcomputer moeten met hetzelfde wifinetwerk verbonden zijn.

Kantoornetwerken en veel thuisrouters isoleren toestellen van elkaar; als de telefoon de code scant maar er niets laadt, verbind dan beide met de hotspot van de telefoon en sta inkomende verbindingen op poort 5173 toe in de firewall van de computer.

  • Start het project op de ontwikkelcomputer met npm run dev.
  • Zoek het adres van de computer op het lokale netwerk (ipconfig op Windows, ifconfig op macOS of Linux; gebruik het inet-adres, niet 127.0.0.1).
  • Genereer de QR-code:
evenhub qr --url "http://<your-lan-ip>:5173"

Open in de Even Realities App het tabblad Even Hub, tik op Scan QR in het ontwikkelaarsgedeelte en richt de camera op de code in de terminal.

  • De plugin verschijnt binnen een seconde op de bril en herlaadt telkens wanneer je opslaat.

Deze sessie stopt zodra de telefoon vergrendelt of de app naar de achtergrond gaat; scan opnieuw om verder te gaan.

Stap 8: Test de volledige ervaring op de bril

Gebruik hiervoor een private build of bètabuild in plaats van de QR-sessie: verpak de plugin met evenhub pack, upload het .ehpk-bestand in het ontwikkelaarsportaal en installeer het via Me > Apps > Private builds (je eigen bril) of via een bètagroep (collega's).

Een bètabuild gedraagt zich precies zoals een uitgebrachte plugin, ook wat er gebeurt wanneer de telefoon vergrendelt, iets wat de QR-sessie niet kan tonen.

Het doel van deze fase is problemen op te sporen die je op een computerscherm moeilijk opmerkt.

· Controleer tekstlengte en leesbaarheid terwijl je op een natuurlijke manier beweegt.

· Ga na of drukken en swipes werken zoals verwacht.

· Controleer de verbinding met de smartphone en het Bluetooth-gedrag.

· Controleer of de informatie op het juiste moment in de workflow verschijnt.

· Geef de plugin aan iemand die niet bij de ontwikkeling betrokken was en kijk of die hem begrijpt zonder gedetailleerde instructies.

Wat maakt een goede Even Realities G2-plugin?

Een sterke G2-plugin biedt een kleine hoeveelheid nuttige informatie op precies het moment dat de gebruiker die nodig heeft. Hij moet de noodzaak verminderen om te stoppen, een telefoon boven te halen of de aandacht naar een ander scherm te verleggen.

Meer functies toevoegen verbetert de ervaring niet automatisch. De G2 komt het best tot zijn recht wanneer de interface licht blijft en de gebruiker ondersteunt zonder zelf het middelpunt van de aandacht te worden.

· Laat elk scherm draaien rond één taak of beslissing.

· Kies liever korte tekst die je in één oogopslag leest dan lange instructies.

· Gebruik een klein aantal voorspelbare interacties.

· Test de workflow vroeg op de fysieke bril.

· Ontwerp voor de echte werkomgeving, niet alleen voor de simulator.

Veelgemaakte fouten om te vermijden

Een veelgemaakte fout is te veel informatie op het G2-scherm zetten. Lange instructies moeten normaal gezien worden opgesplitst in meerdere kleinere schermen of vereenvoudigd, zodat alleen getoond wordt wat nodig is voor de huidige actie.

Een andere fout is te veel functies bouwen voordat je hebt bevestigd dat de basisworkflow echt werkt. Een eerste plugin moet één idee goed bewijzen voordat hij complexer wordt.

Alleen in de simulator testen volstaat evenmin. Iets wat er op een computer correct uitziet, kan heel anders aanvoelen wanneer je het door de G2 bekijkt. Test de volledige workflow altijd op een echte bril en let vooral op tekstlengte, het gedrag van gebaren, connectiviteit en timing.

Eindadvies

Voor bedrijven die eigen software op de Even Realities G2, overwegen, is een afgebakende proof of concept het beste vertrekpunt. Kies één workflow, bouw de kleinste nuttige plugin, valideer hem in de Simulator en test hem daarna op de echte bril met echte gebruikers.

Plan de distributie vroeg: Even Hub heeft nog geen privékanaal voor bedrijven.

Een plugin bereikt de bril van collega's via een bètagroep, een e-maillijst die je in het ontwikkelaarsportaal beheert, en alles wat in de store wordt uitgebracht, wordt openbaar en wereldwijd vermeld.

Zo krijgt het team bewijs over de bruikbaarheid en de zakelijke waarde voordat de applicatie wordt uitgebreid.

Evalueert je organisatie het toestel nog, bezoek dan de productpagina van de Even Realities G2 voor actuele prijzen, specificaties en ondersteuning bij de uitrol. VR Expert AI kan bedrijven ook helpen om AI-brillen te vergelijken, pilotprojecten te plannen en toestellen aan te kopen voor tests of uitrol.

Veelgestelde vragen

Dit artikel

In de code van je plugin, via de bridge.onEvenHubEvent-handler van de SDK. De gebeurtenissen zijn drukken, dubbel drukken, omhoog swipen, omlaag swipen, lang drukken en loslaten, en ze komen terecht bij de enige container op de pagina waarvoor isEventCapture is ingesteld. Twee ervan zijn deels gereserveerd: een dubbele druk op het eerste scherm moet het systeemdialoogvenster voor afsluiten openen (bridge.shutDownPageContainer(1)), en tikken gevolgd door lang drukken opent het contextmenu van de bril.

Op drie manieren, voor drie doeleinden. Tijdens de ontwikkeling: voer npm run dev uit, genereer een code met evenhub qr --url "http://<your-lan-ip>:5173" en scan die vanuit het ontwikkelaarsgedeelte van het tabblad Even Hub in de Even Realities App

Nee. De eerste fases kun je doorlopen met de Even Hub Simulator. Een fysieke G2-bril blijft wel nodig voor degelijke tests op het toestel voordat een workflow klaar wordt geacht voor echt gebruik.

Ja. De plugin draait als webcode op de telefoon, dus hij kan via HTTPS met fetch of een WebSocket een CRM, takensysteem of interne database bereiken, op twee voorwaarden: elke origin moet vermeld staan in de netwerkmachtiging in de app.json van de plugin, en de server moet de gebruikelijke CORS-headers meesturen. Hou API-sleutels uit het pakket, want iedereen met een uitgebrachte .ehpk kan de inhoud ervan uitpakken

VR Expert AI levert de Even Realities G2 voor zakelijk gebruik, inclusief pilottoestellen en grotere uitrols. Op de productpagina vind je actuele prijzen, beschikbaarheid en een manier om zakelijke ondersteuning aan te vragen. Bekijk de productpagina van de Even Realities G2 - Even Realities G2-productpagina: https://ai.vr-expert.com/en/ai-glasses/even-realities-g2 - Even Hub-ontwikkelaarsdocumentatie: https://hub.evenrealities.com/docs/get-started/overview - Templates: https://hub.evenrealities.com/docs/get-started/quickstart/templates - Lokaal testen: https://hub.evenrealities.com/docs/test/local-testing - Bètatesten: https://hub.evenrealities.com/docs/test/beta-testing - Richtlijnen voor app-inzending en QA: https://hub.evenrealities.com/docs/ship/app-submission