# RcsUceAdapter

Added in[API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Summary:[Methods](https://developer.android.com/reference/android/telephony/ims/RcsUceAdapter#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/telephony/ims/RcsUceAdapter#inhmethods)  

# RcsUceAdapter

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/telephony/ims/RcsUceAdapter "View this page in Kotlin")\|Java

`
public


class
RcsUceAdapter
`  
`

extends `[Object](https://developer.android.com/reference/java/lang/Object)`


``


`

|---|-------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.telephony.ims.RcsUceAdapter |

<br />

*** ** * ** ***

Manages RCS User Capability Exchange for the subscription specified.  
Requires the[PackageManager#FEATURE_TELEPHONY_IMS](https://developer.android.com/reference/android/content/pm/PackageManager#FEATURE_TELEPHONY_IMS)feature which can be detected using[PackageManager.hasSystemFeature(String)](https://developer.android.com/reference/android/content/pm/PackageManager#hasSystemFeature(java.lang.String)).  
**See also:**

- [for information on creating an instance of this class.](https://developer.android.com/reference/android/telephony/ims/ImsRcsManager#getUceAdapter())

## Summary

|                                                                                                                                                 ### Public methods                                                                                                                                                  ||
|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` boolean` | ` `[isUceSettingEnabled](https://developer.android.com/reference/android/telephony/ims/RcsUceAdapter#isUceSettingEnabled())`() ` The setting for whether or not the user has opted in to the automatic refresh of the RCS capabilities associated with the contacts in the user's contact address book. |

| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object)          | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object.                                                                                                                                                      | | ` boolean`                                                                     | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one.                                           | | ` void`                                                                        | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.                                                          | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`<?>` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`.                                                                                                                                                | | ` int`                                                                         | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object.                                                                                                                                                 | | ` final void`                                                                  | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor.                                                                                                                            | | ` final void`                                                                  | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor.                                                                                                                         | | ` `[String](https://developer.android.com/reference/java/lang/String)          | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object.                                                                                                                                            | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed.                   | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*.                                                                                             | ||

## Public methods

### isUceSettingEnabled

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

```
public boolean isUceSettingEnabled ()
```

The setting for whether or not the user has opted in to the automatic refresh of the RCS capabilities associated with the contacts in the user's contact address book. By default, this setting is disabled and must be enabled after the user has seen the opt-in dialog shown by[ImsRcsManager.ACTION_SHOW_CAPABILITY_DISCOVERY_OPT_IN](https://developer.android.com/reference/android/telephony/ims/ImsRcsManager#ACTION_SHOW_CAPABILITY_DISCOVERY_OPT_IN).

If this feature is enabled, the device will periodically share the phone numbers of all of the contacts in the user's address book with the carrier to refresh the RCS capabilities cache associated with those contacts as the local cache becomes stale.

This setting will only enable this feature if[CarrierConfigManager.Ims.KEY_RCS_BULK_CAPABILITY_EXCHANGE_BOOL](https://developer.android.com/reference/android/telephony/CarrierConfigManager.Ims#KEY_RCS_BULK_CAPABILITY_EXCHANGE_BOOL)is also enabled.

Note: This setting does not affect whether or not the device publishes its service capabilities if the subscription supports presence publication.  
Requires[Manifest.permission.READ_PHONE_STATE](https://developer.android.com/reference/android/Manifest.permission#READ_PHONE_STATE)

<br />

|                                                              Returns                                                              ||
|-----------|------------------------------------------------------------------------------------------------------------------------|
| `boolean` | true if the user has opted in for automatic refresh of the RCS capabilities of their contacts, false otherwise. <br /> |

|                                                                                                                                                                                                                                                                                                      Throws                                                                                                                                                                                                                                                                                                      ||
|------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [ImsException](https://developer.android.com/reference/android/telephony/ims/ImsException)                       | if the subscription associated with this instance of[RcsUceAdapter](https://developer.android.com/reference/android/telephony/ims/RcsUceAdapter)is valid, but the ImsService associated with the subscription is not available. This can happen if the ImsService has crashed, for example, or if the subscription becomes inactive. See[ImsException.getCode()](https://developer.android.com/reference/android/telephony/ims/ImsException#getCode())for more information on the error codes. |
| [UnsupportedOperationException](https://developer.android.com/reference/java/lang/UnsupportedOperationException) | If the device does not have[PackageManager.FEATURE_TELEPHONY_IMS](https://developer.android.com/reference/android/content/pm/PackageManager#FEATURE_TELEPHONY_IMS).                                                                                                                                                                                                                                                                                                                            |