Skip to content
Mit KI weiterarbeiten

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:

powershell
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:

powershell
npm ci
npm run testkit

Der 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:

ts
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.