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

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

注: 多くの場合、特定のタイプのフォアグラウンド サービスを作成する代わりに、専用の API を使用できます。専用の API が利用可能な場合は、通常、フォアグラウンド サービスを作成するよりも API を使用することをおすすめします。これらの API は、適切なフォアグラウンド サービス タイプの代替手段セクションに記載されています。

カメラ

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

camera

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

FOREGROUND_SERVICE_CAMERA

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_CAMERA

ランタイムの前提条件

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

注: CAMERA 実行時の権限には、使用中に関する制限が適用されます。このため、アプリがバックグラウンドで動作している間は camera フォアグラウンド サービスを作成できません。また、いくつかの例外を除いて、BOOT_COMPLETED レシーバーから 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:

• Declare at least one of the following permissions in your manifest:

  • CHANGE_NETWORK_STATE
  • CHANGE_WIFI_STATE
  • CHANGE_WIFI_MULTICAST_STATE
  • NFC
  • TRANSMIT_IR

• Request and be granted at least one of the following runtime permissions:

  • BLUETOOTH_CONNECT
  • BLUETOOTH_ADVERTISE
  • BLUETOOTH_SCAN
  • UWB_RANGING

• Call UsbManager.requestPermission()

Description

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

Note: If your app performs a projection or remote messaging operation, use the corresponding media projection or remote messaging type instead.

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 15 以降をターゲットとするアプリは、BOOT_COMPLETED ブロードキャスト レシーバからデータ同期フォアグラウンド サービスを起動できません。詳細については、フォアグラウンド サービスを起動する BOOT_COMPLETED ブロードキャスト レシーバーの制限をご覧ください。

代替

詳しくは、データ同期フォアグラウンド サービスに代わる方法をご覧ください。

健康

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

android:foregroundServiceType

health

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

FOREGROUND_SERVICE_HEALTH

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_HEALTH

ランタイムの前提条件

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

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

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

  • BODY_SENSORS
  • ACTIVITY_RECOGNITION

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

説明

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

位置情報

Foreground service type to declare in manifest under

android:foregroundServiceType

location

Permission to declare in your manifest

FOREGROUND_SERVICE_LOCATION

Constant to pass to startForeground()

FOREGROUND_SERVICE_TYPE_LOCATION

Runtime prerequisites

The user must have enabled location services and the app must be granted at least one of the following runtime permissions:

• ACCESS_COARSE_LOCATION
• ACCESS_FINE_LOCATION

Note: In order to check that the user has enabled location services as well as granted access to the runtime permissions, use PermissionChecker#checkSelfPermission()

Note: The location runtime permissions are subject to while-in-use restrictions. For this reason, you cannot create a location foreground service while your app is in the background, unless you've been granted the ACCESS_BACKGROUND_LOCATION runtime permission. For more information, see Restrictions on starting foreground services that need while-in-use permissions.

Description

Long-running use cases that require location access, such as navigation and location sharing.

Alternatives

If your app needs to be triggered when the user reaches specific locations, consider using the geofence API instead.

メディア

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

android:foregroundServiceType

mediaPlayback

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

FOREGROUND_SERVICE_MEDIA_PLAYBACK

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK

ランタイムの前提条件

なし

説明

音声や動画のバックグラウンド再生を続行します。Android TV でデジタル動画録画（DVR）機能をサポートします。

注: Android 15 以降をターゲットとするアプリでは、BOOT_COMPLETED ブロードキャスト レシーバからメディア再生フォアグラウンド サービスを起動することはできません。詳しくは、BOOT_COMPLETED ブロードキャスト レシーバによるフォアグラウンド サービスの起動に関する制限をご覧ください。

代替

ピクチャー イン ピクチャー動画を表示する場合は、ピクチャー イン ピクチャー モードを使用します。

メディアを処理しています

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

android:foregroundServiceType

mediaProcessing

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

FOREGROUND_SERVICE_MEDIA_PROCESSING

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_MEDIA_PROCESSING

ランタイムの前提条件

なし

説明

メディアを別の形式に変換するなど、メディア アセットに対して時間のかかるオペレーションを実行するためのサービス。システムは、このサービスの実行を限定します。通常の状況では、この時間制限は 24 時間のうち 6 時間です。（この上限は、アプリのすべての mediaProcessing フォアグラウンド サービスで共有されます）。

次のシナリオでは、アプリはメディア処理サービスを手動で停止する必要があります。

• コード変換オペレーションが終了したか、失敗状態になったら、サービスで Service.stopForeground() と Service.stopSelf() を呼び出して、サービスを完全に停止します。

タイムアウト期間に達すると、システムはサービスの Service.onTimeout(int, int) メソッドを呼び出します。この時点で、サービスが Service.stopSelf() を呼び出すまでに数秒かかります。サービスが Service.stopSelf() を呼び出さないと、ANR が発生して「<fgs_type> のフォアグラウンド サービスがタイムアウト内に停止しませんでした: <component_name>」というエラー メッセージが表示されます。

注: Service.onTimeout(int, int) は Android 14 以前では使用できません。これらのバージョンを実行しているデバイスでは、メディア処理サービスがタイムアウト期間に達すると、システムはアプリを直ちにキャッシュに保存します。そのため、アプリはタイムアウト通知の受信を待つべきではありません。代わりに、可能な限り速やかに、フォアグラウンド サービスを終了するか、バックグラウンド サービスに変更する必要があります。

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

要在清单中声明的前台服务类型

android:foregroundServiceType

mediaProjection

在清单中声明的权限

FOREGROUND_SERVICE_MEDIA_PROJECTION

要传递给 startForeground() 的常量

FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION

运行时前提条件

在启动前台服务之前调用 createScreenCaptureIntent() 方法。这样做会向用户显示权限通知；用户必须先授予权限，您才能创建服务。

创建前台服务后，您可以调用 MediaProjectionManager.getMediaProjection()。

说明

使用 MediaProjection API 将内容投影到非主要显示屏或外部设备。这些内容不必全都为媒体内容。

注意： 以 Android 15 或更高版本为目标平台的应用不得通过 BOOT_COMPLETED 广播接收器启动媒体投影前台服务。如需了解详情，请参阅对启动前台服务的 BOOT_COMPLETED 广播接收器的限制。

替代方案

如需将媒体流式传输到其他设备，请使用 Google Cast SDK。

マイク

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

android:foregroundServiceType

microphone

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

FOREGROUND_SERVICE_MICROPHONE

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_MICROPHONE

ランタイムの前提条件

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

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

説明

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

電話

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

android:foregroundServiceType

phoneCall

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

FOREGROUND_SERVICE_PHONE_CALL

startForeground() に渡す定数

FOREGROUND_SERVICE_TYPE_PHONE_CALL

ランタイムの前提条件

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

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

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

注: Android 15 以降をターゲットとするアプリは、BOOT_COMPLETED ブロードキャスト レシーバから通話フォアグラウンド サービスを起動できません。詳細については、フォアグラウンド サービスを起動する BOOT_COMPLETED ブロードキャスト レシーバーの制限をご覧ください。

説明

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 或更高版本为目标平台，您需要在 Play 管理中心的应用内容页面（政策 > 应用内容）中声明应用的前台服务类型。如需详细了解如何在 Play 管理中心内声明前台服务类型，请参阅了解前台服务和全屏 intent 要求。