寫程式一定照這個順序：先匯入函式庫、選好相機模式，再建立物件、幫相機取名字，最後用這個名字去呼叫功能。左邊一步一步做，右邊的程式會跟著長出來；在模擬的相機畫面裡拖色塊、色紙、積木或線，就能看到程式會印出什麼。
EV3 已上機驗證2026-11-03 用出貨版韌體 v1.0-261101 在實機跑過：原廠 EV3 韌體（EV3-G 紅外線積木、13 個相機模式逐格讀）、Pybricks v4 範例 1～4；ev3dev／EV3 MicroPython v2 只核對模式表（跟原廠紅外線感應器相同）。EV3 版不能從主機下命令，相機模式在相機 MENU 切。
程式的第一件事是告訴主機「我要用神攝手的函式庫」。沒有這行，後面寫的 UniCam 主機看不懂，會出現 NameError。
main.py 同一層。Pybricks（code.pybricks.com）：按「Import a file」匯入同一個專案。一台車可能接好幾個感應器，所以要「建立一個物件」：告訴程式相機接在哪個孔、是哪個模式，並幫它取個名字。之後每次讀值都叫這個名字。
模式編號要不要寫在程式裡？
mode= 後面的數字是第 1 步選的模式編號；相機選單也要切到同一個模式（不一樣時函式庫會照你寫的模式解讀，數字會亂掉）。
寫法都是「cam.功能名稱()」：名字＋小數點＋功能。功能依相機模式分組，虛線框的功能是別的模式用的，要換模式才能用（點下去會幫你換）。點一個功能，程式和輸出會換成它的範例。
模擬畫面是示意：數值直接用畫面上的位置換算（X 0～159 左→右、Y 0～119 上→下、面積 %＝寬×高÷整個畫面），色相碼是那張色紙／積木本來的顏色（紅 0、黃 40、綠 80、藍 160、紫 200、白桌面 244、黑膠帶 252），不是相機裡面的算法；實際數值會因光線差一些。顏色追蹤假設相機上已經教了 4 色：色 1 紅、色 2 綠、色 3 藍、色 4 黃。物體偵測的形狀是你直接選的（不是相機判斷的），物體 1、2…照面積由大到小排，X、Y 是形狀的質心（白點）、虛線框是外框，角度就是你轉的角度。
每個功能都有一段可以直接放進迴圈的範例，右上角標它能用的模式。按「試試看」會切到第 3 步（需要的話也幫你換模式）。
按「複製」拿到完整程式。更多範例（多色、取色、照順序、循線停路口）在 EV3 範例頁。
!先在相機上教「目標 1」的顏色，相機選單切到模式 13。色塊在左邊車子卻往右轉：把 KP 改成負數。
!相機斜看前方地面。偏移在左＝負，所以「線在左 → 往左轉」用 turn = KP * e。看不到線時照最後離線方向原地轉找線。
None。EV3 函式庫讀不到時回傳 None（不是上一次的值），電腦畫面印一行「MBC: 讀不到感應器」。拿 None 去比大小會出 TypeError，所以重要的程式先寫 if v is None:。在右邊勾「拔掉感應器」看看。mode= 就照你寫的解讀；不寫就讀紅外線模式 0 自動取得。用了這個模式沒有的功能會出現 ValueError（訊息會寫要用哪個模式）。total() 才知道前幾格有效。grid() 讀原始格子（EV3 原始 Y 是下＝小）。循線偏移：線在左＝負、在右＝正（站在車後面往前看）。edges()、far_width()、marker()、line_all() 和照順序給色號要多讀模式 2。同一個迴圈不要一直在兩組之間換。EV3 沒有 lost()、cell()、colors_found()、firmware_version()；count() 只有模式 14。