このページは Cloud Translation API によって翻訳されました。

フォアグラウンドサービス

フォアグラウンドサービスは、ユーザーが認識できるオペレーションを実行します。

ステータスバーに通知を表示することにより、アプリがフォアグラウンドでタスクを実行していること、それに伴いシステムリソースが消費されていることにユーザーが気付けるようにします。

フォアグラウンドサービスを使用しているアプリの例を次に示します。

この音楽プレーヤーアプリは、フォアグラウンドサービスで音楽を再生します。通知として、いま再生中の曲が表示されます。
このフィットネスアプリは、ユーザーからの許可を得たうえで、ユーザーのランニングをフォアグラウンドサービスで記録します。通知には、現在のフィットネスセッション中にユーザーが移動した距離が表示されます。

フォアグラウンドサービスを使用する場合は、ユーザーがアプリを直接操作していないときでも、タスクが実行されていることに気付けるようにする必要があります。アクションの重要度が低く、優先度が最も低い通知を使用する場合は、代わりにバックグラウンドタスクを作成します。

このドキュメントでは、フォアグラウンドサービスの使用に必要な権限と、フォアグラウンドサービスを開始してバックグラウンドから削除する方法について説明します。また、特定のユースケースをフォアグラウンドサービスのタイプに関連付ける方法と、バックグラウンドで実行されているアプリからフォアグラウンドサービスを開始したときに適用されるアクセス制限についても説明します。

ユーザーがデフォルトで通知を閉じることができる

Android 13（API レベル 33）以降では、デフォルトで、ユーザーはフォアグラウンドサービスに関連付けられた通知を閉じることができます。そのためには、通知でスワイプ操作を行います。従来、フォアグラウンドサービスが停止するか、フォアグラウンドから除去されない限り、通知は閉じられません。

ユーザーが通知を閉じないようにするには、Notification.Builder を使用して通知を作成するときに、true を setOngoing() メソッドに渡します。

通知をすぐに表示するサービス

フォアグラウンドサービスに次の特性の少なくとも 1 つがある場合、Android 12 以降を搭載したデバイスでも、サービスが開始されるとすぐに、関連する通知が表示されます。

サービスがアクションボタンを含む通知に関連付けられている。
サービスの foregroundServiceType が mediaPlayback、mediaProjection、または phoneCall である。
サービスが、通知の category 属性の定義に応じて、通話、ナビゲーション、またはメディア再生に関連するユースケースを提供している。
サービスが、通知の設定時に FOREGROUND_SERVICE_IMMEDIATE を setForegroundServiceBehavior() に渡すことで、動作変更をオプトアウトしている。

Android 13（API レベル 33）以降では、ユーザーが通知権限を拒否しても、フォアグラウンドサービスに関連する通知がタスクマネージャーに表示されます。ただし、この通知は通知ドロワーには表示されません。

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

アプリのマニフェストで、アプリの各フォアグラウンドサービスを <service> 要素で宣言します。サービスごとに、android:foregroundServiceType 属性を使用して、サービスが実行する処理の種類を宣言します。

たとえば、アプリが音楽を再生するフォアグラウンドサービスを作成する場合は、次のようにサービスを宣言します。

<manifest xmlns:android="http://schemas.android.com/apk/res/android" ...>
  <application ...>

    <service
        android:name=".MyMediaPlaybackService"
        android:foregroundServiceType="mediaPlayback"
        android:exported="false">
    </service>
  </application>
</manifest>

サービスに複数のタイプが適用される場合は、| 演算子で区切ってください。たとえば、カメラとマイクを使用するサービスは、次のように宣言します。

android:foregroundServiceType="camera|microphone"

注: アプリがターゲットとする API レベルによっては、アプリマニフェストでフォアグラウンドサービスの宣言が必要になる場合があります。

API レベル 29 以降: 位置情報を使用しているすべてのフォアグラウンドサービスを、location サービスタイプを使用して宣言する必要があります。
API レベル 30 以降: カメラまたはマイクを利用するすべてのフォアグラウンドサービスを、それぞれ camera または microphone サービスタイプを使用して宣言する必要があります。
API レベル 34 以降: すべてのフォアグラウンドサービスをサービスタイプとともに宣言する必要があります。

フォアグラウンドサービスを作成しようとしたときに、そのタイプがマニフェストで宣言されていない場合、startForeground() の呼び出し時に MissingForegroundServiceTypeException がスローされます。

必須ではない場合でも、すべてのフォアグラウンドサービスを申告し、サービスタイプを指定することをおすすめします。

フォアグラウンドサービスの権限をリクエストする

Android 9（API レベル 28）以降をターゲットとするアプリでフォアグラウンドサービスを使用する場合、次のコードスニペットに示すように、アプリマニフェストで FOREGROUND_SERVICE をリクエストする必要があります。これは標準の権限であるため、リクエスト元のアプリに自動的に付与されます。

また、アプリが API レベル 34 以降をターゲットとしている場合は、フォアグラウンドサービスが行う処理の種類に適した権限タイプをリクエストする必要があります。各フォアグラウンドサービスのタイプには、対応する権限タイプがあります。たとえば、アプリがカメラを使用するフォアグラウンドサービスを起動する場合は、FOREGROUND_SERVICE 権限と FOREGROUND_SERVICE_CAMERA 権限の両方をリクエストする必要があります。これらはすべて Normal 権限であるため、マニフェストに記載されている場合は自動的に付与されます。

<manifest xmlns:android="http://schemas.android.com/apk/res/android" ...>

    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_CAMERA"/>

    <application ...>
        ...
    </application>
</manifest>

フォアグラウンドサービスの前提条件

Android 14（API レベル 34）以降では、フォアグラウンドサービスを起動すると、サービスタイプに基づいて特定の前提条件がシステムによってチェックされます。たとえば、location タイプのフォアグラウンドサービスを起動しようとすると、システムはアプリに ACCESS_COARSE_LOCATION 権限または ACCESS_FINE_LOCATION 権限のいずれかがすでにあることを確認します。一致していない場合、システムは SecurityException をスローします。

そのため、フォアグラウンドサービスを開始する前に、必要な前提条件が満たされていることを確認する必要があります。フォアグラウンドサービスのタイプのドキュメントに、各フォアグラウンドサービスタイプに必要な前提条件が記載されています。

フォアグラウンドサービスを開始する

サービスをフォアグラウンドサービスとして実行するようシステムにリクエストする前に、サービス自体を開始します。

Kotlin

val intent = Intent(...) // Build the intent for the service
context.startForegroundService(intent)

Java

Context context = getApplicationContext();
Intent intent = new Intent(...); // Build the intent for the service
context.startForegroundService(intent);

サービス内（通常は onStartCommand() 内）で、サービスをフォアグラウンドで実行するようリクエストできます。これを行うには、ServiceCompat.startForeground() を呼び出します（androidx-core 1.12 以降で利用可能）。このメソッドが取るパラメータは次のとおりです。

サービス
ステータスバーの通知を一意に識別する正の整数
Notification オブジェクト自体
サービスによる作業を識別するフォアグラウンドサービスのタイプ

これらのタイプは、特定のユースケースに応じて、マニフェストで宣言されたタイプのサブセットである場合があります。サービスタイプをさらに追加する必要がある場合は、startForeground() を再度呼び出すことができます。

たとえば、フィットネスアプリが、常に location 情報を必要とするランニングトラッカーサービスを実行しているが、メディアの再生が必要になる場合とそうでない場合があります。マニフェストで location と mediaPlayback の両方を宣言する必要があります。ユーザーがランニングを開始し、位置情報の追跡のみを希望する場合、アプリは startForeground() を呼び出して ACCESS_FINE_LOCATION 権限のみを渡す必要があります。次に、ユーザーが音声の再生を開始する場合は、startForeground() を再度呼び出して、すべてのフォアグラウンドサービスタイプのビット単位の組み合わせ（この場合は ACCESS_FINE_LOCATION|FOREGROUND_SERVICE_MEDIA_PLAYBACK）を渡します。

以下に、カメラのフォアグラウンドサービスを起動する例を示します。

Kotlin

class MyCameraService: Service() {

  private fun startForeground() {
    // Before starting the service as foreground check that the app has the
    // appropriate runtime permissions. In this case, verify that the user has
    // granted the CAMERA permission.
    val cameraPermission =
            PermissionChecker.checkSelfPermission(this, Manifest.permission.CAMERA)
    if (cameraPermission != PermissionChecker.PERMISSION_GRANTED) {
        // Without camera permissions the service cannot run in the foreground
        // Consider informing user or updating your app UI if visible.
        stopSelf()
        return
    }

    try {
        val notification = NotificationCompat.Builder(this, "CHANNEL_ID")
            // Create the notification to display while the service is running
            .build()
        ServiceCompat.startForeground(
            /* service = */ this,
            /* id = */ 100, // Cannot be 0
            /* notification = */ notification,
            /* foregroundServiceType = */
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA
            } else {
                0
            },
        )
    } catch (e: Exception) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S
                && e is ForegroundServiceStartNotAllowedException) {
            // App not in a valid state to start foreground service
            // (e.g. started from bg)
        }
        // ...
    }
  }
}

Java

public class MyCameraService extends Service {

    private void startForeground() {
        // Before starting the service as foreground check that the app has the
        // appropriate runtime permissions. In this case, verify that the user
        // has granted the CAMERA permission.
        int cameraPermission =
            ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA);
        if (cameraPermission == PackageManager.PERMISSION_DENIED) {
            // Without camera permissions the service cannot run in the
            // foreground. Consider informing user or updating your app UI if
            // visible.
            stopSelf();
            return;
        }

        try {
            Notification notification =
                new NotificationCompat.Builder(this, "CHANNEL_ID")
                    // Create the notification to display while the service
                    // is running
                    .build();
            int type = 0;
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                type = ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA;
            }
            ServiceCompat.startForeground(
                    /* service = */ this,
                    /* id = */ 100, // Cannot be 0
                    /* notification = */ notification,
                    /* foregroundServiceType = */ type
            );
        } catch (Exception e) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S &&
                    e instanceof ForegroundServiceStartNotAllowedException
            ) {
                // App not in a valid state to start foreground service
                // (e.g started from bg)
            }
            // ...
        }
    }

    //...
}

フォアグラウンドからサービスを削除する

サービスをフォアグラウンドから削除するには、stopForeground() を呼び出します。このメソッドは、ステータスバーの通知も削除するかどうかを示すブール値を受け取ります。サービスは引き続き実行されます。

サービスがフォアグラウンドで実行中に停止すると、その通知は削除されます。

フォアグラウンドサービスを実行しているアプリのユーザーが開始した停止を処理する

通知ドロワーの下部に、現在バックグラウンドで実行されているアプリの数を表示するボタンがあります。このボタンを押すと、ダイアログが開き、さまざまなアプリの名前がリストされます。各アプリの右側に [停止] ボタンがあります。 — **図 1.** Android 13 以降を搭載したデバイスのタスクマネージャーのワークフロー。

Android 13（API レベル 33）以降では、アプリのターゲット SDK バージョンに関係なく、ユーザーは通知ドロワーからワークフローを完了して、フォアグラウンドサービスが進行中のアプリを停止できます。タスクマネージャーと呼ばれるこのアフォーダンスは、現在フォアグラウンドサービスを実行しているアプリのリストを表示します。

このリストには、[有効なアプリ] というラベルが付きます。各アプリの横には [停止] ボタンがあります。図 1 は、Android 13 を搭載したデバイスでのタスクマネージャーのワークフローを示しています。

タスクマネージャーでユーザーがアプリの横の [停止] ボタンを押すと、次のアクションが発生します。

システムがメモリからアプリを削除します。そのため、実行中のフォアグラウンドサービスだけでなく、アプリ全体が停止します。
システムはアプリのアクティビティのバックスタックを削除します。
メディアの再生が停止します。
フォアグラウンドサービスに関連付けられた通知が削除されます。
アプリは履歴に残ります。
スケジュールされたジョブは、スケジュールされた時刻に実行されます。
アラームは、設定した時刻または時間帯に鳴ります。

ユーザーがアプリを停止している間または停止した後でアプリが想定どおりに動作するかどうかをテストするには、ターミナルウィンドウで次の ADB コマンドを実行します。

adb shell cmd activity stop-app PACKAGE_NAME

除外

特定のタイプのアプリには、以下のセクションで説明するいくつかのレベルの除外が適用されます。

除外は、プロセス単位ではなくアプリ単位で適用されます。アプリ内の 1 つのプロセスが除外されると、そのアプリ内の他のプロセスもすべて除外されます。

タスクマネージャーの表示対象からの除外

以下のアプリは、タスクマネージャーに一切表示されることなく、フォアグラウンドサービスを実行できます。

システムレベルのアプリ
緊急情報サービスアプリ（つまり、ROLE_EMERGENCY ロールを持つアプリ）
デモモードのデバイス

ユーザーによる停止対象からの除外

以下のタイプのアプリがフォアグラウンドサービスを実行している場合、それらはタスクマネージャーに表示されますが、アプリ名の横に、ユーザーがタップできる [停止] ボタンは表示されません。

フォアグラウンドサービスの代わりに専用の API を使用する

多くのユースケースでは、フォアグラウンドサービスを使用する代わりに、プラットフォーム API または Jetpack API を使用して処理を行うことができます。適切な専用 API がある場合は、ほとんどの場合、フォアグラウンドサービスを使用する代わりに API を使用する必要があります。専用に構築された API には、通常、ユースケース固有の追加機能が用意されています。これらの機能は、自分で構築する必要がありました。たとえば、 Bubbles API は、チャットバブル機能を実装する必要があるメッセージアプリの複雑な UI ロジックを処理します。

フォアグラウンドサービスのタイプのドキュメントには、フォアグラウンドサービスの代わりに使用できる代替手段が記載されています。

バックグラウンドからフォアグラウンドサービスを開始する場合の制限

Android 12 以降をターゲットとするアプリは、少数の特殊なケースを除き、バックグラウンドで動作しているときにフォアグラウンドサービスを起動できません。アプリがバックグラウンドで実行されているときにフォアグラウンドサービスを起動しようとしたときに、フォアグラウンドサービスが例外ケースのいずれかを満たさない場合、システムは ForegroundServiceStartNotAllowedException をスローします。

また、使用中の権限（ボディセンサー、カメラ、マイク、位置情報の権限など）が必要なフォアグラウンドサービスをアプリが起動する場合、アプリがバックグラウンドでの起動制限の例外のいずれかに該当する場合でも、アプリがバックグラウンドにある間はサービスを作成できません。その理由については、使用中の権限が必要なフォアグラウンドサービスの起動に関する制限のセクションで説明しています。

バックグラウンド開始制限の除外

次の状況では、アプリがバックグラウンドで実行されている場合でも、フォアグラウンドサービスを開始できます。

アプリがユーザーに表示された状態（アクティビティなど）から遷移する。
アプリがバックグラウンドからアクティビティを開始できる。ただし、既存のタスクのバックスタックにアプリのアクティビティがある場合は除きます。
アプリが Firebase Cloud Messaging を使用して優先度の高いメッセージを受信する。

注: アプリがユーザーに時間的制約のあるコンテンツを表示するために優先度の高いメッセージを使用していない場合、システムは優先度の高いメッセージを通常の優先度にダウングレードできます。メッセージの優先度が下げられると、アプリはフォアグラウンドサービスを開始できず、フォアグラウンドサービスを開始しようとすると ForegroundServiceStartNotAllowedException が返されます。

そのため、フォアグラウンドサービスを開始する前に、RemoteMessage.getPriority() の結果を調べて、PRIORITY_HIGH() であることを確認することをおすすめします。優先度の高いメッセージとそれらを使用するタイミングについては、FCM's documentation をご覧ください。
ユーザーがアプリに関連する UI 要素でアクションを実行する。たとえば、バブル、通知、ウィジェット、またはアクティビティを操作する。
アプリが正確なアラームを呼び出して、ユーザーがリクエストしたアクションを完了します。
アプリがデバイスの現在の入力方法である。
アプリがジオフェンスまたはアクティビティ遷移の検出に関連するイベントを受信する。
デバイスが再起動して、ブロードキャストレシーバで ACTION_BOOT_COMPLETED、ACTION_LOCKED_BOOT_COMPLETED、または ACTION_MY_PACKAGE_REPLACED のインテントアクションを受信した後。

注: アプリが Android 14 以降を対象としている場合、BOOT_COMPLETED レシーバーから特定のフォアグラウンドサービスのタイプを起動することに制限があります。詳しくは、BOOT_COMPLETED ブロードキャストレシーバによるフォアグラウンドサービスの起動に関する制限をご覧ください。
アプリがブロードキャストレシーバで ACTION_TIMEZONE_CHANGED、ACTION_TIME_CHANGED、または ACTION_LOCALE_CHANGED のインテントアクションを受信する。
アプリは NfcService から ACTION_TRANSACTION_DETECTED イベントを受信します。
アプリがデバイス所有者やプロファイル所有者など、特定のシステムロールまたは権限を持っている。
アプリがコンパニオンデバイスマネージャーを使用していて、REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND 権限または REQUEST_COMPANION_RUN_IN_BACKGROUND 権限を宣言している。可能な限り REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND を使用してください。
ユーザーがアプリの電池の最適化をオフにする。
アプリが SYSTEM_ALERT_WINDOW 権限を保持している。注: Android 15 以降をターゲットとするアプリの場合、SYSTEM_ALERT_WINDOW 権限が必要で、かつアプリにオーバーレイウィンドウを表示する必要があります。

使用中の権限が必要なフォアグラウンドサービスの起動に関する制限

Android 14（API レベル 34）以降では、使用中の権限が必要なフォアグラウンドサービスを開始する場合に注意すべき特別な状況があります。

アプリが Android 14 以降をターゲットとしている場合、オペレーティングシステムはフォアグラウンドサービスを作成するときに、アプリにそのサービスタイプに適したすべての権限があることを確認します。たとえば、microphone タイプのフォアグラウンドサービスを作成すると、オペレーティングシステムは、アプリに現在 RECORD_AUDIO 権限が付与されていることを確認します。この権限がない場合、システムは SecurityException をスローします。

使用中の権限の場合、問題が発生する可能性があります。アプリに「使用中」権限が付与されている場合、その権限はフォアグラウンドで実行されている間のみ有効です。つまり、アプリがバックグラウンドにあり、カメラ、位置情報、マイクタイプのフォアグラウンドサービスを作成しようとすると、アプリに必要な権限が現在付与されていないと判断され、SecurityException がスローされます。

同様に、アプリがバックグラウンドにあり、BODY_SENSORS 権限が必要なヘルスサービスを作成した場合、アプリには現在その権限がないため、システムは例外をスローします。（これは、ACTIVITY_RECOGNITION などの異なる権限を必要とするヘルスサービスの場合は適用されません）。PermissionChecker.checkSelfPermission() を呼び出しても、この問題は防止されません。アプリに使用中の権限がある場合、アプリがその権限を持っているかどうかを確認するために checkSelfPermission() を呼び出した場合、アプリがバックグラウンドにあっても PERMISSION_GRANTED が返されます。メソッドが PERMISSION_GRANTED を返すと、「アプリはアプリの使用中にこの権限を持ちます」と表示されます。

そのため、フォアグラウンドサービスで使用中の権限が必要な場合は、サービスが定義された例外のいずれかに該当しない限り、アプリにアクティビティが表示されている間に Context.startForegroundService() または Context.bindService() を呼び出す必要があります。

使用中の権限の制限の免除

状況によっては、アプリがバックグラウンドで実行されているときにフォアグラウンドサービスが開始しても、アプリがフォアグラウンドで実行されている（「使用中」に）位置情報、カメラ、マイクの情報にアクセスできる場合があります。

同様の状況で、サービスが location のフォアグラウンドサービスのタイプを申告し、ACCESS_BACKGROUND_LOCATION 権限を持つアプリによってサービスが開始された場合、このサービスは、アプリがバックグラウンドで実行されている場合でも、常に位置情報にアクセスできます。

これらの状況は次のとおりです。

システムコンポーネントがサービスを開始します。
サービスは、アプリウィジェットを操作することで開始されます。
このサービスはまず、通知を操作します。
このサービスは、別の可視アプリから送信された PendingIntent として開始されます。
デバイス所有者モードで実行されている Device Policy Controller であるアプリによってサービスが開始される。
VoiceInteractionService を提供するアプリによってサービスが開始される。
START_ACTIVITIES_FROM_BACKGROUND 特権を持つアプリによってサービスが開始される。

アプリで影響を受けるサービスを特定する

アプリをテストするとき、フォアグラウンドサービスを開始します。開始されたサービスが、位置情報、マイク、カメラに対するアクセスを制限されている場合は、次のメッセージが Logcat に表示されます。

Foreground service started from background can not have \
location/camera/microphone access: service SERVICE_NAME

フォアグラウンド サービス

ユーザーがデフォルトで通知を閉じることができる

通知をすぐに表示するサービス

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

フォアグラウンド サービスの権限をリクエストする

フォアグラウンド サービスの前提条件

フォアグラウンド サービスを開始する

Kotlin

Java

Kotlin

Java

フォアグラウンドからサービスを削除する

フォアグラウンド サービスを実行しているアプリのユーザーが開始した停止を処理する

除外

タスク マネージャーの表示対象からの除外

ユーザーによる停止対象からの除外

フォアグラウンド サービスの代わりに専用の API を使用する

バックグラウンドからフォアグラウンド サービスを開始する場合の制限

バックグラウンド開始制限の除外

使用中の権限が必要なフォアグラウンド サービスの起動に関する制限

使用中の権限の制限の免除

アプリで影響を受けるサービスを特定する

フォアグラウンドサービス

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

フォアグラウンドサービスの権限をリクエストする

フォアグラウンドサービスの前提条件

フォアグラウンドサービスを開始する

フォアグラウンドサービスを実行しているアプリのユーザーが開始した停止を処理する

タスクマネージャーの表示対象からの除外

フォアグラウンドサービスの代わりに専用の API を使用する

バックグラウンドからフォアグラウンドサービスを開始する場合の制限

使用中の権限が必要なフォアグラウンドサービスの起動に関する制限