快應(yīng)用 后臺運行

為了節(jié)省系統(tǒng)資源，通常情況下，快應(yīng)用切換到后臺后將會暫停運行，等到再次切換回前臺時繼續(xù)運行。但音樂\運動等類型的應(yīng)用， 退到后臺后可能仍然需要繼續(xù)運行，為滿足此類需求，加入了對后臺運行的支持。后臺運行模式的工作原理如下:

在快應(yīng)用切換到后臺時，系統(tǒng)將會檢查是否滿足后臺運行的條件，如果滿足，快應(yīng)用將繼續(xù)運行，否則將被暫停。此條件包括：

1.  manifest.json 中聲明了后臺運行接口 
2. 快應(yīng)用調(diào)用 Resident 接口啟動了后臺運行模式 
3. 當前至少有一個（已在 manifest.json 中聲明的）后臺運行接口正在運行

處于后臺運行中的應(yīng)用，如果所有后臺運行接口均運行結(jié)束，系統(tǒng)將會啟動 20s 倒計時。倒計時結(jié)束后，如果仍未有后臺運行接口被調(diào)用， 快應(yīng)用將會退出后臺運行模式，暫停運行。

快應(yīng)用進入后臺運行模式后，系統(tǒng)將會在通知欄上顯示一個通知，以提示用戶此快應(yīng)用正在后臺運行。快應(yīng)用可以定制通知上的描述文案， 以告知用戶后臺工作的狀態(tài)。通知上有結(jié)束按鈕，用戶可以強制快應(yīng)用退出后臺運行模式。

實踐建議:

• 后臺運行需要消耗較多的系統(tǒng)資源，快應(yīng)用需要根據(jù)自身需求審慎使用。針對申請后臺運行的快應(yīng)用，上線審核時將會審核其后臺運行的需求是否合理。
• 后臺運行接口的導入和后臺執(zhí)行的工作放到 app.ux 中，而不是放到頁面中，以免避免頁面切換和銷毀的影響。
• 盡量提供定制的通知欄描述文案，并且文案應(yīng)準確描述后臺工作的內(nèi)容及其狀態(tài)（比如網(wǎng)盤應(yīng)用可以顯示：“備份進度 30%”），以免用戶反感。

配置方法

manifest.json 中聲明所需的后臺運行接口。后臺運行接口包括：

• 音頻播放：system.audio
• 錄音：system.record
• 上傳下載：system.request
• 地理位置：system.geolocation

{
  "package": "com.hybrid.demo.sample",
   ......

  "config": {
    "logLevel": "trace",
    "background": {
      "features":[
        "system.audio",
        "system.record",
        "system.request",
        "system.geolocation"
      ]
     }
   ......
}

Resident接口使用

詳細用法參見 Resident 腳本

接口分類

后臺運行狀態(tài)下，各接口根據(jù)限制級別的不同被分為三大類：需申請訪問、可直接訪問、禁止訪問（每個接口的文檔上均附有本接口的限制級別）。

1. 需申請訪問的接口
   此部分接口需要在 manifest.json 的 background 中聲明后才能在后臺運行狀態(tài)中使用，并且只有在調(diào)用了如下幾個接口中的方法時，快應(yīng)用才可以進入后臺運行狀態(tài)。 例如：音頻（system.audio），　錄音（system.record），上傳下載（system.request），地理位置（ system.geolocation ）等。
2. 可直接訪問的接口
   此部分接口可以在后臺運行狀態(tài)下直接使用。 例如：應(yīng)用上下文（ system.app ），日志打印（ console ），通知消息（ system.notification ），數(shù)據(jù)請求（ system.fetch ）等。
3. 禁止訪問的接口
   在后臺運行狀態(tài)下，如下接口禁止訪問（如果訪問將返回804錯誤）。 例如：頁面路由（ system.router ），分享（ system.share ），彈窗（ system.prompt ），打開網(wǎng)頁（ system.webview ）等

通知提示

如果使用 Audio 接口并且在通知欄顯示了音頻播放狀態(tài)，將不會再顯示后臺運行通知；

如果只使用除 Audio 外的其它后臺運行接口，快應(yīng)用進入后臺狀態(tài)后，通知欄會顯示如下提示（描述信息可通過 resident 中 startResident 接口進行修改，默認不顯示）：