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

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

カメラ

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

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

説明

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

接続されたデバイス

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

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

説明

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

説明

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

位置情報

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

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

説明

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

代替

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

メディア

マニフェストの で宣言するフォアグラウンド サービス タイプ
android:foregroundServiceType
mediaPlayback
マニフェストで宣言する権限
FOREGROUND_SERVICE_MEDIA_PLAYBACK
startForeground() に渡す定数
FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
ランタイムの前提条件
なし
説明

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

代替

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

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

マニフェストで宣言するフォアグラウンド サービス タイプ
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 を使用して、プライマリ以外のディスプレイや外部デバイスにコンテンツを投影します。このコンテンツはメディア コンテンツ以外でもかまいませんが、

代替

別のデバイスにメディアをストリーミングするには、Google Cast SDK を使用します。

マイク

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

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

説明

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

電話

マニフェストの で宣言するフォアグラウンド サービス タイプ
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>

除外されたシステム

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

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

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

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

If your app targets Android 14 or higher, you'll need to declare your app's foreground service types in the Play Console's app content page (Policy > App content). For more information on how to declare your foreground service types in Play Console, see Understanding foreground service and full-screen intent requirements.