Създаване на плъгин за Even Realities G2 с Even Hub

Как да създадете първия си плъгин за Even Realities G2

Резюме

Плъгините за [Even Realities G2](https://ai.vr-expert.com/en/ai-glasses/even-realities-g2) позволяват на разработчиците да създават собствени приложения за очилата, вместо да разчитат само на стандартните функции.

С Even Hub екипът от разработчици може да изгради уеб базирано приложение, да го прегледа в симулатора, да дефинира взаимодействия като натискания и плъзгания, а след това да тества същия работен процес на физическите очила G2 чрез Even Realities App.

За бизнеса това отваря вратата към специално създадени работни процеси като стъпки за поддръжка с указания, подсказки по време на срещи, потвърждаване на задачи, информация от CRM, достъп до вътрешна база от знания и други леки приложения, които поставят полезна информация директно в зрителното поле на потребителя.

Ключът е да проектирате кратки взаимодействия, които се схващат с един поглед, вместо да пренасяте интерфейса на телефон или настолен компютър върху смарт очилата.

Ако вашата организация оценява хардуера, преди да започне разработката, вижте продуктовата страница на Even Realities G2 за спецификации, цени, наличност и поддръжка при внедряване в бизнеса.

Какво е плъгин за Even Realities G2?

Плъгинът за Even Realities G2 е собствено приложение, изградено около конкретна нужда или работен процес. Вие решавате какво трябва да прави плъгинът, каква информация да показва и как потребителят взаимодейства с него.

Например една компания може да създаде плъгин за поддръжка, който показва следващата задача, състоянието на оборудването и проста стъпка за потвърждение директно на очилата.

На практика Even Hub превръща G2 в платформа за собствен софтуер. Even Realities описва приложенията за Even Hub като уеб приложения, изградени с HTML, CSS и JavaScript или TypeScript, които се свързват с очилата чрез Even Hub SDK.

Кодът ви се изпълнява в приложението Even Realities на телефона; очилата изобразяват това, което SDK им изпраща, и връщат натисканията и плъзганията по Bluetooth. Официална документация на Even Hub

Какво ви е необходимо, преди да започнете

  • Редактор на код: Използва се за отваряне и редактиране на проекта на плъгина. Visual Studio Code е лесен вариант за начинаещи.
  • Акаунт в Even Realities: Използва се в мобилното приложение и в средата за разработчици на Even Hub.
  • Even Realities App: Сдвоява G2 с телефона и предоставя раздела за разработчици, използван за локално тестване.
  • Node.js: Необходим е за стартиране на инструментите за разработка на Even Hub на компютъра ви.
  • Even Hub SDK: Свързва приложението ви с дисплея и входните събития на G2. Това е npm пакетът @evenrealities/even_hub_sdk, който се инсталира във всеки проект; официалните шаблони вече го съдържат.
  • Even Hub Simulator: Прозорец на работния плот (npm пакет @evenrealities/evenhub-simulator), който изобразява платното на очилата с размер 576 x 288 и приема въвеждане чрез натискане, двойно натискане, плъзгане и продължително натискане, така че да можете да правите итерации, без да носите очилата.
  • Even Hub CLI: npm пакетът @evenrealities/evenhub-cli. Има три команди: evenhub init създава манифеста app.json, evenhub qr генерира QR кода за тестване на очилата, а evenhub pack пакетира приложението като файл .ehpk.
  • Физически очила [Even Realities G2](https://ai.vr-expert.com/en/ai-glasses/even-realities-g2): Не са необходими за първите етапи в симулатора, но са задължителни за пълноценно тестване на устройството преди внедряване.

Как да създадете първия си плъгин за Even Realities G2

Стъпка 1: Инсталирайте редактор на код

Първото, от което се нуждаете, е редактор на код. В него отваряте, разглеждате и променяте файловете, от които се състои вашият плъгин за G2.

Visual Studio Code е практична отправна точка, защото е безплатен и работи под Windows, macOS и Linux.

Стъпка 2: Решете какво трябва да прави плъгинът

Започнете с една ясна функция. Първият ви плъгин трябва да решава малък проблем, а не да се опитва да стане цялостна платформа.

Целта е да потвърдите, че работният процес наистина функционира добре на смарт очила, преди да инвестирате време в допълнителни функции.

· Определете потребителя и точния момент, в който очилата трябва да помогнат.

· Изберете минималната информация, която трябва да се появи на дисплея.

· Определете действието, което потребителят трябва да предприеме след това.

· Решете как изглежда успехът, например изпълнение на задача, без да се поглежда телефонът.

Стъпка 3: Настройте Even Hub и инструментите за разработка

Even Hub е платформата за разработка, която се използва за създаване, тестване и публикуване на приложения за G2. Основният работен процес използва SDK, Simulator и CLI. Отворете Even Hub

3.1 Настройте акаунта си в Even Realities

· Инсталирайте Even Realities App на смартфона си.

· Създайте акаунт в Even Realities или влезте в съществуващия си акаунт.

· Сдвоете очилата G2 с телефона. Ако очилата са нови, завършете процеса на настройка и инсталирайте най-новия фърмуер, предложен от приложението, преди да започнете разработката.

3.2 Подгответе компютъра си

Инструментите за разработка на Even Hub изискват Node.js (основата, която позволява на инструментите на Even Hub да работят на компютъра).

  • Инсталирайте Node.js на компютъра си с Windows, macOS или Linux (препоръчително: Node 20 LTS или Node 22 и по-нови версии). Проверете с node -v и npm -v.
  • Отворете терминала и изпълнете:
npm install -g @evenrealities/evenhub-cli @evenrealities/evenhub-simulator

Това инсталира Even Hub CLI (командите evenhub или eh) и Simulator.

SDK се добавя поотделно за всеки проект, а не глобално; шаблоните в 3.4 вече го съдържат, а за проект, който изграждате ръчно, изпълнявате npm install @evenrealities/even_hub_sdk@latest в папката на проекта.

Инструментите за разработка трябва да се инсталират само веднъж. След това същата среда може да се използва повторно за бъдещи проекти за плъгини за G2.

3.3 Активирайте функциите за разработчици

· Влезте в уебсайта за разработчици на Even Hub със същия акаунт в Even Realities, който използвате в мобилното приложение.

Никъде няма превключвател за режим на разработчик: влизането в уеб хъба отбелязва акаунта ви като акаунт на разработчик.

· Затворете напълно Even Realities App на телефона си и го отворете отново.

· Отворете раздела Even Hub в приложението и проверете дали функциите за разработчици са налични, включително QR скенерът, използван за локално тестване.

Официален източник: Статия за поддръжка на Even Hub

3.4 Започнете с официален стартов проект

За първи плъгин започнете от официален стартов проект на Even Hub, вместо сами да създавате цялата структура на проекта.

Така намалявате грешките при настройката и можете да се съсредоточите върху интерфейса и работния процес.

  • Изберете един от четирите шаблона на Even: minimal (за запознаване със SDK), text-heavy (приложения за четене и дълго съдържание), asr (гласови бележки и гласово управление) или image (изображения, които се схващат с един поглед).
  • За първи плъгин изберете minimal.
  • В терминала създайте проекта от шаблона и го стартирайте:
npx degit even-realities/evenhub-templates/minimal my-first-plugin 
cd my-first-plugin 
npm install
npm run dev
  • Отворете папката на проекта в редактора на код.

Всеки шаблон е проект с Vite и TypeScript с инсталиран SDK, манифест app.json и файл src/main.ts, който се свързва с очилата, преди да се изпълни каквото и да било друго.

  • В app.json задайте package_id (във формат на обърнат домейн, само малки букви и цифри), name (до 20 знака, като не може да съдържа думата Even), description и permissions.
  • Заменете public/icon.png със собствена иконка в сиви тонове с размер 24 x 24.

Стъпка 4: Проектирайте специално за G2

Even Hub SDK изгражда екрана на очилата от контейнери: правоъгълни области, разположени на определени пикселни позиции върху платно с размер 576 x 288, всяка от които съдържа текст, списък с превъртане или изображение в сиви тонове.

На очилата нищо не се изобразява като HTML; телефонът изпълнява уеб кода ви, а очилата изобразяват само това, което SDK изпраща.

Някои ограничения, които трябва да вземете предвид при проектирането:

един шрифт с един размер,

16 нюанса на зеленото,

най-много 8 текстови контейнера или контейнера за списъци плюс 4 контейнера за изображения на страница,

приблизително 400 до 500 знака на цял екран,

списъци с до 20 елемента по 64 знака,

изображения до 288 x 144 px.

За първи плъгин е достатъчен един текстов контейнер, който запълва платното, както в шаблона minimal на Even.

Заменете примерното съдържание с информацията, от която се нуждае вашият работен процес, решете къде да се показва и проверете дали всеки екран може да бъде разбран с един поглед.

Стъпка 5: Прегледайте плъгина в Even Hub Simulator

Когато първият екран е готов, стартирайте проекта с npm run dev (той се обслужва на http://localhost:5173) и го отворете в Simulator с evenhub-simulator http://localhost:5173.

Simulator изобразява платното на очилата с размер 576 x 288 в прозорец на работния плот и ви позволява да изпращате натискания, двойни натискания, плъзгания и продължителни натискания чрез бутоните му или клавишни комбинации, така че да правите бързи итерации, преди да преминете към очилата.

Той не е хардуерен емулатор: скоростта, времето за реакция на Bluetooth и особеностите на устройството се проявяват само на истинските G2.

· Проверете дали текстът се побира правилно.

· Проверете дали информацията е лесна за разбиране с един поглед.

· Премахнете ненужния текст или елементи от интерфейса.

· Проверете дали визуалната йерархия прави следващото действие очевидно.

Стъпка 6: Решете как потребителят управлява плъгина

След това определете как входните сигнали от G2 управляват вашия плъгин.

SDK предава шест събития от сензорните панели на дръжките, както и от допълнителния пръстен R1 – със собствен източник, така че да можете да ги различавате: натискане, двойно натискане, плъзгане нагоре, плъзгане надолу, продължително натискане и отпускане след продължително натискане.

Две правила определят дизайна.

Само един контейнер на страница получава входни сигнали (този, при който isEventCapture е зададено на 1), затова изграждайте всеки екран около един активен елемент.

Освен това два жеста са частично заети: двойното натискане на първия ви екран трябва да извиква bridge.shutDownPageContainer(1), за да покаже системния диалог за изход, а докосване, последвано от продължително натискане, отваря собственото контекстно меню на очилата, затова третирайте продължителното натискане като допълнителна възможност, а не като единствения начин за достъп до дадена функция.

· Отворете проекта на плъгина в редактора на код.

· Намерете обработчика bridge.onEvenHubEvent в src/main.ts (шаблоните съдържат такъв).

· Присвоете на всеки поддържан жест едно конкретно действие.

· Тествайте взаимодействието в Simulator, преди да преминете към очилата.

Стъпка 7: Пуснете плъгина на истинските G2

След като версията в Simulator работи правилно, тествайте същото приложение на физическите очила G2.

Смартфонът и компютърът за разработка трябва да са в една и съща Wi-Fi мрежа.

Офисните мрежи и много домашни рутери изолират устройствата едно от друго; ако телефонът сканира кода, но нищо не се зарежда, свържете и двете устройства към точката за достъп на телефона и разрешете входящите връзки на порт 5173 в защитната стена на компютъра.

  • Стартирайте проекта на компютъра за разработка с npm run dev.
  • Намерете адреса на компютъра в локалната мрежа (ipconfig под Windows, ifconfig под macOS или Linux; използвайте адреса inet, а не 127.0.0.1).
  • Генерирайте QR кода:
evenhub qr --url "http://<your-lan-ip>:5173"

В Even Realities App отворете раздела Even Hub, докоснете Scan QR в секцията за разработчици и насочете камерата към кода в терминала.

  • Плъгинът се появява на очилата в рамките на секунда и се презарежда при всяко запазване.

Тази сесия приключва, когато телефонът се заключи или приложението премине във фонов режим; сканирайте отново, за да продължите.

Стъпка 8: Тествайте цялостното изживяване на очилата

За целта използвайте частна или бета компилация вместо QR сесията: пакетирайте плъгина с evenhub pack, качете файла .ehpk в портала за разработчици и го инсталирайте от Me > Apps > Private builds (за собствените ви очила) или чрез Beta група (за колеги).

Бета компилацията се държи точно като публикуван плъгин, включително по отношение на това какво се случва, когато телефонът се заключи – нещо, което QR сесията не може да покаже.

Целта на този етап е да откриете проблеми, които трудно се забелязват на екрана на компютъра.

· Проверете дължината и четливостта на текста, докато се движите естествено.

· Уверете се, че натисканията и плъзганията работят според очакванията.

· Проверете връзката със смартфона и поведението на Bluetooth.

· Проверете дали информацията се появява в точния момент от работния процес.

· Дайте плъгина на човек, който не е участвал в разработката, и вижте дали може да го разбере без подробни инструкции.

Какво прави един плъгин за Even Realities G2 добър?

Добрият плъгин за G2 предоставя малко количество полезна информация точно в момента, в който потребителят се нуждае от нея. Той трябва да намалява нуждата да спирате, да вадите телефона си или да пренасочвате вниманието си към друг дисплей.

Добавянето на повече функции не подобрява автоматично изживяването. G2 разкрива най-силните си страни, когато интерфейсът остава лек и подпомага потребителя, без да се превръща в основен фокус на вниманието.

· Поддържайте всеки екран фокусиран върху една задача или едно решение.

· Предпочитайте кратък текст, който се схваща с един поглед, пред дълги инструкции.

· Използвайте малък брой предвидими взаимодействия.

· Тествайте работния процес на физическите очила още в ранен етап.

· Проектирайте спрямо реалната работна среда, а не само спрямо симулатора.

Често срещани грешки, които да избягвате

Една често срещана грешка е да се поставя твърде много информация на дисплея на G2. Дългите инструкции обикновено трябва да се разделят на няколко по-малки екрана или да се опростят така, че да показват само необходимото за текущото действие.

Друга грешка е да се изграждат твърде много функции, преди да се потвърди, че основният работен процес наистина работи. Първият плъгин трябва да докаже добре една идея, преди да стане по-сложен.

Само тестването в симулатора също не е достатъчно. Нещо, което изглежда правилно на компютъра, може да се усеща съвсем различно, когато се гледа през G2. Винаги тествайте целия работен процес на истински очила и обръщайте специално внимание на дължината на текста, поведението на жестовете, свързаността и времето за реакция.

Окончателна препоръка

За компании, които обмислят собствен софтуер за Even Realities G2, най-добрата отправна точка е тясно фокусирано доказателство на концепцията. Изберете един работен процес, създайте най-малкия полезен плъгин, валидирайте го в Simulator и след това го тествайте на истинските очила с реални потребители.

Планирайте разпространението отрано: Even Hub все още няма частен корпоративен канал.

Плъгинът достига до очилата на колегите чрез Beta група – имейл списък, който управлявате в портала за разработчици, а всичко, което бъде публикувано в магазина, се показва публично и в целия свят.

Това дава на екипа доказателства за използваемостта и бизнес стойността, преди приложението да бъде разширено.

Ако вашата организация все още оценява устройството, посетете продуктовата страница на Even Realities G2 за актуални цени, спецификации и поддръжка при внедряване. VR Expert AI може също да помогне на компаниите да сравнят AI очила, да планират пилотни проекти и да осигурят устройства за тестване или внедряване.

Често задавани въпроси

Тази статия

В кода на плъгина, чрез обработчика bridge.onEvenHubEvent на SDK. Събитията са натискане, двойно натискане, плъзгане нагоре, плъзгане надолу, продължително натискане и отпускане, и те достигат до единствения контейнер на страницата, при който е зададено isEventCapture. Две от тях са частично запазени: двойното натискане на първия екран трябва да отваря системния диалог за изход (bridge.shutDownPageContainer(1)), а докосване, последвано от продължително натискане, отваря контекстното меню на очилата.

По три начина, за три различни цели. По време на разработката: изпълнете npm run dev, генерирайте код с evenhub qr --url "http://<your-lan-ip>:5173" и го сканирайте от секцията за разработчици в раздела Even Hub на Even Realities App

Не. Първите етапи могат да бъдат завършени с Even Hub Simulator. Физическите очила G2 все пак са необходими за пълноценно тестване на устройството, преди даден работен процес да се счита за готов за реална употреба.

Да. Плъгинът работи като уеб код на телефона, така че може да достига до CRM, система за задачи или вътрешна база данни през HTTPS с fetch или WebSocket при две условия: всеки източник (origin) трябва да бъде посочен в мрежовото разрешение в app.json на плъгина, а сървърът трябва да изпраща обичайните CORS заглавки. Не включвайте API ключове в пакета, тъй като всеки, който разполага с публикуван .ehpk файл, може да извлече съдържанието му

VR Expert AI доставя Even Realities G2 за бизнес употреба, включително пилотни бройки и по-мащабни внедрявания. Продуктовата страница предоставя актуални цени, информация за наличност и възможност за заявяване на бизнес поддръжка. Вижте продуктовата страница на Even Realities G2 - Even Realities G2 – продуктова страница: https://ai.vr-expert.com/en/ai-glasses/even-realities-g2 - Документация за разработчици на Even Hub: https://hub.evenrealities.com/docs/get-started/overview - Шаблони: https://hub.evenrealities.com/docs/get-started/quickstart/templates - Локално тестване: https://hub.evenrealities.com/docs/test/local-testing - Бета тестване: https://hub.evenrealities.com/docs/test/beta-testing - Указания за подаване на приложения и контрол на качеството: https://hub.evenrealities.com/docs/ship/app-submission