ComplicationRequest

public ComplicationRequest(
    int complicationInstanceId,
    @NonNull ComplicationType complicationType
)

public ComplicationRequest(
    int complicationInstanceId,
    @NonNull ComplicationType complicationType,
    boolean immediateResponseRequired
)

Constructs a ComplicationRequest without setting isForSafeWatchFace.

@RequiresApi(value = 33)
public ComplicationRequest(
    int complicationInstanceId,
    @NonNull ComplicationType complicationType,
    boolean immediateResponseRequired,
    int isForSafeWatchFace
)

public final int getComplicationInstanceId()

The system's id for the requested complication which is a unique value for the tuple Watch face ComponentName, complication slot ID.

public final @NonNull ComplicationType getComplicationType()

The ComplicationType of complication data requested.

public final int isForSafeWatchFace()

Intended for OEM use, returns whether this request is on behalf of a 'safe' watch face as defined by the ComplicationDataSourceService.METADATA_KEY_SAFE_WATCH_FACES meta data in the data source's manifest. The data source may choose to serve different results for a 'safe' watch face.

If the ComplicationDataSourceService.METADATA_KEY_SAFE_WATCH_FACES meta data is not defined then this will be TargetWatchFaceSafety.UNKNOWN.

Note if the ComplicationDataSourceService does not have the privileged permission com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE, then this will be TargetWatchFaceSafety.UNKNOWN.

public final boolean isImmediateResponseRequired()

If true then ComplicationRequestListener.onComplicationData should be called as soon as possible (ideally less than 100ms instead of the usual 20s deadline). This will only be true within a ComplicationDataSourceService.onStartImmediateComplicationRequests pair which will not be called unless the ComplicationDataSourceService has privileged permission com.google.android.wearable.permission.USE_IMMEDIATE_COMPLICATION_UPDATE.