Gravio HubKit / Gravio Studio 更新履歴
本ページでは、Gravio HubKit と Gravio Studio(Windows / Mac)の各リリースにおける主な変更点をまとめています。
目次
Gravio HubKit
6.4.0(2026年11月9日)
アップデート前の確認事項
- 一部のコンポーネントで、既存アクションの動作に影響する変更があります。特に File Delete のフォルダの扱い と 出力変数の名前・型の変更 を確認してください。
- アップデート後は Web UI のログイン状態が一度解除されます。再度ログインしてください。
- Mac 版は macOS 15.8 以降が必要になりました。
新機能
Web UI:MCP クライアントの設定ガイド
アカウント管理 画面から、パーソナルアクセストークンを使って HubKit MCP サーバー に接続するための設定手順を表示できるようになりました。
- Claude Desktop、Cursor、その他の MCP クライアント(Streamable HTTP)ごとに設定内容を表示し、コピーできます
- Windows 版・Mac 版のハブでは、Claude Desktop 用の拡張機能ファイル(
.mcpb)をダウンロードできます。トークンはファイルに含まれず、インストール時に入力します - Linux 版と Gravio Hub X64 でも、HubKit MCP サーバーを利用できるようになりました。ハブ以外の PC からは
https://<ハブのアドレス>/mcpに接続します(設定例)
Gravio Hub X64:ネットワークアクセス設定
Gravio Hub 設定 に「ネットワークアクセス」セクションを追加しました(管理者のみ)。ネットワーク上の他のマシンから接続できるサービスごとに、待ち受けの状況とファイアウォールの状態を確認し、ポートを開閉できます。閉じたポートは、再起動やアップデートの後も閉じたままです。
- 対象サービス:Web UI と Gravio Studio(HTTPS)、SSH、ログイン不要の Hub API、App Service 公開リスナー、i-PRO カメラのイベント、MQTT ブローカー、MCP サーバー
- ポートの開閉には、ホストファイアウォールを備えた新しい OS イメージが必要です(後述の「OS の更新」で移行できます)。MCP サーバーのオン/オフは、どの OS イメージでも切り替えられます
- WAN へのポート転送で、認証のない Hub API(29442)や、ログインなしで API を使える状態の 443 番ポートを公開する設定には警告を表示します
Gravio Hub X64:OS の更新(ディスク構成の移行)
古いディスク構成の Gravio Hub X64 を、USB メモリを使わずに、リカバリパーティションとホストファイアウォールを備えた現在の OS イメージへ移行できるようになりました。Gravio Hub 設定 から、事前確認、新しい OS のダウンロード、PC へのバックアップ、更新の開始、進捗と結果の確認までを行えます。
- Hub ID、Hub の設定、ネットワーク設定は引き継がれます
- Hub データが 4 GB を超える場合、ログ、カメラの画像・動画、センサーデータの履歴、AI モデル、アクションが保存したファイルは引き継がれません。更新前に PC バックアップを保存し、更新後に「HubKit データインポート」で復元してください
- 更新中は Hub が2回再起動し、通常 5〜15 分(データが多い場合は 30 分ほど)使用できません。更新が終わるまで電源を切らないでください
- 更新後は、ファイアウォールで許可されたポート以外には外部から接続できなくなります。許可されるポートは更新前の画面に表示されます
カメラ:ONVIF の HTTPS / IPv6 対応
- ONVIF カメラに HTTPS および IPv6 アドレスで接続できるようになりました
- RTSP ソースに、TLS 証明書の検証を省略する
Insecureオプションを追加しました rtsps://の既定ポートを 322 に変更しました
関数仕様の取得 API
アクションフロー式で使える関数の一覧と、引数・戻り値の型を返す GET /api/action/spec/functions を追加しました。HubKit MCP サーバーもこの一覧を参照するようになり、そのハブで実際に使える関数だけを AI クライアントに提示します。
変更・改善
File Delete:ワイルドカード対応とフォルダの扱いの変更
File Delete コンポーネントを刷新しました。
- ファイル名にワイルドカード(
*、?など)を使えるようになりました。セミコロン(;)で区切って複数のパターンを指定できます - パターンがフォルダに一致したときの動作を選ぶ
Foldersプロパティを追加しましたSkip(既定):フォルダは削除せずにスキップするStop:エラーとしてアクションを停止するDelete:フォルダを中身ごと削除する
- 削除したパスを
cv.Deleted、スキップしたフォルダをcv.Skippedで参照できます - アクションデータフォルダ自体と、その外側のファイルは削除できません
従来のバージョンでは、指定したパスがフォルダの場合は中身ごと削除していました。6.4.0 では既定でフォルダを削除しないため、フォルダの削除を前提にしているアクションでは Folders を Delete に設定してください。旧 All プロパティは使用されなくなりました。
出力変数名の統一
次のコンポーネントの出力変数名を、先頭が大文字の形式に統一しました。
- Claude:
id→Id、model→Model、stop_reason→StopReason、stop_sequence→StopSequence、input_tokens→InputTokens、output_tokens→OutputTokens - Standard LLM:
model→Model、input_tokens→InputTokens、output_tokens→OutputTokens、finish_reason→FinishReason、reasoning→Reasoning - Microsoft Drive Upload / SharePoint Upload:
fileURL→FileURL、fileId→FileId、fileName→FileName - Gemini / OpenAIChat:
FinshReasons→FinishReasons(綴りの誤りを修正)
6.4.0 では旧名の変数も引き続き出力されますが、今後のリリースで削除する予定です。
出力変数の型の統一
次の出力変数は、結果の件数や出力形式によらず常に同じ型を返すようになりました。旧形式での出力は行われないため、これらの変数を使用しているアクションを確認してください。
- OpenAIChat:
cv.FinishReasons、cv.MessageNames、cv.MessageRolesは、応答の候補が1件の場合も常に配列になります(従来は1件のとき単一の値) - Statistics:
cv.Statisticsは常に配列になります(従来は対象の値が配列でない場合に単一の値) - Exec:
cv.Stderrは常に文字列になります(従来は出力形式がバイナリの場合にバイト列)
IVAR 連携の廃止
IVAR(サードパーティの映像解析エンジン)との連携を廃止しました。新しいレイヤーでは IVAR のデータ種別(顔認識、人数カウントなど)を選択できなくなり、IVAR サーバーを登録・設定する API(/ivar/*)を削除しました。既存の IVAR レイヤーと記録済みのデータは参照できますが、IVAR からの新しいイベントは受信しなくなります。i-PRO カメラとの連携は従来どおり利用できます。
CSV File Write:Header プロパティの追加
ファイルを新規作成・上書きするとき(Append がオフのとき)に、1行目にヘッダー行を書き込む Header プロパティを追加しました。カンマ区切りの文字列、または配列で指定します。追記時はヘッダーを書き込みません。空欄(既定)の場合は、従来どおりヘッダーなしで出力します。
関数:Sprintf の数値の書式指定
Sprintf で、数値を書式指定子(%d、%f、%x など)に合う型へ自動的に変換するようになりました。従来は Sprintf("%d", 42) が %!d(float64=42) になるなど、数値の内部的な型(整数・小数)によっては正しく整形できない場合がありました。
AI 系コンポーネント:Temperature などに小数を指定可能に
Amazon Nova、OpenAIChat、OpenAICompletion、OpenAIAudio、OpenAITextEdit の Temperature、Top-P などのパラメーターに、0.7 のような小数を入力できるようになりました(従来は整数のみ)。
内部サービスの待ち受けアドレスの変更
セキュリティ強化のため、ハブ内部でのみ使用するサービスは、ハブ自身からの接続だけを受け付けるようになりました。
- IVAR Manager(29448):i-PRO カメラからのイベント受信のみ、外部からの接続を受け付けます
- MCP サーバー(29454):ハブ以外の PC の MCP クライアントからは
https://<ハブのアドレス>/mcpに接続してください(設定例)
Windows 版の変更
- タスクトレイアプリ(Gravio Tools)で、サービスの停止中の表示、キーボードでのサービスの切り替えに対応し、PC の再起動後に UAC の確認なしで自動起動するようになりました
- HubKit の各サービスが異常終了した場合に、自動的に再起動するようになりました
- インストール時に全サービスのデータベースをバックアップし、直近3世代を保持します
- Windows 11 で OS のバージョンを取得できない問題を修正しました
Mac 版の変更
- 動作環境が macOS 15.8 以降になりました
- 各サービスの環境変数
PATHの先頭に/usr/local/binを追加し、HOMEを設定しました。Exec コンポーネントなどで実行するコマンドが、Linux 版と同じように見つかるようになります
その他
- マッピングで
$だけを指定すると、アクションの実行が異常終了する問題を修正しました - MQTT の Webhook で、String 型のレイヤーに送られた JSON 文字列が正しくデコードされない問題を修正しました
- タイマートリガーで、解釈できないスケジュール(タイムゾーンのみの指定など)が保存され、Trigger Manager が異常終了する問題を修正しました。保存時にエラーを返します
- イベントトリガーの追加条件が検証されず、不正な条件を保存できてしまう問題を修正しました
- バックスラッシュ(
\)を含む ID のアクションを開く・保存する・削除することができない問題を修正しました - Gravio Hub X64:
- Wi-Fi AP モードがアップリンクのないときの代替として起動していた場合に、起動時にアップリンクへの接続を再試行するようにしました
- ホットスポットは停止しているが次回起動時に AP モードが開始される設定のとき、その状態を表示し、停止できるようにしました
6.3.2(2026年8月18日)
新機能
Standard LLM コンポーネント
OpenAI 互換または Anthropic 互換の API エンドポイントを持つ LLM サーバー・サービスを呼び出す、汎用 LLM アクションコンポーネントを新規追加しました。
- Ollama / LM Studio / vLLM などローカルで動作するオープンソース LLM から、OpenRouter / Groq などのクラウドサービスまで、1つのコンポーネントで利用できます
- 画像などのファイル添付(複数ファイル可)によるマルチモーダル入力に対応
- レスポンス形式として
text/json_object/json_schemaを選択可能(Anthropic 互換 API ではjson_objectは非対応) - 温度・Top-P・停止シーケンス・シード値などの追加パラメーターに対応し、モデルの推論(reasoning)内容をコンポーネント変数として取得できます
詳細は アクションリファレンス:Standard LLM を参照してください。
Web UI:証明書設定に Let's Encrypt 自動取得・自動更新を追加
Web UI の証明書設定から、Let's Encrypt によるサーバー証明書の自動取得と自動更新が行えるようになりました。
Gravio Hub X64 向けの機能強化
- AP モード(ホットスポット)の開始/停止:Web UI の Hub 設定タブから、Gravio Hub の AP モードを開始/停止できるようになりました
- LTE USB ドングルによる WAN 接続:SWD01 および Soracom Onyx(SC-QGLC4-C1)の LTE USB ドングルによる WAN 接続に対応しました。Wi-Fi を優先アップリンク、LTE をフォールバックとして利用でき、Web UI から切り替えられます
- Tailscale リモートアクセスのオンデマンド ON/OFF:Tailscale によるリモートアクセスを Web UI からオンデマンドに ON/OFF できるようになりました(Gravio Hub X64 のみ)。再起動をまたいで接続が維持されます
変更・改善
Gravio Matrix Gen2 Display:画像対応の強化
- 32 ビットに加えて、8ビット/16ビット(5-5-5/5-6-5)/24ビットの BMP ファイルに対応しました。表示時に自動的に 32 ビット形式へ変換されます(圧縮 BMP は非対応)
- 画像の種類に 「その他」 を追加し、PNG / JPG ファイルを自動的に GIF へ変換して表示できるようになりました
修正
- 推論(inference)レイヤーのデバイス割当ダイアログにカメラが列挙されない問題を修正しました
6.3.0(2026年5月20日)
Mac 版のアップデート方法に関する注意
インストーラの仕組みの変更により、本バージョンに限り gravio.com の Web サイトから DMG をダウンロードして上書き更新をしてください。上書きする前に、Gravio HubKit を停止し、ツールバーアプリを終了してから行ってください。
新機能
Gravio Matrix Gen2 系コンポーネント
第2世代の Gravio LED Matrix Gen2 デバイス用に、3つのアクションコンポーネントを新規追加しました。HTTP / MQTT のどちらの接続方法にも対応しています。
- Gravio Matrix Gen2 Display:テキストや画像(GIF / BMP)の表示。アニメーションGIF、表示位置の指定(簡単/詳細モード)に対応
- Gravio Matrix Gen2 Control:画面のクリア、明るさの設定、デバイスの再起動
- Gravio Matrix Gen2 Template:温度、湿度、気圧、CO2濃度、開閉などのテンプレート表示
デバイス側の接続セットアップ手順や MQTT / HTTP プロトコル仕様については センサー・デバイス接続ガイド:Gravio LED Matrix Gen2 を参照してください。
重要:Gravio Matrix(第1世代)と Gravio LED Matrix Gen2(第2世代)はまったく異なる別製品で、ハードウェアの仕様・接続方式・デバイスIDの形式が異なります。それぞれ対応するコンポーネントのみが利用でき、互換性はありません。
- 第1世代デバイス → 従来の Gravio Matrix コンポーネントのみ
- 第2世代デバイス → 上記の Gravio Matrix Gen2 系コンポーネントのみ
Simple Counter コンポーネント
HubKit 上に永続化される整数カウンタを操作するための2つのコンポーネントを新規追加しました。
- Simple Counter (Read):保存済みのカウンタ値を読み出す(未設定時は
0) - Simple Counter (Write):カウンタを加算または減算する(
AdjustByプロパティで指定)
スコープは HubKit(インストール全体で共有)と ActionGlobal(同一 .acs 内のみ共有)の2種類から選択できます。値はコンポーネントローカルステートとして $ActionDataDirectory/storage/localState/ 配下に永続化され、アクション実行をまたいで保持されます。
Web UI:機能パッケージ管理
Web UI 上で機能パッケージ(複数のトリガー・アクション・関連リソースを1つの .zip にまとめたもの)の 作成・適用・エクスポート・インポート・削除 が行えるようになりました。Hub 管理画面の「アクション設定」セクションから利用できます。
機密データを保護するため、パッケージ作成時に 「ベースプロパティのフィールド値を除外」 オプションを有効にすると、トークンや認証情報をパッケージから除外できます。
Web UI:基本プロパティセット
Web UI 上で、認証情報・接続先・APIキーなど複数のアクションで再利用される設定値(基本プロパティセット)を一元管理できるページを新規追加しました。OAuth2 を利用するカテゴリでは「トークン取得」ボタンから直接認可フローを開始できます。
Web UI:デバイス連携設定(i-PRO / Webhook / MQTTブローカー)
Hub 管理画面のデバイスリスト上部に、以下のデバイス連携設定ダイアログを開くボタンを追加しました。
- i-PRO:i-PRO シリーズ監視カメラのカメラ一覧・追加・編集と、HubKit エンドポイント URL の参照
- Webhook:Webhook エンドポイントの作成、ペイロードフォーマット(
query-params/json)、認証タイプ(なし / BASIC認証)の設定、Webhook URL のコピー - MQTTブローカー:購読対象トピックエントリの作成、ブローカーの登録、QoS/クリーンセッション/タイムアウト等の設定
Webhook:バイナリ/メディアファイル受信
Webhook エンドポイントが、JSON ペイロードだけでなく画像・音声・動画などのバイナリファイルを受信して HubKit 上に保存できるようになりました。
- ファイル種別の判別は
Content-Type→Content-Dispositionのfilename拡張子 → ボディ先頭 3KB の内容(mimetype)の順 - 保存形式:
<エンドポイント短縮ID>/<YYYYMMDD>/data-<タイムスタンプ>.<拡張子> Content-Dispositionヘッダでfilenameを指定した場合はその名前で保存(不正文字は_に置換)
関数:Add / Sub / DurationParse
アクションフロー式言語で使用できる関数を拡張しました。
Add(x, y):数値・文字列・Duration・日時・配列を扱える汎用加算(左辺の型で動作が決まります)Sub(x, y):数値・Duration・日時を扱える汎用減算(配列は非対応)DurationParse(s):"300ms"、"-1.5h"、"2h45m"などの文字列を Duration 型に変換
変更・改善
Microsoft Exchange List Events
Microsoft Graph API の POST /users/{id}/calendarView エンドポイントに準拠する形に更新されました。
- 定期イベント(recurring event)の各インスタンスも取得できるようになりました
- 時間範囲フィルタが
Events Starting After(StartDateTime)とEvents Ending Before(EndDateTime)の2つに集約され、Events Starting BeforeおよびEvents Ending Afterは廃止されました Events Happening Today/Events Currently Ongoingがオフの場合、Events Starting After/Events Ending Beforeの入力が必須となります
既存のアクションで旧プロパティを使用していた場合は、新しいプロパティに置き換える必要があります。
Sensor Data DB:ContinueOnEmpty プロパティの追加
レコードが0件だった場合のアクション実行の挙動を選択できる ContinueOnEmpty プロパティを追加しました。
false(既定):従来通り、レコードが0件のときは後続コンポーネントを実行しないtrue:空のペイロードを出力してアクションの実行を継続する
Split:JSON Object(マップ)入力対応
Split コンポーネントの入力が JSON Object の場合、各エントリを { "Key": ..., "Value": ... } 形式の構造体として1件ずつ次のコンポーネントに渡せるようになりました。条件式では Value.Key / Value.Value を参照できます。
Webhook:ファイル名形式の変更
Webhook 経由で保存されるファイルの命名規則を変更しました。
- 旧:
webhook-<id>-<タイムスタンプ>.<拡張子> - 新:
data-<タイムスタンプ>.<拡張子>
ファイル名のパターンを利用しているアクションがある場合は、新しい形式に合わせて調整してください。
Webhook:エラーメッセージの改善
Webhook エンドポイントのペイロードフォーマット(query-params / json)に対応しない HTTP メソッドでリクエストされた場合のエラーメッセージを、より具体的でわかりやすい内容に改善しました。
Gravio Studio for Windows
6.3.4846(2026年8月18日)
- Gravio HubKit 6.3.2 で追加されたコンポーネント(Standard LLM)のサポート
6.3.4837(2026年5月20日)
新機能
Copy ID / Name ボタンの追加
Area・Layer・Device・Triggers の各項目に ID / 名前をクリップボードにコピーするボタン を追加しました。アクションフロー内でデバイス ID やエリア ID を参照する式を書く際に手入力する必要がなくなり、入力ミスを防げます。
Webhook:バイナリ/メディアファイル受信のサポート
Studio 上でも、Gravio HubKit 6.3.0 で追加された Webhook バイナリファイル受信 を作成・編集できるようになりました。受信形式として query-params / json に加え、画像・音声・動画などのバイナリペイロードを受け入れるエンドポイントを Studio から構成できます。
変更・改善
設定メニュー:「ログのダウンロード」と「実験的コンポーネント」の分離
設定メニュー上で1つにまとまっていた 「ログのダウンロード」 と 「実験的コンポーネント」 の操作を、それぞれ独立した項目として整理しました。意図しない操作を避けやすくなっています。
通知設定:ポート 587 のプレースホルダ表示
通知(SMTP)設定のポート入力欄に、一般的な SMTP サブミッションポート 587 をプレースホルダ値として表示するようにしました。
クイック実行コンソール:Studio のローカル時刻で表示
クイック実行コンソール内のアクションログを、Studio が動作している PC のローカル時刻 で表示するようにしました。サーバとクライアントのタイムゾーンが異なる環境でもログを読み取りやすくなっています。
Gravio Studio for Mac
6.3.0(2026年5月20日)
- Gravio HubKit 6.3.0 で対応したコンポーネントのサポート