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

デベロッパーがユーザー向けのフォアグラウンド サービスをより意識的に定義できるように、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 が発生します。

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

Android 14 をターゲットとするアプリでフォアグラウンド サービスを使用する場合、Android 14 で導入されたフォアグラウンド サービス タイプに基づいて、特定の権限を宣言する必要があります。これらの権限は、このページの対象ユースケースとフォアグラウンド サービス タイプごとの適用セクションの「マニフェスト ファイルで宣言する必要がある権限」に記載されています。

すべての権限は標準の権限として定義され、デフォルトで付与されます。ユーザーはこれらの権限を取り消すことはできません。

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

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

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

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

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

カメラ

android:foregroundServiceType でマニフェストで宣言するフォアグラウンド サービス タイプ
camera
マニフェストで宣言する権限
FOREGROUND_SERVICE_CAMERA
startForeground() に渡す定数です。
FOREGROUND_SERVICE_TYPE_CAMERA
ランタイムの前提条件

CAMERA の実行時の権限をリクエストし、その権限を付与する

注: CAMERA の実行時の権限には、使用中に対する制限が適用されます。このため、いくつかの例外を除き、アプリがバックグラウンドで実行されている間は、camera フォアグラウンド サービスを作成できません。詳しくは、使用中権限を必要とするフォアグラウンド サービスの起動に関する制限をご覧ください。

説明

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

接続されたデバイス

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:

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
ランタイムの前提条件
なし
説明

次のようなデータ転送オペレーション:

  • データのアップロードまたはダウンロード
  • バックアップと復元オペレーション
  • インポート / エクスポート オペレーション
  • データの取得
  • ローカル ファイルの処理
  • ネットワーク経由でのデバイスとクラウド間のデータ転送
代替

ユーザーが開始するデータ転送ジョブを作成して、ユーザーが長時間のデータのアップロード タスクやダウンロード タスクを開始できるようにします。

Download Manager API を使用して、URI からデータをダウンロードします。

BackupManager を使用して、データをバックアップまたは復元します。

その他のユースケースについては、WorkManager の使用を検討してください。

健康

マニフェストで申告するフォアグラウンド サービスのタイプ
android:foregroundServiceType
health
マニフェストで宣言する権限
FOREGROUND_SERVICE_HEALTH
startForeground() に渡す定数
FOREGROUND_SERVICE_TYPE_HEALTH
ランタイムの前提条件

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

注: BODY_SENSORS の実行時の権限には、使用中に対する制限が適用されます。このため、いくつかの例外を除き、アプリがバックグラウンドで動作しているときにボディセンサーを使用する health フォアグラウンド サービスを作成することはできません。詳しくは、使用中の権限を必要とするフォアグラウンド サービスの起動に関する制限をご覧ください。

説明

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

位置情報

マニフェストで宣言するフォアグラウンド サービス タイプ
android:foregroundServiceType
location
マニフェストで宣言する権限
FOREGROUND_SERVICE_LOCATION
startForeground() に渡す定数です。
FOREGROUND_SERVICE_TYPE_LOCATION
ランタイムの前提条件

次の実行時の権限のうち少なくとも 1 つをリクエストし、付与されている。

注: 位置情報に関する実行時の権限には、使用中に関する制限が適用されます。このため、いくつかの例外を除き、アプリがバックグラウンドで実行されている間は、location フォアグラウンド サービスを作成できません。詳しくは、使用中権限を必要とするフォアグラウンド サービスの起動に関する制限をご覧ください。

説明

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

代替

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

Media

マニフェストで宣言するフォアグラウンド サービス タイプ
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 フォアグラウンド サービスを作成できません。詳しくは、使用中権限を必要とするフォアグラウンド サービスの起動に関する制限をご覧ください。

説明

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

電話

マニフェストで宣言するフォアグラウンド サービス タイプ
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 を使用して通話をスクリーニングすることを検討してください。

リモート メッセージ

マニフェストで申告するフォアグラウンド サービスのタイプ
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 タイプの宣言を無視します。ただし、サービスは引き続き、他の宣言されたタイプの前提条件に準拠している必要があります。詳細については、フォアグラウンド サービスのドキュメントをご覧ください。

特殊用途

Foreground service type to declare in manifest under
android:foregroundServiceType
specialUse
Permission to declare in your manifest
FOREGROUND_SERVICE_SPECIAL_USE
Constant to pass to startForeground()
FOREGROUND_SERVICE_TYPE_SPECIAL_USE
Runtime prerequisites
None
Description

Covers any valid foreground service use cases that aren't covered by the other foreground service types.

In addition to declaring the FOREGROUND_SERVICE_TYPE_SPECIAL_USE foreground service type, developers should declare use cases in the manifest. To do so, they specify the <property> element within the <service> element. These values and corresponding use cases are reviewed when you submit your app in the Google Play Console. The use cases you provide are free-form, and you should make sure to provide enough information to let the reviewer see why you need to use the specialUse type.

<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 つを満たしている必要があります。

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

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