你在鍛鍊健身時，有沒有遇到這樣的情況？辛辛苦苦鍛鍊了幾小時，卻發現App停止了執行，本次運動並沒有被記錄到App上，從而失去了一個檢視完整運動資料的機會？

運動類App是透過手機或者穿戴裝置的感測器，來識別運動狀態並反饋給使用者的，App能否在手機後臺時刻保持執行是影響運動資料完整性的關鍵因素。為了滿足使用者檢視完整運動資料的需求，運動類App都希望在裝置後臺保活，並透過感測器實時記錄使用者的運動資料。但大部分手機廠商為了節省電量，一旦應用處於後臺就會被系統限制甚至強制關閉，導致最終呈現給使用者的運動記錄不完整。

運動類App要想實現端側後臺保活，目前通常有兩種解決辦法：

1.引導使用者在手機上手動設定保活，如關閉電池最佳化，允許App後臺執行。這種方法缺點在於操作步驟較複雜，使用者學習成本較高。

2.可以透過整合[華為運動健康服務](https://developer.huawei.com/consumer/cn/hms/huaweihealth/?ha_source=hms1)來解決此問題，運動健康服務提供支援後臺保活的運動記錄API，整合該能力後應用能夠在使用者的鍛鍊過程中在華為手機後臺保持執行，從而實現使用者鍛鍊過程中的運動記錄不間斷。

那如何實現後臺保活功能呢？以下是詳細的整合步驟。

**整合步驟**

1.請參考[開發準備](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/apply-id-0000001050069756?ha_source=hms1)完成申請Health Kit服務，勾選產品必需申請的資料許可權並整合SDK。

2.呼叫後臺保活功能需申請運動記錄讀取許可權，再[獲取使用者授權](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/add-permissions-0000001050069726?ha_source=hms1)完成許可權申請。

3.為保證您的應用不被系統凍結，需要開啟一個前臺服務Foreground services，在前臺服務中呼叫ActivityRecordsController方法建立允許後臺執行的運動記錄；

4.呼叫ActivityRecordsController的beginActivityRecord介面開始允許後臺執行的運動記錄，預設會申請允許應用後臺執行時長10分鐘；

```
// 請注意此處的this為Activity物件
ActivityRecordsController activityRecordsController = HuaweiHiHealth.getActivityRecordsController(this);

// 1.構造新運動記錄開始時間
long startTime = Calendar.getInstance().getTimeInMillis(); 
// 2.構造ActivityRecord物件，設定運動記錄開始時間 
ActivityRecord activityRecord = new ActivityRecord.Builder() 
    .setId("MyBeginActivityRecordId") 
    .setName("BeginActivityRecord") 
    .setDesc("This is ActivityRecord begin test!") 
    .setActivityTypeId(HiHealthActivities.RUNNING) 
    .setStartTime(startTime, TimeUnit.MILLISECONDS) 
    .build();

// 3.構建應用運動記錄執行中展示的頁面, MyActivity需替換成自身的Activity類
ComponentName componentName = new ComponentName(this, MyActivity.class);

// 4.構建運動記錄後臺執行狀態變化監聽器
OnActivityRecordListener activityRecordListener = new OnActivityRecordListener() {
    @Override
    public void onStatusChange(int statusCode) {
        Log.i("ActivityRecords", "onStatusChange statusCode:" + statusCode);
    }
};

// 5.呼叫啟動新運動記錄API介面beginActivityRecord
Task<void> task1 = activityRecordsController.beginActivityRecord(activityRecord, componentName, activityRecordListener); 
// 6.新增啟動ActivityRecord成功 
task1.addOnSuccessListener(new OnSuccessListener<void>() { 
    @Override 
    public void onSuccess(Void aVoid) { 
        Log.i("ActivityRecords", "MyActivityRecord begin success"); 
    } 
// 7.新增啟動ActivityRecord失敗
}).addOnFailureListener(new OnFailureListener() { 
    @Override 
    public void onFailure(Exception e) { 
        String errorCode = e.getMessage(); 
        String errorMsg = HiHealthStatusCodes.getStatusCodeMessage(Integer.parseInt(errorCode)); 
        Log.i("ActivityRecords", errorCode + ": " + errorMsg); 
    } 
});
```

5.若使用者運動時間較長，每臨近10分鐘（小於10分鐘）需呼叫ActivityRecordsController的continueActivityRecord介面續申請後臺保活10分鐘；

```
// 請注意此處的this為Activity物件
ActivityRecordsController activityRecordsController = HuaweiHiHealth.getActivityRecordsController(this);

// 呼叫continueActivityRecord方法為指定運動記錄續申請允許後臺執行，入參為ActivityRecord的ID字串 
Task<void> endTask = activityRecordsController.continueActivityRecord("MyBeginActivityRecordId");
endTask.addOnSuccessListener(new OnSuccessListener<void>() {
    @Override
    public void onSuccess(Void aVoid) {
        Log.i("ActivityRecords", "continue backgroundActivityRecord was successful!");
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(Exception e) {
        Log.i("ActivityRecords", "continue backgroundActivityRecord error");
    }
});
```

6.當使用者運動結束時，呼叫ActivityRecordsController的endActivityRecord介面停止該運動記錄，同時取消應用後臺保活；

```
// 請注意此處的this為Activity物件
final ActivityRecordsController activityRecordsController = HuaweiHiHealth.getActivityRecordsController(this);

// 呼叫endActivityRecord介面停止運動記錄，入參為ActivityRecord的ID字串或者null
// 入參為ID字串時，停止當前應用指定ID的運動記錄
// 入參為null時，停止該應用當前所有的未停止運動記錄
Task<list>> endTask = activityRecordsController.endActivityRecord("MyBeginActivityRecordId");
endTask.addOnSuccessListener(new OnSuccessListener<list>>() {
    @Override
    public void onSuccess(List<activityrecord> activityRecords) {
        Log.i("ActivityRecords","MyActivityRecord End success");
        // 返回停止成功的運動記錄列表
        if (activityRecords.size() > 0) {
            for (ActivityRecord activityRecord : activityRecords) {
                DateFormat dateFormat = DateFormat.getDateInstance();
                DateFormat timeFormat = DateFormat.getTimeInstance();
                Log.i("ActivityRecords", "Returned for ActivityRecord: " + activityRecord.getName() + "\n\tActivityRecord Identifier is "
                    + activityRecord.getId() + "\n\tActivityRecord created by app is " + activityRecord.getPackageName()
                    + "\n\tDescription: " + activityRecord.getDesc() + "\n\tStart: "
                    + dateFormat.format(activityRecord.getStartTime(TimeUnit.MILLISECONDS)) + " "
                    + timeFormat.format(activityRecord.getStartTime(TimeUnit.MILLISECONDS)) + "\n\tEnd: "
                    + dateFormat.format(activityRecord.getEndTime(TimeUnit.MILLISECONDS)) + " "
                    + timeFormat.format(activityRecord.getEndTime(TimeUnit.MILLISECONDS)) + "\n\tActivity:"
                    + activityRecord.getActivityType());
            }
        } else {
            // 沒有停止成功返回null
            Log.i("ActivityRecords","MyActivityRecord End response is null");
        }
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(Exception e) {
        String errorCode = e.getMessage();
        String errorMsg = HiHealthStatusCodes.getStatusCodeMessage(Integer.parseInt(errorCode));
        Log.i("ActivityRecords",errorCode + ": " + errorMsg);
    }
});
```

需要注意的是，由於端側後臺保活API屬於敏感許可權，運動類應用接入時需進行人工稽核，確保資料安全、流程合規才能上架。

獲取[端側後臺保活能力開發文件](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/activityrecord-develop-0000001050069730#section1717012318910?ha_source=hms1)

華為[運動健康場景解決方案](https://developer.huawei.com/consumer/cn/solution/hms/healthandfitness/?ha_source=hms1)

**瞭解更多詳情>>**

訪問[華為開發者聯盟官網](http://developer.huawei.com/consumer/cn/hms?ha_source=hms1)  
獲取[開發指導文件](http://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1)  
華為移動服務開源倉庫地址：[GitHub](http://github.com/HMS-Core)、[Gitee](http://gitee.com/hms-core)

**關注我們，第一時間瞭解 HMS Core 最新技術資訊~**</activityrecord></list></list></void></void></void></void>

運動App如何實現端側後臺保活，讓運動記錄更完整？

相關文章