Stay organized with collections
Save and categorize content based on your preferences.
RcsUceAdapter
public
class
RcsUceAdapter
extends Object
Manages RCS User Capability Exchange for the subscription specified.
Requires the PackageManager#FEATURE_TELEPHONY_IMS feature which can be detected using PackageManager.hasSystemFeature(String).
Summary
Public methods |
|---|
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.
|
Inherited methods |
|---|
From class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this object.
|
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object.
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait(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(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()
Causes the current thread to wait until it is awakened, typically
by being notified or interrupted.
|
|
Public methods
isUceSettingEnabled
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.
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 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
| Returns |
|---|
boolean |
true if the user has opted in for automatic refresh of the RCS capabilities of their
contacts, false otherwise. |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# RcsUceAdapter\n\nAdded in [API level 30](/guide/topics/manifest/uses-sdk-element#ApiLevels) \nSummary: [Methods](#pubmethods) \\| [Inherited Methods](#inhmethods) \n\nRcsUceAdapter\n=============\n\n*** ** * ** ***\n\n[Kotlin](/reference/kotlin/android/telephony/ims/RcsUceAdapter \"View this page in Kotlin\") \\|Java\n\n\n`\npublic\n\n\nclass\nRcsUceAdapter\n`\n\n\n`\n\nextends `[Object](/reference/java/lang/Object)`\n\n\n`\n\n`\n\n\n`\n\n|---|-------------------------------------|\n| [java.lang.Object](/reference/java/lang/Object) ||\n| ↳ | android.telephony.ims.RcsUceAdapter |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nManages RCS User Capability Exchange for the subscription specified.\n\n\u003cbr /\u003e\n\n\nRequires the [PackageManager#FEATURE_TELEPHONY_IMS](/reference/android/content/pm/PackageManager#FEATURE_TELEPHONY_IMS) feature which can be detected using [PackageManager.hasSystemFeature(String)](/reference/android/content/pm/PackageManager#hasSystemFeature(java.lang.String)). \n**See also:**\n\n- [for information on creating an instance of this class.](/reference/android/telephony/ims/ImsRcsManager#getUceAdapter())\n\nSummary\n-------\n\n| ### Public methods ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` boolean` | ` `[isUceSettingEnabled](/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. |\n\n| ### Inherited methods |\n|-----------------------|---|\n| From class ` `[java.lang.Object](/reference/java/lang/Object)` ` |---------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](/reference/java/lang/Object) | ` `[clone](/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](/reference/java/lang/Object)` obj) ` Indicates whether some other object is \"equal to\" this one. | | ` void` | ` `[finalize](/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](/reference/java/lang/Class)`\u003c?\u003e` | ` `[getClass](/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this `Object`. | | ` int` | ` `[hashCode](/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](/reference/java/lang/String) | ` `[toString](/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](/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](/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](/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||\n\nPublic methods\n--------------\n\n### isUceSettingEnabled\n\nAdded in [API level 30](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic boolean isUceSettingEnabled ()\n```\n\nThe setting for whether or not the user has opted in to the automatic refresh of the RCS\ncapabilities associated with the contacts in the user's contact address book. By default,\nthis setting is disabled and must be enabled after the user has seen the opt-in dialog shown\nby [ImsRcsManager.ACTION_SHOW_CAPABILITY_DISCOVERY_OPT_IN](/reference/android/telephony/ims/ImsRcsManager#ACTION_SHOW_CAPABILITY_DISCOVERY_OPT_IN).\n\n\nIf this feature is enabled, the device will periodically share the phone numbers of all of\nthe contacts in the user's address book with the carrier to refresh the RCS capabilities\ncache associated with those contacts as the local cache becomes stale.\n\n\nThis setting will only enable this feature if\n[CarrierConfigManager.Ims.KEY_RCS_BULK_CAPABILITY_EXCHANGE_BOOL](/reference/android/telephony/CarrierConfigManager.Ims#KEY_RCS_BULK_CAPABILITY_EXCHANGE_BOOL) is\nalso enabled.\n\n\nNote: This setting does not affect whether or not the device publishes its service\ncapabilities if the subscription supports presence publication.\n\n\u003cbr /\u003e\n\n\nRequires [Manifest.permission.READ_PHONE_STATE](/reference/android/Manifest.permission#READ_PHONE_STATE)\n\n\u003cbr /\u003e\n\n| Returns ||\n|-----------|------------------------------------------------------------------------------------------------------------------------|\n| `boolean` | true if the user has opted in for automatic refresh of the RCS capabilities of their contacts, false otherwise. \u003cbr /\u003e |\n\n| Throws ||\n|-------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [ImsException](/reference/android/telephony/ims/ImsException) | if the subscription associated with this instance of [RcsUceAdapter](/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()](/reference/android/telephony/ims/ImsException#getCode()) for more information on the error codes. |\n| [UnsupportedOperationException](/reference/java/lang/UnsupportedOperationException) | If the device does not have [PackageManager.FEATURE_TELEPHONY_IMS](/reference/android/content/pm/PackageManager#FEATURE_TELEPHONY_IMS). |"]]
