菊廠程式員每天輕鬆跟練劉畊巨集健身操，到底怎麼做到的？

健身房不開，國民“運動量”卻爆髮式上漲。私教都拉不回的運動自律，被劉畊巨集的一套毽子操拉回來了。最近程式員阿強也在女友的打卡帶動下，跟著劉教練開啟了在家健身模式，線上與千萬網友隔空同頻共振，阿強表示，終於找到快樂運動的正確打開方式。阿強切身體會了居家健身需求的興起，BUT，其不足之處也漸漸浮現。 ...

健身房不開，國民“運動量”卻爆髮式上漲。

私教都拉不回的運動自律，被劉畊巨集的一套毽子操拉回來了。最近程式員阿強也在女友的打卡帶動下，跟著劉教練開啟了在家健身模式，線上與千萬網友隔空同頻共振，阿強表示，終於找到快樂運動的正確打開方式。
阿強切身體會了居家健身需求的興起，BUT，其不足之處也漸漸浮現。

線上跟學，一套動作，統一的節奏無法適配每一個人的身體狀態…長期不運動或運動量小的同學，習慣了peace模式的身體驟然接受大開大合、耗時不短的健身操，健身熱情跟得上，身體和心臟也跟不上，所以，在家健身的男生女生們，需要一個貼身運動健康管家來實時監控運動狀況！

收到內心發來的開發需求，阿強說乾就乾，使用HMS Core的運動健康服務能力，打造了一個運動管家App，開始運動後，實時監控運動時間、消耗的卡路里、心率等健康數據，幫助調整運動狀態。

Demo示例

關於華為運動健康服務（HUAWEI Health Kit）

運動健康服務分為基礎能力服務和擴展能力服務。

基礎能力服務：Health Kit基礎能力提供原子化數據開放，在獲取用戶對數據的授權後，應用通過介面訪問運動健康數據，對用戶數據進行增、刪、改、查等操作，為用戶提供運動健康類數據服務。

擴展能力服務： Health Kit擴展能力服務開放更多實時運動和健康數據、運動和健康解決方案場景化數據。

運動管家App相關能力則是基於Health Kit拓展能力中的功能進行開發。

開發流程

1、開發環境要求

Android 平臺的要求

安裝Android Studio 3.X及以上

JDK 1.8.211及以上

應用應滿足以下條件

minSdkVersion 24

targetSdkVersion 29

compileSdkVersion 29

Gradle 4.6及以上

測試應用的設備要求Android 6.0 及以上版本且裝有華為運動健康App的華為手機。

2、開發步驟

完整的開發流程如下。

3、開始運動和停止運動功能實現

控制運動和獲取實時運動配合使用順序一般為：

（1）registerSportData，開始獲取實時運動數據。

（2）startSport，開始運動。

（3）stopSport，停止運動。

（4）unregisterSportData，停止獲取實時運動數據。

關鍵代碼步驟

（1）開始獲取實時運動數據

調用 HiHealthDataStore 對象的 registerSportData 方法，開始獲取實時運動數據。
通過請求參數 HiSportDataCallback 對象，返回查詢結果，結果中數據類型參考實時運動 Bundle 對象鍵值。

HiHealthDataStore.registerSportData(context, new HiSportDataCallback() {
    @Override
    public void onResult(int resultCode) {
        // 介面調用結果 
        Log.i(TAG, "registerSportData onResult resultCode:" + resultCode);
    }

    @Override
    public void onDataChanged(int state, Bundle bundle) {
        // 實時數據變化回調        
        Log.i(TAG, "registerSportData onChange state: " + state);        
        StringBuffer stringBuffer = new StringBuffer("");              
        if (state == HiHealthKitConstant.SPORT_STATUS_RUNNING) {
            Log.i(TAG, "heart rate : " + bundle.getInt(HiHealthKitConstant.BUNDLE_KEY_HEARTRATE));
            Log.i(TAG, "distance : " + bundle.getInt(HiHealthKitConstant.BUNDLE_KEY_DISTANCE));
            Log.i(TAG, "duration : " + bundle.getInt(HiHealthKitConstant.BUNDLE_KEY_DURATION));
            Log.i(TAG, "calorie : " + bundle.getInt(HiHealthKitConstant.BUNDLE_KEY_CALORIE));
            Log.i(TAG, "totalSteps : " + bundle.getInt(HiHealthKitConstant.BUNDLE_KEY_TOTAL_STEPS));
            Log.i(TAG, "totalCreep : " + bundle.getInt(HiHealthKitConstant.BUNDLE_KEY_TOTAL_CREEP));
            Log.i(TAG, "totalDescent : " + bundle.getInt(HiHealthKitConstant.BUNDLE_KEY_TOTAL_DESCENT));
        }        
    }
});

（2）開始運動

開始和結束運動支持的運動類型常量

調用 HiHealthDataStore 對象的 startSport 方法，啟動相應類型的運動。
通過請求參數 ResultCallback 對象，返回查詢結果。

// 室外跑步
int sportType = HiHealthKitConstant.SPORT_TYPE_RUN;
HiHealthDataStore.startSport(context, sportType, new ResultCallback() {
    @Override
    public void onResult(int resultCode, Object message) {
        if (resultCode == HiHealthError.SUCCESS) {
            Log.i(TAG, "start sport success");
        }
    }
});

（3）結束運動：

調用 HiHealthDataStore 對象的 stopSport 方法，停止相應類型的運動。
通過請求參數 ResultCallback 對象，返回查詢結果。

HiHealthDataStore.stopSport(context, new ResultCallback() {
    @Override
    public void onResult(int resultCode, Object message) {
        if (resultCode == HiHealthError.SUCCESS) {
            Log.i(TAG, "stop sport success");
        }
    }
});

（4）停止獲取實時運動數據：

調用 HiHealthDataStore 對象的 unregisterSportData 方法，停止獲取實時運動數據。
通過請求參數 HiSportDataCallback 對象，返回查詢結果。

HiHealthDataStore.unregisterSportData(context, new HiSportDataCallback() {
    @Override
    public void onResult(int resultCode) {
        // 介面調用結果
        Log.i(TAG, "unregisterSportData onResult resultCode:" + resultCode);
    }

    @Override
    public void onDataChanged(int state, Bundle bundle) {
        // 此時不會被調用
    }
});

4、今日活動量查詢功能實現

查詢每日活動量，包含步數統計、步數詳情、距離、熱量及運動中高強度，這部分數據來源於手機或華為穿戴設備，需先申請開通許可權，並獲取用戶授權，否則介面將調用失敗。所需許可權點此查詢。

（1）使用 execQuery 介面查詢用戶每日活動量

1、調用 HiHealthDataStore 對象的 execQuery 方法，查詢用戶每日活動量。

2、通過請求參數 ResultCallback 對象，返回查詢結果。

步數統計為例：

int timeout = 0;
// 查詢當天步數
Calendar currentDate = Calendar.getInstance();
currentDate.set(Calendar.HOUR_OF_DAY, 0);
currentDate.set(Calendar.MINUTE, 0);
currentDate.set(Calendar.SECOND, 0);
long startTime = currentDate.getTimeInMillis();
long endTime = System.currentTimeMillis();
// 查詢步數
HiHealthDataQuery hiHealthDataQuery = new HiHealthDataQuery(HiHealthPointType.DATA_POINT_STEP_SUM, startTime,
        endTime, new HiHealthDataQueryOption());
HiHealthDataStore.execQuery(context, hiHealthDataQuery, timeout, new ResultCallback() {
    @Override
    public void onResult(int resultCode, Object data) {
        Log.i(TAG, "query steps resultCode: " + resultCode);
        if (resultCode == HiHealthError.SUCCESS && data instanceof List) {
            List dataList = (ArrayList) data;
            for (Object obj : dataList) {
                HiHealthPointData pointData = (HiHealthPointData) obj;
                Log.i(TAG, "start time : " + pointData.getStartTime());
                Log.i(TAG, "query steps : " + String.valueOf(pointData.getValue()));
            }
        }
    }
});

查詢數據所需參數及查詢結果：

5、運動記錄查詢

查詢30天內運動記錄代碼示例：

1、調用 HiHealthDataStore 對象的 execQuery 方法，查詢用戶運動記錄。

2、通過請求參數 ResultCallback 對象，返回查詢結果。

int timeout = 0;
 long endTime = System.currentTimeMillis();
 // 查詢時間範圍 : 30 天
 long startTime = endTime - 1000 * 60 * 60 * 24 * 30L;
 // 查詢跑步記錄
 HiHealthDataQuery hiHealthDataQuery = new HiHealthDataQuery(HiHealthSetType.DATA_SET_RUN_METADATA, startTime,
         endTime, new HiHealthDataQueryOption());
 HiHealthDataStore.execQuery(context, hiHealthDataQuery, timeout, new ResultCallback() {
     @Override
     public void onResult(int resultCode, Object data) {
if (resultCode == HiHealthError.SUCCESS && data instanceof List){ 
            List dataList = (List) data;
            for (Object obj : dataList) {
                HiHealthSetData hiHealthData = (HiHealthSetData) obj;
                Map map = hiHealthData.getMap();
                Log.i(TAG, "start time : " + hiHealthData.getStartTime());
                Log.i(TAG, "total_time : " +  map.get(HiHealthKitConstant.BUNDLE_KEY_TOTAL_TIME));
                Log.i(TAG, "total_distance : " + map.get(HiHealthKitConstant.BUNDLE_KEY_TOTAL_DISTANCE));
                Log.i(TAG, "total_calories : " + map.get(HiHealthKitConstant.BUNDLE_KEY_TOTAL_CALORIES));
                Log.i(TAG, "step : " + map.get(HiHealthKitConstant.BUNDLE_KEY_STEP));
                Log.i(TAG, "average_pace : " + map.get(HiHealthKitConstant.BUNDLE_KEY_AVERAGEPACE));
                Log.i(TAG, "average_speed : " + map.get(HiHealthKitConstant.BUNDLE_KEY_AVERAGE_SPEED));
                Log.i(TAG, "average_step_rate : " + map.get(HiHealthKitConstant.BUNDLE_KEY_AVERAGE_STEP_RATE));
                Log.i(TAG, "step_distance : " + map.get(HiHealthKitConstant.BUNDLE_KEY_STEP_DISTANCE));
                Log.i(TAG, "average_heart_rate : " + map.get(HiHealthKitConstant.BUNDLE_KEY_AVERAGE_HEART_RATE));
                Log.i(TAG, "total_altitude : " + map.get(HiHealthKitConstant.BUNDLE_KEY_TOTAL_ALTITUDE));
                Log.i(TAG, "total_descent : " + map.get(HiHealthKitConstant.BUNDLE_KEY_TOTALDESCENT));
                Log.i(TAG, "data source : " + map.get(HiHealthKitConstant.BUNDLE_KEY_DATA_SOURCE));
            }
        }
     }
 });

點此查詢數據所需參數及查詢結果

瞭解更多詳情>>

訪問華為開發者聯盟官網
獲取開髮指導文檔
華為移動服務開源倉庫地址：GitHub、Gitee

關註我們，第一時間瞭解 HMS Core 最新技術資訊~