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. 「ログイン」をクリック — サーバーが起動中の場合、「サーバー待機中...」ダイアログが表示されます。

初期設定

初回ログイン後、以下の手順を順番に完了してください：

1. デフォルトパスワードを変更 → 設定 → ユーザー設定 → 管理者アカウントを編集
2. ライセンスを有効化 → 設定 → ライセンス → キーを入力またはファイルをアップロード
3. カメラを追加 → 設定 → サーバーとカメラ → + カメラ追加
4. カメラグループを作成 → カメラグループタブ → + グループ作成
5. グループにAIパイプラインを割り当て → グループ詳細 → AIパイプライン設定
6. カメラごとの検知を有効化 → ライブビュー → カメラを選択 → AI設定 → タイプを有効化

カメラの追加

自動検出（ONVIF）

1. 設定 → サーバーとカメラ → + カメラ追加に移動
2. 自動モードを選択
3. 検索をクリック — ネットワークで検出されたカメラがリストに表示されます
4. 追加するカメラにチェック
5. 必要に応じてカメラの認証情報（ID/パスワード）を入力
6. 追加をクリック

手動（RTSP URL）

1. 手動モードを選択
2. カメラ名と完全なRTSP URLを入力：rtsp://user:pass@192.168.1.50:554/stream1
3. 必要に応じてカメラ認証情報（ID/パスワード）を入力
4. 追加をクリック

カメラグループ＆AIパイプライン

グループはカメラを管理し、共有AI処理を割り当てます。グループ内のすべてのカメラは同じパイプライン設定を共有します。

1. グループ作成： サーバーとカメラ → カメラグループ → + グループ作成 → 名前を入力 → 作成
2. カメラ割り当て： グループ詳細 → + カメラ割り当て → カメラにチェック → 割り当て。1台のカメラは1つのグループにのみ所属するため、すでにいずれかのグループに属しているカメラはカメラ割り当てリストに表示されません。
3. パイプライン割り当て： グループ詳細 → AIパイプライン設定 → パイプラインを選択 → 追加
4. カメラごとの検知を有効化： ライブビュー → カメラを選択 → AI設定 → 炎/煙/転倒/侵入を有効化 → 保存

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イベントが発生すると、該当するカメラタイルのボーダーがそのイベントの色（検知ボックスと同じ色。色が未設定の場合は赤）で点滅します。

イベントアイコンと色： 各AIイベントタイプには、パイプラインのイベント出力で設定されたアイコンと色があり、クライアントはこれを唯一の基準として使用します。AI設定のイベントチップやインシデントログのラベルにこのアイコンと色が表示され、上記のアラートフラッシュも同じ色を使用します。

4. 設定＆構成

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

一般設定

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

サーバーとカメラ

全カメラタブ

• テーブルビュー：カメラ名、IP、ステータス（オンライン/オフライン）、グループ、AI検知ステータス、アラーム（AI検知ステータス = そのカメラでAI検知が有効かどうか）
• 検索： カメラ名またはIPでフィルタ
• フィルター： ステータスドロップダウン（オンライン/オフライン/すべて）、グループドロップダウン
• 一括操作： 複数のカメラにチェック → グループに割り当てまたは削除
• 編集/削除： カメラごとのアクションボタン

カメラグループタブ

• グループカード表示：名前、割り当てパイプライン、カメラ数、AI数、アラーム数
• グループ作成： + グループ作成 → 名前 → 作成
• カメラ割り当て： グループ詳細 → + カメラ割り当て → チェック → 割り当て
• AIパイプライン設定： ドロップダウンからパイプラインを選択 → 追加

AI設定

アクセス：設定 → AI設定。AdminとSuper_AdminはAIモデルを管理できます。Super_Adminのみがパイプラインを作成/変更できます（Adminはパイプラインの閲覧が可能）。Adminには、パイプラインの作成・編集・削除のコントロールが無効化された状態（ツールチップ付き）で表示されます。パイプラインを変更できるのはSuper_Adminのみです。

AIモデルHub

• モデルカード表示：タイプバッジ（Detector/Classifier/Embedder/Segmenter）、バージョン、名前、説明
• 検索＆フィルタ： モデル検索、タイプフィルタ（すべて/Detector/Classifier/Embedder/Segmenter）
• モデルアップロード： + 新規AIモデル追加 → ウェイト（.onnx/.pt/.enc/.tflite）とマニフェスト（.toml）をアップロード → 保存
• 設定： モデルカードの[設定]ボタン → バージョン管理ダイアログ。バージョン履歴、モデルエンジン・設定（.toml）の差し替え、新バージョンのアップロード、説明の編集が可能です（モデル名は変更不可）。変更は自動的に適用されます。アクティブなパイプラインで使用中のモデルを変更した場合は、再起動を推奨するメッセージが表示されます。
• 削除： 使用されていないモデルのみ削除できます。アクティブなパイプラインが参照しているモデルは削除できません。

AIパイプライン

カメラごとのAI設定

ライブビューでカメラを右クリック → AI設定：

• AI機能をON → 検知するイベントタイプを選択： 炎、 煙、 転倒、 侵入
• 定義済みルール： 各イベント出力を展開すると、モーダルで該当する検知ルール（パイプラインのイベント出力オプション、信頼度閾値など）を表示/編集できます。閾値が低いほど敏感になり、高いほど誤検知が減ります。
• ROI： ポリゴンを描画 — このエリア内のみで検知
• RONI： ポリゴンを描画 — このエリア内の検知を無視（ROI/RONIポリゴンはROIエディタ内で個別に削除）
• FPS to AI： AIに送信するフレームを制御するセレクター（ドロップダウン）。低い = GPU使用量が少ない
• 初期化： このカメラのAI設定をデフォルト値に戻します。
• 保存をクリックして変更を適用

検知ボックスの初期色：転倒＝黄、炎＝赤、煙＝オレンジ、侵入＝青（パイプラインごとに変更可能）。

通知設定

チャンネル（配信方法）

各チャンネルはテスト、アクティブ/非アクティブの切り替え、編集、または削除（ルールが参照している場合は削除不可）が可能です。ヘッダーが複数必要な場合はカンマ（,）で区切ります。

ルール（IF-THEN自動化）

5ステップでルールを作成します。ルール名（1〜100文字）を入力：

1. IF（トリガー）： AIイベント（炎/煙/転倒/侵入）、カメラ状態（オンライン/オフライン）、またはシステムアラート
2. 範囲＆スケジュール： カメラ/グループを選択 + スケジュール（常時またはカスタム曜日/時間）
3. スロットル： 配信ケイデンスを次の5つから選択 — 即時 / 1分に1回 / 1時間に1回 / バッチ(5分) / ダイジェスト(毎時)。1日の最大回数（任意）も設定できます。
4. ゲート（任意）： 追加条件（例：信頼度 > 0.5、ボックスサイズ）
5. THEN（アクション）： チャンネルとメール受信者を選択。各ルールには通知音の再生トグルがあり、このルールでの音の有無を切り替えられます。さらに、各ルールで発生時に再生する通知音を選択でき、プレビューボタンで試聴できます。

アラート音の対応： 炎・煙 → アラーム、侵入 → サイレン、転倒 → アラート、その他 → ビープ。音は約2秒間デバウンスされ、各通知ルールの再生トグルでオフにできます。

グローバルポリシー

• 通知カウントダウン： 同じソースからの同じイベントアラート間の最小秒数
• 制限： 1分あたり/1時間あたりの最大通知数
• サイレントタイム： 指定した時間帯にすべての通知を抑制

ポリシーを保存をクリックして適用。初期化をクリックしてデフォルトに戻す。

ユーザー設定

Admin/Super_Adminのみ。設定 → ユーザー設定。

• ユーザー追加： + 追加 → ユーザー名（3〜20文字）、パスワード（4文字以上）、電子メール、役割 → 保存
• 編集： 役割、パスワード、または状態を変更（電子メールは変更不可）。状態を「非活性化」に設定すると、削除せずにログインを防止できます。
• 役割： Admin、User（Super_AdminはUIで割り当てできません）
• 役割変更の制限：Userは管理者(Admin)に昇格できますが、管理者(Admin)をUserに降格することはできません。

ライセンス管理

ライセンスステータス

ライセンスページには以下が表示されます：現在のステータス（有効 / 期限間近（残りN日） / 期限切れ）、有効期限、ライセンスカメラ数。

ライセンスはマシンに紐づいており（ハードウェア・デバイスID）、別のマシンへ移すことはできません。

オンラインアクティベーション

1. キーを入力：XXXXX-XXXXX-XXXXX-XXXXX
2. ライセンスを有効化をクリック

オフラインアクティベーション

1. リクエストファイルを生成をクリック → .reqファイルを保存
2. ファイルをサポートに送信 → ライセンスファイルを受け取る
3. ライセンスファイルをアップロードをクリック → ライセンスを適用

システム設定

ヘルプページ

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

• ユーザーマニュアル — デフォルトブラウザでこのマニュアルを開く
• サポートに連絡 — 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

イベントの監査

1. TrueまたはFalseを選択 — True = 実際のイベントを確認、False = 誤検知
2. メモを追加（任意） — 観察した内容を記述（最大500文字）
3. 「チェック」をクリック — イベントに記録されます：確認者、最終修正日時、True/Falseステータス

イベントのダウンロード

• 詳細ページのダウンロードアイコンをクリック
• フォーマットを選択：イメージ（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. 用語集