Eventos de ciclo de vida y de estadísticas

TileService es un servicio vinculado. Tu TileService se vincula como resultado de la solicitud de tu app o si el sistema necesita comunicarse con ella. Un ciclo de vida de servicio vinculado típico contiene los siguientes cuatro métodos de devolución de llamada: onCreate(), onBind(), onUnbind() y onDestroy(). El sistema invoca estos métodos cada vez que el servicio entra en una nueva fase del ciclo de vida.

Importante: Tu TileService seguirá pasando por el ciclo de vida típico de Service. Sin embargo, TileService difiere de la mayoría de los otros servicios vinculados porque contiene métodos de ciclo de vida específicos de TileService a los que tu app puede reaccionar. Se llama a los métodos de ciclo de vida de Service y TileService en dos subprocesos asíncronos separados.

Además de las devoluciones de llamada que controlan el ciclo de vida del servicio vinculado, puedes implementar otros métodos específicos del ciclo de vida de TileService. Todos los servicios de tarjetas deben implementar onTileRequest() y onTileResourcesRequest() para responder a las solicitudes de actualización del sistema.

• onTileAddEvent(): El sistema llama a este método solo cuando el usuario agrega tu tarjeta por primera vez y si la quita y la vuelve a agregar. Este es el mejor momento para realizar cualquier inicialización única.

  Solo se llama a onTileAddEvent() cuando se reconfigura el conjunto de tarjetas, no cada vez que el sistema crea una tarjeta. Por ejemplo, cuando se reinicia o enciende el dispositivo, no se llama a onTileAddEvent() para las tarjetas que ya se habían agregado. En su lugar, puedes usar getActiveTilesAsync() para obtener una instantánea de las tarjetas que te pertenecen que están activas.

• onTileRemoveEvent(): El sistema llama a este método solo si el usuario quita tu tarjeta.

• onTileEnterEvent(): El sistema llama a este método cuando aparece en la pantalla una tarjeta proporcionada por este proveedor.

• onTileLeaveEvent(): El sistema llama a este método cuando una tarjeta proporcionada por este proveedor desaparece de la vista en la pantalla.

• onTileRequest(): El sistema llama a este método cuando solicita un nuevo cronograma a este proveedor.

• onTileResourcesRequest(): El sistema llama a este método cuando solicita un conjunto de recursos a este proveedor. Esto puede suceder la primera vez que se carga una tarjeta o cada vez que cambia la versión del recurso.

Nota: No exijas (ni dependas de) que las fases se produzcan en un orden en particular. Solo se puede llamar a onTileAddEvent() cuando un usuario agrega tu tarjeta. Se puede llamar a onTileEnterEvent() y onTileLeaveEvent() varias veces durante el ciclo de vida de TileService. Nunca se llamará a onTileRemoveEvent() si el usuario no quita la tarjeta.

Consulta qué tarjetas están activas

Las tarjetas activas son tarjetas que se agregaron para mostrarse en el reloj. Usa el método estático getActiveTilesAsync() de TileService para consultar qué tarjetas que pertenecen a tu app están activas.

Precaución: El resultado refleja la lista de tarjetas activas en el momento en que se realizó la llamada, que podría haber cambiado cuando se recibe el resultado. Usa las devoluciones de llamada onTileAddEvent() y onTileRemoveEvent() para programar acciones que deben ocurrir cuando tu tarjeta se vuelve activa o inactiva.