MirAI ユーザーマニュアル

1. 概要

MirAIは、インテリジェントな映像監視およびAI分析プラットフォームです。高性能なRustベースサーバー（AI推論、ストリーム管理、データ保存）とQt C++デスクトップクライアント（ライブ監視、イベント管理、設定）で構成されています。

主要機能

• リアルタイム映像ストリーミング — GStreamerによる低遅延RTSPとハードウェアアクセラレーションデコーディング。サーバーあたり最大100台のカメラに対応。
• AIイベント検知 — 炎（火災）、煙、転倒、侵入のパイプラインベース検知。ROI/RONIゾーンと信頼度閾値の設定が可能。
• マルチカメラグリッド — 1×1から10×10までの柔軟なグリッド（最大100台同時表示）。カメラの台数に応じてグリッドが自動的に拡大・縮小します。ドラッグ＆ドロップによる並べ替え、カメラグループに対応。
• カメラグループ＆AIパイプライン — カメラをグループ化し、グループごとにAIパイプラインを割り当て。
• イベント録画＆監査 — プリイベントバッファ付き自動録画。監査ワークフロー（True/False）、マルチフォーマットダウンロード（MP4、AVI、PNG、JPG）。
• 通知システム — Email、Webhook、HTTPエンドポイント、SNMP配信によるIF-THENルールエンジン。グローバルレート制限とサイレントタイム。
• マルチサーバー対応 — 複数のサーバーに同時接続し、それぞれを個別のタブで表示。
• ロールベースアクセス — Super_Admin、Admin、Userロールによる詳細な権限管理。
• システム管理 — ストレージポリシー、スケジュールバックアップ/リストア、監査証跡、ログUser、自動更新。
• 多言語対応 — 英語、韓国語、日本語。タイムゾーンと日付形式の設定が可能。

メイン画面レイアウト

システム要件

ユーザーロール

2. はじめに

ログイン

1. MirAIを起動 — デスクトップアイコンをダブルクリックします。
2. サーバーIPを入力 — サーバーのIPアドレスを入力します（例：192.168.1.100）。デフォルトポート：7878（HTTPS）。
3. IDとパスワードを入力 — システム管理者から提供された認証情報を使用します。
4. 「IDとパスワードを記憶」にチェック（任意） — 次回の自動ログインが有効になります。
5. 「ログイン」をクリック — サーバーが起動中の場合、「サーバー待機中...」ダイアログが表示されます。

3. ライブビュー

グリッド操作

グリッドへのカメラ追加

• カメラをドラッグ — サーバーリストから空のグリッドセルにドロップ
• サーバーをドラッグ — そのサーバーのすべてのカメラでグリッドを埋める
• カメラグループをドラッグ — グループ内のすべてのカメラでグリッドを埋める
• 並べ替え — セル間でドラッグしてカメラを並べ替え

グリッドナビゲーション

グリッドのサイズは配置されたカメラの台数に応じて自動的に調整されます（例：カメラを追加すると1×2が1×3に拡大）。ズーム操作はありません。

カメラをドラッグ中は、ライブプレビューで配置先のセルがハイライト表示され、変更後のグリッドサイズ（例：「3 × 2」）が表示されます。すでにグリッド上にあるカメラを再度追加した場合は、新しいタイルを作らず、既存のタイルがハイライトされます。

カメラホバーメニュー

カメラタイルにマウスを合わせるとコントロールバーが表示されます：

通知パネル（右サイドバー）

AIがイベントを検知した場合：

1. 右パネルに通知カードが表示されます：イベントタイプアイコン、カメラ名、サーバー、タイムスタンプ、サムネイル
2. 通知をクリックするとイベント詳細ビューに直接移動します
3. 「すべてクリア」をクリックしてすべての通知を消去
4. ミュートボタン（右上、スピーカーアイコン）でアラート音を消音

パネルにマウスを合わせている間は、新しいカードが届いてもスクロール位置が固定され、確認中のカードを見失いません。パネルは最大50枚のカードを保持し、それを超えると古いカードから削除されます。パネルを折りたたんでいるときに新しいアラートが届くと、再表示アイコンが赤く点滅します。

サーバー管理

サーバーリストツリー構造

ツリー内の表示の見方：

• カメラ名の色： 現在グリッドに表示中のカメラは明るい白、グリッドに表示していないカメラはグレーで表示されます。
• AIチップ（紫）：そのカメラでAI検知が有効です。
• ベル（黄）：そのカメラを対象にした通知ルールが存在します。
• 録画ドット： 赤＝録画中、黄＝保留中、オレンジ＝エラー。

カメラグループを右クリックするとすべて展開／すべて折りたたみを選択できます。また、カメラをグループ上にドラッグすると、確認のうえそのグループへ割り当てを変更できます。

サーバーコンテキストメニュー（サーバーを右クリック）

• サーバー情報 — CPU・GPUの製品名を表示
• カメラ追加 — カメラ追加ダイアログを開く
• カメラテスト — ストリームの動作確認用テストビデオウィンドウを開く
• ログ確認 — このサーバーのイベントログを開く

カメラコンテキストメニュー（カメラを右クリック）

• カメラ設定 — カメラ名、解像度、プロファイルを編集
• ログ確認 — このカメラのイベントのみを表示
• AI設定 — このカメラのAI検知を設定
• フロー表示 — AIパイプラインフロー図を表示（読み取り専用）

すべてのコンテキストメニューにはカメラID表示トグルが含まれており、グリッドのカメラIDバッジを表示/非表示にできます。

サーバーの追加

1. サーバーリストエリアを右クリック → サーバー追加
2. サーバーのIPアドレス、ユーザーID、パスワードを入力
3. テストをクリックして接続を確認
4. 追加をクリック
5. 新しいサーバーが上部に新しいタブとして表示されます

サーバー情報ダイアログ

サーバーを右クリック → サーバー情報で表示される内容：

• サーバー名 — 編集できるのは現在ログイン中のサーバーで、かつ管理者権限（Admin/Super_Admin）がある場合のみです。それ以外では読み取り専用となり、保存ボタンは表示されません。
• CPU・GPUの製品名
• サーバー削除ボタン — このサーバーから切断

複数サーバーの利用

MirAIは1つのクライアントから複数のサーバーを監視できます。サインインしたサーバーがログインサーバーで、（上記の手順で）追加したサーバーは追加サーバーとなり、上部に独立したタブとして表示されます。タブをクリックしてサーバーを切り替えます。

追加サーバーでもすべてを監視できます。カメラをグリッドに配置し、ライブ映像を表示し、サーバーリストのツリーを参照し、イベントログを開き、AIイベントを確認できます。各カメラには、そのカメラが属するサーバーで定義されたAIイベントの種類が表示されます。

追加サーバーは読み取り専用です。カメラのグループ分け、AI設定、通知ルール、ユーザー管理、その他ほとんどの設定は、現在ログイン中のサーバーでのみ変更できます。追加サーバーを設定するには、そのサーバーに直接ログインしてください。（追加サーバーではサーバー名などの項目は読み取り専用となり、グループへのドラッグ＆ドロップも無効になります。）

追加サーバーの監視を終了するには、サーバーを右クリック → サーバー情報 → サーバー削除を選択します。これはクライアントの接続を切断するだけで、サーバー自体には影響しません。

カメラステータスインジケーター

以下の状態はライブビューのグリッド内の各カメラタイルに表示されます:

アラート時の画面フラッシュ： AIイベントが発生すると、該当するカメラタイルのボーダーがそのイベントの色（検知ボックスと同じ色。色が未設定の場合は赤）で点滅します。

4. 設定＆構成

トップナビゲーションバーの設定ボタンからアクセスします。左サイドバーに設定カテゴリが表示されます。

一般設定

すべてのユーザーロールで利用可能。外観と設定を構成：

ヘルプページ

設定 → ヘルプ（すべてのロールで利用可能）。含まれる内容：

• ユーザーマニュアル — デフォルトブラウザでこのマニュアルを開く
• サポートに連絡 — MarkAny Co., Ltd.サポート情報（ウェブサイト、電話、メール）
• キーボードショートカット — すべてのキーボードショートカットのクイックリファレンス
• サードパーティライセンス — Qt（LGPL v3）、GStreamer（LGPL v2.1+）、OpenCV（Apache 2.0）、Rust crates（MIT/Apache 2.0）

5. イベントログ

トップナビゲーションのイベントログタブ、またはサーバー/カメラを右クリック → ログ確認からアクセスします。

イベントのフィルタリング

テーブルには以下が表示されます：日時、サムネイル、カメラ、イベント種類、イベント（True/False）、確認者、確認日時。下部にページネーション。

イベント詳細ビュー

任意の行をクリックして開きます：

• ビデオ再生（タイムラインスクラバー付き） — 約5秒のプリイベントバッファを含む。再生をクリック、ドラッグでシーク。
• AIバウンディングボックスオーバーレイ — キャプチャ画像上に検出された内容を表示
• メタデータ： イベント種類、サーバー名、カメラ名、最終修正日時、イベントT・F

イベントのダウンロード

• 詳細ページのダウンロードアイコンをクリック
• フォーマットを選択：イメージ（PNG/JPG）および/または動画（MP4/AVI）
• バウンディングボックスを含めるにチェックすると、AI検知ボックスを書き出すイメージ・動画に焼き込みます
• 保存フォルダを選択 → プログレスインジケーター付きでダウンロード開始

6. よくある質問

7. トラブルシューティング

接続の問題

切断＆再接続の動作

サーバー接続が失われた場合：

• メイン画面に「切断されました」オーバーレイが表示されます
• カメラストリームは最後に受信したフレームでフリーズします
• クライアントは数秒ごとに自動的に再接続を試みます
• 再接続されると、ストリームが再開しオーバーレイが消えます
• 切断中に受信した通知は遡って表示されません

一般的な接続の問題

• 対象マシンでサーバーアプリケーションが実行中であることを確認
• IPアドレスとポート（デフォルト：7878）を確認
• ファイアウォールがサーバーポートへの受信接続を許可していることを確認
• 両方のマシンが同じネットワーク上にあるか、VPNが設定されていることを確認
• 使用中に「サーバー切断」→ ネットワークを確認。クライアントは自動再接続します。

カメラの問題

フィードが表示されない

• まずVLCでRTSP URLをテストし、MirAI外で動作することを確認
• カメラがサーバーマシンから到達可能であることを確認（クライアントだけでなく）
• カメラステータスインジケーターを確認（緑=オンライン、赤=オフライン、黄色点滅=停止）
• サーバーログを確認：logs/server.log

検出中にカメラが見つからない

• IP範囲が正しく、カメラの電源が入っていることを確認
• カメラがONVIFをサポートし、有効になっていることを確認
• 代わりにRTSP URLで手動追加を試す

AI検知の問題

• カメラの検知が有効であることを確認（右クリック → AI設定）
• カメラがアクティブなパイプラインが割り当てられたグループに属していることを確認
• 信頼度閾値を下げる（テスト用に0.3〜0.5を試す）
• ROI/RONIを確認 — イベントがROIポリゴンの外にある可能性
• サーバーGPUが過負荷でないことを確認（90%超 → フレームドロップ）
• 正しいAIモデルがModel Hubでアクティブであることを確認
• logs/ai_pipeline.logを確認

通知の問題

• チャンネルがアクティブであることを確認（チャンネルタブでONに切り替え）
• チャンネルカードのテストボタンをクリックして配信を確認
• イベントタイプをチャンネルにリンクするルールがあることを確認
• グローバルポリシーを確認 — サイレントタイムが抑制している可能性
• レート制限を確認（1分/1時間あたりの最大数が使い果たされている可能性）
• Email：SMTP設定、ポート、暗号化、認証情報を確認
• Webhook：URLがサーバーから到達可能であることを確認

一般的なエラーメッセージ

パフォーマンスのヒント

• クライアントのCPU負荷を軽減するために小さいグリッドレイアウトを使用
• 多数のフィードを監視する場合、ホバーメニューでカメラを低解像度に切り替え
• 「FPS to AI」スライダーを下げてサーバーGPU使用量を削減
• 保持ポリシーを設定して古い録画を自動削除し、ディスク容量を解放
• クライアントマシンで他のリソース集約型アプリケーションを閉じる

クイックリファレンス：ヒント＆ショートカット

8. 用語集