神攝手 ESP32CAM × EV3 × EV3 Classroom
這一頁只講 EV3 Classroom(Scratch 積木):在 MINDSTORMS EV3 上用它讀神攝手 ESP32CAM的安裝步驟、每個值怎麼讀、能用的命令與範例。要換產品、主機或軟體,用上方的切換列。
安裝與設定
你需要
- 感應器:神攝手 ESP32CAM(EV3 版,RJ12 接頭)。SPIKE 版插在 EV3 上不會被認出來。
- 主機:LEGO MINDSTORMS EV3。
- 連接線:產品內附的標準連接線,或樂高原廠 EV3 線。
- 軟體:LEGO MINDSTORMS EV3 Classroom(Scratch 積木風格,跟 SPIKE 的積木一樣)。第一次用 EV3 的人最好上手。
安裝軟體
- 到 LEGO Education 下載頁 安裝 EV3 Classroom。
- 打開範例:下載
.lmsp檔 → 在 EV3 Classroom 首頁按「開啟」選這個檔 → 接上 EV3 → 右下角「下載並執行」。
讓軟體認得感應器
不用裝擴充、不用裝驅動程式。感應器在 EV3 上會模擬成樂高原廠感應器(多數產品顯示成「紅外線感應器」),直接用內建的感應器積木。
- Classroom 的積木外觀是 Scratch 風格,但讀取模式跟 EV3 官方軟體完全一樣:Proximity/Beacon/Remote 三種,數值範圍也相同,看下面的讀值。
- 有些產品附 MBC 自訂積木(My Blocks),已經放在範例專案裡,打開範例就能用。
重要
不要在程式中途切換模式。 EV3 主機每次切換感應器模式,會卡住約 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)在 EV3 Classroom 讀不到:它在 EV3 上是第三方感應器(type 95)。請改用 EV3-G(MBC 自訂積木)、clev3r 或 Pybricks。
第一次測試
- 下載本頁範例 1 的
.lmsp,開啟後接上 EV3,按「下載並執行」。 - EV3 螢幕上的數字跟著感應器前方的東西變化,就是接好了。
常見問題
- 數字一直不變? 拔掉感應器重插一次(EV3 要先開機再插)。
- 積木圖是英文? EV3 Classroom 沒有繁體中文介面,本站的積木圖是英文版。
- 某些範例沒有 Classroom 版? 標「僅 Pybricks/EV3 MicroPython/clev3r」的範例用到的模式,Classroom 的積木讀不到。
- 程式跑一跑會頓一下? 程式裡切換了感應器模式,每次切換約 1 秒,改成只用一種模式。
讀值(學校版)
感應器在 EV3 會顯示成樂高原廠感應器,用 Classroom 的原廠感應器積木讀(Classroom 沒有繁中介面,積木名稱用英文)。
色相 hue
| 範圍 | 意思 |
|---|---|
-1~100 |
S1 取樣點色相 0 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 色相 | Infrared Sensor → Proximity | 讀到的數 | 模式 0 |
飽和度 saturation
| 範圍 | 意思 |
|---|---|
0~100 |
S1 取樣點飽和度 0~100 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 飽和度 | Infrared Sensor → Beacon proximity, channel 1 | 讀到的數 | 模式 1 |
明度 value
| 範圍 | 意思 |
|---|---|
0~100 |
S1 取樣點明度 0~100 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 明度 | Infrared Sensor → Beacon heading, channel 2 | 讀到的數 | 模式 1 |
動態 motion
| 範圍 | 意思 |
|---|---|
0~100 |
全畫面動態量 0~100(畫面變化越多越大) |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 動態 | Infrared Sensor → Beacon proximity, channel 2 | 讀到的數 | 模式 1 |
色塊 X blobX
| 範圍 | 意思 |
|---|---|
0~100 |
色塊中心 X 0~100,左 = 0;沒找到 = 0 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 色塊 X | Infrared Sensor → Beacon heading, channel 3 | 讀到的數 | 模式 1 |
色塊 Y blobY
| 範圍 | 意思 |
|---|---|
0~75 |
色塊中心 Y 0~75,下 = 0、上 = 75;沒找到 = 0 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 色塊 Y | Infrared Sensor → Beacon proximity, channel 3 | 讀到的數 | 模式 1 |
色塊寬 blobW
| 範圍 | 意思 |
|---|---|
0~100 |
色塊寬 W 0~100;0 = 沒找到 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 色塊寬 | Infrared Sensor → Beacon heading, channel 4 | 讀到的數 | 模式 1 |
色塊高 blobH
| 範圍 | 意思 |
|---|---|
0~75 |
色塊高 H 0~75;沒找到 = 0 |
| 值 | 積木 | 換算 | 模式 |
|---|---|---|---|
| 色塊高 | Infrared Sensor → Beacon proximity, channel 4 | 讀到的數 | 模式 1 |
這個軟體讀不到:色塊面積、有找到色塊。要用這些值請改用 Arduino/mBlock/micro:bit。
讀值(WRO 版)
感應器在 EV3 會顯示成樂高原廠感應器,用 Classroom 的原廠感應器積木讀(Classroom 沒有繁中介面,積木名稱用英文)。
色點 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 看到什麼顏色?;範例 2:顏色播報:螢幕顯示顏色名稱;範例 3:交通號誌柱:紅停綠走;範例 4:看到黑線就停車;範例 5:左中右三個色點:紅色在哪邊?
其他問題
- EV3 顯示成紅外線感應器? 正常:感應器模擬成樂高原廠感應器,用原廠積木就能讀。
- 切換模式時卡一下? EV3 每次換模式要等約 1 秒。整趟任務盡量只用同一個模式的積木。
還有問題?到 聯絡我們 附上你用的軟體和程式截圖。
下載
本頁依據
- 主機與軟體清單:
_build/guides.json - 值與命令:
_build/protocol/cam_school.json、_build/protocol/cam_wro.json(單一真相來源) - 安裝與設定:
_build/guides/software/ev3-classroom.zh.md、_build/guides/product/esp32cam/ev3-classroom.zh.md - 範例:
sensors/esp32cam/ev3-examples(-wro).md




