カスタム実行ノード概要

​

カスタム実行ノードとは

• WiFiネットワークの制御(スキャン、接続、切断)
• IoTデバイスの管理(スマートホーム、センサー)
• ハードウェアとのインタラクション(GPIO、シリアルポート)
• リモートデバイスでのカスタムコマンド実行
• リアルタイムイベント通知の送信

​

ユースケース

​

ネットワークテスト

• テスト実行中に WiFi ネットワークを切り替え
• ネットワーク切断をシミュレート
• 信号強度とレイテンシを監視

​

IoT自動化

• スマートライト、サーモスタット、ドアロック
• 温度、湿度、モーションセンサー
• カスタムハードウェア統合

​

リモートコマンド実行

• 組込みシステムでスクリプトを実行
• テスト機器を制御
• テストインフラストラクチャを管理

​

動作仕組み

​

主要機能

​

自己記述型

​

デフォルトで安全

• 初回接続にはユーザー承認が必要
• 認証用の事前共有キー
• 内部ネットワーク展開（公共インターネットに公開されない）

​

リアルタイムイベント

• wifi.connected - WiFi 接続確立
• sensor.temperature_changed - 温度読み取り更新
• ユースケースに固有のカスタムイベント

​

言語非依存

• WebSocket クライアント
• JSON シリアライゼーション
• プラットフォーム(Python、Node.js、Go、Rust、C++ など)

​

アーキテクチャ

• ✅ 独立して実行
• ✅ WebSocket 経由で接続
• ✅ 独自の機能を宣言
• ✅ 内部実行ノードに干渉しない

​

プロトコルの基本

​

メッセージ形式

{
  "id": "msg-uuid-001",
  "protocolVersion": "1.0.0",
  "type": "register",
  "timestamp": "2026-01-21T10:30:00.000Z",
  "payload": { ... }
}

​

接続フロー

1. 接続 - 実行ノードが WebSocket 経由で接続
2. 登録 - 実行ノード情報と機能を送信
3. 認証 - ユーザーが承認(初回)またはキーが検証(再接続)
4. 実行 - Qaptly がコマンドを送信、実行ノードが応答
5. イベント - 実行ノードがリアルタイムイベントを送信(オプション)
6. ハートビート - 接続を維持(30秒ごと)

​

はじめに

​

要件

• 開発環境: WebSocket をサポートする任意の言語
• Qaptly Desktop: バージョン 0.15.0 以降
• 対象デバイス(オプション): Raspberry Pi、Arduino、またはネットワーク接続デバイス

​

次のステップ

1. クイックスタートガイドに従って、最初の実行ノードを構築
2. プロトコルリファレンスを読んで詳細な仕様を確認
3. 例をチェックして、完全な実装を確認