# WatchFacePushManager.SetWatchFaceAsActiveException

Artifact: [androidx.wear.watchfacepush:watchfacepush](https://developer.android.com/jetpack/androidx/releases/wear-watchfacepush) [View Source](https://cs.android.com/search?q=file:androidx/wear/watchfacepush/WatchFacePush.kt+class:androidx.wear.watchfacepush.WatchFacePushManager.SetWatchFaceAsActiveException) Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-watchfacepush#1.0.0)

*** ** * ** ***


```
public final class WatchFacePushManager.SetWatchFaceAsActiveException extends Exception
```

<br />

|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) ||||
| ↳ | [kotlin.Throwable](https://developer.android.com/reference/java/lang/Throwable.html) |||
|   | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception.html) ||
|   |   | ↳ | [androidx.wear.watchfacepush.WatchFacePushManager.SetWatchFaceAsActiveException](https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager.SetWatchFaceAsActiveException) |

*** ** * ** ***

An exception that can be thrown by `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager#setWatchFaceAsActive(kotlin.String)`

## Summary

| ### Constants |
|---|---|
| `static final int` | `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager.SetWatchFaceAsActiveException#ERROR_INVALID_SLOT_ID()` The slot ID provided is not valid. |
| `static final int` | `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager.SetWatchFaceAsActiveException#ERROR_MAXIMUM_ATTEMPTS_REACHED()` The maximum number of attempts to set the watch face as active has been reached. |
| `static final int` | `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager.SetWatchFaceAsActiveException#ERROR_MISSING_PERMISSION() = 1000` The required permission to set the watch face as active is missing. |
| `static final int` | `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager.SetWatchFaceAsActiveException#ERROR_UNKNOWN()` Unknown error while setting a watch face as active. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager.SetWatchFaceAsActiveException#SetWatchFaceAsActiveException(kotlin.Int,kotlin.Throwable)(int errorCode, https://developer.android.com/reference/java/lang/Throwable.html rootCause)` |

| ### Public methods |
|---|---|
| `final int` | `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager.SetWatchFaceAsActiveException#getErrorCode()()` The specific subtype of error occurred. |
| `https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager.SetWatchFaceAsActiveException#getMessage()()` |

### Inherited methods

From [kotlin.Throwable](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-throwable/index.html) `final void` `https://developer.android.com/reference/java/lang/Throwable.html#addSuppressed(java.lang.Throwable)(@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/Throwable.html exception)` `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/Throwable.html` `https://developer.android.com/reference/java/lang/Throwable.html#fillInStackTrace()()` `https://developer.android.com/reference/java/lang/Throwable.html` `https://developer.android.com/reference/java/lang/Throwable.html#getCause()()` `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html` `@https://developer.android.com/reference/androidx/annotation/RecentlyNullable
https://developer.android.com/reference/java/lang/Throwable.html#getLocalizedMessage()()` `@https://developer.android.com/reference/androidx/annotation/NonNull StackTraceElement[]` `@https://developer.android.com/reference/androidx/annotation/RecentlyNonNull
https://developer.android.com/reference/java/lang/Throwable.html#getStackTrace()()` `final @https://developer.android.com/reference/androidx/annotation/NonNull Throwable[]` `@https://developer.android.com/reference/androidx/annotation/RecentlyNonNull
https://developer.android.com/reference/java/lang/Throwable.html#getSuppressed()()` `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/Throwable.html` `https://developer.android.com/reference/java/lang/Throwable.html#initCause(java.lang.Throwable)(@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/Throwable.html cause)` `void` `https://developer.android.com/reference/java/lang/Throwable.html#printStackTrace()()` `void` `https://developer.android.com/reference/java/lang/Throwable.html#printStackTrace(java.io.PrintStream)(@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/io/PrintStream.html s)` `void` `https://developer.android.com/reference/java/lang/Throwable.html#printStackTrace(java.io.PrintWriter)(@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/io/PrintWriter.html s)` `void` `https://developer.android.com/reference/java/lang/Throwable.html#setStackTrace(java.lang.StackTraceElement[])(@https://developer.android.com/reference/androidx/annotation/NonNull StackTraceElement[] stackTrace)`

## Constants

### ERROR_INVALID_SLOT_ID

```
public static final int ERROR_INVALID_SLOT_ID
```

The slot ID provided is not valid. The watch face might have been removed previously, or the ID is simply incorrect. Make sure to retrieve slot IDs by calling `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager#listWatchFaces()` or `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager#addWatchFace(android.os.ParcelFileDescriptor,kotlin.String)`.

### ERROR_MAXIMUM_ATTEMPTS_REACHED

```
public static final int ERROR_MAXIMUM_ATTEMPTS_REACHED
```

The maximum number of attempts to set the watch face as active has been reached.

### ERROR_MISSING_PERMISSION

```
public static final int ERROR_MISSING_PERMISSION = 1000
```

The required permission to set the watch face as active is missing.

### ERROR_UNKNOWN

```
public static final int ERROR_UNKNOWN
```

Unknown error while setting a watch face as active. Typically this means that the Watch Face Push service on the watch could not be accessed or that the watch may be in a bad state.

## Public constructors

### SetWatchFaceAsActiveException

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

```
public SetWatchFaceAsActiveException(int errorCode, Throwable rootCause)
```

| Parameters |
|---|---|
| `int errorCode` | The specific subtype of error occurred. See `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager.SetWatchFaceAsActiveException.Companion.ErrorCode` for the possible values. |
| `https://developer.android.com/reference/java/lang/Throwable.html rootCause` | The exception that caused the problem in the first place. |

## Public methods

### getErrorCode

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

```
public final int getErrorCode()
```

The specific subtype of error occurred. See `https://developer.android.com/reference/androidx/wear/watchfacepush/WatchFacePushManager.SetWatchFaceAsActiveException.Companion.ErrorCode` for the possible values.

### getMessage

```
public String getMessage()
```