神攝手舊版已停止支援：2026-10 以前出貨的神攝手（學校版／WRO 版）已停止支援，說明與範例保留供參考。需要升級成目前的神攝手：請聯繫原購買的經銷商寄回，韌體更新免費，來回運費由買家負擔。 你要找的是目前的神攝手 →
MBC 神攝手 WRO 版（HUE12） × EV3 Pybricks

三個步驟在 EV3 上用 MicroPython 讀神攝手 WRO 版

在 EV3 上寫 MicroPython 一定照這個順序：先匯入，再建立物件、幫感應器取名字，最後才用這個名字去讀值。上面先選你用的是 Pybricks v4 還是 EV3 MicroPython v2，左邊一步一步做，右邊的程式會跟著長出來；點模擬畫面上的格子換顏色，就能看到程式會印出什麼。

你用的軟體：
1

匯入函式庫

程式的第一件事是告訴 Pybricks「我要用神攝手的函式庫」。沒有這行，後面寫的 MBC_HUE12 主機看不懂，會出現 NameError。

選一種函式庫（兩種寫法完全一樣，只差 import 那一行）：

  1. 下載函式庫（存成檔案，檔名不要改）：MBC_hue12.py（只接神攝手 WRO 版）或 MBC_sensors.py（統一函式庫）；你選的是 MBC_hue12.py。
  2. 用 Chrome 打開 code.pybricks.com，照網站說明把 EV3 換成 Pybricks 韌體（正式版已內建 EV3 韌體）。
  3. 在左邊檔案區按「Import a file」，把函式庫匯入同一個專案。
  4. 檔名不要改，也不要放進子資料夾。
  5. 回到主程式，在最上面寫下面這幾行（右邊程式標 ① 的地方）。
2

建立物件：幫感應器取名字

一台車可能接好幾個感應器，所以要「建立一個物件」：告訴程式感應器接在哪個孔，並幫它取個名字。之後每次要讀值，都是叫這個名字。

感應器接在哪個孔？

要不要開啟多工？

程式裡的 1 就是孔位編號：EV3 1~4 = S1~S4。也可以寫成 Port.S1，但要多匯入 from pybricks.parameters import Port。

3

使用功能

寫法都是「hue12.功能名稱()」：名字＋小數點＋功能。點一個功能，程式和輸出會換成它的範例。

模擬神攝手畫面（12 格排成一排）：點格子換顏色，看右邊的輸出怎麼變
要塗的顏色（先選顏色，再點上面的格子）：

模擬畫面是示意：每種顏色用一個代表數字，實際的色相、飽和度會跟著燈光和物塊變。12 格的位置是你在感應器上設定的，這裡排成一排方便看（第 1 格在最左邊）；紅框 = 範例讀的第 1 格，格子下面的數字是程式讀到的色相。

每個功能的範例

完整範例


        
!

      

      

        

        

        
!

      

      

        

        

        
!

      

    

  


  

    
使用注意

    
    
      
  1. Pybricks v4 一定要先 update()。get_slot() 不會自己去讀感應器，只拿 update() 存好的資料；沒有呼叫 update()，12 格會一直是 ('NONE', 255, 0)。每一圈迴圈呼叫一次就好。
    2. 
      
  2. 拔線時兩種軟體不一樣。Pybricks v4 的 MBC 函式庫：update() 回傳 False、get_slot() 回傳上一次的資料，電腦畫面印一行提醒，程式不會停；插回去自動恢復，要知道有沒有接好就用 sensor_ok()。EV3 MicroPython v2 的 Ev3devSensor：讀不到會出現 OSError，程式停下來，要插回去再重新執行。在右邊勾「拔掉感應器」可以看到這兩種情形。
    3. 
      
  3. 顏色碼怎麼看：0～239 是彩色（紅色在頭尾：0～9 和 230～239）、240～245 白、246～250 黑、255 = 這一格沒設定（感應器還在選單裡時，12 格也全部是 255）。函式庫的顏色名稱：Red 紅、Org 橘、Yel 黃、Lim 黃綠、Grn 綠、Mnt 薄荷綠、Cyn 青、Azr 天藍、Blu 藍、Prp 紫、Mag 洋紅、Pnk 粉紅、Wht 白、Blk 黑、NONE 沒設定。
    4. 
      
  4. EV3 只有一個模式：12 格都在模式 0，不用換模式，讀幾格都不會變慢。這款沒有身分資料，device_id()、firmware_version() 讀不到（會出現 ValueError）；要確認接的是它，看建立物件時印出的 Connected to ID: 95，或用 clev3r 的 Sensor.GetType（是 95）。
    5. 
      
  5. EV3 Classroom 讀不到這款。它的感應器類型 95 不是樂高原廠的類型，EV3 Classroom 的積木讀不到；EV3 軟體（EV3-G）要先匯入 MBC 的自訂積木。Pybricks v4、EV3 MicroPython v2、clev3r 都能直接讀。
    6.