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

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

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

フォアグラウンドサービスにステータスバーが表示される通知を設定して、アプリがフォアグラウンドでタスクを実行していて、システムリソースを消費しています。

フォアグラウンドサービスを使用するアプリの例としては、次のようなものが挙げられます。

フォアグラウンドサービスで音楽を再生する音楽プレーヤーアプリ。通知現在再生中の曲が表示されます。
フォアグラウンドサービスでのユーザーのランニングを、ユーザーの許可を得る場合などです通知に距離が表示されることがありますユーザーが現在のフィットネスセッション中に移動したデータ。

アプリがタスクを実行する必要がある場合のみフォアグラウンドサービスを使用するユーザーが直接やり取りしていないときでも、クリックします。アクションの重要度が低い場合は、通知の場合は、背景を作成するとともに、タスクを使用してください。

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

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

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

ユーザーが通知を非表示にできないようにするには、 setOngoing()にtrue メソッド Notification.Builder を使用して通知を作成する際に、

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

フォアグラウンドサービスが次のいずれかの特性を持つ場合、サービス開始直後にシステムが関連する通知を表示する。 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 レベルによっては、アプリでフォアグラウンドサービスを申告することが必須 manifest:

API レベル 29 以降: すべてのフォアグラウンドを宣言する必要があります。位置情報を使用するサービスには、 location サービスタイプを指定します。
API レベル 30 以上: すべてのフォアグラウンドを宣言する必要があります。使用しないでください。 camera または microphone サービスタイプを指定します。
API レベル 34 以降: すべてのフォアグラウンドを宣言する必要があります。サービスタイプによって異なります

フォアグラウンドサービスを作成しようとしたときに、そのタイプが宣言されていない場合場合、システムは MissingForegroundServiceTypeException startForeground() の呼び出し時。

必須ではない場合でも、そのサービスタイプを提供します。

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

Android 9（API レベル 28）以降をターゲットとし、フォアグラウンドサービスを使用するアプリリクエストを FOREGROUND_SERVICE をアプリマニフェストに追加します。次のコードスニペットをご覧ください。これは通常の権限があるため、システムはリクエスト元のアプリに自動的に付与されます。

また、アプリが API レベル 34 以降をターゲットとしている場合は、フォアグラウンドサービスの作業内容に応じた適切な権限タイプできます。各フォアグラウンドサービスタイプ権限タイプがあります。たとえば、アプリが使用する場合は、カメラと API の両方をリクエストする必要があります。 FOREGROUND_SERVICE および FOREGROUND_SERVICE_CAMERA 付与できます。これらはすべて通常の権限なので、システムは自動的に検出されます。

<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。

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

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

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

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 以降で利用可能）。このメソッドは、 parameters:

サービス
ステータスバーの通知を一意に識別する正の整数
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 により、ユースケース固有の追加機能が提供されることがよくあります。独自の機能を構築できます。たとえば Bubbles API が複雑な UI ロジックを処理し、チャットふきだし機能を実装する必要があるメッセージアプリ。

フォアグラウンドサービスのタイプに関するドキュメントフォアグラウンドサービスの代わりに使用できます。

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

Android 12 以降をターゲットとするアプリは、フォアグラウンドを開始できないアプリがバックグラウンドで実行されているときにのみアクセスできます。ただし、ケース。アプリがアプリがバックグラウンドで実行されているときのフォアグラウンドサービス、および例外的なケースのいずれかを満たさない場合、システムは ForegroundServiceStartNotAllowedException。

また、アプリがフォアグラウンドサービスを起動し、使用中の権限（たとえば、ボディセンサー、カメラ、マイク、ロケーションアプリがバックグラウンドで実行されているときは、サービスを作成できません。アプリがバックグラウンド起動から除外された場合でも、あります。その理由については、使用中に必要なフォアグラウンドサービスを開始する権限。

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

次の状況では、アプリがフォアグラウンドサービスまたはアプリがバックグラウンドで動作しているとき。

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

注: 高い優先度がシステムによりダウングレードされることがあります。アプリが優先度の高いメッセージを使用していない場合は、メッセージを通常の優先度に戻す時間的制約のあるコンテンツをユーザーに表示するのに最適ですメッセージの優先度がダウングレードすると、アプリはフォアグラウンドサービスを起動して開始できません 1 つ目は ForegroundServiceStartNotAllowedException。

そのため、テスト環境で生成された RemoteMessage.getPriority() パスワードが PRIORITY_HIGH() フォアグラウンドサービスを開始しようとするとき。優先度の高いアラートの使い方については、このモジュールのコースリソースにある FCM's documentation。
ユーザーがアプリに関連する UI 要素でアクションを実行する。たとえば、バブル、通知、ウィジェット、またはアクティビティを操作する。
アプリは正確なアラームをユーザーがリクエストしたアクションを完了するまでの時間です。
アプリがデバイスの現在の入力であるメソッド。
アプリがジオフェンスまたはアクティビティ遷移の検出に関連するイベントを受信する。
デバイスが再起動して、ブロードキャストレシーバで ACTION_BOOT_COMPLETED、ACTION_LOCKED_BOOT_COMPLETED、または ACTION_MY_PACKAGE_REPLACED のインテントアクションを受信した後。
アプリがブロードキャストレシーバで ACTION_TIMEZONE_CHANGED、ACTION_TIME_CHANGED、または ACTION_LOCALE_CHANGED のインテントアクションを受信する。
アプリが ACTION_TRANSACTION_DETECTED NfcService のイベント。
アプリがデバイス所有者やプロファイル所有者など、特定のシステムロールまたは権限を持っている。
アプリはコンパニオンデバイスマネージャーを使用し、 REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND 権限または REQUEST_COMPANION_RUN_IN_BACKGROUND 付与します。可能な限り、 REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND。
アプリは SYSTEM_ALERT_WINDOW 付与します。
ユーザーがアプリのバッテリーの最適化をオフにしている。

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

Android 14（API レベル 34）以降では、注意すべき特別な状況があります。フォアグラウンドサービスを起動するときに、この間に権限を与える必要があります。

Android 14 以降をターゲットとするアプリの場合、オペレーティングシステムチェックして、フォアグラウンドサービスの作成時にそのサービスタイプに適切な権限を付与できます。たとえば、Terraform でタイプのフォアグラウンドサービス microphone: オペレーティングアプリが現在動作しているバージョンと RECORD_AUDIO 付与します。その権限がない場合、システムは SecurityException。

使用中の権限では、問題が発生する可能性があります。アプリにその権限が割り当てられているのは、使用中の権限のみフォアグラウンドにする必要があります。つまり、アプリがバックグラウンドで動作していて、フォアグラウンドサービスの場合、システムがアプリに必要な権限が現在付与されておらず、 SecurityException。

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

そのため、フォアグラウンドサービスが使用中の権限を必要とする場合は、 Context.startForegroundService() または Context.bindService() を呼び出す必要がある一方で、アプリが可視アクティビティを持っていること。ただし、サービスが定義された除外を使用します。

使用中権限の制限の免除

アプリの起動時にフォアグラウンドサービスが開始された場合であっても、実行回数バックグラウンドで、アプリがフォアグラウンドで実行されているときのカメラ、マイクの情報（「使用中のみ」）。

同じ状況で、サービスでフォアグラウンドサービスのタイプが location であり、がある ACCESS_BACKGROUND_LOCATION アクセスが許可されている場合でも、アプリはバックグラウンドで動作します。

以下に、これらの状況を示します。

システムコンポーネントがサービスを開始します。
このサービスはまず、ウィジェットをご覧ください。
このサービスはまず、通知を操作します。
このサービスはまず PendingIntent: 表示されます。
このサービスは、デバイスポリシーであるアプリによって開始されます。コントローラ: デバイス所有者モードで実行されます。
このサービスは、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 を使用する

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

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