# Notification.Action.WearableExtender

Added in[API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# WearableExtender

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/app/Notification.Action.WearableExtender "View this page in Java")  

```
class WearableExtender : Notification.Action.Extender
```

|---|------------------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                                       ||
| ↳ | [android.app.Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#) |

Wearable extender for notification actions. To add extensions to an action, create a new[android.app.Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)object using the`WearableExtender()`constructor and apply it to a[android.app.Notification.Action.Builder](https://developer.android.com/reference/kotlin/android/app/Notification.Action.Builder)using[android.app.Notification.Action.Builder#extend](https://developer.android.com/reference/kotlin/android/app/Notification.Action.Builder#extend(android.app.Notification.Action.Extender)).  

```kotlin
Notification.Action action = new Notification.Action.Builder(
          R.drawable.archive_all, "Archive all", actionIntent)
          .extend(new Notification.Action.WearableExtender()
                  .setAvailableOffline(false))
          .build();
```

<br />

## Summary

|                                                                                                                                                                                                                                                        Public constructors                                                                                                                                                                                                                                                         ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#WearableExtender())`()` Create a[android.app.Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)with default options.                                                                                                                                                                                                    |
| [WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#WearableExtender(android.app.Notification.Action))`(`action:` `[Notification.Action](https://developer.android.com/reference/kotlin/android/app/Notification.Action)!`)` Create a[android.app.Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)by reading wearable options present in an existing notification action. |

|                                                                                                                                                                                                                                                                                                             Public methods                                                                                                                                                                                                                                                                                                              ||
|-------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | [clone](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#clone())`()` <br />                                                                                                                                                                                                                                                                                                                                                                  |
| [Notification.Action.Builder](https://developer.android.com/reference/kotlin/android/app/Notification.Action.Builder)!                    | [extend](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#extend(android.app.Notification.Action.Builder))`(`builder:` `[Notification.Action.Builder](https://developer.android.com/reference/kotlin/android/app/Notification.Action.Builder)!`)` Apply wearable extensions to a notification action that is being built.                                                                                                                     |
| [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!                                            | [getCancelLabel](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#getCancelLabel())`()` Get the label to display to cancel the action.                                                                                                                                                                                                                                                                                                        |
| [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!                                            | [getConfirmLabel](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#getConfirmLabel())`()` Get the label to display to confirm that the action should be executed.                                                                                                                                                                                                                                                                             |
| [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)                                                        | [getHintDisplayActionInline](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#getHintDisplayActionInline())`()` Get a hint that this Action should be displayed inline.                                                                                                                                                                                                                                                                       |
| [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)                                                        | [getHintLaunchesActivity](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#getHintLaunchesActivity())`()` Get a hint that this Action will launch an[Activity](https://developer.android.com/reference/kotlin/android/app/Activity)directly, telling the platform that it can generate the appropriate transitions                                                                                                                            |
| [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!                                            | [getInProgressLabel](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#getInProgressLabel())`()` Get the label to display while the wearable is preparing to automatically execute the action.                                                                                                                                                                                                                                                 |
| [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)                                                        | [isAvailableOffline](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#isAvailableOffline())`()` Get whether this action is available when the wearable device is not connected to a companion device.                                                                                                                                                                                                                                         |
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | [setAvailableOffline](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#setAvailableOffline(kotlin.Boolean))`(`availableOffline:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` Set whether this action is available when the wearable device is not connected to a companion device.                                                                                                                 |
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | [setCancelLabel](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#setCancelLabel(kotlin.CharSequence))`(`label:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`)` Set a label to display to cancel the action.                                                                                                                                                                              |
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | [setConfirmLabel](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#setConfirmLabel(kotlin.CharSequence))`(`label:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`)` Set a label to display to confirm that the action should be executed.                                                                                                                                                   |
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | [setHintDisplayActionInline](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#setHintDisplayActionInline(kotlin.Boolean))`(`hintDisplayInline:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` Set a hint that this Action should be displayed inline.                                                                                                                                                |
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | [setHintLaunchesActivity](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#setHintLaunchesActivity(kotlin.Boolean))`(`hintLaunchesActivity:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` Set a hint that this Action will launch an[Activity](https://developer.android.com/reference/kotlin/android/app/Activity)directly, telling the platform that it can generate the appropriate transitions. |
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | [setInProgressLabel](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#setInProgressLabel(kotlin.CharSequence))`(`label:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`)` Set a label to display while the wearable is preparing to automatically execute the action.                                                                                                                       |

## Public constructors

### WearableExtender

Added in[API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
WearableExtender()
```

Create a[android.app.Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)with default options.  

### WearableExtender

Added in[API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
WearableExtender(action: Notification.Action!)
```

Create a[android.app.Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)by reading wearable options present in an existing notification action.

|                                                                     Parameters                                                                      ||
|----------|-------------------------------------------------------------------------------------------------------------------------------------------|
| `action` | [Notification.Action](https://developer.android.com/reference/kotlin/android/app/Notification.Action)!:the notification action to inspect |

## Public methods

### clone

Added in[API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun clone(): Notification.Action.WearableExtender!
```

|                                                                                Return                                                                                ||
|-------------------------------------------------------------------------------------------------------------------------------------------|---------------------------|
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | a clone of this instance. |

|                                                                                                           Exceptions                                                                                                           ||
|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `java.lang.CloneNotSupportedException` | if the object's class does not support the`Cloneable`interface. Subclasses that override the`clone`method can also throw this exception to indicate that an instance cannot be cloned. |

### extend

Added in[API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun extend(builder: Notification.Action.Builder!): Notification.Action.Builder!
```

Apply wearable extensions to a notification action that is being built. This is typically called by the[android.app.Notification.Action.Builder#extend](https://developer.android.com/reference/kotlin/android/app/Notification.Action.Builder#extend(android.app.Notification.Action.Extender))method of[android.app.Notification.Action.Builder](https://developer.android.com/reference/kotlin/android/app/Notification.Action.Builder).

|                                                                          Parameters                                                                          ||
|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------|
| `builder` | [Notification.Action.Builder](https://developer.android.com/reference/kotlin/android/app/Notification.Action.Builder)!:the builder to be modified |

|                                                                        Return                                                                         ||
|------------------------------------------------------------------------------------------------------------------------|-------------------------------|
| [Notification.Action.Builder](https://developer.android.com/reference/kotlin/android/app/Notification.Action.Builder)! | the build object for chaining |

### getCancelLabel

Added in[API level 22](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun getCancelLabel(): CharSequence!
```

**Deprecated:** *Deprecated in Java.*

Get the label to display to cancel the action. This is usually an imperative verb like "Cancel".

|                                                                  Return                                                                   ||
|------------------------------------------------------------------------------------------------|-------------------------------------------|
| [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)! | the label to display to cancel the action |

### getConfirmLabel

Added in[API level 22](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun getConfirmLabel(): CharSequence!
```

**Deprecated:** *Deprecated in Java.*

Get the label to display to confirm that the action should be executed. This is usually an imperative verb like "Send".

|                                                                       Return                                                                       ||
|------------------------------------------------------------------------------------------------|----------------------------------------------------|
| [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)! | the label to confirm the action should be executed |

### getHintDisplayActionInline

Added in[API level 25](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun getHintDisplayActionInline(): Boolean
```

Get a hint that this Action should be displayed inline.

|                                                                                                 Return                                                                                                 ||
|------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------|
| [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | `true`if the Action should be displayed inline,`false`otherwise. The default value is`false`if this was never set. |

### getHintLaunchesActivity

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun getHintLaunchesActivity(): Boolean
```

Get a hint that this Action will launch an[Activity](https://developer.android.com/reference/kotlin/android/app/Activity)directly, telling the platform that it can generate the appropriate transitions

|                                                                                                                     Return                                                                                                                      ||
|------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | `true`if the content intent will launch an activity and transitions should be generated, false otherwise. The default value is`false`if this was never set. |

### getInProgressLabel

Added in[API level 22](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun getInProgressLabel(): CharSequence!
```

**Deprecated:** *Deprecated in Java.*

Get the label to display while the wearable is preparing to automatically execute the action. This is usually a 'ing' verb ending in ellipsis like "Sending..."

|                                                                               Return                                                                               ||
|------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
| [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)! | the label to display while the action is being prepared to execute |

### isAvailableOffline

Added in[API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun isAvailableOffline(): Boolean
```

Get whether this action is available when the wearable device is not connected to a companion device. The user can still trigger this action when the wearable device is offline, but a visual hint will indicate that the action may not be available. Defaults to`true`.  

### setAvailableOffline

Added in[API level 20](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun setAvailableOffline(availableOffline: Boolean): Notification.Action.WearableExtender!
```

Set whether this action is available when the wearable device is not connected to a companion device. The user can still trigger this action when the wearable device is offline, but a visual hint will indicate that the action may not be available. Defaults to`true`.  

### setCancelLabel

Added in[API level 22](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun setCancelLabel(label: CharSequence!): Notification.Action.WearableExtender!
```

**Deprecated:** *Deprecated in Java.*

Set a label to display to cancel the action. This is usually an imperative verb, like "Cancel".

|                                                                    Parameters                                                                     ||
|---------|------------------------------------------------------------------------------------------------------------------------------------------|
| `label` | [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!:the label to display to cancel the action |

|                                                                                   Return                                                                                   ||
|-------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | this object for method chaining |

### setConfirmLabel

Added in[API level 22](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun setConfirmLabel(label: CharSequence!): Notification.Action.WearableExtender!
```

**Deprecated:** *Deprecated in Java.*

Set a label to display to confirm that the action should be executed. This is usually an imperative verb like "Send".

|                                                                         Parameters                                                                         ||
|---------|---------------------------------------------------------------------------------------------------------------------------------------------------|
| `label` | [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!:the label to confirm the action should be executed |

|                                                                                   Return                                                                                   ||
|-------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | this object for method chaining |

### setHintDisplayActionInline

Added in[API level 25](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun setHintDisplayActionInline(hintDisplayInline: Boolean): Notification.Action.WearableExtender!
```

Set a hint that this Action should be displayed inline.

|                                                                             Parameters                                                                              ||
|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------|
| `hintDisplayInline` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html):`true`if action should be displayed inline, false otherwise |

|                                                                                   Return                                                                                   ||
|-------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | this object for method chaining |

### setHintLaunchesActivity

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun setHintLaunchesActivity(hintLaunchesActivity: Boolean): Notification.Action.WearableExtender!
```

Set a hint that this Action will launch an[Activity](https://developer.android.com/reference/kotlin/android/app/Activity)directly, telling the platform that it can generate the appropriate transitions.

|                                                                                                      Parameters                                                                                                      ||
|------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `hintLaunchesActivity` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html):`true`if the content intent will launch an activity and transitions should be generated, false otherwise. |

|                                                                                   Return                                                                                   ||
|-------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | this object for method chaining |

### setInProgressLabel

Added in[API level 22](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun setInProgressLabel(label: CharSequence!): Notification.Action.WearableExtender!
```

**Deprecated:** *Deprecated in Java.*

Set a label to display while the wearable is preparing to automatically execute the action. This is usually a 'ing' verb ending in ellipsis like "Sending..."

|                                                                                 Parameters                                                                                 ||
|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `label` | [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!:the label to display while the action is being prepared to execute |

|                                                                                   Return                                                                                   ||
|-------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| [Notification.Action.WearableExtender](https://developer.android.com/reference/kotlin/android/app/Notification.Action.WearableExtender#)! | this object for method chaining |