Gravio HubKit マニュアル

Gravio HubKit / Gravio Studio 更新履歴

本ページでは、Gravio HubKit と Gravio Studio(Windows / Mac)の各リリースにおける主な変更点をまとめています。

目次


Gravio HubKit

6.4.0(2026年11月9日)

アップデート前の確認事項

新機能

Web UI:MCP クライアントの設定ガイド

アカウント管理 画面から、パーソナルアクセストークンを使って HubKit MCP サーバー に接続するための設定手順を表示できるようになりました。

Gravio Hub X64:ネットワークアクセス設定

Gravio Hub 設定 に「ネットワークアクセス」セクションを追加しました(管理者のみ)。ネットワーク上の他のマシンから接続できるサービスごとに、待ち受けの状況とファイアウォールの状態を確認し、ポートを開閉できます。閉じたポートは、再起動やアップデートの後も閉じたままです。

Gravio Hub X64:OS の更新(ディスク構成の移行)

古いディスク構成の Gravio Hub X64 を、USB メモリを使わずに、リカバリパーティションとホストファイアウォールを備えた現在の OS イメージへ移行できるようになりました。Gravio Hub 設定 から、事前確認、新しい OS のダウンロード、PC へのバックアップ、更新の開始、進捗と結果の確認までを行えます。

カメラ:ONVIF の HTTPS / IPv6 対応
関数仕様の取得 API

アクションフロー式で使える関数の一覧と、引数・戻り値の型を返す GET /api/action/spec/functions を追加しました。HubKit MCP サーバーもこの一覧を参照するようになり、そのハブで実際に使える関数だけを AI クライアントに提示します。

変更・改善

File Delete:ワイルドカード対応とフォルダの扱いの変更

File Delete コンポーネントを刷新しました。

従来のバージョンでは、指定したパスがフォルダの場合は中身ごと削除していました。6.4.0 では既定でフォルダを削除しないため、フォルダの削除を前提にしているアクションでは Folders を Delete に設定してください。旧 All プロパティは使用されなくなりました。

出力変数名の統一

次のコンポーネントの出力変数名を、先頭が大文字の形式に統一しました。

6.4.0 では旧名の変数も引き続き出力されますが、今後のリリースで削除する予定です。

出力変数の型の統一

次の出力変数は、結果の件数や出力形式によらず常に同じ型を返すようになりました。旧形式での出力は行われないため、これらの変数を使用しているアクションを確認してください。

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 のような小数を入力できるようになりました(従来は整数のみ)。

内部サービスの待ち受けアドレスの変更

セキュリティ強化のため、ハブ内部でのみ使用するサービスは、ハブ自身からの接続だけを受け付けるようになりました。

Windows 版の変更
Mac 版の変更

その他

6.3.2(2026年8月18日)

新機能

Standard LLM コンポーネント

OpenAI 互換または Anthropic 互換の API エンドポイントを持つ LLM サーバー・サービスを呼び出す、汎用 LLM アクションコンポーネントを新規追加しました。

詳細は アクションリファレンス:Standard LLM を参照してください。

Web UI:証明書設定に Let's Encrypt 自動取得・自動更新を追加

Web UI の証明書設定から、Let's Encrypt によるサーバー証明書の自動取得と自動更新が行えるようになりました。

Gravio Hub X64 向けの機能強化

変更・改善

Gravio Matrix Gen2 Display:画像対応の強化

修正

6.3.0(2026年5月20日)

Mac 版のアップデート方法に関する注意

インストーラの仕組みの変更により、本バージョンに限り gravio.com の Web サイトから DMG をダウンロードして上書き更新をしてください。上書きする前に、Gravio HubKit を停止し、ツールバーアプリを終了してから行ってください。

新機能

Gravio Matrix Gen2 系コンポーネント

第2世代の Gravio LED Matrix Gen2 デバイス用に、3つのアクションコンポーネントを新規追加しました。HTTP / MQTT のどちらの接続方法にも対応しています。

デバイス側の接続セットアップ手順や MQTT / HTTP プロトコル仕様については センサー・デバイス接続ガイド:Gravio LED Matrix Gen2 を参照してください。

重要:Gravio Matrix(第1世代)と Gravio LED Matrix Gen2(第2世代)はまったく異なる別製品で、ハードウェアの仕様・接続方式・デバイスIDの形式が異なります。それぞれ対応するコンポーネントのみが利用でき、互換性はありません。

Simple Counter コンポーネント

HubKit 上に永続化される整数カウンタを操作するための2つのコンポーネントを新規追加しました。

スコープは 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 管理画面のデバイスリスト上部に、以下のデバイス連携設定ダイアログを開くボタンを追加しました。

Webhook:バイナリ/メディアファイル受信

Webhook エンドポイントが、JSON ペイロードだけでなく画像・音声・動画などのバイナリファイルを受信して HubKit 上に保存できるようになりました。

関数:Add / Sub / DurationParse

アクションフロー式言語で使用できる関数を拡張しました。

変更・改善

Microsoft Exchange List Events

Microsoft Graph API の POST /users/{id}/calendarView エンドポイントに準拠する形に更新されました。

既存のアクションで旧プロパティを使用していた場合は、新しいプロパティに置き換える必要があります。

Sensor Data DB:ContinueOnEmpty プロパティの追加

レコードが0件だった場合のアクション実行の挙動を選択できる ContinueOnEmpty プロパティを追加しました。

Split:JSON Object(マップ)入力対応

Split コンポーネントの入力が JSON Object の場合、各エントリを { "Key": ..., "Value": ... } 形式の構造体として1件ずつ次のコンポーネントに渡せるようになりました。条件式では Value.Key / Value.Value を参照できます。

Webhook:ファイル名形式の変更

Webhook 経由で保存されるファイルの命名規則を変更しました。

ファイル名のパターンを利用しているアクションがある場合は、新しい形式に合わせて調整してください。

Webhook:エラーメッセージの改善

Webhook エンドポイントのペイロードフォーマット(query-params / json)に対応しない HTTP メソッドでリクエストされた場合のエラーメッセージを、より具体的でわかりやすい内容に改善しました。


Gravio Studio for Windows

6.3.4846(2026年8月18日)

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日)