フォアグラウンドサービスタイプは必須

デベロッパーがユーザー向けのフォアグラウンドサービスをより意識的に定義できるように、Android 10 で <service> 要素内に android:foregroundServiceType 属性が導入されました。

Android 14 をターゲットとするアプリでは、適切なフォアグラウンドサービスタイプを指定する必要があります。以前のバージョンの Android と同様に、複数のタイプを組み合わせることができます。以下に、選択可能なフォアグラウンドサービスタイプのリストを示します。

アプリのユースケースがこれらのタイプのいずれにも関連していない場合は、WorkManager またはユーザーが開始するデータ転送ジョブを使用するようにロジックを移行することを強くおすすめします。

Android 14 では、health, remoteMessaging, shortService, specialUse 型と systemExempted 型が新たに導入されています。

次のコードスニペットは、マニフェストでのフォアグラウンドサービスタイプの宣言の例を示しています。

<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 が発生します。

フォアグラウンドサービスタイプを使用する新しい権限を宣言する

If apps that target Android 14 use a foreground service, they must declare a specific permission, based on the foreground service type, that Android 14 introduces. These permissions appear in the sections labeled "permission that you must declare in your manifest file" in the intended use cases and enforcement for each foreground service type section on this page.

All of the permissions are defined as normal permissions and are granted by default. Users cannot revoke these permissions.

実行時にフォアグラウンドサービスタイプを含める

对于启动前台服务的应用，最佳实践是使用 startForeground() 的 ServiceCompat 版本（在 androidx-core 1.12 及更高版本中提供），并在其中传入前台服务类型的按位整数。您可以选择传递一个或多个类型值。

通常，您应仅声明特定用例所需的类型。这样可以更轻松地满足系统对每种前台服务类型的预期。如果某项前台服务以多种类型启动，则该前台服务必须遵守所有类型的平台强制执行要求。

ServiceCompat.startForeground(0, notification, FOREGROUND_SERVICE_TYPE_LOCATION)

如果在调用中未指定前台服务类型，则类型默认为清单中定义的值。如果您未在清单中指定服务类型，系统会抛出 MissingForegroundServiceTypeException。

如果前台服务在启动后需要新权限，您应再次调用 startForeground() 并添加新的服务类型。例如，假设一款健身应用运行一项始终需要 location 信息但可能不需要 media 权限的跑步跟踪器服务。您需要在清单中同时声明 location 和 mediaPlayback。如果用户开始跑步，只希望跟踪其位置信息，您的应用应调用 startForeground()，并仅传递 location 服务类型。然后，如果用户想开始播放音频，请再次调用 startForeground() 并传递 location|mediaPlayback。

システムによるランタイムチェック

フォアグラウンドサービスのタイプが適切な方法で使用されているかどうかは、システムによってチェックされます。また、アプリが適切な実行時権限をリクエストしているか、あるいは適切な API を使用しているかもチェックされます。たとえば、フォアグラウンドサービスタイプ FOREGROUND_SERVICE_TYPE_LOCATION を使用するアプリは、ACCESS_COARSE_LOCATION または ACCESS_FINE_LOCATION をリクエストすると想定されます。

これは、アプリがユーザーに権限をリクエストしてフォアグラウンドサービスを開始する場合、特定の順序でオペレーションを実行する必要があることを意味します。権限は、startForeground() を呼び出す前にリクエストして権限を取得する必要があります。そのため、フォアグラウンドサービスの開始後に適切な権限をリクエストするアプリは、オペレーションの順序を変更し、フォアグラウンドサービスの開始前に権限をリクエストしなければなりません。

プラットフォームの適用の詳細は、このページの対象ユースケースとフォアグラウンドサービスタイプごとの適用セクションの「ランタイム要件」に記載されています。

各フォアグラウンドサービスタイプの対象ユースケースと適用

特定のフォアグラウンドサービスタイプを使用するには、マニフェストファイルで特定の権限を宣言し、特定のランタイム要件を満たすとともに、アプリがそのタイプの対象ユースケースセットのいずれかを満たすようにする必要があります。以降のセクションでは、宣言する必要がある権限、ランタイムの前提条件、各タイプの対象ユースケースについて説明します。

カメラ

Foreground service type to declare in manifest under android:foregroundServiceType

camera

Permission to declare in your manifest

FOREGROUND_SERVICE_CAMERA

Constant to pass to startForeground()

FOREGROUND_SERVICE_TYPE_CAMERA

Runtime prerequisites

Request and be granted the CAMERA runtime permission

Note: The CAMERA runtime permission is subject to while-in-use restrictions. For this reason, you cannot create a camera foreground service while your app is in the background, with a few exceptions. For more information, see Restrictions on starting foreground services that need while-in-use permissions.

Description

Continue to access the camera from the background, such as video chat apps that allow for multitasking.

接続されたデバイス

Foreground service type to declare in manifest under

android:foregroundServiceType

connectedDevice

Permission to declare in your manifest

FOREGROUND_SERVICE_CONNECTED_DEVICE

Constant to pass to startForeground()

FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE

Runtime prerequisites

At least one of the following conditions must be true:

Declare at least one of the following permissions in your manifest:
Request and be granted at least one of the following runtime permissions:
Call UsbManager.requestPermission()

Description

Interactions with external devices that require a Bluetooth, NFC, IR, USB, or network connection.

Alternatives

If your app needs to do continuous data transfer to an external device, consider using the companion device manager instead. Use the companion device presence API to help your app stay running while the companion device is in range.

If your app needs to scan for bluetooth devices, consider using the Bluetooth scan API instead.

データの同期

要在清单中的以下位置声明的前台服务类型

android:foregroundServiceType

dataSync

在清单中声明的权限

FOREGROUND_SERVICE_DATA_SYNC

要传递给 startForeground() 的常量

FOREGROUND_SERVICE_TYPE_DATA_SYNC

运行时前提条件

无

说明

数据传输操作，例如：

数据上传或下载
备份和恢复操作
导入或导出操作
获取数据
本地文件处理
通过网络在设备和云端之间传输数据

替代方案

如需了解详情，请参阅数据同步前台服务的替代方案。

健康

マニフェストで宣言するフォアグラウンドサービスタイプ

android:foregroundServiceType

health

マニフェストで宣言する権限

FOREGROUND_SERVICE_HEALTH

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_HEALTH

ランタイムの前提条件

次の条件の少なくとも 1 つを満たす必要があります。

マニフェストで HIGH_SAMPLING_RATE_SENSORS 権限を宣言します。
次の実行時の権限を少なくとも 1 つリクエストし、付与されていること。
- BODY_SENSORS（API レベル 35 以前）
- READ_HEART_RATE
- READ_SKIN_TEMPERATURE
- READ_OXYGEN_SATURATION
- ACTIVITY_RECOGNITION

注: BODY_SENSORS とセンサーベースの READ ランタイム権限には、使用中の制限が適用されます。そのため、アプリがバックグラウンドにあるときにボディセンサーを使用する health フォアグラウンドサービスを作成するには、BODY_SENSORS_BACKGROUND（API レベル 33 ～ 35）または READ_HEALTH_DATA_IN_BACKGROUND（API レベル 36 以上）の権限が付与されている必要があります。詳細については、使用中の権限が必要なフォアグラウンドサービスの開始に関する制限をご覧ください。

説明

フィットネスカテゴリのアプリ（エクササイズトラッカーなど）をサポートする、長時間にわたるユースケース。

位置情報

マニフェストで宣言するフォアグラウンドサービスタイプ

android:foregroundServiceType

location

マニフェストで宣言する権限

FOREGROUND_SERVICE_LOCATION

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_LOCATION

ランタイムの前提条件

ユーザーが位置情報サービスを有効にしており、アプリに次のいずれかの実行時の権限が付与されている必要があります。

注: ユーザーが位置情報サービスを有効にして実行時の権限へのアクセスを許可していることを確認するには、PermissionChecker#checkSelfPermission() を使用します。

注: 位置情報のランタイム権限には、使用中の制限が適用されます。そのため、ACCESS_BACKGROUND_LOCATION ランタイム権限が付与されている場合を除き、アプリがバックグラウンドにあるときに location フォアグラウンドサービスを作成することはできません。詳細については、使用中の権限が必要なフォアグラウンドサービスの開始に関する制限をご覧ください。

説明

ナビゲーションや現在地の共有など、位置情報へのアクセスが必要な長時間にわたるユースケース。

代替

ユーザーが特定の場所に到達したときにアプリをトリガーする必要がある場合は、代わりに geofence API の使用を検討してください。

メディア

要在清单中的以下位置声明的前台服务类型
android:foregroundServiceType: mediaPlayback
在清单中声明的权限: FOREGROUND_SERVICE_MEDIA_PLAYBACK
要传递给 startForeground() 的常量: FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
运行时前提条件: 无
说明: 在后台继续播放音频或视频。在 Android TV 上支持数字视频录制 (DVR) 功能。
替代方案: 如果您要显示画中画视频，请使用画中画模式。

メディアプロジェクション

要在清单中的以下位置声明的前台服务类型
android:foregroundServiceType: mediaProjection
在清单中声明的权限: FOREGROUND_SERVICE_MEDIA_PROJECTION
要传递给 startForeground() 的常量: FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
运行时前提条件: 在启动前台服务之前调用 createScreenCaptureIntent() 方法。这样做会向用户显示权限通知；用户必须先授予权限，您才能创建服务。; 创建前台服务后，您可以调用 MediaProjectionManager.getMediaProjection()。
说明: 使用 MediaProjection API 将内容投影到非主要显示屏或外部设备。这些内容不必全都为媒体内容。
替代方案: 如需将媒体流式传输到其他设备，请使用 Google Cast SDK。

マイク

Foreground service type to declare in manifest under

android:foregroundServiceType

microphone

Permission to declare in your manifest

FOREGROUND_SERVICE_MICROPHONE

Constant to pass to startForeground()

FOREGROUND_SERVICE_TYPE_MICROPHONE

Runtime prerequisites

Request and be granted the RECORD_AUDIO runtime permission.

Note: The RECORD_AUDIO runtime permission is subject to while-in-use restrictions. For this reason, you cannot create a microphone foreground service while your app is in the background, with a few exceptions. For more information, see Restrictions on starting foreground services that need while-in-use permissions.

Description

Continue microphone capture from the background, such as voice recorders or communication apps.

電話

マニフェストで宣言するフォアグラウンドサービスタイプ

android:foregroundServiceType

phoneCall

マニフェストで宣言する権限

FOREGROUND_SERVICE_PHONE_CALL

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_PHONE_CALL

ランタイムの前提条件

次の条件の少なくとも 1 つを満たす必要があります。

アプリがマニフェストファイルで MANAGE_OWN_CALLS 権限を宣言している。

アプリが ROLE_DIALER ロールを介してデフォルトのダイヤルアプリである。

説明

ConnectionService API を使用して、現在の呼び出しを続行します。

代替

電話、ビデオ、VoIP 通話を行う必要がある場合は、android.telecom ライブラリの使用を検討してください。

CallScreeningService を使用して通話をスクリーニングすることを検討してください。

リモートメッセージ

Foreground service type to declare in manifest under
android:foregroundServiceType: remoteMessaging
Permission to declare in your manifest: FOREGROUND_SERVICE_REMOTE_MESSAGING
Constant to pass to startForeground(): FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING
Runtime prerequisites: None
Description: Transfer text messages from one device to another. Assists with continuity of a user's messaging tasks when they switch devices.

ショートサービス

マニフェストで宣言するフォアグラウンドサービスタイプ

android:foregroundServiceType

shortService

マニフェストで宣言する権限

なし

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_SHORT_SERVICE

ランタイムの前提条件

なし

説明

中断や延期ができない重要な作業を迅速に終了します。

このタイプには、以下のような特徴があります。

短時間（約 3 分）しか実行できない。
スティッキーフォアグラウンドサービスをサポートしていない。
他のフォアグラウンドサービスを開始できない。
タイプ固有の権限は不要だが、FOREGROUND_SERVICE 権限は必要。
shortService を別のサービスタイプに変更できるのは、アプリが現在新しいフォアグラウンドサービスを開始できる場合のみです。
フォアグラウンドサービスは、いつでもタイプを shortService に変更できます。この時点でタイムアウト期間が開始されます。

shortService のタイムアウトは、Service.startForeground() が呼び出された時点から始まります。アプリは、タイムアウトが発生する前に Service.stopSelf() または Service.stopForeground() を呼び出すことが想定されています。それ以外の場合は、新しい Service.onTimeout() が呼び出されます。これにより、アプリは短い期間、stopSelf() または stopForeground() を呼び出してサービスを停止できます。

Service.onTimeout() が呼び出されてからしばらくすると、アプリはキャッシュに保存された状態になり、ユーザーがアプリを操作している場合を除き、フォアグラウンドにないと見なされるようになります。アプリがキャッシュに保存されてからしばらくして、サービスが停止していない場合、アプリで ANR が発生します。ANR メッセージには、FOREGROUND_SERVICE_TYPE_SHORT_SERVICE と記載されます。このような理由から、Service.onTimeout() コールバックを実装することをおすすめします。

Android 13 以前では Service.onTimeout() コールバックは存在しません。このようなデバイスで同じサービスが実行されている場合、タイムアウトも ANR も発生しません。Service.onTimeout() コールバックを受け取っていなくても、処理タスクが完了したらすぐにサービスが停止するようにしてください。

shortService のタイムアウトを尊重しない場合、他の有効なフォアグラウンドサービスや、他のアプリライフサイクルプロセスが実行されていても、アプリで ANR が発生することに注意してください。

アプリがユーザーに表示されている場合、または、バックグラウンドからのフォアグラウンドサービスの開始を許可する除外の条件の一つを満たす場合、もう一度 FOREGROUND_SERVICE_TYPE_SHORT_SERVICE が呼び出され、Service.StartForeground() のパラメータによってタイムアウトがさらに 3 分延長されます。アプリがユーザーに表示されておらず、除外の条件の一つを満たしていない場合、別のフォアグラウンドサービスを起動しようとすると、タイプに関係なく ForegroundServiceStartNotAllowedException が発生します。

ユーザーがアプリのバッテリーの最適化を無効にしていても、shortService FGS のタイムアウトの影響を受けます。

shortService タイプと別のフォアグラウンドサービスタイプを含むフォアグラウンドサービスを開始する場合、システムは shortService タイプの宣言を無視します。ただし、サービスは引き続き、他の宣言されたタイプの前提条件に準拠する必要があります。詳細については、フォアグラウンドサービスのドキュメントをご覧ください。

特殊用途

マニフェストで宣言するフォアグラウンドサービスのタイプ

android:foregroundServiceType

specialUse

マニフェストで宣言する権限

FOREGROUND_SERVICE_SPECIAL_USE

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_SPECIAL_USE

ランタイムの前提条件

なし

説明

他のフォアグラウンドサービスタイプでは対応できない有効なフォアグラウンドサービスのユースケースに対応します。

デベロッパーは、FOREGROUND_SERVICE_TYPE_SPECIAL_USE フォアグラウンドサービスタイプを宣言することに加えて、マニフェストでユースケースを宣言する必要があります。そのためには、<service> 要素内に <property> 要素を指定します。これらの値とそれに対応するユースケースは Google Play Console でアプリを送信すると審査されます。用途自由形式のケースなので、十分な量の情報を specialUse を使用する必要がある理由をレビュアーが確認できるようにするための情報あります。

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

除外されたシステム

Foreground service type to declare in manifest under

android:foregroundServiceType

systemExempted

Permission to declare in your manifest

FOREGROUND_SERVICE_SYSTEM_EXEMPTED

Constant to pass to startForeground()

FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED

Runtime prerequisites

None

Description

Reserved for system applications and specific system integrations, to continue to use foreground services.

To use this type, an app must meet at least one of the following criteria:

Device is in demo mode state
App is a Device Owner
App is a Profiler Owner
Safety Apps that have the ROLE_EMERGENCY role
Device Admin apps
Apps holding SCHEDULE_EXACT_ALARM or USE_EXACT_ALARM permission and are using Foreground Service to continue alarms in the background, including haptics-only alarms.
VPN apps (configured using Settings > Network & Internet > VPN)

Otherwise, declaring this type causes the system to throw a ForegroundServiceTypeNotAllowedException.

フォアグラウンドサービスタイプの使用に対する Google Play ポリシーの適用

Android 14 以降をターゲットとするアプリの場合は、Google Play Console の [アプリのコンテンツ] ページ（[ポリシー] > [アプリのコンテンツ]）で、アプリのフォアグラウンドサービスのタイプを申告する必要があります。Google Play Console でフォアグラウンドサービスのタイプを申告する方法について詳しくは、フォアグラウンドサービスと全画面インテントの要件についてをご覧ください。

フォアグラウンド サービス タイプは必須 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

フォアグラウンド サービス タイプを使用する新しい権限を宣言する

実行時にフォアグラウンド サービス タイプを含める

システムによるランタイム チェック

各フォアグラウンド サービス タイプの対象ユースケースと適用

カメラ

接続されたデバイス

データの同期

健康

位置情報

メディア

メディア プロジェクション

マイク

電話

リモート メッセージ

ショート サービス

特殊用途

除外されたシステム

フォアグラウンド サービス タイプの使用に対する Google Play ポリシーの適用

フォアグラウンドサービスタイプは必須

フォアグラウンドサービスタイプを使用する新しい権限を宣言する

実行時にフォアグラウンドサービスタイプを含める

システムによるランタイムチェック

各フォアグラウンドサービスタイプの対象ユースケースと適用

メディアプロジェクション

リモートメッセージ

ショートサービス

フォアグラウンドサービスタイプの使用に対する Google Play ポリシーの適用