Accelerometer 继承自：Service, BaseControl

以流的形式提供加速度计的原始读数 AccelerometerReadingEvent，描述设备的加速度，单位为 m/s^2，其中包含重力的影响。

与 UserAccelerometer 不同，本服务报告的是加速度计（移动设备内置的物理传感器）的原始数据，不做任何后处理。

加速度计无法区分设备加速运动带来的影响与周围引力场带来的影响。这意味着，在地球表面即使设备完全静止，Accelerometer 的读数也是强度为 9.8、方向朝上的加速度（与重力加速度方向相反）。这可以用来推断设备的位置信息（水平/竖直/倾斜）。如果设备处于自由落体状态，加速度计报告的加速度为零。

注意：

• 支持的平台：Android、iOS 和 Web。
• Web 会忽略请求的采样间隔。

示例

import flet as ft


def main(page: ft.Page):
    def handle_reading(e: ft.AccelerometerReadingEvent):
        reading.value = f"x={e.x:.2f} m/s^2, y={e.y:.2f} m/s^2, z={e.z:.2f} m/s^2"

    def handle_error(e: ft.SensorErrorEvent):
        page.add(ft.Text(f"Accelerometer error: {e.message}"))

    page.services.append(
        ft.Accelerometer(
            on_reading=handle_reading,
            on_error=handle_error,
            interval=ft.Duration(milliseconds=100),
            cancel_on_error=False,
        )
    )

    page.add(
        ft.SafeArea(
            content=ft.Column(
                controls=[
                    ft.Text("Move your device to see accelerometer readings."),
                    reading := ft.Text("Waiting for data..."),
                ]
            )
        )
    )


if __name__ == "__main__":
    ft.run(main)

属性

名称	类型	默认值	说明
enabled	bool	True	是否应对传感器进行采样。禁用可停止数据流。
interval	Optional[Duration]	None	期望的采样间隔，以 Duration 提供。默认为 200 毫秒。 注意，移动平台会把这个值当作建议值，实际频率可能因硬件和操作系统的限制而有所不同。
cancel_on_error	bool	True	在首次出现传感器错误时是否取消流订阅。
data	Any	skip_	任意类型的自定义数据。
key	Optional['KeyValue']	None	用于在更新之间保持控件标识稳定的键。

只读属性

名称	类型	默认值	说明
parent	Optional['BaseControl']	—	此控件的直接祖先（父级）。 默认为 None，只有在此控件被挂载（加入页面树）后才有值。 Page 控件（页面树的根）是个例外 —— 它的 parent 始终为 None。
page	'Page'	—	此控件所属的页面。

事件

名称	类型	默认值	说明
on_reading	Optional[EventHandler[AccelerometerReadingEvent]]	None	有新的读数可用时触发。 event 提供 x、y、z 加速度值以及 timestamp（自纪元以来的微秒数）。
on_error	Optional[EventHandler[SensorErrorEvent]]	None	平台报告传感器错误时触发（例如设备未提供加速度计）。event.message 包含错误文本。

方法

名称	类型	默认值	说明
before_update	—	—	—
init	—	—	—
is_isolated	—	—	返回此控件是否被标记为隔离。 隔离控件会被排除在父级驱动的更新遍历之外，并需要自行管理更新边界。
build	—	—	在控件初始化期间调用一次，用于定义其子控件。在此方法中 page 属性可用。
before_event	—	—	在事件处理器执行之前拦截事件。 返回 False 可取消分发。返回 True 或 None 则继续正常的事件处理。
did_mount	—	—	在控件挂载到页面树之后调用。 重写此方法以启动需要已挂载页面的资源，例如订阅、定时器或服务监听器。
will_unmount	—	—	在控件从页面树移除之前调用。 重写此方法以释放 did_mount() 中创建的资源，例如订阅、定时器或外部句柄。
get_data_channel	—	—	解析为此 widget 在 Dart 侧分配的 [DataChannel]。模式： on_data_channel_open: Optional[ft.EventHandler[DataChannelOpenEvent]] = None def init(self): self.on_data_channel_open = self._on_open def _on_open(self, e): self._channel = self.get_data_channel(e.channel_id) 幂等 —— 底层的 Connection 会按 id 缓存 DataChannel，因此重复调用会返回同一实例。没有错误路径：该 id 始终来自框架触发的事件，所以当此方法运行时，通道在两端都已存在。
update	None	—	为此控件请求一次 UI 更新。 在更改控件状态或属性后调用。控件必须已挂载到页面且未被标记为冻结。