フォアグラウンド サービスのタイプ

Android 14（API レベル 34）以降では、フォアグラウンド サービスごとに適切なサービスタイプを宣言する必要があります。つまり、FOREGROUND_SERVICE 権限をリクエストするだけでなく、アプリ マニフェストでサービスタイプを宣言し、そのタイプに適したフォアグラウンド サービスの権限をリクエストする必要があります。さらに、フォアグラウンド サービスのタイプによっては、サービスを起動する前に実行時の権限をリクエストする必要があります。

カメラ

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 つを宣言します。

  • CHANGE_NETWORK_STATE
  • CHANGE_WIFI_STATE
  • CHANGE_WIFI_MULTICAST_STATE
  • NFC
  • TRANSMIT_IR

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

  • BLUETOOTH_CONNECT
  • BLUETOOTH_ADVERTISE
  • BLUETOOTH_SCAN
  • UWB_RANGING

• UsbManager.requestPermission() を呼び出します。

説明

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

代替

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

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

データの同期

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

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

• マニフェストで HIGH_SAMPLING_RATE_SENSORS 権限を宣言します。

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

  • BODY_SENSORS
  • ACTIVITY_RECOGNITION

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

説明

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

位置情報

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

android:foregroundServiceType

location

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

FOREGROUND_SERVICE_LOCATION

startForeground() に渡す定数です。

FOREGROUND_SERVICE_TYPE_LOCATION

ランタイムの前提条件

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

• ACCESS_COARSE_LOCATION
• ACCESS_FINE_LOCATION

注: 位置情報に関する実行時の権限には、使用中に関する制限が適用されます。このため、いくつかの例外を除き、アプリがバックグラウンドで実行されている間は、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 タイプの宣言を無視します。ただし、サービスは引き続き、他の宣言されたタイプの前提条件に準拠している必要があります。詳細については、フォアグラウンド サービスのドキュメントをご覧ください。

特殊用途

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

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 でフォアグラウンド サービスのタイプを申告する方法について詳しくは、フォアグラウンド サービスと全画面インテントの要件についてをご覧ください。