Added in API level 28

Summary: Constants | Inherited Constants | Fields | Methods | Inherited Methods

Telephony.CarrierId

public static final class Telephony.CarrierId
extends Object implements BaseColumns

java.lang.Object
↳	android.provider.Telephony.CarrierId

Contains carrier identification information for the current subscriptions.

Summary

Constants
`String`	`CARRIER_ID` A unique carrier id
`String`	`CARRIER_NAME` A user facing carrier name.
`String`	`PRECISE_CARRIER_ID` A fine-grained carrier id.
`String`	`PRECISE_CARRIER_ID_NAME` A user facing carrier name for precise carrier id `PRECISE_CARRIER_ID`.

Inherited constants

From interface android.provider.BaseColumns

`String`	`_COUNT` The count of rows in a directory.
`String`	`_ID` The unique ID for a row.

Fields
`public static final Uri`	`CONTENT_URI` The `content://` style URI for this provider.

Public methods
`static Uri`	`getPreciseCarrierIdUriForSubscriptionId(int subscriptionId)` Generates a content `Uri` used to receive updates on precise carrier identity change on the given subscriptionId returned by `TelephonyManager#getSimPreciseCarrierId()`.
`static Uri`	`getUriForSubscriptionId(int subscriptionId)` Generates a content `Uri` used to receive updates on carrier identity change on the given subscriptionId Use this `Uri` with a `ContentObserver` to be notified of changes to the carrier identity `TelephonyManager#getSimCarrierId()` while your app is running.

Public methods


      getPreciseCarrierIdUriForSubscriptionId(int subscriptionId)

Generates a content Uri used to receive updates on precise carrier identity change on the given subscriptionId returned by TelephonyManager#getSimPreciseCarrierId().


      getUriForSubscriptionId(int subscriptionId)

Generates a content Uri used to receive updates on carrier identity change on the given subscriptionId

Use this Uri with a ContentObserver to be notified of changes to the carrier identity TelephonyManager#getSimCarrierId() while your app is running.

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 timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

Constants

CARRIER_ID

Added in API level 28

public static final String CARRIER_ID

A unique carrier id

See also:

Type: INTEGER

Constant Value: "carrier_id"

CARRIER_NAME

Added in API level 28

public static final String CARRIER_NAME

A user facing carrier name.

See also:

Type: TEXT

Constant Value: "carrier_name"

PRECISE_CARRIER_ID

Added in Android Q

public static final String PRECISE_CARRIER_ID

A fine-grained carrier id.

See also:

This is not a database column, only used to notify content observers for {@link #getPreciseCarrierIdUriForSubscriptionId(int)}

Constant Value: "precise_carrier_id"

PRECISE_CARRIER_ID_NAME

Added in Android Q

public static final String PRECISE_CARRIER_ID_NAME

A user facing carrier name for precise carrier id PRECISE_CARRIER_ID.

See also:

This is not a database column, only used to notify content observers for {@link #getPreciseCarrierIdUriForSubscriptionId(int)}

Constant Value: "precise_carrier_id_name"

Fields

CONTENT_URI

Added in API level 28

public static final Uri CONTENT_URI

The content:// style URI for this provider.

Public methods

getPreciseCarrierIdUriForSubscriptionId

Added in Android Q

public static Uri getPreciseCarrierIdUriForSubscriptionId (int subscriptionId)

Generates a content Uri used to receive updates on precise carrier identity change on the given subscriptionId returned by TelephonyManager#getSimPreciseCarrierId().

Parameters
`subscriptionId`	`int`: the subscriptionId to receive updates on

Returns
`Uri`	the Uri used to observe precise carrier identity changes

See also:

Use this {@link android.net.Uri Uri} with a {@link android.database.ContentObserver ContentObserver} to be notified of changes to the precise carrier identity {@link android.telephony.TelephonyManager#getSimPreciseCarrierId() TelephonyManager#getSimPreciseCarrierId()} while your app is running. You can also use a {@link android.app.job.JobService JobService} to ensure your app is notified of changes to the {@link android.net.Uri Uri} even when it is not running. Note, however, that using a {@link android.app.job.JobService JobService} does not guarantee timely delivery of updates to the {@link android.net.Uri Uri}.

getUriForSubscriptionId

Added in API level 28

public static Uri getUriForSubscriptionId (int subscriptionId)

Generates a content Uri used to receive updates on carrier identity change on the given subscriptionId

Use this Uri with a ContentObserver to be notified of changes to the carrier identity TelephonyManager#getSimCarrierId() while your app is running. You can also use a JobService to ensure your app is notified of changes to the Uri even when it is not running. Note, however, that using a JobService does not guarantee timely delivery of updates to the Uri.

Parameters
`subscriptionId`	`int`: the subscriptionId to receive updates on

Returns
`Uri`	the Uri used to observe carrier identity changes