Jak stworzyć pierwszą wtyczkę do Even Realities G2

Podsumowanie

Wtyczki do [Even Realities G2](https://ai.vr-expert.com/en/ai-glasses/even-realities-g2) pozwalają programistom tworzyć własne aplikacje na okulary, zamiast polegać wyłącznie na standardowych funkcjach.

Korzystając z Even Hub, zespół programistów może zbudować aplikację webową, wyświetlić jej podgląd w symulatorze, zdefiniować interakcje, takie jak naciśnięcia i przesunięcia, a następnie przetestować ten sam przepływ pracy na fizycznych okularach G2 za pośrednictwem Even Realities App.

Dla firm otwiera to drogę do dedykowanych przepływów pracy, takich jak prowadzenie krok po kroku przez czynności serwisowe, podpowiedzi podczas spotkań, potwierdzanie zadań, informacje z CRM, dostęp do wewnętrznej bazy wiedzy i inne lekkie aplikacje, które umieszczają przydatne informacje bezpośrednio w polu widzenia użytkownika.

Kluczem jest projektowanie z myślą o krótkich interakcjach, które da się ogarnąć jednym spojrzeniem, a nie przenoszenie interfejsu z telefonu czy komputera na inteligentne okulary.

Jeśli Twoja organizacja ocenia sprzęt przed rozpoczęciem prac programistycznych, zajrzyj na stronę produktu Even Realities G2, gdzie znajdziesz specyfikację, ceny, informacje o dostępności oraz wsparciu we wdrożeniach biznesowych.

Czym jest wtyczka do Even Realities G2?

Wtyczka do Even Realities G2 to własna aplikacja zbudowana wokół konkretnej potrzeby lub przepływu pracy. To Ty decydujesz, co wtyczka ma robić, jakie informacje wyświetlać i w jaki sposób użytkownik ma z niej korzystać.

Na przykład firma mogłaby stworzyć wtyczkę serwisową, która wyświetla bezpośrednio na okularach kolejne zadanie, stan urządzenia i prosty krok potwierdzenia.

W praktyce Even Hub zmienia G2 w platformę dla niestandardowego oprogramowania. Even Realities opisuje aplikacje Even Hub jako aplikacje webowe zbudowane w HTML, CSS oraz JavaScript lub TypeScript, połączone z okularami za pomocą Even Hub SDK.

Twój kod działa wewnątrz aplikacji Even Realities na telefonie; okulary wyświetlają to, co wyśle im SDK, i przekazują z powrotem naciśnięcia oraz przesunięcia przez Bluetooth. Oficjalna dokumentacja Even Hub

Czego potrzebujesz przed rozpoczęciem

• Edytor kodu: Służy do otwierania i edytowania projektu wtyczki. Visual Studio Code to prosta opcja dla początkujących.
• Konto Even Realities: Używane w aplikacji mobilnej i w środowisku programistycznym Even Hub.
• Even Realities App: Paruje G2 z telefonem i udostępnia sekcję dla programistów używaną do testów lokalnych.
• Node.js: Wymagany do uruchamiania narzędzi programistycznych Even Hub na komputerze.
• Even Hub SDK: Łączy aplikację z wyświetlaczem G2 i zdarzeniami wejściowymi. Jest to pakiet npm @evenrealities/even_hub_sdk, instalowany w każdym projekcie; oficjalne szablony już go zawierają.
• Even Hub Simulator: Okno na komputerze (pakiet npm @evenrealities/evenhub-simulator), które rysuje obszar wyświetlania okularów 576 x 288 i przyjmuje naciśnięcie, podwójne naciśnięcie, przesunięcie oraz długie naciśnięcie, dzięki czemu możesz wprowadzać kolejne poprawki bez zakładania okularów.
• Even Hub CLI: Pakiet npm @evenrealities/evenhub-cli. Ma trzy polecenia: evenhub init tworzy manifest app.json, evenhub qr generuje kod QR do testów na okularach, a evenhub pack pakuje aplikację do pliku .ehpk.
• Fizyczne okulary [Even Realities G2](https://ai.vr-expert.com/en/ai-glasses/even-realities-g2): Niewymagane na pierwszych etapach pracy z symulatorem, ale niezbędne do rzetelnych testów na urządzeniu przed wdrożeniem.

Jak stworzyć pierwszą wtyczkę do Even Realities G2

Krok 1: Zainstaluj edytor kodu

Pierwszą rzeczą, której potrzebujesz, jest edytor kodu. To w nim otwierasz, przeglądasz i zmieniasz pliki składające się na wtyczkę do G2.

Visual Studio Code to praktyczny punkt wyjścia, ponieważ jest bezpłatny i działa w systemach Windows, macOS i Linux.

Krok 2: Zdecyduj, co ma robić wtyczka

Zacznij od jednej, jasno określonej funkcji. Pierwsza wtyczka powinna rozwiązywać niewielki problem, a nie próbować stać się kompletną platformą.

Celem jest potwierdzenie, że dany przepływ pracy rzeczywiście dobrze sprawdza się na inteligentnych okularach, zanim zainwestujesz czas w dodatkowe funkcje.

· Określ użytkownika i dokładny moment, w którym okulary mają mu pomóc.

· Wybierz minimalny zakres informacji, które muszą pojawić się na wyświetlaczu.

· Określ, jakie działanie użytkownik powinien podjąć jako następne.

· Ustal, jak wygląda sukces, na przykład wykonanie zadania bez zaglądania do telefonu.

Krok 3: Skonfiguruj Even Hub i narzędzia programistyczne

Even Hub to platforma programistyczna służąca do tworzenia, testowania i publikowania aplikacji na G2. Podstawowy przepływ pracy opiera się na SDK, Simulatorze i CLI. Otwórz Even Hub

3.1 Skonfiguruj konto Even Realities

· Zainstaluj Even Realities App na smartfonie.

· Utwórz konto Even Realities lub zaloguj się na istniejące konto.

· Sparuj okulary G2 z telefonem. Jeśli okulary są nowe, przed rozpoczęciem prac dokończ proces konfiguracji i zainstaluj najnowsze oprogramowanie układowe (firmware) oferowane przez aplikację.

3.2 Przygotuj komputer

Narzędzia programistyczne Even Hub wymagają Node.js (podstawy, która pozwala uruchamiać narzędzia Even Hub na komputerze).

• Zainstaluj Node.js na komputerze z systemem Windows, macOS lub Linux (zalecane: Node 20 LTS lub Node 22 i nowsze). Sprawdź wersję poleceniami node -v i npm -v.
• Otwórz terminal i uruchom:

npm install -g @evenrealities/evenhub-cli @evenrealities/evenhub-simulator

Spowoduje to zainstalowanie Even Hub CLI (polecenia evenhub lub eh) oraz Simulatora.

SDK dodaje się do każdego projektu osobno, a nie globalnie; szablony z punktu 3.4 już je zawierają, a w przypadku projektu tworzonego ręcznie należy uruchomić npm install @evenrealities/even_hub_sdk@latest w folderze projektu.

Narzędzia programistyczne wystarczy zainstalować raz. To samo środowisko można potem wykorzystywać w kolejnych projektach wtyczek do G2.

3.3 Włącz funkcje dla programistów

· Zaloguj się na stronie Even Hub dla programistów, używając tego samego konta Even Realities, którego używasz w aplikacji mobilnej.

Nigdzie nie ma przełącznika trybu programisty: samo zalogowanie się do internetowego Even Hub oznacza Twoje konto jako konto programisty.

· Całkowicie zamknij Even Realities App na telefonie i otwórz ją ponownie.

· Otwórz sekcję Even Hub w aplikacji i sprawdź, czy funkcje dla programistów są dostępne, w tym skaner QR używany do testów lokalnych.

Oficjalne źródło: Artykuł pomocy na temat Even Hub

3.4 Zacznij od oficjalnego projektu startowego

Przy pierwszej wtyczce zacznij od oficjalnego projektu startowego Even Hub, zamiast samodzielnie tworzyć całą strukturę projektu.

Ogranicza to błędy w konfiguracji i pozwala skupić się na interfejsie oraz przepływie pracy.

• Wybierz jeden z czterech szablonów Even: minimal (nauka SDK), text-heavy (aplikacje do czytania i długie treści), asr (notatki głosowe i sterowanie głosem) lub image (obrazy do szybkiego podglądu).

• Przy pierwszej wtyczce wybierz minimal.

• W terminalu utwórz projekt z szablonu i uruchom go:

npx degit even-realities/evenhub-templates/minimal my-first-plugin 

cd my-first-plugin 

npm install

npm run dev

• Otwórz folder projektu w edytorze kodu.

Każdy szablon to projekt Vite i TypeScript z zainstalowanym SDK, manifestem app.json oraz plikiem src/main.ts, który łączy się z okularami, zanim uruchomi się cokolwiek innego.

• W app.json ustaw package_id (w stylu odwróconej domeny, wyłącznie małe litery i cyfry), name (do 20 znaków; nazwa nie może zawierać słowa Even), description i permissions.

• Zastąp plik public/icon.png własną ikoną 24 x 24 w odcieniach szarości.

Krok 4: Projektuj specjalnie z myślą o G2

Even Hub SDK buduje ekran okularów z kontenerów: prostokątnych obszarów umieszczonych w określonych pozycjach pikselowych na obszarze 576 x 288, z których każdy zawiera tekst, przewijaną listę lub obraz w odcieniach szarości.

Na okularach nic nie jest renderowane jako HTML; telefon uruchamia Twój kod webowy, a okulary wyświetlają tylko to, co wyśle SDK.

Kilka ograniczeń, które trzeba uwzględnić w projekcie:

jedna czcionka w jednym rozmiarze,

16 odcieni zieleni,

maksymalnie 8 kontenerów tekstowych lub list oraz 4 kontenery obrazów na stronę,

około 400–500 znaków na pełny ekran,

listy do 20 pozycji po 64 znaki,

obrazy do 288 x 144 px.

Przy pierwszej wtyczce wystarczy jeden kontener tekstowy wypełniający cały obszar, tak jak w szablonie minimal od Even.

Zastąp przykładową treść informacjami potrzebnymi w Twoim przepływie pracy, zdecyduj, gdzie mają się pojawiać, i sprawdź, czy każdy ekran da się zrozumieć jednym spojrzeniem.

Krok 5: Wyświetl podgląd wtyczki w Even Hub Simulator

Gdy pierwszy ekran będzie gotowy, uruchom projekt poleceniem npm run dev (serwer działa pod adresem http://localhost:5173) i otwórz go w Simulatorze poleceniem evenhub-simulator http://localhost:5173.

Simulator rysuje obszar wyświetlania okularów 576 x 288 w oknie na komputerze i pozwala wysyłać naciśnięcia, podwójne naciśnięcia, przesunięcia i długie naciśnięcia za pomocą przycisków lub skrótów klawiaturowych, dzięki czemu możesz szybko wprowadzać poprawki, zanim przejdziesz do okularów.

Nie jest to emulator sprzętu: szybkość działania, opóźnienia Bluetooth i specyficzne zachowania urządzenia ujawniają się dopiero na prawdziwych G2.

· Sprawdź, czy tekst prawidłowo się mieści.

· Sprawdź, czy informacje są łatwe do zrozumienia jednym spojrzeniem.

· Usuń zbędny tekst lub elementy interfejsu.

· Sprawdź, czy hierarchia wizualna jasno wskazuje następne działanie.

Krok 6: Zdecyduj, jak użytkownik będzie sterować wtyczką

Następnie określ, w jaki sposób sygnały wejściowe G2 sterują wtyczką.

SDK dostarcza sześć zdarzeń z panelów dotykowych na zausznikach oraz z opcjonalnego pierścienia R1, z osobnym źródłem, dzięki czemu można je od siebie odróżnić: naciśnięcie, podwójne naciśnięcie, przesunięcie w górę, przesunięcie w dół, długie naciśnięcie i zwolnienie długiego naciśnięcia.

Projekt kształtują dwie zasady.

Sygnały wejściowe odbiera tylko jeden kontener na stronie (ten, który ma isEventCapture ustawione na 1), więc buduj każdy ekran wokół jednego aktywnego elementu.

Ponadto dwa gesty są częściowo zarezerwowane: podwójne naciśnięcie na pierwszym ekranie musi wywoływać bridge.shutDownPageContainer(1), aby wyświetlić systemowe okno wyjścia, a dotknięcie, po którym następuje długie naciśnięcie, otwiera własne menu kontekstowe okularów, dlatego traktuj długie naciśnięcie jako dodatek, a nie jedyny sposób dotarcia do funkcji.

· Otwórz projekt wtyczki w edytorze kodu.

· Znajdź procedurę obsługi bridge.onEvenHubEvent w pliku src/main.ts (szablony ją zawierają).

· Przypisz każdemu obsługiwanemu gestowi jedno konkretne działanie.

· Przetestuj interakcję w Simulatorze, zanim przejdziesz do okularów.

Krok 7: Uruchom wtyczkę na prawdziwych G2

Gdy wersja w Simulatorze działa poprawnie, przetestuj tę samą aplikację na fizycznych okularach G2.

Smartfon i komputer deweloperski muszą być połączone z tą samą siecią Wi-Fi.

Sieci biurowe i wiele domowych routerów izoluje urządzenia od siebie; jeśli telefon zeskanuje kod, ale nic się nie wczytuje, przełącz oba urządzenia na hotspot telefonu i zezwól na połączenia przychodzące na porcie 5173 w zaporze komputera.

• Uruchom projekt na komputerze deweloperskim poleceniem npm run dev.

• Znajdź adres komputera w sieci lokalnej (ipconfig w systemie Windows, ifconfig w systemie macOS lub Linux; użyj adresu inet, a nie 127.0.0.1).

• Wygeneruj kod QR:

evenhub qr --url "http://<your-lan-ip>:5173"

W Even Realities App otwórz kartę Even Hub, dotknij Scan QR w sekcji dla programistów i skieruj aparat na kod wyświetlony w terminalu.

• Wtyczka pojawi się na okularach w ciągu sekundy i będzie przeładowywana przy każdym zapisie.

Ta sesja kończy się, gdy telefon się zablokuje lub aplikacja przejdzie w tło; aby ją wznowić, zeskanuj kod ponownie.

Krok 8: Przetestuj całość na okularach

Na tym etapie zamiast sesji QR użyj kompilacji prywatnej lub beta: spakuj wtyczkę poleceniem evenhub pack, prześlij plik .ehpk w portalu dla programistów i zainstaluj go z poziomu Me > Apps > Private builds (Twoje własne okulary) lub przez grupę Beta (współpracownicy).

Kompilacja beta działa dokładnie tak samo jak opublikowana wtyczka, również po zablokowaniu telefonu, czego sesja QR nie jest w stanie pokazać.

Celem tego etapu jest wykrycie problemów, które trudno zauważyć na ekranie komputera.

· Sprawdź długość i czytelność tekstu podczas naturalnego poruszania się.

· Upewnij się, że naciśnięcia i przesunięcia działają zgodnie z oczekiwaniami.

· Sprawdź łączność ze smartfonem i działanie Bluetooth.

· Sprawdź, czy informacje pojawiają się we właściwym momencie przepływu pracy.

· Daj wtyczkę komuś, kto nie brał udziału w jej tworzeniu, i sprawdź, czy zrozumie ją bez szczegółowych instrukcji.

Co wyróżnia dobrą wtyczkę do Even Realities G2?

Dobra wtyczka do G2 dostarcza niewielką ilość przydatnych informacji dokładnie w chwili, gdy użytkownik ich potrzebuje. Powinna ograniczać konieczność zatrzymywania się, wyjmowania telefonu lub przenoszenia uwagi na inny wyświetlacz.

Dodawanie kolejnych funkcji nie poprawia automatycznie wrażeń z użytkowania. G2 sprawdza się najlepiej, gdy interfejs pozostaje lekki i wspiera użytkownika, nie stając się głównym obiektem jego uwagi.

· Każdy ekran powinien dotyczyć jednego zadania lub jednej decyzji.

· Zamiast długich instrukcji stosuj krótki tekst, który można ogarnąć jednym spojrzeniem.

· Korzystaj z niewielkiej liczby przewidywalnych interakcji.

· Wcześnie testuj przepływ pracy na fizycznych okularach.

· Projektuj z myślą o rzeczywistym środowisku pracy, a nie tylko o symulatorze.

Typowe błędy, których warto unikać

Jednym z częstych błędów jest umieszczanie zbyt wielu informacji na wyświetlaczu G2. Długie instrukcje zwykle należy podzielić na kilka mniejszych ekranów lub uprościć tak, by pokazywały tylko to, co jest potrzebne do bieżącego działania.

Kolejnym błędem jest tworzenie zbyt wielu funkcji, zanim potwierdzi się, że podstawowy przepływ pracy rzeczywiście działa. Pierwsza wtyczka powinna dobrze sprawdzić jeden pomysł, zanim stanie się bardziej złożona.

Same testy w symulatorze również nie wystarczą. Coś, co wygląda poprawnie na komputerze, może sprawiać zupełnie inne wrażenie, gdy ogląda się to przez G2. Zawsze testuj cały przepływ pracy na prawdziwych okularach i zwracaj szczególną uwagę na długość tekstu, działanie gestów, łączność oraz kwestie czasowe.

Rekomendacja końcowa

Dla firm rozważających stworzenie własnego oprogramowania na Even Realities G2 najlepszym punktem wyjścia jest wąsko zakrojony proof of concept. Wybierz jeden przepływ pracy, zbuduj najmniejszą użyteczną wtyczkę, zweryfikuj ją w Simulatorze, a następnie przetestuj na prawdziwych okularach z udziałem rzeczywistych użytkowników.

Zaplanuj dystrybucję z wyprzedzeniem: Even Hub nie ma jeszcze prywatnego kanału dla przedsiębiorstw.

Wtyczka trafia na okulary współpracowników przez grupę Beta, czyli listę adresów e-mail zarządzaną w portalu dla programistów, a wszystko, co zostanie opublikowane w sklepie, jest widoczne publicznie na całym świecie.

Daje to zespołowi dowody na użyteczność i wartość biznesową rozwiązania, zanim aplikacja zostanie rozbudowana.

Jeśli Twoja organizacja wciąż ocenia urządzenie, odwiedź stronę produktu Even Realities G2, gdzie znajdziesz aktualne ceny, specyfikację i informacje o wsparciu we wdrożeniach. VR Expert AI może również pomóc firmom w porównaniu okularów AI, zaplanowaniu projektów pilotażowych oraz pozyskaniu urządzeń do testów lub wdrożenia.