ライフサイクル イベントとアナリティクス イベント

TileService はバインドされたサービスです。TileService は、アプリのリクエストの結果として、またはシステムが通信する必要がある場合にバインドされます。一般的なバインド サービスのライフサイクルには、onCreate()、onBind()、onUnbind()、onDestroy() の 4 つのコールバック メソッドが含まれます。サービスが新しいライフサイクル フェーズに入るたびに、これらのメソッドが呼び出されます。

重要: TileService は引き続き一般的な Service ライフサイクルを経ます。ただし、TileService は、アプリが応答できる TileService 固有のライフサイクル メソッドが含まれているため、他のほとんどのバインド サービスとは異なります。Service ライフサイクル メソッドと TileService ライフサイクル メソッドは、2 つの個別の非同期スレッドで呼び出されます。

バインドされたサービスのライフサイクルを制御するコールバックに加えて、TileService ライフサイクルに固有の他のメソッドを実装できます。すべてのタイルサービスは、システムからの更新リクエストに応答するために onTileRequest() と onTileResourcesRequest() を実装する必要があります。

• onTileAddEvent(): ユーザーがタイルを初めて追加したとき、およびユーザーがタイルを削除して再度追加した場合にのみ、システムがこのメソッドを呼び出します。1 回限りの初期化を行うには、このタイミングが最適です。

  onTileAddEvent() は、システムによってタイルが作成されるたびに呼び出されるのではなく、タイルのセットが再構成される場合にのみ呼び出されます。たとえば、デバイスが再起動または電源投入された場合、すでに追加されているタイルは onTileAddEvent() で呼び出されません。代わりに getActiveTilesAsync() を使用して、ユーザーに属する有効なタイルのスナップショットを取得できます。

• onTileRemoveEvent(): ユーザーがタイルを削除した場合にのみ、システムがこのメソッドを呼び出します。

• onTileEnterEvent(): このプロバイダが提供するタイルが画面に表示されたときに、システムがこのメソッドを呼び出します。

• onTileLeaveEvent(): このプロバイダが提供するタイルが画面から外れたときに、システムがこのメソッドを呼び出します。

• onTileRequest(): システムがこのプロバイダから新しいタイムラインをリクエストすると、このメソッドが呼び出されます。

• onTileResourcesRequest(): システムがこのプロバイダにリソース バンドルをリクエストすると、このメソッドが呼び出されます。これは、タイルが初めて読み込まれるときや、リソース バージョンが変更されるたびに発生する可能性があります。

注: フェーズが特定の順序で発生することを要求したり、それに依存したりしないでください。onTileAddEvent() は、ユーザーがタイルを追加したときにのみ呼び出されます。onTileEnterEvent() と onTileLeaveEvent() は、TileService のライフサイクル全体で複数回呼び出されることがあります。ユーザーがタイルを削除しない限り、onTileRemoveEvent() は呼び出されません。

アクティブなタイルをクエリする

アクティブ タイルは、スマートウォッチに表示するために追加されたタイルです。TileService の静的メソッド getActiveTilesAsync() を使用して、アプリに属するアクティブなタイルをクエリします。

注意: 結果には、呼び出し時のアクティブなタイルのリストが反映されます。このリストは、結果が受信されるまでに変更されている可能性があります。タイルがアクティブまたは非アクティブになったときに実行する必要があるアクションのスケジュール設定には、onTileAddEvent() コールバックと onTileRemoveEvent() コールバックを使用します。