Builder

Builder

Builder(
    accountHandle: PhoneAccountHandle!, 
    label: CharSequence!)

Creates a builder with the specified PhoneAccountHandle and label.

Note: each CharSequence or String field is limited to 256 characters. This check is enforced when registering the PhoneAccount via TelecomManager#registerPhoneAccount(PhoneAccount) and will cause an IllegalArgumentException to be thrown if the character field limit is over 256.

Builder

Builder(phoneAccount: PhoneAccount!)

Creates an instance of the PhoneAccount.Builder from an existing PhoneAccount.

addSupportedUriScheme

open fun addSupportedUriScheme(uriScheme: String!): PhoneAccount.Builder!

Specifies an additional URI scheme supported by the PhoneAccount.

Each URI scheme is limited to 256 characters. Adding a scheme over 256 characters will cause an IllegalArgumentException to be thrown when the account is registered.

build

open fun build(): PhoneAccount!

Creates an instance of a PhoneAccount based on the current builder settings.

clearSimultaneousCallingRestriction

open fun clearSimultaneousCallingRestriction(): PhoneAccount.Builder

Clears a previously set simultaneous calling restriction set when PhoneAccount.Builder#Builder(PhoneAccount) is used to create a new PhoneAccount from an existing one.

setAddress

open fun setAddress(value: Uri!): PhoneAccount.Builder!

Sets the address. See PhoneAccount#getAddress.

Note: The entire URI value is limited to 256 characters. This check is enforced when registering the PhoneAccount via TelecomManager#registerPhoneAccount(PhoneAccount) and will cause an IllegalArgumentException to be thrown if URI is over 256.

setCapabilities

open fun setCapabilities(value: Int): PhoneAccount.Builder!

Sets the capabilities. See PhoneAccount#getCapabilities.

setExtras

open fun setExtras(extras: Bundle!): PhoneAccount.Builder!

Specifies the extras associated with the PhoneAccount.

PhoneAccounts only support extra values of type: String, Integer, and Boolean. Extras which are not of these types are ignored.

Note: Each Bundle (Key, Value) String field is limited to 256 characters. Additionally, the bundle is limited to 100 (Key, Value) pairs total. This check is enforced when registering the PhoneAccount via TelecomManager#registerPhoneAccount(PhoneAccount) and will cause an IllegalArgumentException to be thrown if the character field limit is over 256 or more than 100 (Key, Value) pairs are in the Bundle.

setHighlightColor

open fun setHighlightColor(value: Int): PhoneAccount.Builder!

Sets the highlight color. See PhoneAccount#getHighlightColor.

setIcon

open fun setIcon(icon: Icon!): PhoneAccount.Builder!

Sets the icon. See PhoneAccount#getIcon.

Note: An IllegalArgumentException if the Icon cannot be written to memory. This check is enforced when registering the PhoneAccount via TelecomManager#registerPhoneAccount(PhoneAccount)

setShortDescription

open fun setShortDescription(value: CharSequence!): PhoneAccount.Builder!

Sets the short description. See PhoneAccount#getShortDescription.

Note: Each CharSequence or String field is limited to 256 characters. This check is enforced when registering the PhoneAccount via TelecomManager#registerPhoneAccount(PhoneAccount) and will cause an IllegalArgumentException to be thrown if the character field limit is over 256.

setSimultaneousCallingRestriction

open fun setSimultaneousCallingRestriction(handles: MutableSet<PhoneAccountHandle!>): PhoneAccount.Builder

Restricts the ability of this PhoneAccount to ONLY support simultaneous calling with the other PhoneAccountHandles in this Set.

If two or more PhoneAccounts support calling simultaneously, it means that Telecom allows the user to place additional outgoing calls and receive additional incoming calls using other PhoneAccounts while this PhoneAccount also has one or more active calls.

If this setter method is never called or cleared using clearSimultaneousCallingRestriction(), there is no restriction and all PhoneAccounts registered to Telecom by this package support simultaneous calling. If this setter is called and set as an empty Set, then this PhoneAccount does not support simultaneous calling with any other PhoneAccounts registered by the same application.

Note: Simultaneous calling restrictions can only be placed on PhoneAccounts that were registered by the same application. Simultaneous calling across applications is always possible as long as the Connection supports hold. If a PhoneAccountHandle is included here and the package name doesn't match this application's package name, TelecomManager#registerPhoneAccount(PhoneAccount) will throw a SecurityException.

setSubscriptionAddress

open fun setSubscriptionAddress(value: Uri!): PhoneAccount.Builder!

Sets the subscription address. See PhoneAccount#getSubscriptionAddress.

setSupportedUriSchemes

open fun setSupportedUriSchemes(uriSchemes: MutableList<String!>!): PhoneAccount.Builder!

Specifies the URI schemes supported by the PhoneAccount.

A max of 10 URI schemes can be added per account. Additionally, each URI scheme is limited to 256 characters. Adding more than 10 URI schemes or 256 characters on any scheme will cause an IllegalArgumentException to be thrown when the account is registered.