传感器<SensorBinder>-适配功能-基础功能-HarmonyOS 4.X及以下版本主题引擎规范-主题引擎-开发教程-主题中心

功能概述

支持获取四种类型的传感器数据，即加速传感器（accelerometer）、重力传感器（gravity）、线性加速传感器（linearAccelerometer）和陀螺仪（gyroscope）。其中，加速传感器获取的值是线性加速度传感器与重力传感器相加得到的结果，即：加速度(accelerometer) = 线性加速度（linearAccelerometer）+ 重力加速度（gravity）。基于传感器功能，可实现重力感应和摇一摇等效果。

说明

manifest.xml文件中只能有一个VariableBinders和SensorBinder。需要根据应用场景来选择合适的传感器类型，例如：实现重力感应效果时推荐使用accelerometer。

应用场景

可用于荡秋千，摆钟摆动。
可用于游戏场景，比如足球入门。
摇晃手机时，可用于叶子掉落，花瓣落下等。

XML规范

收起
自动换行
深色代码主题
复制
<VariableBinders> 
    <SensorBinder type="" vibrate="" shakeTime="" delay="">
        <Variable name="" index=""/>  
        <Variable name="" index=""/> 
        <Variable name="" index=""/> 
    </SensorBinder> 
</VariableBinders>

参数说明

<SensorBinder>

展开

参数	类型	选项	注释
type	字符串	必填	支持：accelerometer、gravity、linearAccelerometer和gyroscope四种类型
vibrate	数值	选填	摇一摇是否触发震动，取值0/1。0表示不触发震动，1表示触发震动。默认为0，支持表达式
shakeTime	数值	选填	摇一摇触发震动的震动时长，单位为ms，默认为0，支持表达式
delay	数值	选填	摇一摇触发震动的延时时间，单位为ms，默认为0，支持表达式

<Variable>

展开

参数	类型	选项	注释
index	数值	必填	用于标识传感器某个特定方向，取值为0,1,2；具体含义参考下文表格中的解释说明
name	字符串	必填	变量名，用于记录传感器在对应index方向上的值，在使用时可通过#name获取该变量的值

不同类型传感器index解释说明：

展开

传感器类型	index取值	注释
accelerometer	0，1，2	index=0、1、2分别表示x、y、z方向的加速度
gravity	0，1，2	index=0、1、2分别表示x、y、z方向的重力加速度
linearAccelerometer	0，1，2	index=0、1、2分别表示x、y、z方向的线性加速度
gyroscope	0，1，2	index=0、1、2分别表示x、y、z方向的角速度

应用示例

示例一：用获取的重力传感器值来控制DropPhysicalView中雪花飘落的方向和速度。由于重力传感器x轴正方向为水平向左，与手机屏幕x轴正方向相反，所以x_gra的值需要设置负号，使其与手机偏移方向一致。当手机偏移的时候，雪花下落会朝向重力传感器的方向。

收起
自动换行
深色代码主题
复制
<VariableBinders>
    <SensorBinder type="gravity">
        <Variable name="x_gra" index="0"/>
        <Variable name="y_gra" index="1"/>
        <Variable name="z_gra" index="2"/>
    </SensorBinder>
</VariableBinders>
<DropPhysicalView gravityX="-#x_gra" gravityY="#y_gra" airDensity="50">
    <ItemGroup x="0" y="0" width="#screen_width" height="#screen_height">
        <Item count="40" src="xuehua.png">
            <Velocity isRandom="true" velocityX="0" velocityY="5"/>
            <Position isRandom="true"/>
            <AngleVelocity isRandom="true" angleVelocity="10"/>
            <weight isRandom="true" value="0.5"/>
        </Item>
    <ItemGroup/>
</DropPhysicalView>

示例二：基于加速传感器实现重力感应，type设置为accelerometer加速传感器类型。在SensorBinder中获取各个方向的加速度值后，在Image中使用x_acc和y_acc来控制图片的x和y坐标，进而达到重力感应效果。注意：可以调节x_acc和y_acc的符号以及相乘系数来控制图片移动方向和移动幅度大小。

收起
自动换行
深色代码主题
复制
<VariableBinders>
     <SensorBinder type="accelerometer">
          <Variable name="x_acc" index="0"/>
          <Variable name="y_acc" index="1"/>
          <Variable name="z_acc" index="2"/>
     </SensorBinder>
</VariableBinders>
<Image x="610+#x_acc*12" y="390-#y_acc*12" centerX="139" centerY="151" src="ty.png"/>