このページは 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 を使用する

バックグラウンドからのフォアグラウンドサービスの起動に関する制限

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