Service.OnStartCommand(Intent, StartCommandFlags, Int32) メソッド

定義

クライアントが を呼び出してサービスを明示的に開始するたびにシステムによって呼び出 android.content.Context#startServiceされます。指定された引数と、開始要求を表す一意の整数トークンを指定します。

[Android.Runtime.Register("onStartCommand", "(Landroid/content/Intent;II)I", "GetOnStartCommand_Landroid_content_Intent_IIHandler")]
public virtual Android.App.StartCommandResult OnStartCommand (Android.Content.Intent? intent, Android.App.StartCommandFlags flags, int startId);
[<Android.Runtime.Register("onStartCommand", "(Landroid/content/Intent;II)I", "GetOnStartCommand_Landroid_content_Intent_IIHandler")>]
abstract member OnStartCommand : Android.Content.Intent * Android.App.StartCommandFlags * int -> Android.App.StartCommandResult
override this.OnStartCommand : Android.Content.Intent * Android.App.StartCommandFlags * int -> Android.App.StartCommandResult

パラメーター

intent
Intent

指定したとおりに に android.content.Context#startService指定された意図。 プロセスが終了した後にサービスが再起動され、以前に を除く #START_STICKY_COMPATIBILITY何かを返していた場合、これは null になる可能性があります。

flags
StartCommandFlags

この開始要求に関する追加データ。

startId
Int32

開始するこの特定の要求を表す一意の整数。 #stopSelfResult(int) で使用します。

戻り値

戻り値は、システムがサービスの現在の開始状態に使用する必要があるセマンティクスを示します。 ビットに関連付けられている定数の 1 つを指定 #START_CONTINUATION_MASK できます。

属性

注釈

クライアントが を呼び出してサービスを明示的に開始するたびにシステムによって呼び出 android.content.Context#startServiceされます。指定された引数と、開始要求を表す一意の整数トークンを指定します。 このメソッドを直接呼び出さないでください。

下位互換性のために、既定の実装は を呼び出#onStartし、 または #START_STICKY_COMPATIBILITYのいずれかを#START_STICKY返します。

<p class="caution">システムは、サービスの メイン スレッドでこれを呼び出します。 サービスの メイン スレッドは、同じプロセスで実行されているアクティビティに対して UI 操作が行われるのと同じスレッドです。 メイン スレッドのイベント ループが停止しないようにする必要があります。 実行時間の長い操作、ネットワーク呼び出し、または大量のディスク I/O を実行する場合は、新しいスレッドを開始するか、 を使用 android.os.AsyncTaskする必要があります。

の Java ドキュメント android.app.Service.onStartCommand(android.content.Intent, int, int)

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

こちらもご覧ください