快應(yīng)用 后臺(tái)運(yùn)行

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

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

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

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

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

實(shí)踐建議:

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

配置方法

manifest.json 中聲明所需的后臺(tái)運(yùn)行接口。后臺(tái)運(yùn)行接口包括：

• 音頻播放：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接口使用

詳細(xì)用法參見(jiàn) Resident 腳本

接口分類(lèi)

后臺(tái)運(yùn)行狀態(tài)下，各接口根據(jù)限制級(jí)別的不同被分為三大類(lèi)：需申請(qǐng)?jiān)L問(wèn)、可直接訪問(wèn)、禁止訪問(wèn)（每個(gè)接口的文檔上均附有本接口的限制級(jí)別）。

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

通知提示

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

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