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

为了帮助开发者更有目的地定义面向用户的前台服务，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.

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

フォアグラウンドサービスを開始するアプリでは、ServiceCompat バージョンの startForeground()（androidx-core 1.12 以降で利用可能）を使用して、フォアグラウンドサービスタイプをビット単位の整数で渡すことをおすすめします。1 つまたは複数のタイプの値を渡すことができます。

通常、特定のユースケースで必要なタイプのみを宣言する必要があります。これにより、各フォアグラウンドサービスタイプに対するシステムの要件を簡単に満たすことができます。フォアグラウンドサービスが複数のタイプで開始される場合、フォアグラウンドサービスは、すべてのタイプのプラットフォーム適用要件に従う必要があります。

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() を呼び出す前にリクエストして権限を取得する必要があります。そのため、フォアグラウンドサービスの開始後に適切な権限をリクエストするアプリは、オペレーションの順序を変更し、フォアグラウンドサービスの開始前に権限をリクエストしなければなりません。

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

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

In order to use a given foreground service type, you must declare a particular permission in your manifest file, you must fulfill specific runtime requirements, and your app must fulfill one of the intended sets of use cases for that type. The following sections explain the permission that you must declare, the runtime prerequisites, and the intended use cases for each type.

カメラ

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

camera

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

FOREGROUND_SERVICE_CAMERA

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_CAMERA

ランタイムの前提条件

CAMERA の実行時の権限をリクエストして付与される

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

説明

マルチタスクが可能なビデオチャットアプリなど、引き続きバックグラウンドからカメラにアクセスします。

接続されたデバイス

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

android:foregroundServiceType

connectedDevice

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

FOREGROUND_SERVICE_CONNECTED_DEVICE

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE

ランタイムの前提条件

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

マニフェストで次の権限のうち少なくとも 1 つを宣言します。
次の実行時の権限を少なくとも 1 つリクエストし、付与されていること。
UsbManager.requestPermission() を呼び出します。

説明

Bluetooth、NFC、IR、USB、またはネットワーク接続を必要とする外部デバイスとの通信。

代替

アプリが外部デバイスへの継続的なデータ転送を行う必要がある場合は、代わりにコンパニオンデバイスマネージャーを使用することを検討してください。companion device presence API を使用すると、コンパニオンデバイスが範囲内にある間はアプリを実行し続けることができます。

アプリで Bluetooth デバイスをスキャンする必要がある場合は、代わりに Bluetooth scan API を使用することを検討してください。

データの同期

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

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 を使用します。

マイク

マニフェストの

android:foregroundServiceType

microphone

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

FOREGROUND_SERVICE_MICROPHONE

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_MICROPHONE

ランタイムの前提条件

RECORD_AUDIO の実行時の権限をリクエストして付与される。

注: RECORD_AUDIO 実行時の権限には、使用中の制限が適用されます。そのため、少数の例外を除き、アプリがバックグラウンドにあるときに microphone フォアグラウンドサービスを作成することはできません。詳細については、使用中の権限が必要なフォアグラウンドサービスの開始に関する制限をご覧ください。

説明

ボイスレコーダーや通信アプリなど、バックグラウンドからマイクのキャプチャを続行します。

電話

Foreground service type to declare in manifest under

android:foregroundServiceType

phoneCall

Permission to declare in your manifest

FOREGROUND_SERVICE_PHONE_CALL

Constant to pass to startForeground()

FOREGROUND_SERVICE_TYPE_PHONE_CALL

Runtime prerequisites

At least one of these conditions must be true:

App has declared the MANAGE_OWN_CALLS permission in its manifest file.

App is the default dialer app through the ROLE_DIALER role.

Description

Continue an ongoing call using the ConnectionService APIs.

Alternatives

If you need to make phone, video, or VoIP calls, consider using the android.telecom library.

Consider using CallScreeningService to screen calls.

リモートメッセージ

マニフェストで宣言するフォアグラウンドサービスタイプ
android:foregroundServiceType: remoteMessaging
マニフェストで宣言する権限: FOREGROUND_SERVICE_REMOTE_MESSAGING
startForeground() に渡す定数: FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING
ランタイムの前提条件: なし
説明: デバイス間でテキストメッセージを転送します。これにより、ユーザーがデバイスを切り替えたときに、メッセージタスクの継続性が確保されます。

ショートサービス

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

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>

除外されたシステム

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

android:foregroundServiceType

systemExempted

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

FOREGROUND_SERVICE_SYSTEM_EXEMPTED

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED

ランタイムの前提条件

なし

説明

フォアグラウンドサービスを引き続き使用するために、システムアプリと特定のシステム統合用に予約されています。

このタイプを使用するには、アプリが次の条件の少なくとも 1 つを満たしている必要があります。

デバイスがデモモードの状態にある
アプリがデバイス所有者である
アプリがプロファイラ所有者である
ROLE_EMERGENCY のロールを持つ緊急情報アプリである
デバイス管理アプリである
SCHEDULE_EXACT_ALARM 権限または USE_EXACT_ALARM 権限を保持し、フォアグラウンドサービスを使用してハプティクスのみのアラームなど、バックグラウンドでアラームを継続するアプリ。
VPN アプリ（[設定] > [ネットワークとインターネット] > [VPN] を使用して構成）

そうしないと、このタイプを宣言したときに ForegroundServiceTypeNotAllowedException がスローされます。

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

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

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

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

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

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

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

カメラ

接続されたデバイス

データの同期

健康

位置情報

メディア

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

マイク

電話

リモート メッセージ

ショート サービス

特殊用途

除外されたシステム

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

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

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

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

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

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

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

リモートメッセージ

ショートサービス

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