01

場地規劃

到場前需要準備什麼,以及 CameraOS 在網路中的位置。

5 min

需要準備

最低需求備註
電腦搭載 Apple silicon(M1 或更新)的 Mac,macOS 13 以上2020 年以後的 Mac mini 都符合。它放在現場,就在錄影主機旁。
記憶體與磁碟建議 16 GB 記憶體,20 GB 可用磁碟空間另需錄影空間:安裝程式預設最多保留 50 GB。
攝影機任何以 RTSP 串流的攝影機或 NVR(多數 IP 攝影機、ONVIF)RTMP、HLS 與 SRT 串流也可以。您需要每台攝影機的 IP 位址、登入帳密與通道。
網路Mac 與攝影機在同一個網路最好使用有線乙太網路。安裝期間,以及使用選用的 AI 功能時,需要連上網際網路。
授權每台電腦一組授權金鑰安裝後傳送電腦的 ID;我們回傳的金鑰只能用於那台 Mac。

整體架構

攝影機 / NVR區域網路上的 RTSP
→
CameraOS Mac閘道每台攝影機只拉流一次並錄影 · AI 在 Apple GPU 上執行 · 網頁應用程式
→
瀏覽器與手機http://<mac>:4400

每台攝影機只由 Mac 上的閘道拉流一次。錄影、AI 與每位觀看者都從這一條連線讀取,所以攝影機與 NVR 永遠只會看到一個用戶端。影片、事件與設定都留在 Mac 上。

連接埠使用對象開放範圍
4400 TCP網頁應用程式:所有瀏覽器與手機區域網路
8189 UDP傳到瀏覽器與手機的即時影像(WebRTC 媒體)區域網路
8554, 8000, 8889, 9996, 9997閘道 RTSP、AI 服務、WebRTC、錄影回放、閘道 API僅限這台 Mac(127.0.0.1)

每台 Mac 可接幾台攝影機

一個「負載」等於在輕量的 640×360 子碼流上每秒執行一次 AI 分析。應用程式分為輕量、標準與重度:

Mac輕量 App標準 App重度 App
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 傳給我們(16 個字元,例如 XXXX-XXXX-XXXX-XXXX)。每個授權只能用於一台電腦。
  3. 把收到的金鑰(以 CAMOS1. 開頭)貼到 2. 貼上您收到的授權金鑰下方,再按啟用。

之後,齒輪選單 → 授權會顯示授權對象、到期日、包含的應用程式與這台電腦的 ID,也可在此輸入新金鑰(增加應用程式或延長期限)。

Activate this computer
啟用頁面。為其他 Mac 產生的金鑰會被拒絕:「此授權屬於另一台電腦。」

建立管理員帳號

  1. 啟用後會進入建立管理員帳號。
  2. 輸入安裝視窗中的 6 位數設定碼(也存放在 ~/CameraOS/data/setup_code.txt)、名稱,以及至少 8 個字元的密碼(輸入兩次)。
  3. 按建立帳號。您會自動登入並進入「即時」頁面。帳號建立後,設定碼即失效。
Create the admin account
首次執行:設定碼證明您人就在 CameraOS Mac 旁。
03

新增人員與角色

讓每位員工有自己的登入帳號,只給需要的權限。

3 min
角色可以做什麼
管理員所有權限:攝影機、應用程式、區域、分享、使用者、授權、AI 設定。可看到完整的串流位址。
員工觀看即時影像與錄影回放、處理警報、搜尋事件、使用報告與提問。無法變更任何設定。串流密碼會隱藏。
檢視者只能觀看即時影像與錄影回放。無法使用警報、事件、報告或提問。
  1. 齒輪選單 → 使用者。
  2. 在新增成員下方輸入名稱、密碼(8 個字元以上),並選擇角色(預設為員工)。按新增帳號,再把名稱與密碼交給對方;對方可在帳號與密碼中自行變更。
  3. 多人共用的螢幕(大廳電視、示範用),請勾選共用登入:大家都能登入觀看,但只有管理員能變更密碼。管理員帳號不能設為共用。

從下拉選單變更角色會立即生效。重設密碼會讓該使用者在所有裝置上登出。忘記密碼時,由管理員重設。CameraOS 一定會保留至少一位管理員。

Users page
齒輪選單 → 使用者。
04

新增攝影機

選擇品牌,輸入攝影機的位址與登入帳密,CameraOS 就會產生串流網址。

3 min
  1. 攝影機分頁 → + 新增攝影機(或齒輪選單 → + 新增攝影機)。
  2. 選擇品牌:Hikvision、Dahua、TVT、Reolink、Uniview、Axis,或其他 / 網址。
  3. 輸入名稱(「卸貨區」),接著填寫攝影機或 NVR 的 IP 位址、RTSP 連接埠(554)、使用者名稱、密碼與通道(NVR 攝影機編號)。
  4. 串流維持主碼流(高畫質),並勾選在子碼流上執行 AI(建議)。檢查灰色框中的兩個網址。
  5. 按連線。攝影機會出現在清單中,並開啟即時影像。
Add camera dialog, TVT
對話框會產生兩個網址:觀看用(高畫質主碼流)與 AI 用(輕量子碼流)。密碼一律遮蔽。

各品牌預設產生的網址

品牌主碼流(觀看與錄影)子碼流(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 使用主碼流

每個網址的格式為 rtsp://user:password@ip:port<path>,N 為通道。其他攝影機:其他 / 網址可輸入串流網址(RTSP、RTMP、HLS、SRT),以及選填的 AI 串流網址。

新攝影機預設會安裝一個應用程式:徘徊偵測,並立即開始錄影。

A new camera live
幾秒後的新攝影機:即時影像已上線,AI 在子碼流上以每秒 3.3 張執行。
05

設定攝影機

錄影、串流位址、隱私,以及 AI 助理能看到什麼:都在攝影機的「設定」分頁。

3 min

開啟攝影機 → 設定(僅限管理員)。左欄:攝影機健檢、區域與計數線、平面圖,以及每個已安裝應用程式各一個面板。右欄:

面板能做什麼
暫停與錄影關閉攝影機開啟會暫停一切(沒有即時影像、AI、警報或錄影)。關閉錄影則保留即時影像、AI 與警報,但不儲存影片。
攝影機名稱、品牌、主碼流網址與 AI 串流網址。變更網址會重新連線攝影機;錄影與事件都會保留。
隱私與分享臉部模糊會發布臉部模糊處理的串流;之後可用建立公開連結產生免登入的頁面。AI 助理設定已連接的 AI 助理能看到什麼(第 14 章)。
移除攝影機將停止即時影像、錄影及其應用程式。過去的事件仍可搜尋。
Camera settings
「設定」分頁。每個開關都會立即儲存。

平面圖(選用)

平面圖 → 標記地面:把四個角拖到地面上的一個矩形(磁磚、停車格、房間的四個角),也可以填入它的尺寸(公尺)。之後「即時」分頁會在俯視平面圖上以圓點顯示每個人。

儲存空間與歷史資料

齒輪選單 → 儲存空間與清理:顯示已儲存多少影片、可回溯多久、佔用最多空間的攝影機,以及歷史資料要保留多久:

保留項目預設選項
事件與追蹤紀錄30 天7 天到永久
快照14 天3 天到永久
圖表90 天30 天到永久

錄影會在 50 GB 的預算內(安裝程式預設值)最多保留 24 小時,且 CameraOS 一定會保留至少 15 GB 的可用空間:它會先修剪佔用最多空間的攝影機,磁碟嚴重不足時則暫停錄影。若要更大的預算:在終端機中設定 CAMERAOS_MAX_RECORDINGS_GB=200 後執行安裝程式。

Storage and cleanup
齒輪選單 → 儲存空間與清理。
06

新增應用程式

應用程式把攝影機的偵測結果轉成營運上想知道的數字。共四個步驟。

3 min
  1. 在攝影機的「即時」分頁按+ 新增應用程式(或應用程式 → 應用程式商店)。可搜尋或依群組篩選;滑鼠移到卡片上可查看即時示範。
  2. 按安裝。攝影機步驟:選擇攝影機。無法執行此應用程式的攝影機會顯示為灰色,並附上原因。
  3. 區域步驟:在即時影像上畫出應用程式所需的範圍(第 7 章)。越線偵測需要一條警戒線,請依「進」的方向畫線。
  4. 設定步驟:預設值適用於大多數攝影機。在重視隱私的場所使用的應用程式,此攝影機啟用臉部模糊預設為開啟。
  5. 安裝步驟:確認摘要後按安裝到 <camera>。攝影機的 AI 會在幾秒內帶著此應用程式重新啟動。
Install wizard, Zones step
在卸貨區上安裝越線偵測:警戒線橫跨斑馬線。
The app running
幾秒後:攝影機的「即時」分頁,上方顯示應用程式的數字(進、出、通過次數、警報)。

哪些應用程式可以共用一台攝影機

同一台攝影機上的應用程式共用同一次 AI 分析。精靈會拒絕無法共用的組合,並說明原因:

規則範例
工廠產線、包裹送達與武器偵測使用各自專屬的 AI 模型它們需要獨佔一台攝影機,不能有其他應用程式,也不能啟用臉部模糊。
臉部模糊使用姿態模型,只能看到人停車場、車牌辨識、車流量與遺留物品無法加入啟用臉部模糊的攝影機。
照護、托育中心與排隊等候也使用姿態模型需要偵測車輛的應用程式,無法加入執行這些應用程式的攝影機。
柵欄控制器需搭配車牌辨識請先在攝影機上安裝車牌辨識。
不在授權範圍內的應用程式顯示為灰色:「不在您的授權內」。
Install wizard, Camera step
攝影機步驟:每台攝影機都會說明能否安裝此應用程式,以及不能的原因。
07

繪製區域與線

區域告訴應用程式要看哪裡:排隊處、桌位、禁入範圍、要計數的線。

4 min
  1. 攝影機 → 設定 → 區域與計數線 → 編輯區域(或安裝精靈的第 2 步)。
  2. 在繪製下方選擇要畫的類型,例如+ 區域。
  3. 逐一點選各個角。點回第一個角、按兩下或按 Enter 即可完成(點出三個角後會出現完成形狀)。也可以按住拖曳畫出矩形。畫線:點選兩個端點。
  4. 在清單中重新命名:輸入名稱後按 Enter。
  5. 按儲存區域。攝影機的 AI 會在幾秒內以新區域重新啟動。
Drawing a zone
為人數統計在對面人行道上逐角畫出一個區域。
要操作方式
選取區域在影像上點選它,或點選清單中的對應列
調整形狀拖曳角點。拖曳邊上的 + 可新增角點;按兩下角點可將其移除
移動 / 縮放在區域內拖曳 / 拖曳方形控點(按住 Shift 保持比例)
微調方向鍵(按住 Shift 移動較大距離)
刪除按 Delete 或 Backspace 移除選取的角點或區域
復原 / 重做⌘Z / ⇧⌘Z(或 ⌘Y)
取消繪製Esc
Editing a line
編輯警戒線:拖曳兩個端點、重新命名為「北側斑馬線」,然後儲存。

區域類型

類型用途
排隊區排隊的位置(排隊等候)
桌位每張桌子(餐廳與咖啡廳)
貨架貨架區段前方的地面(賣場走道)
停車格每個車位:畫在地面標線的車位上
禁入區域有人進入時發出警報
計數線計算雙向通過次數(兩個點)
區域任何要計算人數的範圍(人數統計、人潮)
防護區域在警戒時段有人進入時發出警報(入侵偵測)
門廊包裹放置的位置(包裹送達)

編輯器只提供這台攝影機上的應用程式會用到的類型,並沿用應用程式自己的名稱(越線偵測把它的線稱為警戒線)。區域屬於攝影機,由其上的應用程式共用;解除安裝應用程式後區域仍會保留。

08

執行攝影機健檢

這台攝影機設定得對嗎?健檢約 30 秒就能完成診斷,並建議要修改什麼。

2 min
  1. 攝影機 → 設定 → 攝影機健檢 → 執行健檢。
  2. 它會觀察攝影機 20 秒,實測主碼流與子碼流,接著用這台攝影機的 AI 在同樣的畫面上試遍所有可用的設定(子碼流或主碼流、畫面大小 640/960/1280、AI 需要多有把握)。期間攝影機照常運作。
  3. 查看四列結果:每列會顯示良好、可以更好或需要修正。
  4. 如果有建議設定,按套用建議。復原可恢復舊設定,即使之後又跑過一次健檢也可以。
Checkup running
「觀察攝影機 20 秒…」我們在卸貨區上的這次健檢花了 27 秒。
項目檢查內容範例(卸貨區)
AI 準確度AI 在目前設定下找到多少,與最清晰的設定相比,或與您自己的計數相比(第 9 章)最清晰設定所找到數量的 91%
畫面與串流每路串流的解析度、影格率、位元率與編碼;損壞的畫面、過暗、逆光、模糊、紅外線主碼流 1280×720 · 24 fps · 1,406 kbit/s H.264;子碼流 640×360
角度與大小人(或車輛、物品)在 AI 眼中有多高:低於 40 px 就開始漏抓人看起來有 47 px 高;26% 低於 40 px
AI 負載這台攝影機佔這台 Mac 可執行量的比例,以及 AI 是否跟得上這台 Mac 可用的 15.4 個負載中佔 5 個(每張 69 ms)
Checkup result
第一次執行:「目前的設定已經是這台攝影機畫面所能達到的最佳狀態。」
Every setting tried
開啟「測試過的所有設定」,可查看每種設定的數量、一致度、大小、時間與負載。

只有調整攝影機本身或爬梯子才能解決的問題,會出現在灰色的🔧 給安裝人員框中:把子碼流提高到 640×480 或 720p、提高位元率或改用 H.265、檢查線材或改用有線連接取代 Wi-Fi、增加照明或 IR、開啟 WDR/BLC、清潔並重新對焦、裝得更高或更近。

Suggestion applied
健檢的四列結果:AI 準確度、畫面與串流、角度與大小、AI 負載。這次沒有可套用的建議;有建議時按「套用建議」,改變主意時再按「復原」。
09

測試 AI 準確度

在三張靜止畫面上自己數人,健檢就會以您的計數為基準替 AI 評分。免費,而且資料不會離開 Mac。

3 min
  1. 健檢完成後,按👆 自己數。
  2. 點選靜止畫面上每一個看得到的人,包括被半遮住和遠處的人。再點一次圓點即可移除。每張約需 20 秒。
  3. 按下一張 →進入第二、第三張,再按用我的計數檢查。
  4. 報告會以您的計數重新評分。你的計數會顯示每張畫面:找到的人標成綠色,漏掉的人用紅圈圈出。重新計數可從頭開始。
Counting people on a still
第 2 張,共 3 張:每人一個圓點。
Your count
我們在卸貨區上的計數:3 張畫面共 28 人。AI 找到 24 人(86%)。有 2 個人在任何設定下都沒被找到:被別人擋住或距離太遠,所以給安裝人員的提示建議把攝影機裝高一點。

檢查 AI 的其他方式

工具位置費用
讓 AI 計數健檢 → 執行前勾選同時讓 … 計算 3 張畫面中的數量並評估角度:會先模糊臉部AI 額度
查看 AI 看到什麼齒輪選單 → 影像上的 AI 標示:追蹤(圓圈、標籤、軌跡)或方框免費
AI 跟得上嗎?齒輪選單 → 效能:實際分析與要求的每秒張數、每次分析的毫秒數免費
品質檢查 / 房間摘要工廠產線與托育中心攝影機:✦ 立即檢查 / ✦ 摘要房間狀況每次幾美分
10

介面導覽

六個分頁、一個告訴您哪裡需要處理的頁首,還有電視牆。

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 上,分享 → 加入主畫面即可把它安裝成 App。

錄影回放:攝影機 → 錄影回放:±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 秒),以及每小時上限(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. 重點:警報(▲▼ 與前一期比較)、已確認的數量、一般回應時間,以及單純依數字寫出的說明:增加或減少四分之一的警報、每台攝影機最忙與最閒的時段。
  3. 依應用程式、依攝影機:每個數字的平均、最高(及發生時間)、變化與最忙時段;事件數量。綠色箭頭代表往好的方向。
  4. 點選攝影機名稱可查看它自己的報告:數字選擇器、一天中各時段(平均)、每日變化(平均),以及該期間的警報,每則都能開啟片段。
Reports, last 7 days
報告,過去 7 天,涵蓋 20 台攝影機。
One camera's report
單一攝影機的報告:排隊人數的各時段與每日變化。
13

設定 AI 並提問

選擇負責回答的 AI,再用白話詢問攝影機的狀況。

3 min

選擇 AI

  1. 齒輪選單 → AI 助理(管理員)。
  2. 選擇服務、貼上它的 API 金鑰,然後按檢查金鑰並列出模型(不會消耗 token)。選擇模型後按儲存。
選項備註
Claude (Anthropic)付費。提問的答案最可靠。預設模型 claude-opus-5-5
ChatGPT (OpenAI)、Gemini (Google)付費;Gemini 有每日限額的免費方案
NVIDIA、OpenRouter免費開發者金鑰與免費模型,有速率限制
本機模型(Ollama)在 Mac 上執行:免費且私密,不需金鑰(預設位址 http://127.0.0.1:11434/v1)
其他(相容 OpenAI)任何相容的服務:一個位址,需要時再加上金鑰
關閉隱藏提問、品質檢查與房間摘要;不會傳送任何資料給 AI

金鑰保存在 Mac 上(~/CameraOS/data,僅擁有者可讀取),永遠不會傳回瀏覽器;已儲存的金鑰只顯示最後 4 個字元。

AI assistant settings
齒輪選單 → AI 助理。

提問

  1. 提問分頁。選擇群組(或任何問題),並在詢問範圍下方選擇攝影機:AI 只會取得這些攝影機的資料。
  2. 輸入問題,或點選建議問題,然後按提問。回答需要幾秒到約一分鐘。
  3. 答案中的事實會引用事件:點選引用或快照,即可從事發前 5 秒開始觀看片段。
An answer with citations
我們問:「今天冰淇淋店的隊伍什麼時候最長?等了多久?」它回答:隊伍最長 7 人,預估等候在上午 9:14–9:15 最長,約 17 秒,單次最長等候 55 秒,每項都附上片段。
14

連接您的 AI 助理(MCP)

在 Claude、Google Antigravity 中的 Gemini 或 OpenAI Codex 裡詢問攝影機的狀況,使用您現有的方案。

5 min

CameraOS 內建 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 查詢(最多 200 列);不含串流登入資訊、分享權杖或應用程式密鑰
search_footage依描述尋找人與車輛,適用於執行影片搜尋的攝影機

選擇每台攝影機分享的內容

攝影機 → 設定 → 隱私與分享 → AI 助理:

設定助理取得的內容
數據與臉部模糊的畫面(預設)計數、事件與歷史資料;畫面中的每張臉都會模糊處理。如果臉部無法模糊,就拒絕提供該畫面,而不是照樣傳送。
數據與完整畫面內容相同,但畫面不做模糊處理
不分享所有工具都看不到這台攝影機
AI assistants setting
隱私與分享 → AI 助理。

試試看

這週冰淇淋窗口什麼時候該多派一個人?
CameraOS · 即時數字CameraOS · 7 天的排隊資料
您的隊伍在下午 5 點左右最長(平均 6 人,最多 9 人),上午 11 點又有一波。過去 7 天您服務了 3,341 人,等候時間維持在 12 秒左右。忙碌的日子,建議在 11 點到中午、下午 5 點到 7 點多排一個人。
那咖啡廳呢?有空桌嗎?
CameraOS · 查看咖啡廳
三張桌子中有兩張空著。靠窗那桌有兩位客人,還有一個人正要進門。The café camera as the assistant received it, faces blurred

真實對話: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 會在刪除錄影與設定前先詢問。

如果出了問題

您看到檢查
攝影機顯示離線查看它那一列的錯誤訊息。開啟「設定」→「攝影機」修正網址或密碼;在 Mac 上用 VLC 試開該網址。確認攝影機已開啟 RTSP,且連接埠(554)可以連通。
即時影像全黑,但攝影機顯示為即時在不支援 HEVC WebRTC 的瀏覽器(部分 Android 裝置、較舊的瀏覽器)中播放 H.265 主碼流:請在 Mac 上使用 Chrome 或 Safari,或把攝影機的主碼流設為 H.264。
AI 漏抓人執行攝影機健檢。人太小(低於 40 px)→ 裝得更近或更高,或套用建議的畫面大小。子碼流解析度太低 → 提高到 640×480 或 720p。
AI 每秒張數低於設定值Mac 太忙:齒輪 → 效能。改用子碼流、降低較閒攝影機的速率,或把攝影機分配到兩台 Mac。
在區域內點一下不會新增角點您是從既有區域上開始畫的:請在空白的影像上開始畫新形狀。
錄影已暫停磁碟快滿了:齒輪 → 儲存空間與清理;縮短保留期間或增加磁碟。
每個頁面都顯示「啟用這台電腦」沒有授權,或授權屬於另一台 Mac,或已到期:請貼上正確的金鑰;齒輪 → 授權會顯示這台電腦的 ID。
找不到提問尚未設定 AI:齒輪 → AI 助理。
AI 助理說沒有授權,或連不到 CameraOSCameraOS 必須在同一台 Mac 上執行且已授權;CameraOS 啟動後再重新啟動助理。

各項數字的可信程度

  • 等候時間是根據看到有人走出隊伍所做的估計。
  • 車牌寬度至少需要約 60 px(100 px 才可靠);兩次辨識結果一致後才會顯示車牌。
  • 跌倒可能因有人刻意躺下而誤報;所以才有升級通報與確認機制。
  • 臉部模糊可能漏掉轉開、太小或被遮住的臉:它是一種嚇阻,不是匿名化。
  • 車流計數在車速快、車流順暢時會低估;請把車流量視為趨勢。壅塞判斷則很可靠。
  • 追蹤計數會高估不重複的人數:同一個人出現在兩台攝影機上,或短暫跟丟,就會算成兩條軌跡。

需要協助嗎?

請把電腦的 ID 傳給我們以取得授權;出問題時,請傳送 ~/CameraOS/logs 中的日誌。第一次安裝我們會陪您一起完成。

預約導覽