必須提供前景服務類型

為了協助開發人員更明確地定義面向使用者的前景服務,Android 10 在 <service> 元素中導入了 android:foregroundServiceType 屬性。

如果您的應用程式指定 Android 14 為目標,則必須指定適當的前景服務類型。與先前的 Android 版本相同,開發人員可以將多種類型合併使用。這份清單列出可供選擇的前景服務類型:

如果應用程式的用途與上述任一類型無關,強烈建議您遷移邏輯,以便使用 WorkManager使用者啟動的資料移轉作業

Android 14 新增 health, remoteMessaging, shortService, specialUsesystemExempted 類型。

以下程式碼片段提供資訊清單中的前景服務類型宣告範例:

<manifest ...>
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
    <application ...>
      <service
          android:name=".MyMediaPlaybackService"
          android:foregroundServiceType="mediaPlayback"
          android:exported="false">
      </service>
    </application>
</manifest>

如果以 Android 14 為目標的應用程式未在資訊清單中定義特定服務類型,則系統將會在呼叫該服務的 startForeground() 時提高 MissingForegroundServiceTypeException

宣告使用前景服務類型的新權限

如果以 Android 14 為目標版本的應用程式使用前景服務,則必須依據前景服務類型宣告 Android 14 的特定權限。本頁「預期用途和強制執行各種前景服務類型」小節中的「您必須在資訊清單檔案中宣告的權限」提供此類權限的說明。

所有權限都會定義為一般權限,系統也將依預設授予這些權限。使用者無法撤銷這些權限。

在執行階段加入前景服務類型

啟動前景服務應用程式的最佳做法是使用 startForeground() 超載版本;在此版本中,您會傳入以位元為單位的前景服務類型整數。您可以選擇傳送一或多個類型值。

一般而言,您只需要宣告特定用途所需的類型。如此可更容易達成系統對每一個前景服務類型的預期要求。如果前景服務是透過多種類型啟動,則前景服務必須遵循所有類型的平台強制執行要求。

不過,如果啟動使用以下任一類型的前景服務,則每次呼叫 startForeground() 啟用該服務時,應一律納入該類型:

Service.startForeground(0, notification, FOREGROUND_SERVICE_TYPE_LOCATION)

如未在呼叫中指定前景服務類型,則該類型會預設為資訊清單中所定義的值。

系統執行階段檢查

系統會檢查前景服務類型的使用是否恰當,並確認應用程式已要求合適的執行階段權限,或使用必要的 API。例如,系統會預期使用 FOREGROUND_SERVICE_TYPE_LOCATION 前景服務類型的應用程式要求 ACCESS_COARSE_LOCATIONACCESS_FINE_LOCATION

這表示當應用程式向使用者要求權限並啟動前景服務時,必須遵循特別明確的作業順序。應用程式必須要求並取得權限,再嘗試呼嘯嘗試呼叫 startForeground()。如果應用程式在前景服務啟動後才要求適當權限,則必須先變更此作業順序並要求權限,才能啟動前景服務。

關於平台違規處置的具體細節,請參閱本頁各前景服務類型預期用途與違規處置一節的「執行階段規定」部分。

各種前景服務類型的預期用途與違規處置

您必須在資訊清單檔案中宣告特定權限,並滿足特定執行階段要求,而且應用程式必須滿足該類型預期用途的其中一項,才能使用特定的前景服務類型。以下各節說明您必須宣告的權限、執行階段要求,以及各個類型的預期用途。

攝影機

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_CAMERA
執行階段要求
要求 CAMERA 執行階段權限
說明
繼續在背景存取相機,例如:支援多工處理的視訊通訊應用程式。

已連結的裝置

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_CONNECTED_DEVICE
執行階段要求

至少必須符合下列其中一項條件:

說明

與需要藍牙、NFC、IR、USB 或網路連線的外部裝置互動。

同步處理資料

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_DATA_SYNC
執行階段要求
說明

資料移轉作業,例如:

  • 上傳或下載資料
  • 備份與還原作業
  • 匯入或匯出作業
  • 擷取資料
  • 本機檔案處理
  • 透過網路在裝置和雲端之間轉移資料

醫療保健

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_HEALTH
執行階段要求

至少必須符合下列其中一項條件:

說明

在健身類別中,任何用於支援應用程式的長時間執行用途,例如:運動追蹤器。

位置

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_LOCATION
執行階段要求

至少要求下列其中一項執行階段權限:

說明

需要位置資訊存取權的長時間執行使用案例,如:導航和位置分享。

媒體

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_MEDIA_PLAYBACK
執行階段要求
說明
在背景中繼續播放音訊或視訊。支援 Android TV 的數位錄影 (DVR) 功能。

媒體投影

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_MEDIA_PROJECTION
執行階段要求
呼叫 createScreenCaptureIntent() 方法。
說明
使用 MediaProjection API 將內容投影到非主要螢幕或外部裝置。此類內容不侷限於媒體內容。不包括 Cast SDK

麥克風

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_MICROPHONE
執行階段要求
要求 RECORD_AUDIO 執行階段權限。
說明
繼續從背景擷取麥克風,如:錄音工具或通訊應用程式。

語音通話

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_PHONE_CALL
執行階段要求
在資訊清單檔案中宣告 MANAGE_OWN_CALLS 權限。
說明
使用 ConnectionService API 繼續目前的通話。

遠端通訊

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_REMOTE_MESSAGING
執行階段要求
說明
在裝置之間轉移簡訊。協助使用者在切換裝置時,繼續編輯訊息。

短程服務

您必須在資訊清單檔案中宣告的權限
執行階段要求
說明

迅速完成無法被中斷或延遲的重大工作。

此類型具備若干獨特特性:

  • 只能執行一小段時間 (約 3 分鐘)。
  • 不支援固定式前景服務。
  • 無法啟動其他前景服務。
  • 雖然不需要特定類型的權限,但仍需有 FOREGROUND_SERVICE 權限。
  • 執行中的前景服務無法變更為 shortService 類型,或由該類型變更。

shortService 的逾時時間是從呼叫 Service.startForeground() 的那一刻算起。應用程式預計會在逾時前呼叫 Service.stopSelf()Service.stopForeground()。否則的話,系統便會呼叫新的 Service.onTimeout(),讓應用程式有空檔呼叫 stopSelf()stopForeground() 以停止服務。

呼叫 Service.onTimeout() 後不久,應用程式就會進入快取狀態,除非使用者積極與應用程式互動,否則該應用程式將不再視為處於前景中。若應用程式進入快取狀態不久後卻尚未停止運作,則會收到 ANR。ANR 訊息提及了 FOREGROUND_SERVICE_TYPE_SHORT_SERVICE。基於上述原因,實作 Service.onTimeout() 回呼是最佳做法。

Service.onTimeout() 回呼不存在於 Android 13 及更早版本中。如果在此類裝置上執行相同的服務,則不會收到逾時或收到 ANR。即使服務尚未收到 Service.onTimeout() 回呼,請確認您的服務在完成處理工作後立即停止。

請注意,如果 shortService 未遵守逾時條件,則即使應用程式具備其他有效的前景服務或其他執行中的應用程式生命週期程序,仍會發生 ANR。

若應用程式對使用者開放瀏覽權限,或符合任一允許從背景作業啟動前景服務的豁免條件,則使用 FOREGROUND_SERVICE_TYPE_SHORT_SERVICE 參數再次呼叫 Service.StartForeground(),可再將逾時時間延長 3 分鐘。若應用程式未對使用者開放瀏覽權限,並且未符合任何一項豁免條件,則無論前景服務類型為何,只要嘗試啟動該前景服務,便會導致ForegroundServiceStartNotAllowedException

就算使用者停用應用程式的電池效能最佳化功能,也仍會受到 shortService FGS 逾時的影響。

若您啟動的前景服務包含 shortService 類型和其他前景服務類型,則系統將忽略 shortService 類型宣告。即便如此,服務仍必須遵守其他宣告類型的要求。

特殊用途

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_SPECIAL_USE
執行階段要求
說明

包含其他前景服務類型未涵蓋的有效前景服務用途。

除了宣告 FOREGROUND_SERVICE_TYPE_SPECIAL_USE 前景服務類型之外,開發人員也應在資訊清單中宣告用途。為此,開發人員可在 <service> 元素中指定 <property> 元素。在您透過 Google Play 管理中心提交應用程式時,系統會審查這些值和對應的用途。

<service android:name="fooService" android:foregroundServiceType="specialUse">
  <property android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE" android:value="foo"/>
</service>

不受規範的系統

您必須在資訊清單檔案中宣告的權限
FOREGROUND_SERVICE_SYSTEM_EXEMPTED
執行階段要求
說明

系統應用程式和特定系統整合的預留項目,以便其繼續使用前景服務。

如要使用此類型,應用程式必須至少符合以下其中一項條件:

否則的話,若宣告此類型將會導致系統擲回 ForegroundServiceTypeNotAllowedException

Google Play 對於使用前景服務類型的政策違規處置

在接下來的幾個月內,Google Play 將會就限制應用程式宣告前景服務類型的時間與類型政策,分享更多相關詳細資訊,並特別著墨於不符合系統期望的類型。