Flutter实战：鸿蒙系统设备传感器数据采集插件开发

张

张建站

2026/4/27 4:57:20

10分钟阅读

本文将详细介绍如何在Flutter鸿蒙应用中开发传感器数据采集插件实现加速度计、陀螺仪、磁力计、光线传感器等数据的实时获取。Flutter 三方库 cached_network_image 的鸿蒙化适配与实战指南欢迎加入开源鸿蒙跨平台社区https://openharmonycrossplatform.csdn.net前言一、前言在移动应用开发中传感器数据采集是运动健康、AR/VR、游戏等应用的核心功能。HarmonyOS提供了完善的传感器框架支持加速度计、陀螺仪、磁力计、光线传感器等多种传感器类型。本文将介绍如何通过Flutter插件机制调用这些原生传感器能力。二、功能概述本插件实现以下传感器数据采集功能传感器说明数据格式加速度计测量设备加速度X/Y/Z三轴 (m/s²)陀螺仪测量角速度X/Y/Z三轴 (rad/s)磁力计测量磁场强度X/Y/Z三轴 (μT)光线传感器测量环境光强度单值 (lux)三、技术架构3.1 整体架构┌─────────────────────┐ │ Flutter UI层 │ │ (传感器数据展示) │ └──────────┬──────────┘ │ EventChannel (数据流) ▼ ┌─────────────────────┐ │ sensor_plugin.dart │ │ (Dart传感器接口) │ └──────────┬──────────┘ │ MethodChannel (控制命令) ▼ ┌─────────────────────┐ │ SensorPlugin.ets │ │ (鸿蒙原生实现) │ └──────────┬──────────┘ │ ▼ ┌─────────────────────┐ │ ohos.sensor │ │ (HarmonyOS传感器API)│ └─────────────────────┘3.2 通信机制MethodChannel用于控制命令检查传感器可用性、获取可用传感器列表EventChannel用于持续接收传感器数据流四、Flutter端实现4.1 数据模型定义// lib/sensor_plugin.dartenumSensorType{accelerometer,gyroscope,magnetometer,light,}classSensorData{finaldouble x;finaldouble y;finaldouble z;finaldouble value;finalint timestamp;SensorData({this.x0,this.y0,this.z0,this.value0,requiredthis.timestamp,});factorySensorData.fromMap(Mapdynamic,dynamicmap){returnSensorData(x:(map[x]asnum?)?.toDouble()??0,y:(map[y]asnum?)?.toDouble()??0,z:(map[z]asnum?)?.toDouble()??0,value:(map[value]asnum?)?.toDouble()??0,timestamp:map[timestamp]asint???0,);}}4.2 插件类实现classSensorPlugin{staticconstMethodChannel_methodChannelMethodChannel(sensor_plugin);staticconstEventChannel_accelerometerChannelEventChannel(sensor_plugin/accelerometer);staticconstEventChannel_gyroscopeChannelEventChannel(sensor_plugin/gyroscope);staticconstEventChannel_magnetometerChannelEventChannel(sensor_plugin/magnetometer);staticconstEventChannel_lightChannelEventChannel(sensor_plugin/light);// 检查传感器是否可用staticFutureboolisSensorAvailable(SensorTypetype)async{try{finalresultawait_methodChannel.invokeMethod(isSensorAvailable,{type:type.index,});returnresultasbool;}onPlatformExceptioncatch(e){print(Failed to check sensor availability:${e.message});returnfalse;}}// 获取可用传感器列表staticFutureListSensorTypegetAvailableSensors()async{try{finalListdynamicresultawait_methodChannel.invokeMethod(getAvailableSensors);returnresult.map((index)SensorType.values[indexasint]).toList();}onPlatformExceptioncatch(e){print(Failed to get available sensors:${e.message});return[];}}// 加速度计数据流staticStreamSensorDataaccelerometerEvents(){return_accelerometerChannel.receiveBroadcastStream({channel:sensor_plugin/accelerometer}).map((event)SensorData.fromMap(eventasMapdynamic,dynamic));}// 陀螺仪数据流staticStreamSensorDatagyroscopeEvents(){return_gyroscopeChannel.receiveBroadcastStream({channel:sensor_plugin/gyroscope}).map((event)SensorData.fromMap(eventasMapdynamic,dynamic));}// 磁力计数据流staticStreamSensorDatamagnetometerEvents(){return_magnetometerChannel.receiveBroadcastStream({channel:sensor_plugin/magnetometer}).map((event)SensorData.fromMap(eventasMapdynamic,dynamic));}// 光线传感器数据流staticStreamSensorDatalightEvents(){return_lightChannel.receiveBroadcastStream({channel:sensor_plugin/light}).map((event)SensorData.fromMap(eventasMapdynamic,dynamic));}}五、鸿蒙原生端实现5.1 插件类结构// ohos/entry/src/main/ets/plugins/SensorPlugin.etsimport{FlutterPlugin,MethodChannel,MethodCall,MethodResult,EventChannel,FlutterPluginBinding}fromohos/flutter_ohos;importcommonfromohos.app.ability.common;importsensorfromohos.sensor;interfaceSensorEventData{x:number;y:number;z:number;value:number;timestamp:number;}interfaceEventSink{success(data:ESObject):void;}exportclassSensorPluginimplementsFlutterPlugin{privatechannel:MethodChannel|nullnull;privateaccelerometerEventChannel:EventChannel|nullnull;privategyroscopeEventChannel:EventChannel|nullnull;privatemagnetometerEventChannel:EventChannel|nullnull;privatelightEventChannel:EventChannel|nullnull;privatecontext:common.Context|nullnull;privateaccelerometerSink:EventSink|nullnull;privategyroscopeSink:EventSink|nullnull;privatemagnetometerSink:EventSink|nullnull;privatelightSink:EventSink|nullnull;constructor(context:common.Context){this.contextcontext;}getUniqueClassName():string{returnSensorPlugin;}}5.2 初始化EventChannelonAttachedToEngine(binding:FlutterPluginBinding):void{// 主通道用于方法调用this.channelnewMethodChannel(binding.getBinaryMessenger(),sensor_plugin);this.channel.setMethodCallHandler(this);// 事件通道用于传感器数据流this.accelerometerEventChannelnewEventChannel(binding.getBinaryMessenger(),sensor_plugin/accelerometer);this.accelerometerEventChannel.setStreamHandler(this);this.gyroscopeEventChannelnewEventChannel(binding.getBinaryMessenger(),sensor_plugin/gyroscope);this.gyroscopeEventChannel.setStreamHandler(this);this.magnetometerEventChannelnewEventChannel(binding.getBinaryMessenger(),sensor_plugin/magnetometer);this.magnetometerEventChannel.setStreamHandler(this);this.lightEventChannelnewEventChannel(binding.getBinaryMessenger(),sensor_plugin/light);this.lightEventChannel.setStreamHandler(this);}5.3 方法调用处理asynconMethodCall(call:MethodCall,result:MethodResult):Promisevoid{switch(call.method){caseisSensorAvailable:this.isSensorAvailable(call,result);break;casegetAvailableSensors:this.getAvailableSensors(result);break;default:result.notImplemented();break;}}privateisSensorAvailable(call:MethodCall,result:MethodResult):void{consttypecall.argument(type)asnumber;constsensorIdthis.getSensorId(type);if(sensorId0){result.success(false);return;}try{constisAvailablesensor.isSensorSupported(sensorId);result.success(isAvailable);}catch(e){result.success(false);}}privategetSensorId(type:number):number{switch(type){case0:returnsensor.SensorType.ACCELEROMETER;case1:returnsensor.SensorType.GYROSCOPE;case2:returnsensor.SensorType.MAGNETIC_FIELD;case3:returnsensor.SensorType.AMBIENT_LIGHT;default:return-1;}}5.4 传感器订阅privatesubscribeAccelerometer():void{try{sensor.on(sensor.SensorType.ACCELEROMETER,(data:ESObject){if(this.accelerometerSink!null){consteventData:SensorEventData{x:data[x]??0,y:data[y]??0,z:data[z]??0,value:data[x]??0,timestamp:Date.now()};this.accelerometerSink!.success(eventData);}});}catch(e){// 处理异常}}privatesubscribeLight():void{try{sensor.on(sensor.SensorType.AMBIENT_LIGHT,(data:ESObject){if(this.lightSink!null){consteventData:SensorEventData{x:0,y:0,z:0,value:data[intensity]??0,timestamp:Date.now()};this.lightSink!.success(eventData);}});}catch(e){// 处理异常}}5.5 EventChannel回调onListen(args:ESObject,sink:EventSink):void{constchannelargs[channel]asstring;switch(channel){casesensor_plugin/accelerometer:this.accelerometerSinksink;this.subscribeAccelerometer();break;casesensor_plugin/gyroscope:this.gyroscopeSinksink;this.subscribeGyroscope();break;casesensor_plugin/magnetometer:this.magnetometerSinksink;this.subscribeMagnetometer();break;casesensor_plugin/light:this.lightSinksink;this.subscribeLight();break;}}onCancel(args:ESObject):void{constchannelargs[channel]asstring;switch(channel){casesensor_plugin/accelerometer:this.accelerometerSinknull;sensor.off(sensor.SensorType.ACCELEROMETER);break;// ... 其他传感器}}六、插件注册在EntryAbility.ets中直接注册插件import{FlutterAbility,FlutterEngine}fromohos/flutter_ohos;import{SensorPlugin}from../plugins/SensorPlugin;exportdefaultclassEntryAbilityextendsFlutterAbility{configureFlutterEngine(flutterEngine:FlutterEngine){super.configureFlutterEngine(flutterEngine)constpluginsflutterEngine.getPlugins();if(plugins!null){plugins.add(newSensorPlugin(this.context));}}}七、UI界面实现// lib/main.dartclassSensorDemoPageextendsStatefulWidget{constSensorDemoPage({super.key});overrideStateSensorDemoPagecreateState()_SensorDemoPageState();}class_SensorDemoPageStateextendsStateSensorDemoPage{SensorData?_accelerometerData;StreamSubscription?_accelerometerSubscription;bool _accelerometerEnabledfalse;void_toggleAccelerometer(bool enabled){if(enabled){_accelerometerSubscriptionSensorPlugin.accelerometerEvents().listen((data){setState(()_accelerometerDatadata);});}else{_accelerometerSubscription?.cancel();setState(()_accelerometerDatanull);}setState(()_accelerometerEnabledenabled);}overrideWidgetbuild(BuildContextcontext){returnScaffold(appBar:AppBar(title:constText(传感器数据采集)),body:ListView(children:[_buildSensorCard(title:加速度计,data:_accelerometerData,enabled:_accelerometerEnabled,onToggle:_toggleAccelerometer,unit:m/s²,),// ... 其他传感器卡片],),);}}八、权限配置在module.json5中添加传感器权限{module:{requestPermissions:[{name:ohos.permission.ACCELEROMETER},{name:ohos.permission.GYROSCOPE},{name:ohos.permission.ACTIVITY_MOTION}]}}九、实际应用场景9.1 运动健康应用// 计步器应用示例SensorPlugin.accelerometerEvents().listen((data){// 分析加速度数据检测步伐detectStep(data);});9.2 屏幕自动调节// 根据环境光调节屏幕亮度SensorPlugin.lightEvents().listen((data){if(data.value50){// 暗光环境降低亮度setScreenBrightness(0.3);}elseif(data.value500){// 强光环境提高亮度setScreenBrightness(1.0);}});9.3 指南针应用// 使用磁力计数据计算方向SensorPlugin.magnetometerEvents().listen((data){double azimuthatan2(data.y,data.x)*180/pi;updateCompassDirection(azimuth);});十、注意事项传感器可用性不同设备支持的传感器类型不同使用前需检查可用性功耗优化传感器持续运行会消耗电量不使用时应及时取消订阅数据采样率根据应用需求设置合适的采样间隔权限申请部分传感器需要用户授权才能使用主线程处理传感器回调在主线程执行避免耗时操作十一、总结本文详细介绍了Flutter鸿蒙传感器数据采集插件的开发过程包括Flutter端EventChannel数据流设计HarmonyOS传感器API的使用方法多传感器同时工作的实现方案完整的UI演示界面通过本插件开发者可以轻松获取设备传感器数据为运动健康、AR/VR、游戏等应用提供基础支持。本文为Flutter鸿蒙开发系列文章之一更多实战内容请关注后续更新。CSDN社区: https://bbs.csdn.net/forums/4f54ff014fbd4d42b72d3c5c1d3c5a4e