神攝手 ESP32CAM × EV3 × EV3-G 官方軟體
這一頁只講 EV3-G 官方軟體(EV3 Lab):在 MINDSTORMS EV3 上用它讀神攝手 ESP32CAM的安裝步驟、每個值怎麼讀、能用的命令與範例。要換產品、主機或軟體,用上方的切換列。
安裝與設定
你需要
- 感應器:神攝手 ESP32CAM(EV3 版,RJ12 接頭)。SPIKE 版插在 EV3 上不會被認出來。
- 主機:LEGO MINDSTORMS EV3。
- 連接線:產品內附的標準連接線,或樂高原廠 EV3 線。
- 軟體:LEGO MINDSTORMS EV3 官方軟體(LabVIEW 風格介面,常稱為 EV3-G)。學校電腦教室、WRO 隊伍最常用。
安裝軟體
- 到 LEGO Education 下載頁 安裝 EV3 官方軟體(EV3 Lab)。
- 打開範例:下載
.ev3檔 → 「檔案 → 開啟專案」→ 接上 EV3 → 右下角「下載並執行」。
讓軟體認得感應器
不用裝擴充、不用裝驅動程式。感應器在 EV3 上會模擬成樂高原廠感應器(多數產品顯示成「紅外線感應器」),直接用內建的感應器積木,選對模式就能讀。
- 紅外線感應器有 Proximity(接近)、Beacon(信標)、Remote(遙控) 三種模式,產品把不同資料放在不同模式,看下面的讀值。
- 有些產品附 MBC 自訂積木(My Blocks),已經放在範例專案裡,打開範例就能用。
重要
不要在程式中途切換模式。 EV3 主機每次切換感應器模式(例如從 Proximity 換到 Remote),會卡住約 1 秒,高速比賽中可能讓車子失控。程式一開始選定一種模式,整趟任務都用它。
接線
- 用連接線把感應器插在 EV3 的 1 號孔(1~4 任一孔都可以,積木裡選同一個孔)。
- EV3 先開機,再插感應器。
- 接頭卡榫朝上,輕輕推進去,不要用力硬插。
先在感應器上設定顏色
神攝手的設定都在感應器背面的彩色螢幕與按鍵上完成,不用電腦:
- 感應器要接上已經開機的主機才會啟動(螢幕先顯示「LEGO Sync...」),出現鏡頭畫面就可以使用。
- 短按側鍵進入設定選單,用左/右鍵選擇、確認鍵進入;在選單中長按側鍵 1 秒清除該組顏色。
- 設定好的顏色與鏡頭參數(亮度、對比、飽和度、曝光、白平衡、翻轉、鏡像)會自動保存,下次開機直接使用。
兩種 EV3 韌體
| 韌體 | EV3 上顯示成 | 能用的軟體 |
|---|---|---|
| 學校老師創意賽版(取色+色塊追蹤+動態偵測) | 紅外線感應器 | EV3-G、EV3 Classroom、Pybricks、clev3r |
| WRO 2026 版(HUE12,12 個色點) | 第三方感應器(type 95) | EV3-G(MBC 自訂積木)、clev3r、Pybricks;EV3 Classroom 讀不到 |
WRO 版(HUE12):先匯入 MBC 自訂積木
用 EV3-G 的話,先下載 MBC 自訂積木 MBC_Hue12Sensor.ev3b,在 EV3-G 選「工具 → 積木匯入」匯入一次(每台電腦只要做一次),WRO 版範例程式才打得開。
第一次測試
- 下載本頁範例 1 的
.ev3,開啟後按「下載並執行」。 - EV3 螢幕上的數字跟著感應器前方的東西變化,就是接好了。
常見問題
- 數字一直不變? 拔掉感應器重插一次(EV3 要先開機再插)。
- EV3 顯示成「紅外線感應器」? 這是正常的,讀數字就是用紅外線感應器的積木。
- 某些範例沒有 EV3-G 版? 標「僅 Pybricks/EV3 MicroPython/clev3r」的範例用到的模式,EV3-G 的積木讀不到。
- 程式跑一跑會頓一下? 程式裡切換了感應器模式,每次切換約 1 秒,改成只用一種模式。
讀值(學校版)
感應器在 EV3 會顯示成樂高原廠感應器,用原廠感應器積木讀就好。
色相 hue
| 範圍 | 意思 |
|---|---|
-1~100 |
S1 取樣點色相 0 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 色相 | 紅外線感應器 →「近接」 | 讀到的數 | 模式 0 |
飽和度 saturation
| 範圍 | 意思 |
|---|---|
0~100 |
S1 取樣點飽和度 0~100 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 飽和度 | 紅外線感應器 →「信標」頻道 1 的近接 | 讀到的數 | 模式 1 |
明度 value
| 範圍 | 意思 |
|---|---|
0~100 |
S1 取樣點明度 0~100 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 明度 | 紅外線感應器 →「信標」頻道 2 的方向 | 讀到的數 | 模式 1 |
動態 motion
| 範圍 | 意思 |
|---|---|
0~100 |
全畫面動態量 0~100(畫面變化越多越大) |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 動態 | 紅外線感應器 →「信標」頻道 2 的近接 | 讀到的數 | 模式 1 |
色塊 X blobX
| 範圍 | 意思 |
|---|---|
0~100 |
色塊中心 X 0~100,左 = 0;沒找到 = 0 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 色塊 X | 紅外線感應器 →「信標」頻道 3 的方向 | 讀到的數 | 模式 1 |
色塊 Y blobY
| 範圍 | 意思 |
|---|---|
0~75 |
色塊中心 Y 0~75,下 = 0、上 = 75;沒找到 = 0 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 色塊 Y | 紅外線感應器 →「信標」頻道 3 的近接 | 讀到的數 | 模式 1 |
色塊寬 blobW
| 範圍 | 意思 |
|---|---|
0~100 |
色塊寬 W 0~100;0 = 沒找到 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 色塊寬 | 紅外線感應器 →「信標」頻道 4 的方向 | 讀到的數 | 模式 1 |
色塊高 blobH
| 範圍 | 意思 |
|---|---|
0~75 |
色塊高 H 0~75;沒找到 = 0 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 色塊高 | 紅外線感應器 →「信標」頻道 4 的近接 | 讀到的數 | 模式 1 |
這個軟體讀不到:色塊面積、有找到色塊。要用這些值請改用 Arduino/mBlock/micro:bit。
讀值(WRO 版)
感應器在 EV3 會顯示成樂高原廠感應器,用原廠感應器積木讀就好。
色點 1~12 顏色碼 spotColor
| 範圍 | 意思 |
|---|---|
0~255 |
10 |
這款不是模擬樂高原廠感應器,原廠積木讀不到;請用範例裡附的 MBC 自訂積木(見上方安裝與設定)。
色點 1~12 鮮豔度 spotVivid
| 範圍 | 意思 |
|---|---|
0~255 |
20 |
這款不是模擬樂高原廠感應器,原廠積木讀不到;請用範例裡附的 MBC 自訂積木(見上方安裝與設定)。
範例(學校版)
範例 1:相機看到了什麼?8 個數字一次看
這個範例會做什麼: 模式 1 一次送出 8 個數字:顏色、鮮豔度、亮度、動態、色塊的 X、Y、寬、高。全部顯示在 EV3 螢幕上,對照相機畫面就能看懂每個數字的意思。
要準備什麼:
- 神攝手(學校版)(EV3 版)
- EV3 主機
怎麼接: 神攝手(學校版)插 1 號孔。相機設定:側鍵短按進選單 → 左右鍵選「2:TRACK」→ 確認 → 把十字對準球,依序調好位置、容許範圍與最小面積 → 按確認存檔。
下載程式(選你用的軟體):
一步一步看懂程式:
- 清除螢幕
- 一直重複
- 顏色:紅 0 或 100、黃約 17、綠約 33、藍約 67,-1=黑白灰
- 鮮豔度 0~100
- 亮度 0~100
- 畫面動了多少 0~100
- 色塊左右位置 0~100
- 色塊上下位置 0~75
- 色塊寬度,0=沒找到
- 色塊高度,越近越大
- 等 0.1 秒
跑起來應該看到: 把球在鏡頭前左右移動,X 跟著變;拿近,W、H 變大;拿走,X、Y、W、H 全部變 0。
常見問題:
- 相機螢幕一直停在「LEGO Sync...」? 相機要接上「已經開機」的 EV3 才會啟動。EV3 先開機,再插相機的線。
- X、Y、W、H 一直是 0? 還沒設定 2:TRACK,或球的顏色不在容許範圍內。
範例 2:紅綠燈車:看到綠色才走
這個範例會做什麼: 用模式 0 只讀「顏色」。看到綠色就往前開,其他顏色(紅色)就停。
要準備什麼:
- EV3 主機+教育版基本車(左輪接 B、右輪接 C)
- 神攝手(學校版)(EV3 版)
- 紅色、綠色的紙卡各一張
怎麼接: 神攝手(學校版)插 1 號孔,裝在車頭、鏡頭朝前。相機設定:側鍵短按進選單 → 左右鍵選「1:COLOR」→ 確認 → 把十字對準要認的顏色,依序調好位置與容許範圍 → 按確認存檔。
下載程式(選你用的軟體):
一步一步看懂程式:
- 一直重複
- 如果顏色在 25~45 之間(綠色)
- 是綠色:往前開
- 否則:
- 不是綠色:停車
- 如果顏色在 25~45 之間(綠色)
跑起來應該看到: 鏡頭前放綠色卡,車子往前開;換成紅色卡,車子停下來。
常見問題:
- 相機螢幕一直停在「LEGO Sync...」? 相機要接上「已經開機」的 EV3 才會啟動。EV3 先開機,再插相機的線。
- 綠色卡也不走? 先跑範例 1 看綠色卡實際的 HUE 是多少,再改程式裡的 25 和 45。
範例 3:防盜警報:有東西動就叫
這個範例會做什麼: 模式 1 的第 4 個數字是「畫面動了多少」。相機對著門口,有人經過數字就會變大,超過 20 就嗶嗶叫。這個範例相機不用做任何設定。
要準備什麼:
- 神攝手(學校版)(EV3 版)
- EV3 主機
怎麼接: 神攝手(學校版)插 1 號孔,鏡頭對著要看守的地方,放穩不要晃。
下載程式(選你用的軟體):
一步一步看懂程式:
- 一直重複
- 螢幕顯示動態值
- 如果動態值大於 20
- 有東西在動:嗶!
跑起來應該看到: 畫面靜止時不叫;手在鏡頭前揮一下,EV3 就嗶嗶叫。
常見問題:
- 相機螢幕一直停在「LEGO Sync...」? 相機要接上「已經開機」的 EV3 才會啟動。EV3 先開機,再插相機的線。
- 沒人也一直叫? 日光燈閃爍或相機在晃。把 20 改大(例如 35)。
範例 4:看球轉頭
這個範例會做什麼: 車子原地轉,讓球一直保持在畫面中間:球在左邊就往左轉、在右邊就往右轉、在中間就停;看不到球就原地轉圈找。
要準備什麼:
- EV3 主機+教育版基本車(左輪接 B、右輪接 C)
- 神攝手(學校版)(EV3 版)
- 一顆顏色鮮豔的球
怎麼接: 神攝手(學校版)插 1 號孔,裝在車頭、鏡頭朝前。相機設定:側鍵短按進選單 → 左右鍵選「2:TRACK」→ 確認 → 把十字對準球,依序調好位置、容許範圍與最小面積 → 按確認存檔。
下載程式(選你用的軟體):
一步一步看懂程式:
- 一直重複
- 如果色塊寬度=0(沒找到球)
- 看不到球(寬度=0):原地慢慢轉圈找
- 否則:
- 如果 X 小於 40(左邊)
- 球在左邊:往左轉
- 否則:
- 否則,如果 X 大於 60(右邊)
- 球在右邊:往右轉
- 否則:
- 球在中間:停住
- 否則,如果 X 大於 60(右邊)
- 如果 X 小於 40(左邊)
- 如果色塊寬度=0(沒找到球)
跑起來應該看到: 拿著球在車子前面左右移動,車頭會跟著球轉。
常見問題:
- 相機螢幕一直停在「LEGO Sync...」? 相機要接上「已經開機」的 EV3 才會啟動。EV3 先開機,再插相機的線。
- 左右顛倒? 把兩個 tank 的 -15 和 15 對調。
範例 5:追球:靠近到一定距離就停
這個範例會做什麼: 把範例 4 改成會往前開:一邊對準球一邊前進,球的高度 H 夠大(夠近)就停下來。
要準備什麼:
- EV3 主機+教育版基本車(左輪接 B、右輪接 C)
- 神攝手(學校版)(EV3 版)
- 一顆顏色鮮豔的球
怎麼接: 神攝手(學校版)插 1 號孔,裝在車頭、鏡頭朝前。相機設定:側鍵短按進選單 → 左右鍵選「2:TRACK」→ 確認 → 把十字對準球,依序調好位置、容許範圍與最小面積 → 按確認存檔。
下載程式(選你用的軟體):
一步一步看懂程式:
- 一直重複
- 如果寬度=0(沒找到球)
- 看不到球:原地轉圈找
- 否則:
- 否則,如果 H 大於 30
- 球的高度大於 30(夠近了):停車
- 否則:
- 轉彎力量 turn =(X − 50)× 0.6:球偏右是正數
- 左輪=25+turn、右輪=25-turn:邊對準邊前進
- 否則,如果 H 大於 30
- 如果寬度=0(沒找到球)
跑起來應該看到: 把球放在地上,車子會轉向球、開過去,在球前面停下來。
常見問題:
- 相機螢幕一直停在「LEGO Sync...」? 相機要接上「已經開機」的 EV3 才會啟動。EV3 先開機,再插相機的線。
- 還很遠就停了? 把 30 改大。
還有問題?歡迎到 聯絡我們 留言,附上你用的軟體和程式截圖,我們會幫你看。
範例(WRO 版)
範例 1:色點 S1 看到什麼顏色?
這個範例會做什麼: WRO 版有 12 個色點,每個色點回報「那一個位置現在的顏色」。先設定 S1,把它的顏色碼和鮮豔度顯示在螢幕上。
要準備什麼:
- 神攝手(WRO 版)(EV3 版)
- EV3 主機
- 各種顏色的積木
怎麼接: 神攝手(WRO 版)插 1 號孔,裝在車頭、鏡頭朝前。相機設定:側鍵短按進選單 → 左右鍵選 S1 → 確認 → 移動十字游標到要看的位置(X、Y)→ 調容許範圍 → 確認存檔。
下載程式(選你用的軟體):
一步一步看懂程式:
- 清除螢幕
- 一直重複
- 第 1 行:S1 的顏色碼
- 第 2 行:S1 的鮮豔度
- 等 0.1 秒
跑起來應該看到: 在 S1 的位置放不同顏色的積木,顏色碼會跟著變:紅約 0、黃約 40、綠約 80、藍約 160。
常見問題:
- 相機螢幕一直停在「LEGO Sync...」? 相機要接上「已經開機」的 EV3 才會啟動。EV3 先開機,再插相機的線。
- 數字一直是 255? 那個色點還沒設定(沒啟用)。照上面的相機設定做一次 S1。
- 顏色數字的意思? 0
239 是彩色:紅 0(或 239)、黃 40、綠 80、青 120、藍 160、紫 200;240245 白;246~250 黑。 - 相機畫面上下顛倒? 到選單把 V-Flip 打開。改完方向後,色點的位置要重新設定一次。
- 原本燒的是學校版,改燒 WRO 版後色點怪怪的? 兩版的設定存在同一個地方,請先在選單做一次 Reset Default,再重新設定色點。
範例 2:顏色播報:螢幕顯示顏色名稱
這個範例會做什麼: 把顏色碼分成幾段,判斷是紅、綠、藍、白、黑,在螢幕上顯示英文名稱並嗶一聲。
要準備什麼:
- 神攝手(WRO 版)(EV3 版)
- EV3 主機
- 紅、綠、藍色積木
怎麼接: 神攝手(WRO 版)插 1 號孔,裝在車頭、鏡頭朝前。相機設定:側鍵短按進選單 → 左右鍵選 S1 → 確認 → 移動十字游標到要看的位置(X、Y)→ 調容許範圍 → 確認存檔。
下載程式(選你用的軟體):
一步一步看懂程式:
- 一直重複
- 把 S1 的顏色碼存進 hue
- 清除螢幕
- 如果是紅色
- 0
14 或 226239:紅色 - 否則:
- 否則,如果是綠色
- 60~100:綠色
- 否則:
- 否則,如果是藍色
- 140~180:藍色
- 否則:
- 否則,如果是白色
- 240~245:白色
- 否則:
- 否則,如果是黑色
- 246~250:黑色
- 否則:
- 其他顏色
- 否則,如果是黑色
- 否則,如果是白色
- 否則,如果是藍色
- 否則,如果是綠色
- 0
- 等 0.3 秒
跑起來應該看到: 把紅、綠、藍積木放到 S1 的位置,螢幕分別顯示 RED、GREEN、BLUE。
常見問題:
- 相機螢幕一直停在「LEGO Sync...」? 相機要接上「已經開機」的 EV3 才會啟動。EV3 先開機,再插相機的線。
- 數字一直是 255? 那個色點還沒設定(沒啟用)。照上面的相機設定做一次 S1。
- 顏色數字的意思? 0
239 是彩色:紅 0(或 239)、黃 40、綠 80、青 120、藍 160、紫 200;240245 白;246~250 黑。 - 相機畫面上下顛倒? 到選單把 V-Flip 打開。改完方向後,色點的位置要重新設定一次。
- 原本燒的是學校版,改燒 WRO 版後色點怪怪的? 兩版的設定存在同一個地方,請先在選單做一次 Reset Default,再重新設定色點。
範例 3:交通號誌柱:紅停綠走
這個範例會做什麼: WRO 未來工程師常見的紅綠柱子:S1 對準前方,看到紅色就停車、看到綠色就往前開。
要準備什麼:
- EV3 主機+教育版基本車(左輪接 B、右輪接 C)
- 神攝手(WRO 版)(EV3 版)
- 紅色、綠色的柱子或積木
怎麼接: 神攝手(WRO 版)插 1 號孔,裝在車頭、鏡頭朝前。相機設定:側鍵短按進選單 → 左右鍵選 S1 → 確認 → 移動十字游標到要看的位置(X、Y)→ 調容許範圍 → 確認存檔。
下載程式(選你用的軟體):
一步一步看懂程式:
- 一直重複
- 把 S1 的顏色碼存進 hue
- 如果是綠色(60~100)
- 綠色:往前開
- 否則:
- 否則,如果是紅色
- 紅色:停車
- 否則,如果是紅色
跑起來應該看到: 前面放綠色柱子,車子往前開;換成紅色,車子停下來。其他顏色會維持原本的動作。
常見問題:
- 相機螢幕一直停在「LEGO Sync...」? 相機要接上「已經開機」的 EV3 才會啟動。EV3 先開機,再插相機的線。
- 數字一直是 255? 那個色點還沒設定(沒啟用)。照上面的相機設定做一次 S1。
- 顏色數字的意思? 0
239 是彩色:紅 0(或 239)、黃 40、綠 80、青 120、藍 160、紫 200;240245 白;246~250 黑。 - 相機畫面上下顛倒? 到選單把 V-Flip 打開。改完方向後,色點的位置要重新設定一次。
- 原本燒的是學校版,改燒 WRO 版後色點怪怪的? 兩版的設定存在同一個地方,請先在選單做一次 Reset Default,再重新設定色點。
範例 4:看到黑線就停車
這個範例會做什麼: 把 S1 設在畫面下方對著地面,車子往前開,S1 看到黑色(246~250)就停。
要準備什麼:
- EV3 主機+教育版基本車(左輪接 B、右輪接 C)
- 神攝手(WRO 版)(EV3 版)
- 白色地面上貼一條黑膠帶
怎麼接: 神攝手(WRO 版)插 1 號孔,裝在車頭、鏡頭朝前。相機設定:側鍵短按進選單 → 左右鍵選 S1 → 確認 → 移動十字游標到畫面下方(對著地面)(X、Y)→ 調容許範圍 → 確認存檔。
下載程式(選你用的軟體):
一步一步看懂程式:
- 往前開
- 等到 S1 的顏色碼在 246~250(黑色)
- 停車
- 嗶一聲
跑起來應該看到: 車子往前開,壓到黑線時停下來並嗶一聲。
常見問題:
- 相機螢幕一直停在「LEGO Sync...」? 相機要接上「已經開機」的 EV3 才會啟動。EV3 先開機,再插相機的線。
- 數字一直是 255? 那個色點還沒設定(沒啟用)。照上面的相機設定做一次 S1。
- 顏色數字的意思? 0
239 是彩色:紅 0(或 239)、黃 40、綠 80、青 120、藍 160、紫 200;240245 白;246~250 黑。 - 相機畫面上下顛倒? 到選單把 V-Flip 打開。改完方向後,色點的位置要重新設定一次。
- 原本燒的是學校版,改燒 WRO 版後色點怪怪的? 兩版的設定存在同一個地方,請先在選單做一次 Reset Default,再重新設定色點。
範例 5:左中右三個色點:紅色在哪邊?
這個範例會做什麼: 設定 S1(左)、S2(中)、S3(右)三個色點,看紅色出現在哪一個,車子就往那邊轉。
要準備什麼:
- EV3 主機+教育版基本車(左輪接 B、右輪接 C)
- 神攝手(WRO 版)(EV3 版)
- 一個紅色積木
怎麼接: 神攝手(WRO 版)插 1 號孔,裝在車頭、鏡頭朝前。相機設定:把 S1 設在畫面左邊、S2 中間、S3 右邊,三個點高度一樣。
下載程式(選你用的軟體):
一步一步看懂程式:
- 一直重複
- 如果 S1 是紅色
- 紅色在左邊(S1):往左轉
- 否則:
- 否則,如果 S3 是紅色
- 紅色在右邊(S3):往右轉
- 否則:
- 否則,如果 S2 是紅色
- 紅色在中間(S2):往前開
- 否則:
- 沒看到紅色:停住
- 否則,如果 S2 是紅色
- 否則,如果 S3 是紅色
- 如果 S1 是紅色
跑起來應該看到: 紅色積木放在車子左前方,車子往左轉;放右前方往右轉;正前方就往前開。
常見問題:
- 相機螢幕一直停在「LEGO Sync...」? 相機要接上「已經開機」的 EV3 才會啟動。EV3 先開機,再插相機的線。
- 數字一直是 255? 那個色點還沒設定(沒啟用)。照上面的相機設定做一次 S1。
- 顏色數字的意思? 0
239 是彩色:紅 0(或 239)、黃 40、綠 80、青 120、藍 160、紫 200;240245 白;246~250 黑。 - 相機畫面上下顛倒? 到選單把 V-Flip 打開。改完方向後,色點的位置要重新設定一次。
- 原本燒的是學校版,改燒 WRO 版後色點怪怪的? 兩版的設定存在同一個地方,請先在選單做一次 Reset Default,再重新設定色點。
還有問題?歡迎到 聯絡我們 留言,附上你用的軟體和程式截圖,我們會幫你看。
其他問題
- EV3 顯示成紅外線感應器? 正常:感應器模擬成樂高原廠感應器,用原廠積木就能讀。
- 切換模式時卡一下? EV3 每次換模式要等約 1 秒。整趟任務盡量只用同一個模式的積木。
還有問題?到 聯絡我們 附上你用的軟體和程式截圖。
下載
本頁依據
- 主機與軟體清單:
_build/guides.json - 值與命令:
_build/protocol/cam_school.json、_build/protocol/cam_wro.json(單一真相來源) - 安裝與設定:
_build/guides/software/ev3-ev3g.zh.md、_build/guides/product/esp32cam/ev3-ev3g.zh.md - 範例:
sensors/esp32cam/ev3-examples(-wro).md









