SimInfoManager

java.lang.Object
- ohos.telephony.SimInfoManager

```
public class SimInfoManager
extends Object
```
Provides applications with APIs for obtaining SIM card status, card file information, and card specifications. SIM cards include SIM, USIM, and CSIM cards.
This class is a singleton class. Applications can use the getInstance method to obtain an instance and then use the instance to invoke the method for obtaining SIM card information.

从以下版本开始:

1

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`int`	`getCardType(int slotId)`	Obtains the type of the SIM card installed in a specified slot.
`int`	`getDefaultVoiceSlotId()`	Obtains the default card slot for the voice service.
`static SimInfoManager`	`getInstance(Context context)`	Obtains an instance of SimInfoManager.
`String`	`getIsoCountryCodeForSim(int slotId)`	Obtains the ISO country code of the SIM card in a specified slot.
`String`	`getLine1NumberFromImpu(int slotId)`	Obtains the Line 1 phone number from the registered IP multimedia subsystem (IMS) based on a specified slot ID.
`int`	`getMaxSimCount()`	Obtains the maximum number of SIM cards that can be used simultaneously on the device, that is, the maximum number of SIM card slots.
`String`	`getSimGid1(int slotId)`	Obtains the Group Identifier Level 1 (GID1) of the SIM card in a specified slot.
`String`	`getSimIccId(int slotId)`	Obtains the ICCID of the SIM card in a specified slot.
`String`	`getSimOperatorNumeric(int slotId)`	Obtains the home PLMN number of the SIM card in a specified slot.
`String`	`getSimSpn(int slotId)`	Obtains the service provider name (SPN) of the SIM card in a specified slot.
`int`	`getSimState(int slotId)`	Obtains the state of the SIM card in a specified slot.
`String`	`getSimTeleNumberIdentifier(int slotId)`	Obtains the alpha identifier of the phone number of the SIM card in a specified slot.
`String`	`getSimTelephoneNumber(int slotId)`	Obtains the MSISDN of the SIM card in a specified slot.
`int`	`getVoiceMailCount(int slotId)`	Obtains the number of messages in the voice mailbox of the SIM card in the specified slot.
`String`	`getVoiceMailIdentifier(int slotId)`	Obtains the alpha identifier of the voice mailbox of the SIM card in a specified slot.
`String`	`getVoiceMailNumber(int slotId)`	Obtains the voice mailbox number of the SIM card in a specified slot.
`boolean`	`hasOperatorPrivileges(int slotId)`	Checks whether your application (the caller) has been granted the operator permissions.
`boolean`	`hasSimCard(int slotId)`	Checks whether a SIM card is inserted in a specified slot.
`boolean`	`isSimActive(int slotId)`	Checks whether the SIM card in a specified slot is activated.
`boolean`	`isSupportMultiSim()`	Checks whether the device supports multiple SIM cards, that is, whether there are multiple card slots.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - getInstance
```
public static SimInfoManager getInstance(Context context)
```
    Obtains an instance of SimInfoManager.
    
    参数:
    
    context - Indicates the context of the application.
    
    返回:
    
    Returns the instance of SimInfoManager.
    
    从以下版本开始:
    
    1
  - isSupportMultiSim
```
public boolean isSupportMultiSim()
```
    Checks whether the device supports multiple SIM cards, that is, whether there are multiple card slots.
    
    返回:
    
    Returns true if the device supports multiple SIM cards; returns false otherwise.
    
    从以下版本开始:
    
    1
  - getMaxSimCount
```
public int getMaxSimCount()
```
    Obtains the maximum number of SIM cards that can be used simultaneously on the device, that is, the maximum number of SIM card slots.
    
    返回:
    
    Returns the maximum number of SIM card slots.
    
    从以下版本开始:
    
    1
  - getIsoCountryCodeForSim
```
public String getIsoCountryCodeForSim(int slotId)
```
    Obtains the ISO country code of the SIM card in a specified slot.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns the country code defined in ISO 3166-2; returns an empty string if no SIM card is inserted.
    
    从以下版本开始:
    
    1
  - getSimOperatorNumeric
```
public String getSimOperatorNumeric(int slotId)
```
    Obtains the home PLMN number of the SIM card in a specified slot.
    The value is recorded in the SIM card and is irrelevant to the network with which the SIM card is currently registered.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns the PLMN number; returns an empty string if no SIM card is inserted.
    
    从以下版本开始:
    
    1
  - getSimSpn
```
public String getSimSpn(int slotId)
```
    Obtains the service provider name (SPN) of the SIM card in a specified slot.
    The value is recorded in the EFSPN file of the SIM card and is irrelevant to the network with which the SIM card is currently registered.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns the SPN; returns an empty string if no SIM card is inserted or no EFSPN file in the SIM card.
    
    从以下版本开始:
    
    1
  - getSimIccId
```
public String getSimIccId(int slotId)
```
    Obtains the ICCID of the SIM card in a specified slot.
    The ICCID is a unique identifier of a SIM card. It consists of 20 digits and is recorded in the EFICCID file of the SIM card.
    Requires Permission: ohos.permission.GET_TELEPHONY_STATE.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns the ICCID; returns an empty string if no SIM card is inserted.
    
    从以下版本开始:
    
    1
  - getSimTelephoneNumber
```
public String getSimTelephoneNumber(int slotId)
```
    Obtains the MSISDN of the SIM card in a specified slot. The MSISDN is recorded in the EFMSISDN file of the SIM card.
    Requires Permission: ohos.permission.GET_TELEPHONY_STATE.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns the MSISDN; returns an empty string if no SIM card is inserted or no MSISDN is recorded in the EFMSISDN file.
    
    从以下版本开始:
    
    1
  - getSimGid1
```
public String getSimGid1(int slotId)
```
    Obtains the Group Identifier Level 1 (GID1) of the SIM card in a specified slot. The GID1 is recorded in the EFGID1 file of the SIM card.
    Requires Permission: ohos.permission.GET_TELEPHONY_STATE.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns the GID1; returns an empty string if no SIM card is inserted or no GID1 in the SIM card.
    
    从以下版本开始:
    
    1
  - getSimState
```
public int getSimState(int slotId)
```
    Obtains the state of the SIM card in a specified slot.
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    Returns one of the following SIM card states:
    
    TelephonyConstants#SIM_STATE_UNKNOWN
    TelephonyConstants#SIM_STATE_NOT_PRESENT
    TelephonyConstants#SIM_STATE_LOCKED
    TelephonyConstants#SIM_STATE_NOT_READY
    TelephonyConstants#SIM_STATE_READY
    TelephonyConstants#SIM_STATE_LOADED
    从以下版本开始:
    
    1
  - hasSimCard
```
public boolean hasSimCard(int slotId)
```
    Checks whether a SIM card is inserted in a specified slot.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns true if a SIM card is inserted; return false otherwise.
    
    从以下版本开始:
    
    1
  - getSimTeleNumberIdentifier
```
public String getSimTeleNumberIdentifier(int slotId)
```
    Obtains the alpha identifier of the phone number of the SIM card in a specified slot.
    Only applications with the ohos.permission.GET_TELEPHONY_STATE permission can call this method.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns the alpha identifier of the phone number; returns an empty string if no phone number alpha identifier is written into the SIM card.
    
    从以下版本开始:
    
    3
  - getVoiceMailNumber
```
public String getVoiceMailNumber(int slotId)
```
    Obtains the voice mailbox number of the SIM card in a specified slot.
    Only applications with the ohos.permission.GET_TELEPHONY_STATE permission can call this method.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns the voice mailbox number; returns an empty string if no voice mailbox number is written into the SIM card.
    
    从以下版本开始:
    
    3
  - getVoiceMailCount
```
public int getVoiceMailCount(int slotId)
```
    Obtains the number of messages in the voice mailbox of the SIM card in the specified slot.
    Only applications with the ohos.permission.GET_TELEPHONY_STATE permission can call this method.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns the number of messages in the voice mailbox.
    
    从以下版本开始:
    
    3
  - getVoiceMailIdentifier
```
public String getVoiceMailIdentifier(int slotId)
```
    Obtains the alpha identifier of the voice mailbox of the SIM card in a specified slot.
    Only applications with the ohos.permission.GET_TELEPHONY_STATE permission can call this method.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns the voice mailbox alpha identifier; returns an empty string if no voice mailbox alpha identifier is written into the SIM card.
    
    从以下版本开始:
    
    3
  - isSimActive
```
public boolean isSimActive(int slotId)
```
    Checks whether the SIM card in a specified slot is activated.
    
    参数:
    
    slotId - Indicates the card slot index number, ranging from 0 to the maximum card slot index number supported by the device.
    
    返回:
    
    Returns true if the SIM card is activated; returns false otherwise.
    
    从以下版本开始:
    
    3
  - getDefaultVoiceSlotId
```
public int getDefaultVoiceSlotId()
```
    Obtains the default card slot for the voice service.
    
    返回:
    
    Returns 0 if card 1 is used as the default card slot for the voice service; returns 1 if card 2 is used as the default card slot for the voice service; returns -1 if no card is available for the voice service.
    
    从以下版本开始:
    
    3
  - hasOperatorPrivileges
```
public boolean hasOperatorPrivileges(int slotId)
```
    Checks whether your application (the caller) has been granted the operator permissions.
    
    参数:
    
    slotId - Indicates the ID of the SIM card slot.
    
    返回:
    
    Returns true if your application has been granted the operator permissions; returns false otherwise.
    
    从以下版本开始:
    
    4
  - getLine1NumberFromImpu
```
public String getLine1NumberFromImpu(int slotId)
```
    Obtains the Line 1 phone number from the registered IP multimedia subsystem (IMS) based on a specified slot ID.
    Permissions: SystemPermission.GET_TELEPHONY_STATE
    
    参数:
    
    slotId - Indicates the ID of the specified slot.
    
    返回:
    
    Returns a string representation of the Line 1 phone number.
    
    从以下版本开始:
    
    5
  - getCardType
```
public int getCardType(int slotId)
```
    Obtains the type of the SIM card installed in a specified slot.
    
    参数:
    
    slotId - Indicates the ID of the specified slot.
    
    返回:
    
    Returns the SIM card type.
    
    从以下版本开始:
    
    5

类 SimInfoManager

方法概要

从类继承的方法 java.lang.Object

方法详细资料

getInstance

isSupportMultiSim

getMaxSimCount

getIsoCountryCodeForSim

getSimOperatorNumeric

getSimSpn

getSimIccId

getSimTelephoneNumber

getSimGid1

getSimState

hasSimCard

getSimTeleNumberIdentifier

getVoiceMailNumber

getVoiceMailCount

getVoiceMailIdentifier

isSimActive

getDefaultVoiceSlotId

hasOperatorPrivileges

getLine1NumberFromImpu

getCardType