菊廠程式設計師每天輕鬆跟練劉畊巨集健身操,到底怎麼做到的?

HMSCore發表於2022-05-31

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

私教都拉不回的運動自律,被劉畊巨集的一套毽子操拉回來了。最近程式設計師阿強也在女友的打卡帶動下,跟著劉教練開啟了在家健身模式,線上與千萬網友隔空同頻共振,阿強表示,終於找到快樂運動的正確開啟方式。
阿強切身體會了居家健身需求的興起,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)開始獲取實時運動資料

  1. 呼叫 HiHealthDataStore 物件的 registerSportData 方法,開始獲取實時運動資料。
  2. 通過請求引數 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)開始運動

開始和結束運動支援的運動型別常量

  1. 呼叫 HiHealthDataStore 物件的 startSport 方法,啟動相應型別的運動。
  2. 通過請求引數 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)結束運動:

  1. 呼叫 HiHealthDataStore 物件的 stopSport 方法,停止相應型別的運動。
  2. 通過請求引數 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)停止獲取實時運動資料:

  1. 呼叫 HiHealthDataStore 物件的 unregisterSportData 方法,停止獲取實時運動資料。
  2. 通過請求引數 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));
            }
        }
     }
 });

點此查詢資料所需引數及查詢結果

瞭解更多詳情>>

訪問華為開發者聯盟官網
獲取開發指導文件
華為移動服務開源倉庫地址:GitHubGitee

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

相關文章