• Microbit Magnetometer：航向/方位信息
  • 属性
  • 方法
  • 事件

« 返回首页

Microbit Magnetometer：航向/方位信息

Microbit_Magnetometer 可以配置 BBC micro:bit 的板载磁力计，并通过适当的方法接收一个或多个磁力计样本。

更多链接：

• 下载 micro:bit 板载磁力计的示例项目。
• 查看 micro:bit 板载磁力计的操作说明。

属性

• BluetoothDevice – 设置连接到 micro:bit 设备的 BluetoothLE 组件。

方法

• ReadMagnetometerBearing – 从 micro:bit 读取单个方位样本。读取成功后，将触发MagnetometerBearingReceived事件。

• ReadMagnetometerData – 从 micro:bit 读取单个磁力计数据样本。读取成功后，将触发MagnetometerDataReceived事件。

• ReadMagnetometerPeriod – 读取 micro:bit 磁力计的当前报告速率。读取周期后，将通过MagnetometerPeriodReceived事件接收。

• RequestMagnetometerBearingUpdates – 请求 micro:bit 方位变化的通知。方位变化将以通过WriteMagnetometerPeriod设置的周期速率报告。方位数据将通过MagnetometerBearingReceived事件报告。

• RequestMagnetometerDataUpdates – 请求 micro:bit 磁力计变化的通知。磁力计变化将以通过WriteMagnetometerPeriod设置的周期速率报告。磁力计数据将通过MagnetometerDataReceived事件报告。

• StopMagnetometerBearingUpdates – 停止接收来自 micro:bit 磁力计的更新。注意设备可能仍有待处理的消息会通过MagnetometerBearingReceived事件报告。

• StopMagnetometerDataUpdates – 停止接收来自 micro:bit 磁力计的更新。注意设备可能仍有待处理的消息会通过MagnetometerDataReceived事件报告。

• WriteMagnetometerPeriod – 使用WriteMagnetometerPeriod方法改变 micro:bit 向 App Inventor 发送磁力计数据的频率。周期以毫秒为单位。根据 micro:bit 规范，有效值为1、2、5、10、20、80、160和640毫秒。

参数:

 * <code>Magnetometer_Period</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/math.html#number">_数字_</a>) &mdash;
   新的磁力计报告周期，单位为毫秒。

事件

• MagnetometerBearingReceived – 当从 micro:bit 接收到方位样本时，MagnetometerBearingReceived事件将被触发。这通常是执行读取或请求操作的结果。方位值报告为相对于北方的度数。

参数:

 * <code>bearing_value</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/math.html#number">_数字_</a>) &mdash;
   相对于北方的方位角，单位为度。

• MagnetometerDataReceived – 当从 micro:bit 接收到磁力计样本时，MagnetometerDataReceived事件将被触发。这通常是执行读取或请求操作的结果。X、Y和Z值以毫特斯拉为单位，因此应除以1000进行缩放。

参数:

+ <code>Magnetometer_X</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/math.html#number">_数字_</a>) &mdash; 磁力计的X值，单位为毫特斯拉。
+ <code>Magnetometer_Y</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/math.html#number">_数字_</a>) &mdash; 磁力计的Y值，单位为毫特斯拉。
+ <code>Magnetometer_Z</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/math.html#number">_数字_</a>) &mdash; 磁力计的Z值，单位为毫特斯拉。

• MagnetometerPeriodReceived – 当从设备读取 micro:bit 磁力计周期后，MagnetometerPeriodReceived事件将被触发。

参数:

 * <code>Magnetometer_Period</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/math.html#number">_数字_</a>) &mdash;
   micro:bit 磁力计的当前报告间隔，单位为毫秒。

• WroteMagnetometerPeriod – 当 micro:bit 报告其周期时，WroteMagnetometerPeriod事件将被触发，这是对之前调用ReadAccelerometerPeriod方法的响应。

参数:

 * <code>Magnetometer_Period</code> (<a href="http://appinventor.mit.edu/explore/ai2/support/blocks/math.html#number">_数字_</a>) &mdash;
   micro:bit 磁力计的报告周期，单位为毫秒。