# NotificationCompat.WearableExtender

Artifact: [androidx.core:core](https://developer.android.com/jetpack/androidx/releases/core) [View Source](https://cs.android.com/search?q=file:androidx/core/app/NotificationCompat.java+class:androidx.core.app.NotificationCompat.WearableExtender) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

*** ** * ** ***


```
public final class NotificationCompat.WearableExtender implements NotificationCompat.Extender
```

<br />

*** ** * ** ***

Helper class to add wearable extensions to notifications.

See [Creating Notifications for Android Wear](https://developer.android.com/training/wearables/notifications) for more information on how to use this class.

To create a notification with wearable extensions:

1. Create a `https://developer.android.com/reference/androidx/core/app/NotificationCompat.Builder`, setting any desired properties.
2. Create a `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender`.
3. Set wearable-specific properties using the `add` and `set` methods of `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender`.
4. Call `https://developer.android.com/reference/androidx/core/app/NotificationCompat.Builder#extend(androidx.core.app.NotificationCompat.Extender)` to apply the extensions to a notification.
5. Post the notification to the notification system with the `NotificationManagerCompat.notify(...)` methods and not the `NotificationManager.notify(...)` methods.

```
Notification notification = new NotificationCompat.Builder(mContext)
        .setContentTitle("New mail from " + sender.toString())
        .setContentText(subject)
        .setSmallIcon(R.drawable.new_mail)
        .extend(new NotificationCompat.WearableExtender()
                .setContentIcon(R.drawable.new_mail))
        .build();
NotificationManagerCompat.from(mContext).notify(0, notification);
```

Wearable extensions can be accessed on an existing notification by using the `WearableExtender(Notification)` constructor, and then using the `get` methods to access values.

```
NotificationCompat.WearableExtender wearableExtender =
        new NotificationCompat.WearableExtender(notification);
List<Notification> pages = wearableExtender.getPages();
```

## Summary

| ### Constants |
|---|---|
| `static final int` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SCREEN_TIMEOUT_LONG() = -1` **This field is deprecated.** This feature is no longer supported. <br /> |
| `static final int` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SCREEN_TIMEOUT_SHORT() = 0` **This field is deprecated.** This feature is no longer supported. <br /> |
| `static final int` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SIZE_DEFAULT() = 0` **This field is deprecated.** Display intents are no longer supported. <br /> |
| `static final int` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SIZE_FULL_SCREEN() = 5` **This field is deprecated.** Display intents are no longer supported. <br /> |
| `static final int` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SIZE_LARGE() = 4` **This field is deprecated.** Display intents are no longer supported. <br /> |
| `static final int` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SIZE_MEDIUM() = 3` **This field is deprecated.** Display intents are no longer supported. <br /> |
| `static final int` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SIZE_SMALL() = 2` **This field is deprecated.** Display intents are no longer supported. <br /> |
| `static final int` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SIZE_XSMALL() = 1` **This field is deprecated.** Display intents are no longer supported. <br /> |
| `static final int` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#UNSET_ACTION_INDEX() = -1` Sentinel value for an action index that is unset. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#WearableExtender()()` Create a `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` with default options. |
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#WearableExtender(android.app.Notification)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/app/Notification.html notification)` |

| ### Public methods |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#addAction(androidx.core.app.NotificationCompat.Action)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.Action action)` Add a wearable action to this notification. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#addActions(java.util.List<androidx.core.app.NotificationCompat.Action>)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/core/app/NotificationCompat.Action> actions)` Adds wearable actions to this notification. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[addPage](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#addPage(android.app.Notification))(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/app/Notification.html page)` **This method is deprecated.** Multiple content pages are no longer supported. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[addPages](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#addPages(java.util.List<android.app.Notification>))(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/android/app/Notification.html> pages)` **This method is deprecated.** Multiple content pages are no longer supported. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#clearActions()()` Clear all wearable actions present on this builder. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[clearPages](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#clearPages())()` **This method is deprecated.** Multiple content pages are no longer supported. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#clone()()` |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.Builder` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#extend(androidx.core.app.NotificationCompat.Builder)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.Builder builder)` Apply wearable extensions to a notification that is being built. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/core/app/NotificationCompat.Action>` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getActions()()` Get the wearable actions present on this notification. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/android/graphics/Bitmap.html` | `[getBackground](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getBackground())()` **This method is deprecated.** Background images are no longer supported. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getBridgeTag()()` Returns the bridge tag of the notification. |
| `int` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getContentAction()()` Get the index of the notification action, if any, that was specified as the primary action. |
| `int` | `[getContentIcon](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getContentIcon())()` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `int` | `[getContentIconGravity](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getContentIconGravity())()` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `boolean` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getContentIntentAvailableOffline()()` Get whether the content intent is available when the wearable device is not connected to a companion device. |
| `int` | `[getCustomContentHeight](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getCustomContentHeight())()` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `int` | `[getCustomSizePreset](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getCustomSizePreset())()` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getDismissalId()()` Returns the dismissal id of the notification. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/android/app/PendingIntent.html` | `[getDisplayIntent](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getDisplayIntent())()` **This method is deprecated.** Display intents are no longer supported. <br /> |
| `int` | `[getGravity](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getGravity())()` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `boolean` | `[getHintAmbientBigPicture](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintAmbientBigPicture())()` **This method is deprecated.** This feature is no longer supported. <br /> |
| `boolean` | `[getHintAvoidBackgroundClipping](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintAvoidBackgroundClipping())()` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `boolean` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintContentIntentLaunchesActivity()()` Get a hint that this notification's content intent will launch an `https://developer.android.com/reference/android/app/Activity.html` directly, telling the platform that it can generate the appropriate transitions |
| `boolean` | `[getHintHideIcon](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintHideIcon())()` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `int` | `[getHintScreenTimeout](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintScreenTimeout())()` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `boolean` | `[getHintShowBackgroundOnly](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintShowBackgroundOnly())()` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/android/app/Notification.html>` | `[getPages](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getPages())()` **This method is deprecated.** Multiple content pages are no longer supported. <br /> |
| `boolean` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getStartScrollBottom()()` Get whether the scrolling position for the contents of this notification should start at the bottom of the contents instead of the top when the contents are too long to display within the screen. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setBackground](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setBackground(android.graphics.Bitmap))(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/android/graphics/Bitmap.html background)` **This method is deprecated.** Background images are no longer supported. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setBridgeTag(java.lang.String)(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/String.html bridgeTag)` Sets a bridge tag for this notification. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setContentAction(int)(int actionIndex)` Set an action from this notification's actions as the primary action. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setContentIcon](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setContentIcon(int))(int icon)` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setContentIconGravity](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setContentIconGravity(int))(int contentIconGravity)` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setContentIntentAvailableOffline(boolean)( boolean contentIntentAvailableOffline )` Set whether the content intent is available when the wearable device is not connected to a companion device. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setCustomContentHeight](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomContentHeight(int))(int height)` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setCustomSizePreset](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int))(int sizePreset)` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDismissalId(java.lang.String)(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/String.html dismissalId)` Sets the dismissal id for this notification. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setDisplayIntent](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent))(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/android/app/PendingIntent.html intent)` **This method is deprecated.** Display intents are no longer supported. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setGravity](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setGravity(int))(int gravity)` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setHintAmbientBigPicture](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintAmbientBigPicture(boolean))(boolean hintAmbientBigPicture)` **This method is deprecated.** This feature is no longer supported. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setHintAvoidBackgroundClipping](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintAvoidBackgroundClipping(boolean))(boolean hintAvoidBackgroundClipping)` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintContentIntentLaunchesActivity(boolean)( boolean hintContentIntentLaunchesActivity )` Set a hint that this notification's content intent will launch an `https://developer.android.com/reference/android/app/Activity.html` directly, telling the platform that it can generate the appropriate transitions. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setHintHideIcon](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintHideIcon(boolean))(boolean hintHideIcon)` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setHintScreenTimeout](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintScreenTimeout(int))(int timeout)` **This method is deprecated.** This method has no effect. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `[setHintShowBackgroundOnly](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintShowBackgroundOnly(boolean))(boolean hintShowBackgroundOnly)` **This method is deprecated.** This method has no effect starting with Wear 2.0. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setStartScrollBottom(boolean)(boolean startScrollBottom)` Set whether the scrolling position for the contents of this notification should start at the bottom of the contents instead of the top when the contents are too long to display within the screen. |

## Constants

### SCREEN_TIMEOUT_LONG

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public static final int SCREEN_TIMEOUT_LONG = -1
```

> [!CAUTION]
> **This field is deprecated.**   
>
> This feature is no longer supported.

Sentinel value for use with `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintScreenTimeout(int)` to keep the screen on for a longer amount of time when this notification is displayed on the screen.

### SCREEN_TIMEOUT_SHORT

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public static final int SCREEN_TIMEOUT_SHORT = 0
```

> [!CAUTION]
> **This field is deprecated.**   
>
> This feature is no longer supported.

Sentinel value for use with `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintScreenTimeout(int)` to keep the screen on for a short amount of time when this notification is displayed on the screen. This is the default value.

### SIZE_DEFAULT

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public static final int SIZE_DEFAULT = 0
```

> [!CAUTION]
> **This field is deprecated.**   
>
> Display intents are no longer supported.

Size value for use with `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int)` to show this notification with default sizing.

For custom display notifications created using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent)`, the default is `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SIZE_MEDIUM()`. All other notifications size automatically based on their content.

### SIZE_FULL_SCREEN

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public static final int SIZE_FULL_SCREEN = 5
```

> [!CAUTION]
> **This field is deprecated.**   
>
> Display intents are no longer supported.

Size value for use with `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int)` to show this notification full screen.

This value is only applicable for custom display notifications created using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent)`.

### SIZE_LARGE

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public static final int SIZE_LARGE = 4
```

> [!CAUTION]
> **This field is deprecated.**   
>
> Display intents are no longer supported.

Size value for use with `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int)` to show this notification with a large size.

This value is only applicable for custom display notifications created using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent)`.

### SIZE_MEDIUM

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public static final int SIZE_MEDIUM = 3
```

> [!CAUTION]
> **This field is deprecated.**   
>
> Display intents are no longer supported.

Size value for use with `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int)` to show this notification with a medium size.

This value is only applicable for custom display notifications created using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent)`.

### SIZE_SMALL

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public static final int SIZE_SMALL = 2
```

> [!CAUTION]
> **This field is deprecated.**   
>
> Display intents are no longer supported.

Size value for use with `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int)` to show this notification with a small size.

This value is only applicable for custom display notifications created using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent)`.

### SIZE_XSMALL

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public static final int SIZE_XSMALL = 1
```

> [!CAUTION]
> **This field is deprecated.**   
>
> Display intents are no longer supported.

Size value for use with `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int)` to show this notification with an extra small size.

This value is only applicable for custom display notifications created using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent)`.

### UNSET_ACTION_INDEX

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public static final int UNSET_ACTION_INDEX = -1
```

Sentinel value for an action index that is unset.

## Public constructors

### WearableExtender

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public WearableExtender()
```

Create a `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` with default options.

### WearableExtender

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public WearableExtender(@NonNull Notification notification)
```

## Public methods

### addAction

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender addAction(@NonNull NotificationCompat.Action action)
```

Add a wearable action to this notification.

When wearable actions are added using this method, the set of actions that show on a wearable device splits from devices that only show actions added using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.Builder#addAction(int,java.lang.CharSequence,android.app.PendingIntent)`. This allows for customization of which actions display on different devices.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.Action action` | the action to add to this notification |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.Action` |   |

### addActions

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender addActions(@NonNull List<NotificationCompat.Action> actions)
```

Adds wearable actions to this notification.

When wearable actions are added using this method, the set of actions that show on a wearable device splits from devices that only show actions added using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.Builder#addAction(int,java.lang.CharSequence,android.app.PendingIntent)`. This allows for customization of which actions display on different devices.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/core/app/NotificationCompat.Action> actions` | the actions to add to this notification |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.Action` |   |

### addPage

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [addPage](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#addPage(android.app.Notification))(@NonNull Notification page)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Multiple content pages are no longer supported.

Add an additional page of content to display with this notification. The current notification forms the first page, and pages added using this function form subsequent pages. This field can be used to separate a notification into multiple sections.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/app/Notification.html page` | the notification to add as another page |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getPages()` |   |

### addPages

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [addPages](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#addPages(java.util.List<android.app.Notification>))(@NonNull List<Notification> pages)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Multiple content pages are no longer supported.

Add additional pages of content to display with this notification. The current notification forms the first page, and pages added using this function form subsequent pages. This field can be used to separate a notification into multiple sections.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/android/app/Notification.html> pages` | a list of notifications |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getPages()` |   |

### clearActions

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender clearActions()
```

Clear all wearable actions present on this builder.

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining. |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#addAction(androidx.core.app.NotificationCompat.Action)` |   |

### clearPages

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [clearPages](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#clearPages())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Multiple content pages are no longer supported.

Clear all additional pages present on this builder.

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining. |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#addPage(android.app.Notification)` |   |

### clone

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender clone()
```

### extend

```
public @NonNull NotificationCompat.Builder extend(@NonNull NotificationCompat.Builder builder)
```

Apply wearable extensions to a notification that is being built. This is typically called by the `https://developer.android.com/reference/androidx/core/app/NotificationCompat.Builder#extend(androidx.core.app.NotificationCompat.Extender)` method of `https://developer.android.com/reference/androidx/core/app/NotificationCompat.Builder`.

### getActions

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull List<NotificationCompat.Action> getActions()
```

Get the wearable actions present on this notification.

### getBackground

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @Nullable Bitmap [getBackground](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getBackground())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Background images are no longer supported.

Get a background image to be displayed behind the notification content. Contrary to the `https://developer.android.com/reference/androidx/core/app/NotificationCompat.BigPictureStyle`, this background will work with any notification style.

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/android/graphics/Bitmap.html` | the background image |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setBackground(android.graphics.Bitmap)` |   |

### getBridgeTag

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @Nullable String getBridgeTag()
```

Returns the bridge tag of the notification.

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/String.html` | the bridge tag or null if not present. |

### getContentAction

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public int getContentAction()
```

Get the index of the notification action, if any, that was specified as the primary action.

If wearable specific actions were added to the main notification, this index will apply to that list, otherwise it will apply to the regular actions list.

| Returns |
|---|---|
| `int` | the action index or `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#UNSET_ACTION_INDEX()` if no action was selected. |

### getContentIcon

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public int [getContentIcon](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getContentIcon())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Get an icon that goes with the content of this notification.

### getContentIconGravity

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public int [getContentIconGravity](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getContentIconGravity())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Get the gravity that the content icon should have within the notification display. Supported values include `https://developer.android.com/reference/android/view/Gravity.html#START` and `https://developer.android.com/reference/android/view/Gravity.html#END`. The default value is `https://developer.android.com/reference/android/view/Gravity.html#END`.

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getContentIcon()` |   |

### getContentIntentAvailableOffline

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public boolean getContentIntentAvailableOffline()
```

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

### getCustomContentHeight

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public int [getCustomContentHeight](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getCustomContentHeight())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Get the custom height in pixels for the display of this notification's content.

This option is only available for custom display notifications created using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent)`. See also `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int)` and `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomContentHeight(int)`.

### getCustomSizePreset

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public int [getCustomSizePreset](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getCustomSizePreset())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Get the custom size preset for the display of this notification out of the available presets found in `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender`, e.g. `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SIZE_LARGE()`.

Some custom size presets are only applicable for custom display notifications created using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent)`. Check the documentation for the preset in question. See also `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomContentHeight(int)` and `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int)`.

### getDismissalId

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @Nullable String getDismissalId()
```

Returns the dismissal id of the notification.

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/String.html` | the dismissal id of the notification or null if it has not been set. |

### getDisplayIntent

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @Nullable PendingIntent [getDisplayIntent](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getDisplayIntent())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Display intents are no longer supported.

Get the intent to launch inside of an activity view when displaying this notification. This `PendingIntent` should be for an activity.

### getGravity

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public int [getGravity](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getGravity())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Get the gravity that this notification should have within the available viewport space. Supported values include `https://developer.android.com/reference/android/view/Gravity.html#TOP`, `https://developer.android.com/reference/android/view/Gravity.html#CENTER_VERTICAL` and `https://developer.android.com/reference/android/view/Gravity.html#BOTTOM`. The default value is `https://developer.android.com/reference/android/view/Gravity.html#BOTTOM`.

### getHintAmbientBigPicture

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public boolean [getHintAmbientBigPicture](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintAmbientBigPicture())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This feature is no longer supported.

Get a hint that this notification's `https://developer.android.com/reference/androidx/core/app/NotificationCompat.BigPictureStyle` (if present) should be converted to low-bit and displayed in ambient mode, especially useful for barcodes and qr codes, as well as other simple black-and-white tickets.

| Returns |
|---|---|
| `boolean` | `true` if it should be displayed in ambient, false otherwise otherwise. The default value is `false` if this was never set. |

### getHintAvoidBackgroundClipping

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public boolean [getHintAvoidBackgroundClipping](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintAvoidBackgroundClipping())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Get a hint that this notification's background should not be clipped if possible, and should instead be resized to fully display on the screen, retaining the aspect ratio of the image. This can be useful for images like barcodes or qr codes.

| Returns |
|---|---|
| `boolean` | `true` if it's ok if the background is clipped on the screen, false otherwise. The default value is `false` if this was never set. |

### getHintContentIntentLaunchesActivity

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public boolean getHintContentIntentLaunchesActivity()
```

Get a hint that this notification's content intent will launch an `https://developer.android.com/reference/android/app/Activity.html` directly, telling the platform that it can generate the appropriate transitions

| Returns |
|---|---|
| `boolean` | `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. |

### getHintHideIcon

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public boolean [getHintHideIcon](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintHideIcon())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Get a hint that this notification's icon should not be displayed.

| Returns |
|---|---|
| `boolean` | `true` if this icon should not be displayed, false otherwise. The default value is `false` if this was never set. |

### getHintScreenTimeout

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public int [getHintScreenTimeout](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintScreenTimeout())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Get the duration, in milliseconds, that the screen should remain on for when this notification is displayed.

| Returns |
|---|---|
| `int` | the duration in milliseconds if \>0, or either one of the sentinel values `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SCREEN_TIMEOUT_SHORT()` or `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SCREEN_TIMEOUT_LONG()`. |

### getHintShowBackgroundOnly

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public boolean [getHintShowBackgroundOnly](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getHintShowBackgroundOnly())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Get a visual hint that only the background image of this notification should be displayed, and other semantic content should be hidden. This hint is only applicable to sub-pages added using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#addPage(android.app.Notification)`.

### getPages

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull List<Notification> [getPages](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getPages())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Multiple content pages are no longer supported.

Get the array of additional pages of content for displaying this notification. The current notification forms the first page, and elements within this array form subsequent pages. This field can be used to separate a notification into multiple sections.

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/android/app/Notification.html>` | the pages for this notification |

### getStartScrollBottom

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public boolean getStartScrollBottom()
```

Get whether the scrolling position for the contents of this notification should start at the bottom of the contents instead of the top when the contents are too long to display within the screen. Default is false (start scroll at the top).

### setBackground

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setBackground](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setBackground(android.graphics.Bitmap))(@Nullable Bitmap background)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Background images are no longer supported.

Set a background image to be displayed behind the notification content. Contrary to the `https://developer.android.com/reference/androidx/core/app/NotificationCompat.BigPictureStyle`, this background will work with any notification style.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/android/graphics/Bitmap.html background` | the background bitmap |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getBackground()` |   |

### setBridgeTag

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender setBridgeTag(@Nullable String bridgeTag)
```

Sets a bridge tag for this notification. A bridge tag can be set for notifications posted from a phone to provide finer-grained control on what notifications are bridged to wearables. See [Adding Wearable Features to Notifications](https://developer.android.com/training/wearables/notifications/bridger) for more information.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/String.html bridgeTag` | the bridge tag of the notification. |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

### setContentAction

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender setContentAction(int actionIndex)
```

Set an action from this notification's actions as the primary action. If the action has a `https://developer.android.com/reference/androidx/core/app/RemoteInput` associated with it, shortcuts to the options for that input are shown directly on the notification.

| Parameters |
|---|---|
| `int actionIndex` | The index of the primary action. If wearable actions were added to the main notification, this index will apply to that list, otherwise it will apply to the regular actions list. |

### setContentIcon

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setContentIcon](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setContentIcon(int))(int icon)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Set an icon that goes with the content of this notification.

### setContentIconGravity

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setContentIconGravity](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setContentIconGravity(int))(int contentIconGravity)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Set the gravity that the content icon should have within the notification display. Supported values include `https://developer.android.com/reference/android/view/Gravity.html#START` and `https://developer.android.com/reference/android/view/Gravity.html#END`. The default value is `https://developer.android.com/reference/android/view/Gravity.html#END`.

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setContentIcon(int)` |   |

### setContentIntentAvailableOffline

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender setContentIntentAvailableOffline(
    boolean contentIntentAvailableOffline
)
```

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

### setCustomContentHeight

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setCustomContentHeight](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomContentHeight(int))(int height)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Set the custom height in pixels for the display of this notification's content.

This option is only available for custom display notifications created using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent)`. See also `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int)` and `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getCustomContentHeight()`.

### setCustomSizePreset

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setCustomSizePreset](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomSizePreset(int))(int sizePreset)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Set the custom size preset for the display of this notification out of the available presets found in `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender`, e.g. `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SIZE_LARGE()`.

Some custom size presets are only applicable for custom display notifications created using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent)`. Check the documentation for the preset in question. See also `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setCustomContentHeight(int)` and `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getCustomSizePreset()`.

### setDismissalId

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender setDismissalId(@Nullable String dismissalId)
```

Sets the dismissal id for this notification. If a notification is posted with a dismissal id, then when that notification is canceled, notifications on other wearables and the paired Android phone having that same dismissal id will also be canceled. See [Adding Wearable Features to Notifications](https://developer.android.com/training/wearables/notifications/bridger) for more information.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/java/lang/String.html dismissalId` | the dismissal id of the notification. |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

### setDisplayIntent

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setDisplayIntent](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setDisplayIntent(android.app.PendingIntent))(@Nullable PendingIntent intent)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Display intents are no longer supported.

Set an intent to launch inside of an activity view when displaying this notification. The `https://developer.android.com/reference/android/app/PendingIntent.html` provided should be for an activity.

```
Intent displayIntent = new Intent(context, MyDisplayActivity.class);
PendingIntent displayPendingIntent = PendingIntent.getActivity(context,
        0, displayIntent, PendingIntent.FLAG_UPDATE_CURRENT);
Notification notification = new NotificationCompat.Builder(context)
        .extend(new NotificationCompat.WearableExtender()
                .setDisplayIntent(displayPendingIntent)
                .setCustomSizePreset(NotificationCompat.WearableExtender.SIZE_MEDIUM))
.build();
```

The activity to launch needs to allow embedding, must be exported, and should have an empty task affinity. It is also recommended to use the device default light theme.

Example AndroidManifest.xml entry:

```
<activity android:name="com.example.MyDisplayActivity"
    android:exported="true"
    android:allowEmbedded="true"
    android:taskAffinity=""
android:theme="@android:style/Theme.DeviceDefault.Light" />
```

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/android/app/PendingIntent.html intent` | the `https://developer.android.com/reference/android/app/PendingIntent.html` for an activity |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#getDisplayIntent()` |   |

### setGravity

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setGravity](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setGravity(int))(int gravity)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Set the gravity that this notification should have within the available viewport space. Supported values include `https://developer.android.com/reference/android/view/Gravity.html#TOP`, `https://developer.android.com/reference/android/view/Gravity.html#CENTER_VERTICAL` and `https://developer.android.com/reference/android/view/Gravity.html#BOTTOM`. The default value is `https://developer.android.com/reference/android/view/Gravity.html#BOTTOM`.

### setHintAmbientBigPicture

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setHintAmbientBigPicture](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintAmbientBigPicture(boolean))(boolean hintAmbientBigPicture)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This feature is no longer supported.

Set a hint that this notification's `https://developer.android.com/reference/androidx/core/app/NotificationCompat.BigPictureStyle` (if present) should be converted to low-bit and displayed in ambient mode, especially useful for barcodes and qr codes, as well as other simple black-and-white tickets.

| Parameters |
|---|---|
| `boolean hintAmbientBigPicture` | `true` to enable converstion and ambient. |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

### setHintAvoidBackgroundClipping

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setHintAvoidBackgroundClipping](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintAvoidBackgroundClipping(boolean))(boolean hintAvoidBackgroundClipping)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Set a hint that this notification's background should not be clipped if possible, and should instead be resized to fully display on the screen, retaining the aspect ratio of the image. This can be useful for images like barcodes or qr codes.

| Parameters |
|---|---|
| `boolean hintAvoidBackgroundClipping` | `true` to avoid clipping if possible. |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

### setHintContentIntentLaunchesActivity

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender setHintContentIntentLaunchesActivity(
    boolean hintContentIntentLaunchesActivity
)
```

Set a hint that this notification's content intent will launch an `https://developer.android.com/reference/android/app/Activity.html` directly, telling the platform that it can generate the appropriate transitions.

| Parameters |
|---|---|
| `boolean hintContentIntentLaunchesActivity` | `true` if the content intent will launch an activity and transitions should be generated, false otherwise. |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

### setHintHideIcon

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setHintHideIcon](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintHideIcon(boolean))(boolean hintHideIcon)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Set a hint that this notification's icon should not be displayed.

| Parameters |
|---|---|
| `boolean hintHideIcon` | `true` to hide the icon, `false` otherwise. |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

### setHintScreenTimeout

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setHintScreenTimeout](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintScreenTimeout(int))(int timeout)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect.

Set a hint that the screen should remain on for at least this duration when this notification is displayed on the screen.

| Parameters |
|---|---|
| `int timeout` | The requested screen timeout in milliseconds. Can also be either `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SCREEN_TIMEOUT_SHORT()` or `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#SCREEN_TIMEOUT_LONG()`. |

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender` | this object for method chaining |

### setHintShowBackgroundOnly

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender [setHintShowBackgroundOnly](https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#setHintShowBackgroundOnly(boolean))(boolean hintShowBackgroundOnly)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> This method has no effect starting with Wear 2.0.

Set a visual hint that only the background image of this notification should be displayed, and other semantic content should be hidden. This hint is only applicable to sub-pages added using `https://developer.android.com/reference/androidx/core/app/NotificationCompat.WearableExtender#addPage(android.app.Notification)`.

### setStartScrollBottom

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/core#1.1.0)

```
public @NonNull NotificationCompat.WearableExtender setStartScrollBottom(boolean startScrollBottom)
```

Set whether the scrolling position for the contents of this notification should start at the bottom of the contents instead of the top when the contents are too long to display within the screen. Default is false (start scroll at the top).