# ComplicationDataSourceUpdateRequester

# ComplicationDataSourceUpdateRequester

Artifact:[androidx.wear.watchface:watchface-complications-data-source](https://developer.android.com/jetpack/androidx/releases/wear-watchface)  
[View Source](https://cs.android.com/search?q=file:androidx/wear/watchface/complications/datasource/ComplicationDataSourceUpdateRequester.kt+class:androidx.wear.watchface.complications.datasource.ComplicationDataSourceUpdateRequester)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/wear/watchface/complications/datasource/ComplicationDataSourceUpdateRequester "View this page in Java")

<br />

```
interface ComplicationDataSourceUpdateRequester
```

<br />

*** ** * ** ***

Allows complication complication data source to request update calls from the system. This effectively allows complication data source to push updates to the system outside of the update request cycle.

## Summary

|                                                                         ### Public companion functions                                                                         |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [ComplicationDataSourceUpdateRequester](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceUpdateRequester) | [create](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceUpdateRequester#create(android.content.Context,android.content.ComponentName))`(context: `[Context](https://developer.android.com/reference/android/content/Context.html)`, complicationDataSourceComponent: `[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html)`)` Creates a[ComplicationDataSourceUpdateRequester](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceUpdateRequester). |

|                             ### Public functions                              |
|-------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [requestUpdate](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceUpdateRequester#requestUpdate(kotlin.IntArray))`(vararg complicationInstanceIds: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`)` Requests that the system call[onComplicationUpdate](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceService#onComplicationRequest(androidx.wear.watchface.complications.datasource.ComplicationRequest,androidx.wear.watchface.complications.datasource.ComplicationDataSourceService.ComplicationRequestListener))on the specified complication data source, for the given complication ids. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [requestUpdateAll](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceUpdateRequester#requestUpdateAll())`()` Requests that the system call[onComplicationUpdate](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceService#onComplicationRequest(androidx.wear.watchface.complications.datasource.ComplicationRequest,androidx.wear.watchface.complications.datasource.ComplicationDataSourceService.ComplicationRequestListener))on the specified complication data source, for all active complications using that complication data source.                                                                                     |

## Public companion functions

### create

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)  

```
fun create(context: Context, complicationDataSourceComponent: ComponentName): ComplicationDataSourceUpdateRequester
```

Creates a[ComplicationDataSourceUpdateRequester](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceUpdateRequester).  

|                                                           Parameters                                                           |
|--------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `context: `[Context](https://developer.android.com/reference/android/content/Context.html)                                     | The[ComplicationDataSourceService](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceService)'s[Context](https://developer.android.com/reference/android/content/Context.html)                           |
| `complicationDataSourceComponent: `[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html) | The[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html)of the[ComplicationDataSourceService](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceService)to reload. |

|                                                                                    Returns                                                                                     |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [ComplicationDataSourceUpdateRequester](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceUpdateRequester) | The constructed[ComplicationDataSourceUpdateRequester](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceUpdateRequester). |

## Public functions

### requestUpdate

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)  

```
fun requestUpdate(vararg complicationInstanceIds: Int): Unit
```

Requests that the system call[onComplicationUpdate](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceService#onComplicationRequest(androidx.wear.watchface.complications.datasource.ComplicationRequest,androidx.wear.watchface.complications.datasource.ComplicationDataSourceService.ComplicationRequestListener))on the specified complication data source, for the given complication ids. Inactive complications are ignored, as are complications configured to use a different complication data source.  

|                                                  Parameters                                                   |
|---------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `vararg complicationInstanceIds: `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | The system's IDs for the complications to be updated as provided to[ComplicationDataSourceService.onComplicationActivated](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceService#onComplicationActivated(kotlin.Int,androidx.wear.watchface.complications.data.ComplicationType))and[ComplicationDataSourceService.onComplicationRequest](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceService#onComplicationRequest(androidx.wear.watchface.complications.datasource.ComplicationRequest,androidx.wear.watchface.complications.datasource.ComplicationDataSourceService.ComplicationRequestListener)). |

### requestUpdateAll

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchface#1.0.0)  

```
fun requestUpdateAll(): Unit
```

Requests that the system call[onComplicationUpdate](https://developer.android.com/reference/kotlin/androidx/wear/watchface/complications/datasource/ComplicationDataSourceService#onComplicationRequest(androidx.wear.watchface.complications.datasource.ComplicationRequest,androidx.wear.watchface.complications.datasource.ComplicationDataSourceService.ComplicationRequestListener))on the specified complication data source, for all active complications using that complication data source.

This will do nothing if no active complications are configured to use the specified complication data source.

This will also only work if called from the same package as the complication data source.