Merge "expose Carrier Id related APIs" am: 18b925a7af
am: 0031ae8145
Change-Id: I6e9837cffdcac094557ea99cde0736abdfff0ff9
This commit is contained in:
@@ -37328,10 +37328,13 @@ package android.provider {
|
||||
}
|
||||
|
||||
public static final class Telephony.CarrierId implements android.provider.BaseColumns {
|
||||
method public static android.net.Uri getPreciseCarrierIdUriForSubscriptionId(int);
|
||||
method public static android.net.Uri getUriForSubscriptionId(int);
|
||||
field public static final java.lang.String CARRIER_ID = "carrier_id";
|
||||
field public static final java.lang.String CARRIER_NAME = "carrier_name";
|
||||
field public static final android.net.Uri CONTENT_URI;
|
||||
field public static final java.lang.String PRECISE_CARRIER_ID = "precise_carrier_id";
|
||||
field public static final java.lang.String PRECISE_CARRIER_ID_NAME = "precise_carrier_id_name";
|
||||
}
|
||||
|
||||
public static final class Telephony.Carriers implements android.provider.BaseColumns {
|
||||
@@ -39456,13 +39459,16 @@ package android.service.carrier {
|
||||
|
||||
public class CarrierIdentifier implements android.os.Parcelable {
|
||||
ctor public CarrierIdentifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String);
|
||||
ctor public CarrierIdentifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, int, int);
|
||||
ctor public CarrierIdentifier(byte[], java.lang.String, java.lang.String);
|
||||
method public int describeContents();
|
||||
method public int getCarrierId();
|
||||
method public java.lang.String getGid1();
|
||||
method public java.lang.String getGid2();
|
||||
method public java.lang.String getImsi();
|
||||
method public java.lang.String getMcc();
|
||||
method public java.lang.String getMnc();
|
||||
method public int getPreciseCarrierId();
|
||||
method public java.lang.String getSpn();
|
||||
method public void writeToParcel(android.os.Parcel, int);
|
||||
field public static final android.os.Parcelable.Creator<android.service.carrier.CarrierIdentifier> CREATOR;
|
||||
@@ -42958,6 +42964,7 @@ package android.telephony {
|
||||
method public java.util.List<android.telephony.CellInfo> getAllCellInfo();
|
||||
method public int getCallState();
|
||||
method public android.os.PersistableBundle getCarrierConfig();
|
||||
method public int getCarrierIdFromSimMccMnc();
|
||||
method public deprecated android.telephony.CellLocation getCellLocation();
|
||||
method public java.util.Map<java.lang.Integer, java.util.List<android.telephony.emergency.EmergencyNumber>> getCurrentEmergencyNumberList();
|
||||
method public java.util.Map<java.lang.Integer, java.util.List<android.telephony.emergency.EmergencyNumber>> getCurrentEmergencyNumberList(int);
|
||||
@@ -42995,6 +43002,8 @@ package android.telephony {
|
||||
method public java.lang.String getSimCountryIso();
|
||||
method public java.lang.String getSimOperator();
|
||||
method public java.lang.String getSimOperatorName();
|
||||
method public int getSimPreciseCarrierId();
|
||||
method public java.lang.CharSequence getSimPreciseCarrierIdName();
|
||||
method public java.lang.String getSimSerialNumber();
|
||||
method public int getSimState();
|
||||
method public int getSimState(int);
|
||||
@@ -43050,6 +43059,7 @@ package android.telephony {
|
||||
field public static final java.lang.String ACTION_SECRET_CODE = "android.telephony.action.SECRET_CODE";
|
||||
field public static final java.lang.String ACTION_SHOW_VOICEMAIL_NOTIFICATION = "android.telephony.action.SHOW_VOICEMAIL_NOTIFICATION";
|
||||
field public static final java.lang.String ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED = "android.telephony.action.SUBSCRIPTION_CARRIER_IDENTITY_CHANGED";
|
||||
field public static final java.lang.String ACTION_SUBSCRIPTION_PRECISE_CARRIER_IDENTITY_CHANGED = "android.telephony.action.SUBSCRIPTION_PRECISE_CARRIER_IDENTITY_CHANGED";
|
||||
field public static final int APPTYPE_CSIM = 4; // 0x4
|
||||
field public static final int APPTYPE_ISIM = 5; // 0x5
|
||||
field public static final int APPTYPE_RUIM = 3; // 0x3
|
||||
@@ -43082,6 +43092,8 @@ package android.telephony {
|
||||
field public static final java.lang.String EXTRA_LAUNCH_VOICEMAIL_SETTINGS_INTENT = "android.telephony.extra.LAUNCH_VOICEMAIL_SETTINGS_INTENT";
|
||||
field public static final java.lang.String EXTRA_NOTIFICATION_COUNT = "android.telephony.extra.NOTIFICATION_COUNT";
|
||||
field public static final java.lang.String EXTRA_PHONE_ACCOUNT_HANDLE = "android.telephony.extra.PHONE_ACCOUNT_HANDLE";
|
||||
field public static final java.lang.String EXTRA_PRECISE_CARRIER_ID = "android.telephony.extra.PRECISE_CARRIER_ID";
|
||||
field public static final java.lang.String EXTRA_PRECISE_CARRIER_NAME = "android.telephony.extra.PRECISE_CARRIER_NAME";
|
||||
field public static final java.lang.String EXTRA_STATE = "state";
|
||||
field public static final java.lang.String EXTRA_STATE_IDLE;
|
||||
field public static final java.lang.String EXTRA_STATE_OFFHOOK;
|
||||
|
||||
@@ -71,10 +71,8 @@ public class CarrierIdentifier implements Parcelable {
|
||||
* @param gid2 group id level 2
|
||||
* @param carrierid carrier unique identifier {@link TelephonyManager#getSimCarrierId()}, used
|
||||
* to uniquely identify the carrier and look up the carrier configurations.
|
||||
* @param preciseCarrierId precise carrier identifier {@link TelephonyManager#getSimPreciseCarrierId()}
|
||||
* @hide
|
||||
*
|
||||
* TODO: expose this to public API
|
||||
* @param preciseCarrierId precise carrier identifier
|
||||
* {@link TelephonyManager#getSimPreciseCarrierId()}
|
||||
*/
|
||||
public CarrierIdentifier(String mcc, String mnc, @Nullable String spn,
|
||||
@Nullable String imsi, @Nullable String gid1, @Nullable String gid2,
|
||||
@@ -155,16 +153,16 @@ public class CarrierIdentifier implements Parcelable {
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the carrier id {@link TelephonyManager#getSimCarrierId() }
|
||||
* @hide
|
||||
* Returns the carrier id.
|
||||
* @see TelephonyManager#getSimCarrierId()
|
||||
*/
|
||||
public int getCarrierId() {
|
||||
return mCarrierId;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the precise carrier id {@link TelephonyManager#getSimPreciseCarrierId()}
|
||||
* @hide
|
||||
* Returns the precise carrier id.
|
||||
* @see TelephonyManager#getSimPreciseCarrierId()
|
||||
*/
|
||||
public int getPreciseCarrierId() {
|
||||
return mPreciseCarrierId;
|
||||
|
||||
@@ -3577,8 +3577,9 @@ public final class Telephony {
|
||||
|
||||
/**
|
||||
* Generates a content {@link Uri} used to receive updates on precise carrier identity
|
||||
* change on the given subscriptionId
|
||||
* {@link TelephonyManager#ACTION_SUBSCRIPTION_PRECISE_CARRIER_IDENTITY_CHANGED}.
|
||||
* change on the given subscriptionId returned by
|
||||
* {@link TelephonyManager#getSimPreciseCarrierId()}.
|
||||
* @see TelephonyManager#ACTION_SUBSCRIPTION_PRECISE_CARRIER_IDENTITY_CHANGED
|
||||
* <p>
|
||||
* Use this {@link Uri} with a {@link ContentObserver} to be notified of changes to the
|
||||
* precise carrier identity {@link TelephonyManager#getSimPreciseCarrierId()}
|
||||
@@ -3589,7 +3590,6 @@ public final class Telephony {
|
||||
*
|
||||
* @param subscriptionId the subscriptionId to receive updates on
|
||||
* @return the Uri used to observe precise carrier identity changes
|
||||
* @hide
|
||||
*/
|
||||
public static Uri getPreciseCarrierIdUriForSubscriptionId(int subscriptionId) {
|
||||
return Uri.withAppendedPath(Uri.withAppendedPath(CONTENT_URI, "precise"),
|
||||
@@ -3610,24 +3610,22 @@ public final class Telephony {
|
||||
*/
|
||||
public static final String CARRIER_ID = "carrier_id";
|
||||
|
||||
/**
|
||||
* A user facing carrier name for precise carrier id.
|
||||
* @see TelephonyManager#getSimPreciseCarrierIdName()
|
||||
* This is not a database column, only used to notify content observers for
|
||||
* {@link #getPreciseCarrierIdUriForSubscriptionId(int)}
|
||||
* @hide
|
||||
*/
|
||||
public static final String PRECISE_CARRIER_ID_NAME = "precise_carrier_id_name";
|
||||
|
||||
/**
|
||||
* A fine-grained carrier id.
|
||||
* @see TelephonyManager#getSimPreciseCarrierId()
|
||||
* This is not a database column, only used to notify content observers for
|
||||
* {@link #getPreciseCarrierIdUriForSubscriptionId(int)}
|
||||
* @hide
|
||||
*/
|
||||
public static final String PRECISE_CARRIER_ID = "precise_carrier_id";
|
||||
|
||||
/**
|
||||
* A user facing carrier name for precise carrier id {@link #PRECISE_CARRIER_ID}.
|
||||
* @see TelephonyManager#getSimPreciseCarrierIdName()
|
||||
* This is not a database column, only used to notify content observers for
|
||||
* {@link #getPreciseCarrierIdUriForSubscriptionId(int)}
|
||||
*/
|
||||
public static final String PRECISE_CARRIER_ID_NAME = "precise_carrier_id_name";
|
||||
|
||||
/**
|
||||
* A unique parent carrier id. The parent-child
|
||||
* relationship can be used to further differentiate a single carrier by different networks,
|
||||
@@ -3639,18 +3637,6 @@ public final class Telephony {
|
||||
*/
|
||||
public static final String PARENT_CARRIER_ID = "parent_carrier_id";
|
||||
|
||||
/**
|
||||
* A unique mno carrier id. mno carrier shares the same {@link All#MCCMNC} as carrier id
|
||||
* and can be solely identified by {@link All#MCCMNC} only. If there is no such mno
|
||||
* carrier, then mno carrier id equals to {@link #CARRIER_ID carrier id}.
|
||||
*
|
||||
* <p>mno carrier id can be used as fallback id. When the exact carrier id configurations
|
||||
* are not found, usually fall back to its mno carrier id.
|
||||
* <P>Type: INTEGER </P>
|
||||
* @hide
|
||||
*/
|
||||
public static final String MNO_CARRIER_ID = "mno_carrier_id";
|
||||
|
||||
/**
|
||||
* Contains mappings between matching rules with carrier id for all carriers.
|
||||
* @hide
|
||||
|
||||
@@ -68,7 +68,13 @@ public class CarrierConfigManager {
|
||||
* This intent is broadcast by the system when carrier config changes. An int is specified in
|
||||
* {@link #EXTRA_SLOT_INDEX} to indicate the slot index that this is for. An optional int extra
|
||||
* {@link #EXTRA_SUBSCRIPTION_INDEX} is included to indicate the subscription index if a valid
|
||||
* one is available for the slot index.
|
||||
* one is available for the slot index. An optional int extra
|
||||
* {@link TelephonyManager#EXTRA_CARRIER_ID} is included to indicate the carrier id for the
|
||||
* changed carrier configuration. An optional int extra
|
||||
* {@link TelephonyManager#EXTRA_PRECISE_CARRIER_ID} is included to indicate the precise
|
||||
* carrier id for the changed carrier configuration.
|
||||
* @see TelephonyManager#getSimCarrierId()
|
||||
* @see TelephonyManager#getSimPreciseCarrierId()
|
||||
*/
|
||||
public static final String
|
||||
ACTION_CARRIER_CONFIG_CHANGED = "android.telephony.action.CARRIER_CONFIG_CHANGED";
|
||||
|
||||
@@ -1222,82 +1222,80 @@ public class TelephonyManager {
|
||||
public static final String ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED =
|
||||
"android.telephony.action.SUBSCRIPTION_CARRIER_IDENTITY_CHANGED";
|
||||
|
||||
/**
|
||||
* Broadcast Action: The subscription precise carrier identity has changed.
|
||||
* Similar like {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED}, this intent will be sent
|
||||
* on the event of {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED}. However, its possible
|
||||
* that precise carrier identity changes while
|
||||
* {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} remains the same e.g, the same
|
||||
* subscription switches to different IMSI could potentially change its precise carrier id.
|
||||
*
|
||||
* The intent will have the following extra values:
|
||||
* <ul>
|
||||
* <li>{@link #EXTRA_PRECISE_CARRIER_ID} The up-to-date precise carrier id of the
|
||||
* current subscription.
|
||||
* </li>
|
||||
* <li>{@link #EXTRA_PRECISE_CARRIER_NAME} The up-to-date carrier name of the current
|
||||
* subscription.
|
||||
* </li>
|
||||
* <li>{@link #EXTRA_SUBSCRIPTION_ID} The subscription id associated with the changed carrier
|
||||
* identity.
|
||||
* </li>
|
||||
* </ul>
|
||||
* <p class="note">This is a protected intent that can only be sent by the system.
|
||||
* @hide
|
||||
*/
|
||||
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
|
||||
public static final String ACTION_SUBSCRIPTION_PRECISE_CARRIER_IDENTITY_CHANGED =
|
||||
"android.telephony.action.SUBSCRIPTION_PRECISE_CARRIER_IDENTITY_CHANGED";
|
||||
|
||||
/**
|
||||
* An int extra used with {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} which indicates
|
||||
* the updated carrier id {@link TelephonyManager#getSimCarrierId()} of
|
||||
* the current subscription.
|
||||
* the updated carrier id returned by {@link TelephonyManager#getSimCarrierId()}.
|
||||
* <p>Will be {@link TelephonyManager#UNKNOWN_CARRIER_ID} if the subscription is unavailable or
|
||||
* the carrier cannot be identified.
|
||||
*/
|
||||
public static final String EXTRA_CARRIER_ID = "android.telephony.extra.CARRIER_ID";
|
||||
|
||||
/**
|
||||
* An int extra used with {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} which indicates
|
||||
* the updated mno carrier id of the current subscription.
|
||||
* <p>Will be {@link TelephonyManager#UNKNOWN_CARRIER_ID} if the subscription is unavailable or
|
||||
* the carrier cannot be identified.
|
||||
*
|
||||
*@hide
|
||||
*/
|
||||
public static final String EXTRA_MNO_CARRIER_ID = "android.telephony.extra.MNO_CARRIER_ID";
|
||||
|
||||
/**
|
||||
* An string extra used with {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} which
|
||||
* indicates the updated carrier name of the current subscription.
|
||||
* {@see TelephonyManager#getSimCarrierIdName()}
|
||||
* @see TelephonyManager#getSimCarrierIdName()
|
||||
* <p>Carrier name is a user-facing name of the carrier id {@link #EXTRA_CARRIER_ID},
|
||||
* usually the brand name of the subsidiary (e.g. T-Mobile).
|
||||
*/
|
||||
public static final String EXTRA_CARRIER_NAME = "android.telephony.extra.CARRIER_NAME";
|
||||
|
||||
/**
|
||||
* Broadcast Action: The subscription precise carrier identity has changed.
|
||||
* The precise carrier id can be used to further differentiate a carrier by different
|
||||
* networks, by prepaid v.s.postpaid or even by 4G v.s.3G plan. Each carrier has a unique
|
||||
* carrier id returned by {@link #getSimCarrierId()} but could have multiple precise carrier id.
|
||||
* e.g, {@link #getSimCarrierId()} will always return Tracfone (id 2022) for a Tracfone SIM,
|
||||
* while {@link #getSimPreciseCarrierId()} can return Tracfone AT&T or Tracfone T-Mobile based
|
||||
* on the current subscription IMSI. For carriers without any fine-grained ids, precise carrier
|
||||
* id is same as carrier id.
|
||||
*
|
||||
* <p>Similar like {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED}, this intent will be
|
||||
* sent on the event of {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} while its also
|
||||
* possible to be sent without {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} when
|
||||
* precise carrier id changes with the same carrier id.
|
||||
* e.g, the same subscription switches to different IMSI could potentially change its
|
||||
* precise carrier id while carrier id remains the same.
|
||||
* @see #getSimPreciseCarrierId()
|
||||
* @see #getSimCarrierId()
|
||||
*
|
||||
* The intent will have the following extra values:
|
||||
* <ul>
|
||||
* <li>{@link #EXTRA_PRECISE_CARRIER_ID} The up-to-date precise carrier id of the
|
||||
* current subscription.
|
||||
* </li>
|
||||
* <li>{@link #EXTRA_PRECISE_CARRIER_NAME} The up-to-date name of the precise carrier id.
|
||||
* </li>
|
||||
* <li>{@link #EXTRA_SUBSCRIPTION_ID} The subscription id associated with the changed carrier
|
||||
* identity.
|
||||
* </li>
|
||||
* </ul>
|
||||
* <p class="note">This is a protected intent that can only be sent by the system.
|
||||
*/
|
||||
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
|
||||
public static final String ACTION_SUBSCRIPTION_PRECISE_CARRIER_IDENTITY_CHANGED =
|
||||
"android.telephony.action.SUBSCRIPTION_PRECISE_CARRIER_IDENTITY_CHANGED";
|
||||
|
||||
/**
|
||||
* An int extra used with {@link #ACTION_SUBSCRIPTION_PRECISE_CARRIER_IDENTITY_CHANGED} which
|
||||
* indicates the updated precise carrier id {@link TelephonyManager#getSimPreciseCarrierId()} of
|
||||
* the current subscription. Note, its possible precise carrier id changes while
|
||||
* {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} remains the same e.g, when
|
||||
* subscription switch to different IMSI.
|
||||
* indicates the updated precise carrier id returned by
|
||||
* {@link TelephonyManager#getSimPreciseCarrierId()}. Note, its possible precise carrier id
|
||||
* changes while {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} remains the same
|
||||
* e.g, when subscription switch to different IMSIs.
|
||||
* <p>Will be {@link TelephonyManager#UNKNOWN_CARRIER_ID} if the subscription is unavailable or
|
||||
* the carrier cannot be identified.
|
||||
* @hide
|
||||
*/
|
||||
public static final String EXTRA_PRECISE_CARRIER_ID =
|
||||
"android.telephony.extra.PRECISE_CARRIER_ID";
|
||||
|
||||
/**
|
||||
* An string extra used with {@link #ACTION_SUBSCRIPTION_PRECISE_CARRIER_IDENTITY_CHANGED} which
|
||||
* indicates the updated precise carrier name of the current subscription.
|
||||
* {@see TelephonyManager#getSimPreciseCarrierIdName()}
|
||||
* <p>it's a user-facing name of the precise carrier id {@link #EXTRA_PRECISE_CARRIER_ID},
|
||||
* @hide
|
||||
* indicates the updated precise carrier name returned by
|
||||
* {@link TelephonyManager#getSimPreciseCarrierIdName()}.
|
||||
* <p>it's a user-facing name of the precise carrier id {@link #EXTRA_PRECISE_CARRIER_ID}, e.g,
|
||||
* Tracfone-AT&T.
|
||||
*/
|
||||
public static final String EXTRA_PRECISE_CARRIER_NAME = "android.telephony.extra.CARRIER_NAME";
|
||||
public static final String EXTRA_PRECISE_CARRIER_NAME =
|
||||
"android.telephony.extra.PRECISE_CARRIER_NAME";
|
||||
|
||||
/**
|
||||
* An int extra used with {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} to indicate the
|
||||
@@ -8335,7 +8333,7 @@ public class TelephonyManager {
|
||||
|
||||
/**
|
||||
* Returns carrier id name of the current subscription.
|
||||
* <p>Carrier id name is a user-facing name of carrier id
|
||||
* <p>Carrier id name is a user-facing name of carrier id returned by
|
||||
* {@link #getSimCarrierId()}, usually the brand name of the subsidiary
|
||||
* (e.g. T-Mobile). Each carrier could configure multiple {@link #getSimOperatorName() SPN} but
|
||||
* should have a single carrier name. Carrier name is not a canonical identity,
|
||||
@@ -8345,7 +8343,7 @@ public class TelephonyManager {
|
||||
* @return Carrier name of the current subscription. Return {@code null} if the subscription is
|
||||
* unavailable or the carrier cannot be identified.
|
||||
*/
|
||||
public CharSequence getSimCarrierIdName() {
|
||||
public @Nullable CharSequence getSimCarrierIdName() {
|
||||
try {
|
||||
ITelephony service = getITelephony();
|
||||
if (service != null) {
|
||||
@@ -8362,10 +8360,10 @@ public class TelephonyManager {
|
||||
*
|
||||
* <p>The precise carrier id can be used to further differentiate a carrier by different
|
||||
* networks, by prepaid v.s.postpaid or even by 4G v.s.3G plan. Each carrier has a unique
|
||||
* carrier id {@link #getSimCarrierId()} but can have multiple precise carrier id. e.g,
|
||||
* {@link #getSimCarrierId()} will always return Tracfone (id 2022) for a Tracfone SIM, while
|
||||
* {@link #getSimPreciseCarrierId()} can return Tracfone AT&T or Tracfone T-Mobile based on the
|
||||
* current subscription IMSI.
|
||||
* carrier id returned by {@link #getSimCarrierId()} but could have multiple precise carrier id.
|
||||
* e.g, {@link #getSimCarrierId()} will always return Tracfone (id 2022) for a Tracfone SIM,
|
||||
* while {@link #getSimPreciseCarrierId()} can return Tracfone AT&T or Tracfone T-Mobile based
|
||||
* on the current subscription IMSI.
|
||||
*
|
||||
* <p>For carriers without any fine-grained carrier ids, return {@link #getSimCarrierId()}
|
||||
* <p>Precise carrier ids are defined in the same way as carrier id
|
||||
@@ -8375,8 +8373,6 @@ public class TelephonyManager {
|
||||
* @return Returns fine-grained carrier id of the current subscription.
|
||||
* Return {@link #UNKNOWN_CARRIER_ID} if the subscription is unavailable or the carrier cannot
|
||||
* be identified.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public int getSimPreciseCarrierId() {
|
||||
try {
|
||||
@@ -8392,16 +8388,14 @@ public class TelephonyManager {
|
||||
|
||||
/**
|
||||
* Similar like {@link #getSimCarrierIdName()}, returns user-facing name of the
|
||||
* precise carrier id {@link #getSimPreciseCarrierId()}
|
||||
* precise carrier id returned by {@link #getSimPreciseCarrierId()}.
|
||||
*
|
||||
* <p>The returned name is unlocalized.
|
||||
*
|
||||
* @return user-facing name of the subscription precise carrier id. Return {@code null} if the
|
||||
* subscription is unavailable or the carrier cannot be identified.
|
||||
*
|
||||
* @hide
|
||||
*/
|
||||
public CharSequence getSimPreciseCarrierIdName() {
|
||||
public @Nullable CharSequence getSimPreciseCarrierIdName() {
|
||||
try {
|
||||
ITelephony service = getITelephony();
|
||||
if (service != null) {
|
||||
@@ -8413,6 +8407,62 @@ public class TelephonyManager {
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns carrier id based on sim MCCMNC (returned by {@link #getSimOperator()}) only.
|
||||
* This is used for fallback when configurations/logic for exact carrier id
|
||||
* {@link #getSimCarrierId()} are not found.
|
||||
*
|
||||
* Android carrier id table <a href="https://android.googlesource.com/platform/packages/providers/TelephonyProvider/+/master/assets/carrier_list.textpb">here</a>
|
||||
* can be updated out-of-band, its possible a MVNO (Mobile Virtual Network Operator) carrier
|
||||
* was not fully recognized and assigned to its MNO (Mobile Network Operator) carrier id
|
||||
* by default. After carrier id table update, a new carrier id was assigned. If apps don't
|
||||
* take the update with the new id, it might be helpful to always fallback by using carrier
|
||||
* id based on MCCMNC if there is no match.
|
||||
*
|
||||
* @return matching carrier id from sim MCCMNC. Return {@link #UNKNOWN_CARRIER_ID} if the
|
||||
* subscription is unavailable or the carrier cannot be identified.
|
||||
*/
|
||||
public int getCarrierIdFromSimMccMnc() {
|
||||
try {
|
||||
ITelephony service = getITelephony();
|
||||
if (service != null) {
|
||||
return service.getCarrierIdFromMccMnc(getSlotIndex(), getSimOperator(), true);
|
||||
}
|
||||
} catch (RemoteException ex) {
|
||||
// This could happen if binder process crashes.
|
||||
}
|
||||
return UNKNOWN_CARRIER_ID;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns carrier id based on MCCMNC (returned by {@link #getSimOperator()}) only. This is
|
||||
* used for fallback when configurations/logic for exact carrier id {@link #getSimCarrierId()}
|
||||
* are not found.
|
||||
*
|
||||
* Android carrier id table <a href="https://android.googlesource.com/platform/packages/providers/TelephonyProvider/+/master/assets/carrier_list.textpb">here</a>
|
||||
* can be updated out-of-band, its possible a MVNO (Mobile Virtual Network Operator) carrier
|
||||
* was not fully recognized and assigned to its MNO (Mobile Network Operator) carrier id
|
||||
* by default. After carrier id table update, a new carrier id was assigned. If apps don't
|
||||
* take the update with the new id, it might be helpful to always fallback by using carrier
|
||||
* id based on MCCMNC if there is no match.
|
||||
*
|
||||
* @return matching carrier id from passing MCCMNC. Return {@link #UNKNOWN_CARRIER_ID} if the
|
||||
* subscription is unavailable or the carrier cannot be identified.
|
||||
* @hide
|
||||
*/
|
||||
@RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)
|
||||
public int getCarrierIdFromMccMnc(String mccmnc) {
|
||||
try {
|
||||
ITelephony service = getITelephony();
|
||||
if (service != null) {
|
||||
return service.getCarrierIdFromMccMnc(getSlotIndex(), mccmnc, false);
|
||||
}
|
||||
} catch (RemoteException ex) {
|
||||
// This could happen if binder process crashes.
|
||||
}
|
||||
return UNKNOWN_CARRIER_ID;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return a list of certs in hex string from loaded carrier privileges access rules.
|
||||
*
|
||||
@@ -8436,48 +8486,6 @@ public class TelephonyManager {
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns MNO carrier id of the current subscription’s MCCMNC.
|
||||
* <p>MNO carrier id can be solely identified by subscription mccmnc. This is mainly used
|
||||
* for MNO fallback when exact carrier id {@link #getSimCarrierId()}
|
||||
* configurations are not found.
|
||||
*
|
||||
* @return MNO carrier id of the current subscription. Return the value same as carrier id
|
||||
* {@link #getSimCarrierId()}, if MNO carrier id cannot be identified.
|
||||
* @hide
|
||||
*/
|
||||
public int getSimMNOCarrierId() {
|
||||
try {
|
||||
ITelephony service = getITelephony();
|
||||
if (service != null) {
|
||||
return service.getSubscriptionMNOCarrierId(getSubId());
|
||||
}
|
||||
} catch (RemoteException ex) {
|
||||
// This could happen if binder process crashes.
|
||||
}
|
||||
return UNKNOWN_CARRIER_ID;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns carrier id based on MCCMNC only. This is for fallback when exact carrier id
|
||||
* {@link #getSimCarrierId()} configurations are not found
|
||||
*
|
||||
* @return matching carrier id from passing mccmnc.
|
||||
* @hide
|
||||
*/
|
||||
@RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)
|
||||
public int getCarrierIdFromMccMnc(String mccmnc) {
|
||||
try {
|
||||
ITelephony service = getITelephony();
|
||||
if (service != null) {
|
||||
return service.getCarrierIdFromMccMnc(getSlotIndex(), mccmnc);
|
||||
}
|
||||
} catch (RemoteException ex) {
|
||||
// This could happen if binder process crashes.
|
||||
}
|
||||
return UNKNOWN_CARRIER_ID;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return the application ID for the uicc application type like {@link #APPTYPE_CSIM}.
|
||||
* All uicc applications are uniquely identified by application ID, represented by the hex
|
||||
|
||||
@@ -1336,18 +1336,6 @@ interface ITelephony {
|
||||
*/
|
||||
String getSubscriptionCarrierName(int subId);
|
||||
|
||||
/**
|
||||
* Returns MNO carrier id of the current subscription’s MCCMNC.
|
||||
* <p>MNO carrier id can be solely identified by subscription mccmnc. This is mainly used
|
||||
* for MNO fallback when exact carrier id {@link #getSimCarrierId()}
|
||||
* configurations are not found.
|
||||
*
|
||||
* @return MNO carrier id of the current subscription. Return the value same as carrier id
|
||||
* {@link #getSimCarrierId()}, if MNO carrier id cannot be identified.
|
||||
* @hide
|
||||
*/
|
||||
int getSubscriptionMNOCarrierId(int subId);
|
||||
|
||||
/**
|
||||
* Returns fine-grained carrier id of the current subscription.
|
||||
*
|
||||
@@ -1383,10 +1371,13 @@ interface ITelephony {
|
||||
* Returns carrier id based on MCCMNC only. This will return a MNO carrier id used for fallback
|
||||
* check when exact carrier id {@link #getSimCarrierId()} configurations are not found
|
||||
*
|
||||
* @param isSubscriptionMccMnc. If {@true} it means this is a query for subscription mccmnc
|
||||
* {@false} otherwise.
|
||||
*
|
||||
* @return carrier id from passing mccmnc.
|
||||
* @hide
|
||||
*/
|
||||
int getCarrierIdFromMccMnc(int slotIndex, String mccmnc);
|
||||
int getCarrierIdFromMccMnc(int slotIndex, String mccmnc, boolean isSubscriptionMccMnc);
|
||||
|
||||
/**
|
||||
* Action set from carrier signalling broadcast receivers to enable/disable metered apns
|
||||
|
||||
Reference in New Issue
Block a user