Utvecklarresurser

Är du utvecklare och vill integrera xBand i ditt projekt? Eller arbetar du med något innovativt som skulle kunna dra nytta av ett vibrationsbaserat gränssnitt?

xBand erbjuder flera integrationsvägar – från CocoaPod och Swift-paket för iOS, till HTTP API och Webhooks för plattformsoberoende serverkommunikation. Oavsett om du bygger egna flöden, experimenterar med nya typer av haptisk feedback, eller utforskar helt nya interaktionsmodeller, ger xBand dig verktygen för att anpassa och utöka enheten efter dina idéer.

Om du är intresserad av djupare samarbeten, partnerskap eller skräddarsydda integrationer pratar vi gärna vidare. Låt oss bygga något spännande tillsammans.

xBand-integration för iOS

Vi tillhandahåller ett lättviktigt iOS-bibliotek för att hantera trådlös kommunikation mellan xBand-enheten och en iOS-app.

Biblioteket hanterar anslutning och att skicka vibrationsmeddelanden till ett xBand. Det finns stöd för Morsemeddelanden och egna vibrationsmönster samt metoder för navigation och riktningsbaserad feedback.

Installation med CocoaPods

Lägg till pod 'xBandConnectIOS' i din Podfile.

Installation med Package Manager

Lägg till xBandConnectIOS som ett Package Dependency med följande URL i din package manager:

https://gitlab.com/xtactor/public/swift-packages/xBandConnectIOS

Exempelprojekt

En demoapp finns tillgänglig för att hjälpa dig komma igång med xBand-integration. Den visar viktiga funktioner som anslutning och vibrationskontroll. Demoappen kräver en fysisk iOS-enhet (inte stöd för simulator).

Exempelprojektet använder xBandConnectIOS som en CocoaPod. Om du vill använda Swift-paketet istället, ta bort xBandConnectIOS från Podfile och lägg till paketberoendet.

GitLab – xBandConnectIOSExempel

Nyckelfunktioner i biblioteket

  • Anslutningshantering: Övervaka anslutning och anslut automatiskt till närliggande xBand-enheter.
  • Vibrationsdata: Skicka standard-Morse eller skapa egna lågnivåmönster för motorerna.
  • Navigation: Anger att xBand ska vibrera baserat på en vinkel och ett avstånd till ett navigationsmål. Navigationsmönstren är förkonfigurerade på enheten. Kontakta oss om du vill veta mer.
  • Batteri- och firmwaremonitorering: Läs enhetsinformation som batterinivå eller firmwareversion via inbyggda callbacks.

Licensiering

Detta bibliotek släpps under MIT-licensen. Se LICENSE-filen i repositoriet för detaljer.

xBand HTTP API och Webhooks

xBand HTTP API låter dig integrera xBand i dina egna system med hjälp av enkla webbförfrågningar. Det ger ett plattformsoberoende sätt att skicka vibrationsmeddelanden till en xBand-enhet och ta emot knappkommandon eller morsemeddelanden från enheten via Webhooks.

Med HTTP API kan du trigga Morsemeddelanden eller lågnivåmotorstyrning. Du kan också fånga inkommande kommandon från bandet och använda dem för att styra funktioner i dina egna applikationer eller tjänster.

Skicka meddelanden till xBand

Skicka vibrationsmeddelanden genom att göra en vanlig HTTP GET-förfrågan till vår endpoint:

https://xtactor.io/api/v1/text-to-xband?apiSecret={apiSecret}&message={message}

Du hittar din API-secret i appen.

Meddelanden konverteras till vibrationer i morsekod på xBand-enheten. För anpassade vibrationsmeddelanden med lågnivåkontroll kan du använda specialtecken (<, >, #, |) i meddelandet för att aktivera specifika vibrationsmotorer eller göra pauser.

Ta emot meddelanden från xBand (Webhooks)

För att ta emot kommandon från xBand, konfigurera en Webhook-URL i xBand-appen.
När kommandot triggas skickar appen en GET-förfrågan till din server med:

  • apiSecret (för validering)
  • message
    • Text (tolkad från knapptryckningar i morsekod), om bandet är i Morseläget.
    • Antalet knapptryckningar som initierade HTTP API-knappkommandot, om bandet är i Klockläget.

Du kan utlösa utgående meddelanden med hjälp av:

Morseläget: skriv "w {message}" i morsekod

Klockläget: tilldela HTTP API till ett knappkommando (antalet tryckningar blir meddelandet)

Exempelserver

Ett enkelt Spring Boot-projekt finns för att hjälpa dig komma igång med Webhook-hantering, svarshantering och innehåller exempel som att skicka meddelanden mellan två xBand-enheter och externa integrationer.

GitLab – Exempel på xBand HTTP-server

Nyckelfunktioner i HTTP API

  • Tvåvägskommunikation: Skicka vibrationsmeddelanden och ta emot kommandon från xBand.
  • Anpassade vibrationsmönster: Använd textbaserade mönster (vibrerar i Morse) eller lågnivåmotorsignaler.
  • Webhook-stöd: Bygg händelsedrivna integrationer.
  • Plattformsoberoende: Fungerar med alla språk, ramverk eller miljöer som stöder HTTPS.
  • Säker kommunikation: All trafik valideras med din apiSecret och skickas alltid via HTTPS.

När man ska använda HTTP API:et

  • Du vill integrera xBand i ett backend-system.
  • Du vill bygga egna kommandon, aviseringar, automation eller kommunikation mellan enheter.
  • Du utforskar avancerade eller experimentella användningsområden som IoT-triggering, Discord-botar, hemautomation eller molnbaserade arbetsflöden.

Partnerskap och skräddarsydda integrationer

Vi är alltid öppna för nya idéer och samarbeten. Oavsett om du utvecklar en app, bygger ett hjälpmedel, skapar en navigationslösning eller utforskar helt nya användningsområden.

Vi kan stödja med:

  • Skräddarsydda integrationer eller prototyper
  • Forskningssamarbeten
  • Lösningar med fokus på tillgänglighet eller navigation
  • Utvecklarvägledning och teknisk support
  • Tidig åtkomst till firmware eller API:er

Om du vill utforska vad som är möjligt tillsammans, kontakta oss på team@xtactor.com .