HarmonyOS鸿蒙Next应用实现手机摇一摇功能，请提供详细步骤和源码

鸿蒙应用实现手机摇一摇功能，请提供详细步骤和源码

1. 实现原理

在鸿蒙应用中，可以通过加速度传感器来检测手机的摇晃动作。当用户在短时间内快速摇晃手机时，加速度传感器会检测到加速度的快速变化，从而触发摇一摇事件。

2. 开发步骤

2.1 创建新项目

1. 打开DevEco Studio
2. 选择"Create HarmonyOS Project"
3. 选择"Empty Ability"模板
4. 配置项目名称、包名等信息

2.2 配置权限

在config.json文件中添加传感器权限：

{
  "module": {
    "reqPermissions": [
      {
        "name": "ohos.permission.ACCELEROMETER"
      }
    ]
  }
}

2.3 创建摇一摇工具类

package com.example.shakedemo.utils;

import ohos.hiviewdfx.HiLog;
import ohos.hiviewdfx.HiLogLabel;
import ohos.sensor.agent.CategoryOrientationAgent;
import ohos.sensor.bean.SensorBean;
import ohos.sensor.listener.ICategoryOrientationDataCallback;

import java.util.List;

public class ShakeDetector {
    private static final HiLogLabel LABEL = new HiLogLabel(HiLog.LOG_APP, 0x00201, "ShakeDetector");
    
    // 传感器代理
    private CategoryOrientationAgent orientationAgent;
    
    // 回调接口
    private OnShakeListener onShakeListener;
    
    // 上次检测时间
    private long lastUpdateTime;
    
    // 上次的加速度值
    private float lastX, lastY, lastZ;
    
    // 阈值
    private static final int SHAKE_THRESHOLD = 2000;
    private static final int UPDATE_INTERVAL = 100;
    
    public interface OnShakeListener {
        void onShake();
    }
    
    public ShakeDetector() {
        orientationAgent = new CategoryOrientationAgent();
    }
    
    public void setOnShakeListener(OnShakeListener listener) {
        this.onShakeListener = listener;
    }
    
    public void start() {
        List<SensorBean> sensorList = orientationAgent.getAllSensors();
        if (sensorList.isEmpty()) {
            HiLog.error(LABEL, "No orientation sensor found");
            return;
        }
        
        int sensorId = sensorList.get(0).getSensorId();
        
        ICategoryOrientationDataCallback callback = new ICategoryOrientationDataCallback() {
            @Override
            public void onSensorDataModified(CategoryOrientationAgent.CategoryOrientationData data) {
                detectShake(data.values);
            }
            
            @Override
            public void onAccuracyDataModified(CategoryOrientationAgent.CategoryOrientationData data, int accuracy) {
                // 精度变化处理
            }
            
            @Override
            public void onCommandCompleted(CategoryOrientationAgent.CategoryOrientationData data) {
                // 命令完成处理
            }
        };
        
        orientationAgent.setSensorDataCallback(callback, sensorId, CategoryOrientationAgent.SENSOR_SAMPLE_RATE_FASTEST);
    }
    
    public void stop() {
        orientationAgent.releaseSensorDataCallback();
    }
    
    private void detectShake(float[] values) {
        long currentTime = System.currentTimeMillis();
        long timeInterval = currentTime - lastUpdateTime;
        
        if (timeInterval < UPDATE_INTERVAL) {
            return;
        }
        
        lastUpdateTime = currentTime;
        
        float x = values[0];
        float y = values[1];
        float z = values[2];
        
        float deltaX = x - lastX;
        float deltaY = y - lastY;
        float deltaZ = z - lastZ;
        
        lastX = x;
        lastY = y;
        lastZ = z;
        
        double speed = Math.sqrt(deltaX * deltaX + deltaY * deltaY + deltaZ * deltaZ) / timeInterval * 10000;
        
        if (speed > SHAKE_THRESHOLD) {
            if (onShakeListener != null) {
                onShakeListener.onShake();
            }
        }
    }
}

2.4 在主页面中使用

package com.example.shakedemo.slice;

import com.example.shakedemo.ResourceTable;
import com.example.shakedemo.utils.ShakeDetector;
import ohos.aafwk.ability.AbilitySlice;
import ohos.aafwk.content.Intent;
import ohos.agp.components.Text;
import ohos.hiviewdfx.HiLog;
import ohos.hiviewdfx.HiLogLabel;

public class MainAbilitySlice extends AbilitySlice {
    private static final HiLogLabel LABEL = new HiLogLabel(HiLog.LOG_APP, 0x00201, "MainAbilitySlice");
    
    private Text shakeText;
    private ShakeDetector shakeDetector;
    
    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        super.setUIContent(ResourceTable.Layout_ability_main);
        
        initComponents();
        initShakeDetector();
    }
    
    private void initComponents() {
        shakeText = (Text) findComponentById(ResourceTable.Id_shake_text);
    }
    
    private void initShakeDetector() {
        shakeDetector = new ShakeDetector();
        shakeDetector.setOnShakeListener(() -> {
            getUITaskDispatcher().asyncDispatch(() -> {
                shakeText.setText("检测到摇一摇动作！");
                HiLog.info(LABEL, "Shake detected!");
                
                // 3秒后恢复原文本
                getUITaskDispatcher().delayDispatch(() -> {
                    shakeText.setText("请摇晃手机");
                }, 3000);
            });
        });
    }
    
    @Override
    protected void onActive() {
        super.onActive();
        shakeDetector.start();
        shakeText.setText("请摇晃手机");
    }
    
    @Override
    protected void onInactive() {
        super.onInactive();
        shakeDetector.stop();
    }
    
    @Override
    protected void onBackground() {
        super.onBackground();
        shakeDetector.stop();
    }
}

2.5 布局文件

在resources/base/layout/ability_main.xml中添加：

<?xml version="1.0" encoding="utf-8"?>
<DirectionalLayout
    xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:width="match_parent"
    ohos:height="match_parent"
    ohos:alignment="center"
    ohos:orientation="vertical">
    
    <Text
        ohos:id="$+id:shake_text"
        ohos:width="match_content"
        ohos:height="match_content"
        ohos:text="请摇晃手机"
        ohos:text_size="24fp"
        ohos:text_alignment="center"
        ohos:margin="20vp"/>
        
</DirectionalLayout>

3. 关键点说明

3.1 传感器权限

必须先在config.json中声明加速度传感器权限，否则无法获取传感器数据。

3.2 传感器回调

通过ICategoryOrientationDataCallback接口接收传感器数据，在onSensorDataModified方法中处理加速度数据。

3.3 摇动检测算法

通过计算三个方向加速度的变化率来判断是否发生摇动。当变化率超过设定的阈值时，触发摇一摇事件。

3.4 性能优化

• 设置合适的数据采样率
• 添加时间间隔检测，避免频繁处理
• 在页面不可见时停止传感器监听

4. 扩展功能建议

1. 灵敏度调节：可以添加设置界面，让用户调节摇动灵敏度
2. 声音反馈：摇动时播放提示音
3. 振动反馈：摇动时触发手机振动
4. 防误触：添加时间间隔限制，避免连续触发

5. 注意事项

1. 确保在真机上测试，模拟器可能无法模拟传感器数据
2. 注意权限申请流程
3. 及时释放传感器资源，避免电量消耗
4. 考虑不同设备的传感器差异

以上代码提供了完整的鸿蒙应用摇一摇功能实现，可以直接在项目中集成使用。