Microbit_Magnetometer可用於設定BBC micro:bit開發板上的磁力感測器，並接收單筆或多筆磁力讀數。

屬性

• BluetoothDevice – 連接至micro:bit 裝置之BluetoothLE元件。

方法

• ReadMagnetometerBearing – 讀取單筆方位角數值。成功讀取之後就會自動呼叫MagnetometerBearingReceived事件。

• ReadMagnetometerData – 讀取單筆磁力感測器資料。成功讀取之後就會自動呼叫MagnetometerDataReceived事件。

• ReadMagnetometerPeriod – 讀取磁力感測器當下的讀取速度(report rate)。成功讀取之後就會由MagnetometerPeriodReceived事件回傳相關數值。

• RequestMagnetometerBearingUpdates – 要求關於micro:bit方位角數值變化的通知。方位角變化會以WriteMagnetometerPeriod方法所設定的速度來回傳。方位角資料會由MagnetometerBearingReceived事件回傳。

• RequestMagnetometerDataUpdates – 要求關於micro:bit磁力感測器讀值變化的通知。磁力數值變化會以WriteMagnetometerPeriod方法所設定的速度來回傳。磁力資料會由MagnetometerDataReceived事件回傳。

• StopMagnetometerBearingUpdates – 停止接收來自micro:bit方位角的更新。請注意可能會有來自裝置的pending messages，所以仍有可能觸發MagnetometerBearingReceived事件。

• StopMagnetometerDataUpdates – 停止接收來自micro:bit磁力感測器的更新。請注意可能會有來自裝置的pending messages，所以仍有可能觸發MagnetometerDataReceived事件。

• WriteMagnetometerPeriod – 本方法可設定micro:bit發送磁力感測器資料給App Inventor的時間間隔。period單位為毫秒。根據micro:bit原廠文件，可用的參數有1, 2, 5, 10, 20, 80, 160與640(毫秒)。

  參數：

  • Magnetometer_Period (數字) — 所要設定的磁力感測器讀取速度，單位為毫秒。

事件

• MagnetometerBearingReceived – 收到來自micro:bit的方位角之後就會自動呼叫本事件。這通常是執行read或request操作的結果。方位角(bearing value)代表對北方的相對角，單位為度。

  參數：

  • bearing_value (數字) — 對北方的方位角，單位為度。

• MagnetometerDataReceived – 只要收到來自micro:bit的磁力感測器值，就會自動呼叫本事件。這通常是執行read或request操作的結果。X、Y與Z等事件數值的單位為毫特斯拉(milli-teslas)，所以計算上要除以1000。

  參數：

  • Magnetometer_X (數字) — 磁力感測器的X軸數值，單位為milliT。
  • Magnetometer_Y (數字) — 磁力感測器的Y軸數值，單位為milliT。
  • Magnetometer_Z (數字) — 磁力感測器的Z軸數值，單位為milliT。

• MagnetometerPeriodReceived – 讀取micro:bit磁力感測器的讀取速度之後就會自動呼叫本事件。

  參數：

  • Magnetometer_Period (數字) —  micro:bit磁力感測器現在的讀取速度區間，單位為毫秒。

• WroteMagnetometerPeriod – 透過ReadAccelerometerPeriod方法要求micro:bit回傳其讀取速度之後，就會自動呼叫本事件。

  參數：

  • Magnetometer_Period (數字) — micro:bit磁力感測器現在的讀取速度區間，單位為毫秒。