Node.js SDK
Verbinde eine Node.js-Anwendung über das binäre Protobuf-WebSocket-Gateway mit Robot Runtime. Nutze Geräteerkennung, Status, Streams und anfragebasierte Operationen mit einem Client.
Installation
Prüfe auf einem vorbereiteten Kit-PC zuerst die gelieferte Softwareliste. Klone den Branch dev des Quickstarts-Repositories oder öffne den gelieferten Node-Quickstart-Ordner. Verwende Node.js 24 LTS und npm. Für den Git-Einstieg:
git clone --branch dev --single-branch https://bitbucket.org/fruitcore/plexa-runtime-quickstarts.gitÖffne anschließend node/ im Git-Klon oder den gelieferten Node-Ordner und führe aus:
npm ci
npm run testkitDer Node-Ordner enthält SDK 0.1.0 und Testkit 0.5.1 als lokale Archive sowie package-lock.json. Führe die Installationsbefehle in diesem Ordner aus. Für gewöhnliche npm-Abhängigkeiten benötigt die Erstinstallation Registry-Zugriff oder einen vorhandenen Cache.
Erster Statusabruf — lokale Fixture
Lass den Testkit-Terminal laufen. Führe im selben Ordner in einem zweiten Terminal npm run status aus; für JavaScript nutze npm run status:js. Das Beispiel prüft Runtime API 0.9.0 und erwartet HORST600_S5. Der Clientlebenszyklus ist:
import { createNodeRobotRuntimeClient } from '@plexa/robot-runtime-sdk';
const client = createNodeRobotRuntimeClient('ws://127.0.0.1:18041/ws/runtime');
await client.connect();
try {
const robots = await client.listRobots();
if (robots.length !== 1) throw new Error('Expected one local fixture robot');
const robot = robots[0];
console.log('Robot:', robot.name);
console.log('Joints in degrees:', await client.getCurrentRobotJoints(robot.name));
} finally {
client.close();
}Das Ergebnis sind ein Fixture-Roboter und seine Gelenkwerte; anschließend wird die Verbindung geschlossen. Die Loopback-Adresse verbindet mit Testdaten, nicht mit deinem physischen Roboter. Verwende für dein System die gelieferte Verbindungskonfiguration und prüfe die Roboteridentität ausdrücklich.
Deine Anwendung erweitern
Gelenkwinkel verwenden Grad, kartesische Positionen Millimeter. Mache Runtime-Fehler und Stream-Abbruch in deiner Anwendung sichtbar.
Node.js-/TypeScript-API-Referenz · Control API · Kit vorbereiten
VS-Code-Tutorial
Node-Quickstart in VS Code öffnen: Editor installieren, einen Statusabruf debuggen, Variablen prüfen und Fixture-Tests ausführen. Die Schritt-für-Schritt-Anleitung enthält Screenshots und Fehlerbehebung für Windows.