サービスの概要

Service は、長時間実行オペレーションをバックグラウンドで実行できるアプリケーション コンポーネントです。ユーザー インターフェースは提供されません。開始されたサービスは、ユーザーが別のアプリケーションに切り替えた後も、しばらくの間実行を継続することがあります。また、コンポーネントをサービスにバインドして、サービスを操作したり、プロセス間通信(IPC)を行ったりすることもできます。たとえば、サービスは、ネットワーク トランザクションの処理、音楽の再生、ファイル I/O の実行、コンテンツ プロバイダとのやり取りをすべてバックグラウンドで行うことができます。

注意: サービスは、ホスティング プロセスのメインスレッドで実行されます。サービスは独自のスレッドを作成せず、特に指定しない限り、別のプロセスで実行されることもありません。アプリケーション応答なし(ANR)エラーを回避するには、サービス内の別のスレッドでブロッキング オペレーションを実行する必要があります。

Service のタイプ

サービスには次の 3 種類があります。

前景

フォアグラウンド サービスは、ユーザーが認識できるオペレーションを実行します。たとえば、オーディオ アプリはフォアグラウンド サービスを使用してオーディオ トラックを再生します。フォアグラウンド サービスは通知を表示する必要があります。 フォアグラウンド サービスは、ユーザーがアプリを操作していないときでも実行を継続します。

フォアグラウンド サービスを使用する場合は、サービスが実行されていることをユーザーが認識できるように、通知を表示する必要があります。この通知は、サービスが停止されるか、フォアグラウンドから削除されない限り、閉じることができません。

アプリでフォアグラウンド サービスを構成する方法の詳細。

注: WorkManager API は、タスクをスケジュールする柔軟な方法を提供し、必要に応じてこれらのジョブをフォアグラウンド サービスとして実行できます。多くの場合、フォアグラウンド サービスを直接使用するよりも、WorkManager を使用することをおすすめします。

背景
バックグラウンド サービスは、ユーザーが直接認識できないオペレーションを実行します。たとえば、アプリがサービスを使用してストレージを圧縮する場合、通常はバックグラウンド サービスになります。

注: アプリが対象 API レベル 26 以降をターゲットとする場合、アプリ自体がフォアグラウンドにないときに、バックグラウンド サービスの実行に制限が課されます。たとえば、ほとんどの場合、バックグラウンドから位置情報にアクセスすべきではありません。代わりに、WorkManager を使用してタスクのスケジュールを設定します。

バインド済み
サービスがバインドされるのは、アプリケーション コンポーネントが bindService() を呼び出してサービスにバインドするときです。バインドされたサービスは、コンポーネントがサービスとやり取りしたり、リクエストを送信したり、結果を受信したり、プロセス間通信(IPC)を使用してプロセス間でそれらを行ったりできるクライアント サーバー インターフェースを提供します。バインドされたサービスは、別のアプリケーション コンポーネントがバインドされている間のみ実行されます。複数のコンポーネントを同時にサービスにバインドできますが、すべてのコンポーネントのバインドが解除されると、サービスは破棄されます。

このドキュメントでは、一般的に開始されたサービスとバインドされたサービスを別々に説明していますが、サービスは両方の方法で動作できます。つまり、開始(無期限に実行)することも、バインドを許可することもできます。これは、コンポーネントがサービスを開始できるようにする onStartCommand() と、バインドを可能にする onBind() という 2 つのコールバック メソッドを実装するかどうかだけの問題です。

サービスが開始されているか、バインドされているか、またはその両方であるかにかかわらず、任意のアプリケーション コンポーネントは、任意のコンポーネントがアクティビティを使用するのと同じ方法で(別のアプリケーションからでも)サービスを使用できます。つまり、Intent でサービスを開始します。ただし、マニフェスト ファイルでサービスを非公開として宣言し、他のアプリからのアクセスをブロックすることもできます。これについては、マニフェストでサービスを宣言するのセクションで詳しく説明します。

サービスとスレッドの選択

サービスは、ユーザーがアプリを操作していないときでもバックグラウンドで実行できるコンポーネントにすぎないため、サービスを作成するのは、サービスが必要な場合に限る必要があります。

メインスレッド以外で作業を行う必要があるものの、ユーザーがアプリを操作している間のみ作業を行う場合は、別のアプリ コンポーネントのコンテキストで新しいスレッドを作成する必要があります。たとえば、アクティビティの実行中にのみ音楽を再生する場合は、onCreate() でスレッドを作成し、onStart() で実行を開始して、onStop() で停止します。また、従来の Thread クラスではなく、java.util.concurrent パッケージまたは Kotlin コルーチンのスレッドプールとエグゼキュータを使用することも検討してください。実行をバックグラウンド スレッドに移動する方法については、Android でのスレッド化をご覧ください。

サービスを使用する場合でも、デフォルトではアプリケーションのメインスレッドで実行されるため、サービスが集中的なオペレーションやブロッキング オペレーションを実行する場合は、サービス内に新しいスレッドを作成する必要があります。

基本情報

サービスを作成するには、Service のサブクラスを作成するか、既存のサブクラスのいずれかを使用する必要があります。実装では、サービスのライフサイクルの重要な側面を処理するコールバック メソッドをオーバーライドし、必要に応じて、コンポーネントがサービスにバインドできるようにするメカニズムを提供する必要があります。オーバーライドする必要がある最も重要なコールバック メソッドは次のとおりです。

onStartCommand()
別のコンポーネント(アクティビティなど)がサービスの開始をリクエストすると、システムは startService() を呼び出してこのメソッドを呼び出します。このメソッドが実行されると、サービスが開始され、バックグラウンドで無期限に実行できます。これを実装する場合は、stopSelf() または stopService() を呼び出して、処理が完了したときにサービスを停止する必要があります。バインディングのみを提供する場合は、このメソッドを実装する必要はありません。
onBind()
別のコンポーネントがサービスにバインドしようとしたとき(RPC を実行する場合など)、システムは bindService() を呼び出してこのメソッドを呼び出します。このメソッドの実装では、IBinder を返すことで、クライアントがサービスとの通信に使用するインターフェースを提供する必要があります。このメソッドは常に実装する必要があります。ただし、バインドを許可しない場合は null を返す必要があります。
onCreate()
システムは、サービスが最初に作成されるときに(onStartCommand() または onBind() を呼び出す前に)、このメソッドを呼び出して 1 回限りのセットアップ手順を実行します。サービスがすでに実行されている場合、このメソッドは呼び出されません。
onDestroy()
このメソッドは、サービスが使用されなくなり、破棄されるときに呼び出されます。サービスは、このメソッドを実装して、スレッド、登録済みのリスナー、レシーバなどのリソースをクリーンアップする必要があります。これは、サービスが受信する最後の呼び出しです。

コンポーネントが startService() を呼び出してサービスを開始すると(onStartCommand() の呼び出しが発生)、サービスは stopSelf() で自身を停止するか、別のコンポーネントが stopService() を呼び出して停止するまで、実行を継続します。

コンポーネントが bindService() を呼び出してサービスを作成し、onStartCommand() が呼び出されない場合、サービスはコンポーネントがバインドされている間のみ実行されます。サービスがすべてのクライアントからバインド解除されると、システムによって破棄されます。

Android システムがサービスを停止するのは、メモリが不足し、ユーザーがフォーカスしているアクティビティのためにシステム リソースを回復する必要がある場合のみです。サービスがユーザー フォーカスのあるアクティビティにバインドされている場合、強制終了される可能性は低くなります。サービスがフォアグラウンドで実行されるように宣言されている場合、強制終了されることはほとんどありません。サービスが開始され、長時間実行されている場合、システムは時間の経過とともにバックグラウンド タスクのリスト内でのサービスの位置を下げ、サービスが強制終了されやすくなります。サービスが開始された場合は、システムによる再起動を適切に処理するように設計する必要があります。システムがサービスを強制終了すると、リソースが利用可能になり次第、サービスが再起動されます。ただし、これは onStartCommand() から返される値にも依存します。システムがサービスを破棄するタイミングについて詳しくは、プロセスとスレッドのドキュメントをご覧ください。

以降のセクションでは、startService() サービス メソッドと bindService() サービス メソッドを作成する方法と、他のアプリケーション コンポーネントからそれらを使用する方法について説明します。

マニフェストでサービスを宣言する

アクティビティや他のコンポーネントと同様に、アプリのマニフェスト ファイルですべてのサービスを宣言する必要があります。

サービスを宣言するには、<application> 要素の子として <service> 要素を追加します。以下に例を示します。

<manifest ... >
  ...
  <application ... >
      <service android:name=".ExampleService" />
      ...
  </application>
</manifest>

マニフェストでサービスを宣言する方法について詳しくは、<service> 要素のリファレンスをご覧ください。

<service> 要素には、サービスの開始に必要な権限や、サービスを実行するプロセスなどのプロパティを定義するために、他の属性を含めることができます。android:name 属性は、唯一の必須属性です。この属性は、サービスのクラス名を指定します。アプリの公開後は、この名前を変更しないでください。サービスを開始またはバインドする明示的なインテントに依存しているため、コードが破損するリスクを回避するためです(ブログ投稿「変更できないもの」をご覧ください)。

注意: アプリの安全性を確保するため、Service を開始する際は常に明示的インテントを使用し、サービスにインテント フィルタを宣言しないでください。暗黙的インテントを使用してサービスを開始すると、デベロッパーはどのサービスがインテントに応答するのかを把握できず、ユーザーもどのサービスが開始するのかがわからないため、セキュリティ上のリスクを伴います。Android 5.0(API レベル 21)以降では、暗黙的インテントを使用して bindService() を呼び出すと、システムから例外がスローされます。

android:exported 属性を組み込んで false に設定することで、サービスをアプリでのみ利用できるようにすることができます。これにより、明示的インテントを使用している場合でも、他のアプリがサービスを開始できなくなります。

注: ユーザーは、デバイスで実行されているサービスを確認できます。認識できないサービスや信頼できないサービスが表示された場合は、そのサービスを停止できます。ユーザーが誤ってサービスを停止しないようにするには、アプリ マニフェストの <service> 要素に android:description 属性を追加する必要があります。説明には、サービスの内容とメリットを説明する短い文を入力します。

開始されたサービスを作成する

開始されたサービスとは、別のコンポーネントが startService() を呼び出すことで開始されるサービスです。これにより、サービスの onStartCommand() メソッドが呼び出されます。

サービスが開始されると、そのサービスは、サービスを開始したコンポーネントとは独立したライフサイクルを持ちます。サービスは、サービスを開始したコンポーネントが破棄された場合でも、バックグラウンドで無期限に実行できます。そのため、サービスは、ジョブが完了したときに stopSelf() を呼び出して自身を停止する必要があります。または、別のコンポーネントが stopService() を呼び出してサービスを停止することもできます。

アクティビティなどのアプリケーション コンポーネントは、startService() を呼び出し、サービスを指定してサービスが使用するデータを含む Intent を渡すことで、サービスを開始できます。サービスは、onStartCommand() メソッドでこの Intent を受け取ります。

たとえば、アクティビティでオンライン データベースにデータを保存する必要があるとします。アクティビティは、コンパニオン サービスを開始し、インテントを startService() に渡すことで、保存するデータをコンパニオン サービスに配信できます。サービスは onStartCommand() でインテントを受信し、インターネットに接続して、データベース トランザクションを実行します。トランザクションが完了すると、サービスは自動的に停止して破棄されます。

注意: サービスは、デフォルトでは、宣言されているアプリケーションと同じプロセス、およびそのアプリケーションのメインスレッドで実行されます。ユーザーが同じアプリケーションのアクティビティを操作しているときに、サービスが集中的なオペレーションやブロッキング オペレーションを実行すると、アクティビティのパフォーマンスが低下します。アプリケーションのパフォーマンスに影響を与えないようにするには、サービス内で新しいスレッドを開始します。

Service クラスは、すべてのサービスの基本クラスです。このクラスを拡張する場合は、サービスがすべての処理を完了できる新しいスレッドを作成することが重要です。サービスはデフォルトでアプリのメインスレッドを使用するため、アプリが実行しているアクティビティのパフォーマンスが低下する可能性があります。

Android フレームワークには、Service のサブクラスである IntentService も用意されています。これは、ワーカー スレッドを使用して、すべての開始リクエストを 1 つずつ処理します。このクラスは、Android 8 Oreo 以降ではバックグラウンド実行制限が導入されたため、適切に動作しません。新しいアプリでは、このクラスを使用することはおすすめしません。また、Android 11 以降では非推奨となっています。 IntentService の代わりに JobIntentService を使用できます。これは、新しいバージョンの Android と互換性があります。

以降のセクションでは、独自のカスタム サービスを実装する方法について説明しますが、ほとんどのユースケースでは、代わりに WorkManager を使用することを強くおすすめします。Android でのバックグラウンド プロセスのガイドを参照して、ニーズに合ったソリューションがあるかどうかを確認してください。

Service クラスを拡張する

Service クラスを拡張して、受信した各インテントを処理できます。基本的な実装は次のようになります。

class HelloService : Service() {

    private var serviceLooper: Looper? = null
    private var serviceHandler: ServiceHandler? = null

    // Handler that receives messages from the thread.
    private inner class ServiceHandler(looper: Looper) : Handler(looper) {

        override fun handleMessage(msg: Message) {
            // Normally we would do some work here, like download a file.
            // For our sample, we just sleep for 5 seconds.
            try {
                Thread.sleep(5000)
            } catch (e: InterruptedException) {
                // Restore interrupt status.
                Thread.currentThread().interrupt()
            }

            // Stop the service using the startId, so that we don't stop
            // the service in the middle of handling another job.
            stopSelf(msg.arg1)
        }
    }

    override fun onCreate() {
        // Start up the thread running the service.  Note that we create a
        // separate thread because the service normally runs in the process's
        // main thread, which we don't want to block.  We also make it
        // background priority so CPU-intensive work will not disrupt our UI.
        HandlerThread("ServiceStartArguments", Process.THREAD_PRIORITY_BACKGROUND).apply {
            start()

            // Get the HandlerThread's Looper and use it for our Handler.
            serviceLooper = looper
            serviceHandler = ServiceHandler(looper)
        }
    }

    override fun onStartCommand(intent: Intent, flags: Int, startId: Int): Int {
        Toast.makeText(this, "service starting", Toast.LENGTH_SHORT).show()

        // For each start request, send a message to start a job and deliver the
        // start ID so we know which request we're stopping when we finish the job.
        serviceHandler?.obtainMessage()?.also { msg ->
            msg.arg1 = startId
            serviceHandler?.sendMessage(msg)
        }

        // If we get killed, after returning from here, restart.
        return START_STICKY
    }

    override fun onBind(intent: Intent): IBinder? {
        // We don't provide binding, so return null.
        return null
    }

    override fun onDestroy() {
        Toast.makeText(this, "service done", Toast.LENGTH_SHORT).show()
    }
}

このサンプルコードでは、onStartCommand() ですべての着信を処理し、バックグラウンド スレッドで実行されている Handler に処理をポストします。IntentService と同様に動作し、すべてのリクエストを順番に処理します。たとえば、複数のリクエストを同時に実行する場合は、スレッドプールで処理を実行するようにコードを変更できます。

onStartCommand() メソッドは整数を返す必要があります。この整数は、システムがサービスを強制終了した場合に、システムがサービスをどのように継続するかを記述する値です。onStartCommand() からの戻り値は、次のいずれかの定数にする必要があります。

START_NOT_STICKY
onStartCommand() が戻った後にシステムがサービスを強制終了した場合、配信するペンディング インテントがない限り、サービスを再作成しない。これは、不要なときにサービスを実行しないようにするための最も安全なオプションです。また、アプリケーションは未完了のジョブを簡単に再起動できます。
START_STICKY
onStartCommand() が返された後にシステムがサービスを強制終了した場合は、サービスを再作成して onStartCommand() を呼び出しますが、最後のインテントは再配信しません。代わりに、サービスを開始するペンディング インテントがない限り、システムは null インテントを使用して onStartCommand() を呼び出します。その場合、それらのインテントが配信されます。これは、コマンドを実行していないが、無期限に実行され、ジョブを待機しているメディア プレーヤー(または同様のサービス)に適しています。
START_REDELIVER_INTENT
onStartCommand() が戻った後にシステムがサービスを強制終了した場合、サービスを再作成し、サービスに最後に配信されたインテントを使用して onStartCommand() を呼び出します。ペンディング インテントは順番に配信されます。これは、ファイルのダウンロードなど、すぐに再開する必要があるジョブをアクティブに実行しているサービスに適しています。

これらの戻り値の詳細については、各定数のリンク先のリファレンス ドキュメントをご覧ください。

サービスの開始

サービスをアクティビティまたは他のアプリケーション コンポーネントから開始するには、Intent を startService() または startForegroundService() に渡します。Android システムは、サービスの onStartCommand() メソッドを呼び出し、起動するサービスを指定する Intent を渡します。

注: 対象 API レベル 26 以降をターゲットとするアプリの場合、アプリ自体がフォアグラウンドにない限り、バックグラウンド サービスの使用または作成に制限が課されます。アプリでフォアグラウンド サービスを作成する必要がある場合は、startForegroundService() を呼び出す必要があります。このメソッドはバックグラウンド サービスを作成しますが、サービスが自身をフォアグラウンドに昇格させることをシステムに通知します。サービスが作成されたら、5 秒以内に startForeground() メソッドを呼び出す必要があります。

たとえば、アクティビティは、次のように startService() を指定した明示的インテントを使用して、前のセクションのサンプル サービス(HelloService)を開始できます。

startService(Intent(this, HelloService::class.java))

startService() メソッドはすぐに戻り、Android システムはサービスの onStartCommand() メソッドを呼び出します。サービスがまだ実行されていない場合、システムはまず onCreate() を呼び出し、次に onStartCommand() を呼び出します。

サービスがバインディングも提供していない場合、startService() で配信されるインテントが、アプリケーション コンポーネントとサービス間の唯一の通信モードになります。ただし、サービスから結果を返すようにする場合は、サービスを開始するクライアントがブロードキャスト用の PendingIntent を(getBroadcast() を使用して)作成し、サービスを開始する Intent でサービスに配信できます。サービスは、ブロードキャストを使用して結果を配信できます。

サービスを開始するリクエストが複数あると、それに対応するサービスの onStartCommand() の呼び出しが複数回行われます。ただし、サービスを停止するには、stopSelf() または stopService() を使用してサービスを停止するリクエストを 1 つだけ送信する必要があります。

サービスの停止

開始されたサービスは、独自のライフサイクルを管理する必要があります。つまり、システムメモリを回復する必要がない限り、システムはサービスを停止または破棄せず、onStartCommand() が戻った後もサービスは実行を継続します。サービスは、stopSelf() を呼び出して自身を停止する必要があります。または、別のコンポーネントが stopService() を呼び出してサービスを停止することもできます。

stopSelf() または stopService() で停止をリクエストされると、システムはできるだけ早くサービスを破棄します。

サービスが onStartCommand() への複数のリクエストを同時に処理する場合、開始リクエストの処理が完了してもサービスを停止しないでください。新しい開始リクエストを受信している可能性があるためです(最初のリクエストの終了時に停止すると、2 番目のリクエストが終了します)。この問題を回避するには、stopSelf(int) を使用して、サービスを停止するリクエストが常に最新の開始リクエストに基づいていることを確認します。つまり、stopSelf(int) を呼び出すときに、停止リクエストに対応する開始リクエストの ID(onStartCommand() に配信された startId)を渡します。その後、stopSelf(int) を呼び出す前にサービスが新しい開始リクエストを受信すると、ID が一致しないため、サービスは停止しません。

注意: システム リソースの浪費とバッテリーの消耗を防ぐため、アプリの処理が完了したらサービスを停止するようにしてください。必要に応じて、他のコンポーネントが stopService() を呼び出してサービスを停止できます。サービスへのバインドを有効にしている場合でも、onStartCommand() への呼び出しを受け取った場合は、常にサービスを自分で停止する必要があります。

サービスのライフサイクルの詳細については、後述のサービスのライフサイクルを管理するをご覧ください。

バインドされたサービスを作成する

バインドされたサービスとは、アプリケーション コンポーネントが bindService() を呼び出してバインドし、長期的な接続を作成できるようにするサービスです。通常、コンポーネントが startService() を呼び出してサービスを開始することはできません。

バインドされたサービスは、アプリ内のアクティビティや他のコンポーネントからサービスを操作する場合や、プロセス間通信(IPC)を介してアプリの機能の一部を他のアプリに公開する場合に作成します。

バインドされたサービスを作成するには、onBind() コールバック メソッドを実装して、サービスとの通信用のインターフェースを定義する IBinder を返します。他のアプリケーション コンポーネントは、bindService() を呼び出してインターフェースを取得し、サービスでメソッドの呼び出しを開始できます。サービスは、バインドされているアプリケーション コンポーネントにサービスを提供するためだけに存在するため、サービスにバインドされているコンポーネントがない場合、システムはサービスを破棄します。onStartCommand() を介してサービスが開始された場合とは異なり、バインドされたサービスを停止する必要はありません。

バインドされたサービスを作成するには、クライアントがサービスと通信する方法を指定するインターフェースを定義する必要があります。サービスとクライアント間のこのインターフェースは、IBinder の実装である必要があります。また、サービスが onBind() コールバック メソッドから返す必要があります。クライアントは IBinder を受け取ると、そのインターフェースを介してサービスとのやり取りを開始できます。

複数のクライアントが同時にサービスにバインドできます。クライアントがサービスとの通信を完了すると、unbindService() を呼び出してバインドを解除します。サービスにバインドされているクライアントがなくなると、システムはサービスを破棄します。

バインドされたサービスを実装する方法は複数あり、その実装は開始されたサービスよりも複雑です。そのため、バインドされたサービスについては、バインドされたサービスに関する別のドキュメントで説明しています。

お客様に通知を送信する

サービスは、実行中にスナックバー通知またはステータスバー通知を使用して、イベントをユーザーに通知できます。

スナックバー通知は、現在のウィンドウの表面に一瞬だけ表示されて消えるメッセージです。ステータスバー通知では、ステータスバーにアイコンとメッセージが表示されます。ユーザーは、このアイコンを選択して、アクティビティの開始などのアクションを実行できます。

通常、ファイルのダウンロードなどのバックグラウンド処理が完了し、ユーザーがそれに対して操作できるようになったときに使用する手法としては、ステータスバー通知が最適です。ユーザーが展開されたビューから通知を選択すると、通知によってアクティビティを開始できます(ダウンロードしたファイルを表示するなど)。

サービスのライフサイクルの管理

サービスのライフサイクルは、アクティビティのライフサイクルよりもはるかにシンプルです。ただし、サービスはユーザーが認識しない状態でバックグラウンドで実行される可能性があるため、サービスの作成方法と破棄方法に細心の注意を払うことがさらに重要です。

サービスのライフサイクル(作成されてから破棄されるまで)は、次の 2 つのパスのいずれかに従います。

  • 開始されたサービス

    サービスは、別のコンポーネントが startService() を呼び出したときに作成されます。サービスは無期限に実行されるため、stopSelf() を呼び出してサービス自体を停止する必要があります。別のコンポーネントが stopService() を呼び出してサービスを停止することもできます。サービスが停止すると、システムによって破棄されます。

  • バインドされたサービス

    サービスは、別のコンポーネント(クライアント)が bindService() を呼び出したときに作成されます。クライアントは IBinder インターフェースを介してサービスと通信します。クライアントは、unbindService() を呼び出すことで接続を閉じることができます。複数のクライアントが同じサービスにバインドできます。すべてのクライアントがバインドを解除すると、システムはサービスを破棄します。サービス自体を停止する必要はありません。

この 2 つのパスは完全に分離されているわけではありません。startService() で、すでに開始されているサービスにバインドできます。たとえば、再生する音楽を識別する Intent を指定して startService() を呼び出すことで、バックグラウンド音楽サービスを開始できます。その後、ユーザーがプレーヤーを操作したり、現在の曲に関する情報を取得したりする場合に、アクティビティは bindService() を呼び出してサービスにバインドできます。このような場合、stopService() または stopSelf() は、すべてのクライアントがバインドを解除するまで、実際にはサービスを停止しません。

ライフサイクル コールバックの実装

アクティビティと同様に、サービスにはライフサイクル コールバック メソッドがあります。このメソッドを実装することで、サービスの状態の変化をモニタリングし、適切なタイミングで処理を実行できます。次のスケルトン サービスは、各ライフサイクル メソッドを示しています。

class ExampleService : Service() {
    private var startMode: Int = 0             // indicates how to behave if the service is killed
    private var binder: IBinder? = null        // interface for clients that bind
    private var allowRebind: Boolean = false   // indicates whether onRebind should be used

    override fun onCreate() {
        // The service is being created
    }

    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        // The service is starting, due to a call to startService()
        return startMode
    }

    override fun onBind(intent: Intent): IBinder? {
        // A client is binding to the service with bindService()
        return binder
    }

    override fun onUnbind(intent: Intent): Boolean {
        // All clients have unbound with unbindService()
        return allowRebind
    }

    override fun onRebind(intent: Intent) {
        // A client is binding to the service with bindService(),
        // after onUnbind() has already been called
    }

    override fun onDestroy() {
        // The service is no longer used and is being destroyed
    }
}

注: アクティビティのライフサイクル コールバック メソッドとは異なり、これらのコールバック メソッドのスーパークラス実装を呼び出す必要はありません。

図 2. サービスのライフサイクル。左側の図は、サービスが startService() で作成された場合のライフサイクルを示し、右側の図は、サービスが bindService() で作成された場合のライフサイクルを示しています。

図 2 は、サービスの一般的なコールバック メソッドを示しています。この図では、startService() によって作成されたサービスと bindService() によって作成されたサービスが区別されていますが、サービスがどのように開始されたかにかかわらず、どのサービスでもクライアントがバインドできる可能性があることに注意してください。onStartCommand() で最初に開始されたサービス(クライアントが startService() を呼び出す)は、onBind() への呼び出し(クライアントが bindService() を呼び出す)を引き続き受信できます。

これらのメソッドを実装することで、サービスのライフサイクルの次の 2 つのネストされたループをモニタリングできます。

  • サービスの存続期間全体は、onCreate() が呼び出されてから onDestroy() が戻るまでの期間です。アクティビティと同様に、サービスは onCreate() で初期設定を行い、onDestroy() で残りのリソースをすべて解放します。たとえば、音楽再生サービスは、onCreate() で音楽を再生するスレッドを作成し、onDestroy() でそのスレッドを停止できます。

    注: onCreate() メソッドと onDestroy() メソッドは、startService() または bindService() のどちらで作成されたかに関係なく、すべてのサービスに対して呼び出されます。

  • サービスのアクティブなライフタイムは、onStartCommand() または onBind() の呼び出しで始まります。各メソッドには、startService() または bindService() に渡された Intent が渡されます。

    サービスが開始された場合、アクティブな存続期間は、存続期間全体が終了するのと同時に終了します(onStartCommand() が戻った後もサービスはアクティブなままです)。サービスがバインドされている場合、アクティブなライフタイムは onUnbind() が戻ったときに終了します。

注: 開始されたサービスは、stopSelf() または stopService() の呼び出しによって停止されますが、サービスに対応するコールバックはありません(onStop() コールバックはありません)。サービスがクライアントにバインドされていない限り、サービスが停止すると、システムはサービスを破棄します。受信するコールバックは onDestroy() のみです。

バインディングを提供するサービスの作成方法については、バインドされたサービスのドキュメントをご覧ください。バインドされたサービスのライフサイクルの管理のセクションに、onRebind() コールバック メソッドの詳細が記載されています。