01

設置の計画

現場に行く前に用意するものと、CameraOS がネットワーク上でどう配置されるか。

5 min

必要なもの

最低要件備考
コンピューターApple silicon 搭載の Mac(M1 以降)、macOS 13 以降2020 年以降のすべての Mac mini が対象です。現場の録画機の隣に置いたままにします。
メモリとディスクメモリ 16 GB 推奨、ディスク空き容量 20 GBこれに加えて録画用の容量が必要です。インストーラーの初期設定では最大 50 GB まで保存します。
カメラRTSP で配信できるカメラまたは NVR(ほとんどの IP カメラ、ONVIF)RTMP、HLS、SRT のストリームにも対応しています。各カメラの IP アドレス、ログイン情報、チャンネルが必要です。
ネットワークMac をカメラと同じネットワークに接続有線 Ethernet が最適です。インターネット接続は、インストール時と、オプションの AI 機能に必要です。
ライセンスコンピューター 1 台につきライセンスキー 1 つインストール後にコンピューターの ID を送っていただくと、その Mac 専用のキーをお返しします。

全体の構成

カメラ / NVRローカルネットワーク上の RTSP
→
CameraOS の Macゲートウェイが各カメラを 1 回だけ取り込んで録画 · Apple GPU で AI · Web アプリ
→
ブラウザーとスマートフォンhttp://<mac>:4400

各カメラは、Mac 上のゲートウェイが 1 回だけ取り込みます。録画、AI、すべての視聴者がその 1 本の接続から読み取るため、カメラや NVR から見えるクライアントは常に 1 つだけです。映像、イベント、設定は Mac の中に保存されます。

ポート利用者公開範囲
4400 TCPWeb アプリ:すべてのブラウザーとスマートフォンローカルネットワーク
8189 UDPブラウザーとスマートフォンへのライブ映像(WebRTC メディア)ローカルネットワーク
8554, 8000, 8889, 9996, 9997ゲートウェイの RTSP、AI サービス、WebRTC、再生、ゲートウェイ APIこの Mac のみ(127.0.0.1)

Mac 1 台あたりのカメラ台数

1「負荷」は、軽量な 640×360 のサブストリームで毎秒 1 回の AI 解析です。アプリは軽量・標準・重量に分かれます:

Mac軽量アプリ標準アプリ高負荷アプリ
Mac mini M4 · 16 GB1682
Mac mini M4 Pro · 24 GB30165
Mac Studio M4 Max~50~25~8

軽量:人数カウント、駐車場、うろつき、ライン通過。標準:行列、カフェ、通路、介護、ナンバープレート。重量:工場ライン。M4 の数値は、M1 Pro での実測値から換算したものです。セットアップ後は、歯車メニュー → パフォーマンス で、実際の負荷と「カメラの追加を計画」計算ツールを確認できます。

The Performance page
歯車メニュー → パフォーマンス:この Mac の負荷、カメラ追加のプランナー、各カメラの AI レート。
02

インストールと有効化

Mac にインストールし、ライセンスを有効化して、最初の管理者を作成します。

15 min

インストール

  1. CameraOS のダウンロードファイルを解凍し、フォルダを開きます。
  2. Install CameraOS.command をダブルクリックします。macOS で「開けません」と表示された場合は、右クリックして 開く を選び、もう一度 開く を選びます(または、システム設定 → プライバシーとセキュリティ → このまま開く)。
  3. ターミナルのウィンドウに進行状況が表示されます。初回のインストールには 10〜20 分かかり、インターネット接続が必要です。Python、Homebrew、開発者ツールは不要です。
  4. 完了すると、ブラウザーで CameraOS が開き、ウィンドウにこのコンピューターの ID とセットアップコードが表示されます。このウィンドウは開いたままにしてください。

ライセンスの有効化

  1. ライセンスが入るまで、どのページを開いても このコンピューターを有効化 が表示されます。
  2. 1. このコンピューターの ID を CameraOS に送る で コピー を押し、ID(XXXX-XXXX-XXXX-XXXX のような 16 文字)を当社に送ってください。ライセンスは 1 台のコンピューターでのみ使えます。
  3. 返送されたキー(CAMOS1. で始まります)を 2. 届いたライセンスキーを貼り付ける に貼り付け、有効化 を押します。

あとから、歯車メニュー → ライセンス で、ライセンス先、終了日、含まれるアプリ、このコンピューターの ID を確認でき、新しいキー(アプリの追加や終了日の延長用)も入力できます。

Activate this computer
有効化ページ。別の Mac 用に発行されたキーは拒否されます:「このライセンスは別のコンピューター用です。」

管理者アカウントの作成

  1. 有効化すると、管理者アカウントを作成 の画面に移動します。
  2. インストールウィンドウに表示された 6 桁の セットアップコード(~/CameraOS/data/setup_code.txt にも記載)、名前、8 文字以上のパスワード(2 回)を入力します。
  3. アカウントを作成 を押します。ログインした状態でライブ画面が開きます。アカウントが作成されると、セットアップコードは使えなくなります。
Create the admin account
初回起動:セットアップコードで、CameraOS の Mac の前にいることを確認します。
03

ユーザーと役割の追加

スタッフにはそれぞれのログインを用意し、必要な権限だけを与えます。

3 min
役割できること
管理者すべて:カメラ、アプリ、ゾーン、共有、ユーザー、ライセンス、AI 設定。ストリームのアドレスを省略なしで表示できます。
スタッフライブ映像と再生の視聴、アラート対応、イベント検索、レポートと「質問」の利用。設定は変更できません。ストリームのパスワードは非表示です。
閲覧者ライブ映像と再生の視聴のみ。アラート、イベント、レポート、「質問」は使えません。
  1. 歯車メニュー → ユーザー。
  2. ユーザーを追加 で、名前、パスワード(8 文字以上)、役割(初期設定は スタッフ)を入力します。アカウントを追加 を押し、名前とパスワードを本人に伝えてください。パスワードは本人が アカウントとパスワード で変更できます。
  3. 複数人で共有する画面(ロビーのテレビやデモなど)には、共有ログイン にチェックを入れます。ログインして視聴はできますが、パスワードを変更できるのは管理者だけです。管理者のログインは共有できません。

役割はドロップダウンからすぐに変更できます。パスワードをリセット を押すと、その人はすべての端末でログアウトされます。パスワードを忘れた場合は、管理者がリセットします。CameraOS では常に 1 人以上の管理者が残ります。

Users page
歯車メニュー → ユーザー。
04

カメラを追加

ブランドを選び、カメラのアドレスとログイン情報を入力すると、CameraOS がストリーム URL を作成します。

3 min
  1. カメラ タブ → + カメラを追加(または歯車メニュー → + カメラを追加)。
  2. ブランド を選びます:Hikvision、Dahua、TVT、Reolink、Uniview、Axis、または その他 / URL。
  3. 名前(「荷捌き場」)を付け、カメラまたは録画機の IP アドレス、RTSP ポート(554)、ユーザー名、パスワード、チャンネル(録画機のカメラ番号) を入力します。
  4. ストリーム は メイン(HD) のまま、サブストリームで AI を実行(推奨) にチェックを入れた状態にします。グレーのボックスに表示される 2 つの URL を確認してください。
  5. 接続 を押します。カメラが一覧に表示され、ライブ映像で開きます。
Add camera dialog, TVT
ダイアログが両方の URL を作成します:表示用(HD のメインストリーム)と AI 用(軽量なサブストリーム)。パスワードは常にマスク表示されます。

各プリセットが作成する URL

ブランドメインストリーム(表示と録画)サブストリーム(AI)
Hikvision/Streaming/Channels/N01/Streaming/Channels/N02
Dahua/cam/realmonitor?channel=N&subtype=0…&subtype=1
TVT/profile1(チャンネルなし)/profile2
Reolink/h264Preview_0N_main/h264Preview_0N_sub
Uniview/unicast/cN/s0/live/unicast/cN/s1/live
Axis/axis-media/media.amp(チャンネルなし)なし:AI はメインストリームを使用します

各 URL は rtsp://user:password@ip:port<path> の形式で、N はチャンネル番号です。その他のカメラ:その他 / URL では、ストリーム URL(RTSP、RTMP、HLS、SRT) と、任意で AI ストリーム URL を入力します。

新しいカメラには、最初から 1 つのアプリ うろつき検知 が入っていて、すぐに録画を開始します。

A new camera live
数秒後の新しいカメラ:ライブ表示され、サブストリーム上で AI が毎秒 1.8 フレームで動作しています。
05

カメラを設定

録画、ストリームのアドレス、プライバシー、AI アシスタントに見せる内容:カメラの「設定」タブで設定します。

3 min

カメラを開く → 設定(管理者のみ)。左の列:カメラ診断、ゾーンとライン、フロアマップ、インストール済みアプリごとのパネル。右の列:

パネルできること
一時停止と録画カメラをオン をオフにすると、すべてが一時停止します(ライブ映像、AI、アラート、録画が止まります)。映像を録画 をオフにすると、ライブ映像、AI、アラートは動作し続けますが、映像は保存されません。
カメラ名前、ブランド、メインストリーム URL、AI ストリーム URL。URL を変更するとカメラが再接続されます。録画とイベントは保持されます。
プライバシーと共有顔ぼかし で顔ぼかしを適用したストリームを公開し、公開リンクを作成 でログイン不要のページを作成できます。AI アシスタント では、接続した AI アシスタントに見せる内容を設定します(第 14 章)。
カメラを削除ライブ映像、録画、アプリを停止します。過去のイベントは引き続き検索できます。
Camera settings
「設定」タブ。各スイッチはすぐに保存されます。

フロアマップ(任意)

フロアマップ → 床をマーク:地面上の長方形(タイル、駐車区画、部屋の角)に 4 つの角をドラッグして合わせます。任意でサイズ(メートル)も入力できます。これで、ライブタブで全員の位置が上から見た平面図上の点として表示されます。

ストレージと履歴

歯車メニュー → ストレージとクリーンアップ:保存されている映像の量とさかのぼれる期間、最も容量を使っているカメラ、履歴の保存期間を確認・設定できます:

保存対象初期設定選択肢
イベントと追跡データ30 日7 日〜無期限
スナップショット14 日3 日〜無期限
グラフ90 日30 日〜無期限

録画は 50 GB の容量枠内で最大 24 時間保存され(インストーラーの初期設定)、CameraOS はディスクの空き容量を常に 15 GB 以上確保します。最も容量を使っているカメラから順に削除し、ディスクが限界まで埋まると録画を一時停止します。容量枠を増やすには、CAMERAOS_MAX_RECORDINGS_GB=200 を設定してターミナルからインストーラーを実行します。

Storage and cleanup
歯車メニュー → ストレージとクリーンアップ。
06

アプリを追加

アプリは、カメラの検出結果を、ビジネスで知りたい数値に変えます。4 つのステップで追加できます。

3 min
  1. カメラのライブタブで + アプリを追加 を押します(または アプリ → アプリストア)。検索するか、グループで絞り込みます。カードにカーソルを合わせると、ライブデモが表示されます。
  2. インストール を押します。ステップ カメラ:カメラを選びます。そのアプリを実行できないカメラはグレー表示になり、理由が示されます。
  3. ステップ ゾーン:アプリに必要なものをライブ映像上に描きます(第 7 章)。ライン通過には ライン が必要で、「入場」とみなす方向に引きます。
  4. ステップ 設定:初期設定はほとんどのカメラに適しています。プライバシーへの配慮が求められるアプリでは、このカメラで顔ぼかしを有効にする がオンになっています。
  5. ステップ インストール:概要を確認して <camera> にインストール を押します。数秒で、アプリに合わせてカメラの AI が再起動します。
Install wizard, Zones step
荷捌き場 にライン通過をインストール:横断歩道を横切るようにラインを引いています。
The app running
数秒後:カメラのライブタブの上部に、アプリの数値(入場、退場、通過数、アラート)が並びます。

1 台のカメラで併用できるアプリ

1 台のカメラのアプリは、1 回の AI 解析を共有します。併用できない組み合わせはウィザードが拒否し、理由を表示します:

ルール例
工場ライン、荷物の配達、武器検知は独自の AI モデルを使用します他のアプリも顔ぼかしもない、専用のカメラが必要です。
顔ぼかしは、人しか検出しない姿勢推定モデルを使用します駐車場、ナンバープレート、交通量、置き去りは、顔ぼかしを使うカメラには追加できません。
介護・転倒検知、保育施設、行列も姿勢推定モデルを使用します車両を必要とするアプリは、これらを実行中のカメラには追加できません。
ゲート制御はナンバープレートと連携します先にナンバープレートをそのカメラにインストールしてください。
ライセンス外のアプリグレー表示で「ライセンス対象外」と表示されます。
Install wizard, Camera step
「カメラ」ステップ:各カメラに、そのアプリを追加できるかどうかと、できない理由が表示されます。
07

ゾーンとラインを描く

ゾーンは、アプリにどこを見るかを伝えます:行列、テーブル、立入禁止エリア、カウントするライン。

4 min
  1. カメラ → 設定 → ゾーンとライン → ゾーンを編集(またはインストールウィザードのステップ 2)。
  2. 描画 で描くものを選びます。例:+ ゾーン。
  3. 角を 1 つずつクリックします。最初の角をクリックするか、ダブルクリックまたは Enter キーで完了します(角が 3 つになると 図形を完成 が表示されます)。押したままドラッグして長方形を描くこともできます。ラインの場合は両端をクリックします。
  4. 一覧で名前を変更します:入力して Enter キーを押します。
  5. ゾーンを保存 を押します。数秒で、新しいゾーンを使ってカメラの AI が再起動します。
Drawing a zone
人数カウント用に、奥の歩道にエリアを角ごとに描いているところ。
操作方法
ゾーンを選択映像上でクリックするか、一覧の行をクリック
形を変える角をドラッグします。辺上の + をドラッグすると角を追加、角をダブルクリックすると削除します
移動 / サイズ変更ゾーンの内側をドラッグ / 四角いハンドルをドラッグ(Shift で比率を維持)
微調整矢印キー(Shift で大きく移動)
削除Delete または Backspace で、選択した角またはゾーンを削除
元に戻す / やり直す⌘Z / ⇧⌘Z(または ⌘Y)
描画をキャンセルEsc
Editing a line
ラインの編集:両端をドラッグし、名前を「北側横断歩道」に変更して保存。

ゾーンの種類

種類用途
行列エリア人が行列に並ぶ場所(行列)
テーブル各テーブル(レストラン・カフェ)
棚棚区画の前の床(店舗の通路)
駐車スペース各区画:路面に描かれた区画線に合わせて描きます
立入禁止ゾーン誰かが入るとアラート
カウントライン方向ごとの通過をカウント(2 点)
エリア人数をカウントする任意の範囲(人数カウント、混雑)
警戒ゾーン警戒時間中に誰かが入るとアラート(侵入検知)
玄関先荷物が置かれる場所(荷物の配達)

エディターには、カメラのアプリが使う種類が、各アプリでの名前で表示されます(ライン通過の場合は ライン)。ゾーンはカメラに属し、そのカメラのアプリで共有されます。アプリをアンインストールしてもゾーンは残ります。

08

カメラ診断を実行

このカメラ、正しく設定できていますか? 約 30 秒の診断で問題を調べ、変更すべき点を提案します。

2 min
  1. カメラ → 設定 → カメラ診断 → 診断を実行。
  2. カメラを 20 秒間観察し、メインストリームとサブストリームを測定してから、同じフレームでこのカメラの AI を、使える可能性のあるすべての設定で実行します(サブストリームかメインストリームか、画像サイズ 640/960/1280、AI に求める確信度)。その間もカメラは通常どおり動作します。
  3. 4 つの行を確認します:それぞれ「良好」「改善の余地あり」「要対応」のいずれかです。
  4. 設定の提案があれば、提案を適用 を押します。元に戻す を押すと、別の診断を実行した後でも以前の設定に戻せます。
Checkup running
「カメラを 20 秒間観察しています…」荷捌き場での実行には 24 秒かかりました。
項目確認する内容例(荷捌き場)
AI の精度現在の設定で AI が見つける量を、最も鮮明な設定、またはご自身の計数(第 9 章)と比較します最も鮮明な設定で見つかる数の 92%
映像とストリーム各ストリームの解像度、フレームレート、ビットレート、コーデック。破損フレーム、暗さ、逆光、ぼやけ、赤外線メイン 1280×720 · 24 fps · 1,520 kbit/s H.264、サブ 640×360
角度と大きさ人(または車両、物)が AI にどのくらいの高さで見えているか:40 px 未満になると見逃しが出始めます人の高さは 49 px。25% が 40 px 未満
AI 負荷この Mac で実行できる量のうち、このカメラが占める割合と、AI が処理に追いついているかこの Mac で使える 24 負荷のうち 5(1 フレーム 25 ms)
Checkup result
初回の実行:「現在の設定は、このカメラの映像でできる最善の状態です。」
Every setting tried
「試したすべての設定」を開くと、各設定の検出数、一致度、大きさ、時間、負荷を確認できます。

カメラ本体かはしごでしか直せない問題は、グレーの🔧 設置担当者へボックスに表示されます:サブストリームを 640×480 か 720p に上げる、ビットレートを上げるか H.265 を使う、ケーブルを確認するか Wi-Fi をやめる、照明や IR を追加する、WDR/BLC をオンにする、レンズを清掃してピントを合わせ直す、もっと高く・近くに設置する。

Suggestion applied
診断の 4 つの行:AI の精度、映像とストリーム、角度と大きさ、AI 負荷。今回は適用する提案はありませんでした。提案があるときは「提案を適用」を押し、考えが変わったら「元に戻す」を押します。
09

AI の精度をテスト

3 枚の静止画で人を自分で数えると、診断があなたの計数と比べて AI を採点します。無料で、データは Mac から出ません。

3 min
  1. 診断の後、👆 自分で数える を押します。
  2. 静止画に見えるすべての人をタップします。半分隠れている人や遠くの人も含めてください。点をもう一度タップすると削除されます。静止画 1 枚あたり約 20 秒です。
  3. 次の静止画 → で 2 枚目と 3 枚目に進み、自分の計数で確認 を押します。
  4. レポートが、あなたの計数を基準に採点し直されます。あなたの計数 では各静止画が表示され、見つかった人は緑、見逃された人は赤い丸で囲まれます。数え直す で最初からやり直せます。
Counting people on a still
3 枚中 2 枚目:1 人につき点を 1 つ。
Your count
荷捌き場での計数結果:3 枚の静止画で 29 人。AI は 25 人(86%)を見つけました。2 人はどの設定でも見つかりませんでした。他の人の陰に隠れていたか、遠すぎたためです。そのため、設置担当者向けのメモでは、カメラをもっと高く設置するよう伝えています。

AI を確認するその他の方法

ツール場所費用
AI に数えさせる診断 → 実行前に … にも 3 枚の静止画を数えて角度を評価してもらい にチェックを入れます:顔は先にぼかされますAI クレジット
AI が見ているものを確認歯車メニュー → 映像上の AI 表示:トラッカー(リング、タグ、軌跡)または ボックス無料
AI は処理に追いついているか歯車メニュー → パフォーマンス:設定した毎秒フレーム数に対して実際に解析したフレーム数、1 回の解析あたりの ms無料
品質検査 / 部屋の様子工場ラインと保育施設のカメラ:✦ 今すぐ検査 / ✦ 部屋の様子をまとめる1 回数セント
10

画面の見方

6 つのタブ、対応が必要なものを知らせるヘッダー、そしてビデオウォール。

3 min
タブ内容
ライブすべてのカメラを AI のオーバーレイと主要な数値付きで表示し、グループで絞り込めます。グリッドまたは ⛶ ウォール。ワイド画面では「質問」、要対応、最新のイベントも表示されます。
カメラすべて、ライブ、オフライン、一時停止中。行を選ぶとカメラが開きます:ライブ · 再生 · イベント · 設定。
アプリインストール済みのアプリ(対応が必要なものが先頭)、カメラ全体の合計、アプリストア。
アクティビティ要対応(未対応のアラートを時間順またはカメラ別に表示)と、すべてのイベント(時間、種類、カメラで検索)。
レポート今日、過去 7 日間、過去 30 日間を、その前の期間と比較(第 12 章)。
質問選んだカメラについて、ふだんの言葉で質問できます(第 13 章)。AI がオフの場合は非表示です。
Live tab
ライブ:カメラのグリッドとアラートレール。
Video wall
ビデオウォール(歯車メニュー → ビデオウォール、または ⛶ ウォール):1、2×2、3×3、4×4、1+5、1+7。ドラッグで入れ替え、ダブルクリックで拡大。

ヘッダー:オフラインのカメラがあるとカメラ台数が琥珀色になり、そのカメラへのリンクになります。ベルは未対応のアラートを示します。歯車には、カメラを追加、ユーザー、ストレージ、パフォーマンス、ライセンス、ビデオウォール、言語(English、繁體中文、日本語)、テーマ、映像上の AI 表示、アラート音、AI アシスタントがあります。スマートフォンでは、タブが画面下部のバーに移動し、歯車を押すと設定ページ全体が開きます。iPhone では、共有 → ホーム画面に追加 でアプリとしてインストールできます。

再生:カメラ → 再生:±10 秒、前後のイベントへの移動、1〜8 倍速、15 分〜24 時間のタイムライン、クリップ → MP4 をダウンロード(最大 30 分)。どこに表示されたイベントでも、5 秒前から録画が再生されます。

11

アラートに対応

アラートは誰かが確認するまで残り、スマートフォンにも送れます。

3 min

何をアラートにするかは各アプリが決めます:転倒、侵入、拒否されたナンバー、ラインの停止など。アラートはすべてのページにバナーとして音付きで表示され、許可されていればブラウザーの通知も届きます(新しいアラートが届いたら通知を受け取る)。

  1. バナーの 確認 を押すか、アクティビティ → 要対応 を開きます。
  2. 時間順 または カメラ別 でグループ化し、カメラごとに すべて確認 できます。繰り返しはまとめて表示されます(「… 以降 151 回」)。
  3. 対応時間が記録されます。アクティビティでは平均が、レポートでは標準的な対応時間が表示されます。

未対応のアラートは確認されるまで残り、確認済みのものは 24 時間表示されます。音はブラウザーごとにミュートできます:歯車メニュー → アラート音。

Activity by camera
アクティビティ → 要対応(カメラ別)。

アラートをスマートフォンに送る:アラート通知アプリ

  1. アラートを送りたい各カメラに アラート通知 をインストールします。
  2. 送信先:Telegram(@BotFather から取得した Telegram ボットトークン と Telegram チャット ID)または Webhook(JSON POST)(Webhook URL)。
  3. アラートのみ か アラートとその他のアプリイベント を選び、同種のイベントを再送するまでの間隔(300 秒)と、1 時間あたりの上限(20 件)を設定します。
  4. テストメッセージを送信 を押します:「送信しました。スマートフォンまたは送信先を確認してください。」
Alert notifier settings
アラート通知の設定。ボットトークンは Mac に保存され、マスク表示されます。
{ "camera": "Care Home · Room 12", "camera_id": 16, "event": "fall", "label": "Person down", "alert": true, "ts": 1794060470.7, "details": { ... }, "event_id": 1323380, "snapshot": "<URL of the snapshot>" }

Telegram のメッセージには、「🚨 ラベル · カメラ · 時刻」というキャプション付きでスナップショットが添付されます。人の出入りとライン通過は送信されません。

12

レポートを読む

各カメラが測定した内容を前の期間と並べて表示し、目立つ点を示します。AI は不要です。

3 min
  1. レポート → 今日、過去 7 日間(初期設定)、過去 30 日間 から選びます。それぞれ、直前の同じ長さの期間と比較します。グループのタブで、小売、ケアなどに絞り込めます。
  2. ハイライト:アラート(前の期間との比較を ▲▼ で表示)、確認された件数、標準的な対応時間、そして数値だけから作られる文章:4 分の 1 増えた・減ったアラート、各カメラで最も多い時間帯と最も少ない時間帯。
  3. アプリごと、カメラごとに:各数値の 平均、最大(とその日時)、変化、最も多い時間帯、そしてイベント数。緑の矢印は良い方向を示します。
  4. カメラの名前をクリックすると、そのカメラのレポートが開きます:数値の選択、時間帯別(平均)、日別(平均)、期間中のアラート(それぞれクリップを開けます)。
Reports, last 7 days
レポート、過去 7 日間、20 台のカメラ。
One camera's report
1 台のカメラのレポート:行列の時間帯別と日別。
13

AI の設定と質問

回答する AI を選び、カメラについてふだんの言葉で質問します。

3 min

AI を選ぶ

  1. 歯車メニュー → AI アシスタント(管理者)。
  2. サービスを選び、API キーを貼り付けて キーを確認してモデルを表示 を押します(トークンは消費しません)。モデルを選んで 保存 を押します。
選択肢備考
Claude (Anthropic)有料。「質問」で最も信頼できる回答が得られます。初期設定のモデルは claude-opus-5-5
ChatGPT (OpenAI)、Gemini (Google)有料。Gemini には 1 日の上限付きの無料枠があります
NVIDIA、OpenRouter無料の開発者キーと、レート制限付きの無料モデル
ローカルモデル(Ollama)Mac 上で動作:無料でプライベート、キー不要(初期設定のアドレスは http://127.0.0.1:11434/v1)
その他(OpenAI 互換)互換性のある任意のサービス:アドレスと、必要であればキー
オフ「質問」、検査、部屋の様子は非表示になり、どの AI にも何も送信されません

キーは Mac 上(~/CameraOS/data、所有者のみアクセス可)に保存され、ブラウザーに送り返されることはありません。保存済みのキーは末尾 4 文字だけが表示されます。

AI assistant settings
歯車メニュー → AI アシスタント。

質問

  1. 質問 タブ。グループ(または 何でも)を選び、質問の対象 でカメラを選びます:AI に渡されるのは、そのカメラのデータだけです。
  2. 質問を入力するか、質問例をタップして、質問 を押します。回答には数秒から 1 分ほどかかります。
  3. 回答内の事実にはイベントが引用されます:引用やスナップショットをタップすると、5 秒前からクリップが再生されます。
An answer with citations
「今日、アイスクリームの行列がいちばん長かったのはいつ?待ち時間は?」と質問しました。回答:行列は最大 7 人、推定待ち時間が最も長かったのは午前 9:14〜9:16 ごろで約 17 秒、1 人の最長の待ち時間は 55 秒。それぞれにクリップが付いていました。
14

AI アシスタントを接続(MCP)

Claude、Google Antigravity の Gemini、OpenAI Codex で、今お使いのプランのままカメラについて質問できます。

5 min

CameraOS には MCP サーバーが含まれています。MCP は、AI アシスタントがツールとつながるためのオープンな標準です。アシスタントのアプリが CameraOS の Mac 上でこのサーバーを起動し、直接やり取りします。ネットワークに対しては何も開かず、読み取り専用です。質問にはお使いのアシスタントが回答するため、CameraOS 側の費用はかかりません。

パスは省略せずに書いてください(<you> は Mac アカウントの名前に置き換えます。設定ファイルでは ~ が展開されません)。

Claude Desktop → Settings → Developer → Edit Config。claude_desktop_config.json に次の内容を追加して保存し、Claude を再起動します:

{ "mcpServers": { "cameraos": { "command": "/Users/<you>/CameraOS/python/venv/bin/python", "args": [ "/Users/<you>/CameraOS/app/vision/cameraos/mcp_server.py" ] } } }

アシスタントにできること

ツールアシスタントに渡す情報
get_live_counts共有されているすべてのカメラの現在の状態:オンラインかどうか、映っているもの、各アプリのライブの数値
look_at_cameraカメラの AI が最後に解析したフレームを画像として渡します(許可されていない限り、顔はぼかされます)
recent_events今起きたこと。新しい順に、カメラと種類ごと
query_database共有カメラの履歴に対する読み取り専用の SQL クエリ 1 回(最大 200 行)。ストリームのログイン情報、共有トークン、アプリのシークレットは含みません
search_footage映像検索を実行しているカメラで、説明から人や車両を探します

カメラごとに共有する内容を選ぶ

カメラ → 設定 → プライバシーと共有 → AI アシスタント:

設定アシスタントが受け取るもの
数値と顔ぼかし済みの画像(初期設定)人数、イベント、履歴と、すべての顔をぼかした画像。顔をぼかせない場合、その画像は送信されず拒否されます。
数値とそのままの画像同じ内容を、ぼかしのない画像で
共有しないそのカメラはすべてのツールから非表示になります
AI assistants setting
プライバシーと共有 → AI アシスタント。

試してみる

今週、アイスクリームの窓口にもう 1 人入れるならいつ?
CameraOS · リアルタイムの数値CameraOS · 7 日間の行列データ
行列が一番長くなるのは午後 5 時ごろ(平均 6 人、最大 9 人)と、午前 11 時ごろです。過去 7 日間で 3,341 人に対応し、待ち時間は 12 秒前後で推移しました。混雑する日は、11 時から正午までと、午後 5 時から 7 時までにもう 1 人追加しましょう。
カフェは? 空いているテーブルある?
CameraOS · カフェを見る
3 つのテーブルのうち 2 つが空いています。窓際のテーブルに 2 人のお客様がいて、ちょうど誰かが入ってきたところです。アシスタントが受け取ったカフェのカメラ映像。顔はぼかされています

実際の会話(日本語訳):Claude が CameraOS のツールでデモ用カメラを参照、2026 年 11 月 4 日。

15

リファレンスとトラブルシューティング

ファイルの保存場所と、問題が起きたときに確認すること。

3 min

ファイルの保存場所(インストール版)

フォルダ内容
~/CameraOS/appプログラム本体(アップデートのたびに置き換えられます)
~/CameraOS/dataアカウント、カメラ、イベント、設定、AI キー、ライセンス、診断結果(アップデート後も保持)
~/CameraOS/recordings録画映像。カメラごとに 10 分単位のセグメント(アップデート後も保持)
~/CameraOS/logsgateway.log、vision.log、web.log:問題が起きたときは、これらを CameraOS に送ってください

アップデート:新しいバージョンの Install CameraOS.command を実行します。カメラ、アカウント、録画、ライセンスはそのまま残ります。削除:Uninstall CameraOS.command は、録画と設定を削除する前に確認を求めます。

うまくいかないときは

症状診断
カメラがオフラインその行にエラーが表示されます。設定 → カメラを開き、URL かパスワードを修正してください。Mac から VLC でその URL を開いてみてください。カメラの RTSP がオンになっていて、ポート(554)に到達できるか確認してください。
カメラはライブなのに映像が黒いHEVC の WebRTC に対応していないブラウザー(一部の Android、古いブラウザー)で H.265 のメインストリームを表示しています:Mac の Chrome か Safari を使うか、カメラのメインストリームを H.264 に設定してください。
AI が人を見逃すカメラ診断 を実行します。人が小さい(40 px 未満)→ もっと近く・高く設置するか、提案された画像サイズを適用します。サブストリームの解像度が低い → 640×480 か 720p に上げます。
AI の毎秒フレーム数が設定値を下回るMac の負荷が高い状態です:歯車 → パフォーマンス。サブストリームを使う、動きの少ないカメラのレートを下げる、またはカメラを 2 台の Mac に分けてください。
ゾーンの内側をクリックしても角が追加されない既存のゾーンの上から描き始めています:新しい図形は、何もない映像の上から描き始めてください。
録画が一時停止したディスクの空き容量がほとんどありません:歯車 → ストレージとクリーンアップ。保存期間を短くするか、ディスクを追加してください。
どのページにも「このコンピューターを有効化」が表示されるライセンスがないか、別の Mac 用か、期限切れです:正しいキーを貼り付けてください。歯車 → ライセンスで、このコンピューターの ID を確認できます。
「質問」が表示されないAI が設定されていません:歯車 → AI アシスタント。
AI アシスタントが、ライセンスがない、または CameraOS に接続できないと言うCameraOS が同じ Mac 上で起動していて、ライセンスが有効である必要があります。CameraOS の起動後に、アシスタントを再起動してください。

各数値の信頼性

  • 待ち時間は、行列から出ていく人をもとにした推定値です。
  • ナンバープレートは、プレートの幅が約 60 px 以上必要です(確実に読むには 100 px)。2 回の読み取り結果が一致するとナンバーが表示されます。
  • 転倒は、意図的に横になった人で誤報が出ることがあります。そのため、エスカレーションと「確認」があります。
  • 顔ぼかしは、横を向いた顔、小さい顔、隠れた顔を見逃すことがあります:抑止策であり、匿名化ではありません。
  • 交通量のカウントは、速く流れる交通では少なめに出ます。交通量は傾向として扱ってください。渋滞の判定は信頼できます。
  • 追跡数は、実際の人数より多くなります:2 台のカメラに映った 1 人や、一時的に見失った 1 人は、2 件の追跡として数えられます。

お手伝いが必要ですか?

ライセンスにはコンピューターの ID を、問題が起きたときは ~/CameraOS/logs のログを送ってください。初回のインストールは一緒に進めます。

デモを予約