Cómo agregar complicaciones a una cara de reloj

Una complicación de una cara de reloj muestra datos de una fuente de datos. Con la API de Complications, las caras de reloj pueden seleccionar las fuentes de datos que desean utilizar para obtener los datos subyacentes. Esto permite que las caras de reloj muestren información además de la hora del día, sin necesidad de utilizar código para obtener los datos.

Cómo usar un ComplicationSlotsManager

Para agregar complicaciones a una cara de reloj, usa un ComplicationSlotsManager.

El ComplicationSlotsManager define cuántas complicaciones admite una cara de reloj y dónde se ubican en la pantalla. Para admitir el cambio de ubicación o la cantidad de complicaciones, el ComplicationSlotsManager también usa el CurrentUserStyleRepository, como se muestra en el siguiente ejemplo:

 override fun createComplicationSlotsManager(
        currentUserStyleRepository: CurrentUserStyleRepository
    ): ComplicationSlotsManager {
        val defaultCanvasComplicationFactory =
            CanvasComplicationFactory { watchState, listener ->
                // ...
            }

        val leftComplicationSlot = ComplicationSlot.createRoundRectComplicationSlotBuilder(
            id = 100,
            canvasComplicationFactory = defaultCanvasComplicationFactory,
            // ...
        )
            .setDefaultDataSourceType(ComplicationType.SHORT_TEXT)
            .build()

        val rightComplicationSlot = ComplicationSlot.createRoundRectComplicationSlotBuilder(
            id = 101,
            canvasComplicationFactory = defaultCanvasComplicationFactory,
            // ...
        )
            .setDefaultDataSourceType(ComplicationType.SHORT_TEXT)
            .build()

        return ComplicationSlotsManager(
            listOf(leftComplicationSlot, rightComplicationSlot),
            currentUserStyleRepository
        )
 }

Tipos y campos

En la siguiente tabla, se describen los tipos y los campos del objeto ComplicationData. Si una cara de reloj solicita un campo que no es válido para un tipo de complicación, se mostrará un valor predeterminado. Por ejemplo, si una cara de reloj intenta acceder a un campo LONG_TEXT en un tipo SHORT_TEXT, se muestra el valor predeterminado del campo LONG_TEXT (nulo). No se garantiza que se muestren los campos opcionales.

En la siguiente tabla, se describen los tipos de complicaciones para datos vacíos que se pueden enviar a cualquier espacio para complicación. No tienen campos y no es necesario incluirlos en una lista de tipos compatibles. Permiten a las caras de reloj diferenciar entre estos tres casos:

• No se seleccionó ninguna fuente.
• El usuario seleccionó "empty" para un espacio.
• Una fuente no tiene datos para enviar.

Las fuentes no pueden enviar TYPE_EMPTY en respuesta a solicitudes de actualización. Envía TYPE_NO_DATA en su lugar.

Para obtener más información, consulta el ejemplo de cara de reloj en GitHub.