@ohos.telephony.sim (SIM卡管理)

SIM卡管理模块提供了SIM卡管理的基础能力，包括获取指定卡槽SIM卡的ISO国家码、归属PLMN号、服务提供商名称、SIM卡状态、卡类型、是否插卡、是否激活等。

说明：

本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import sim from '@ohos.telephony.sim';

sim.isSimActive⁷⁺

isSimActive(slotId: number, callback: AsyncCallback<boolean>): void

获取指定卡槽SIM卡是否激活。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.isSimActive(0, (err: BusinessError, data: boolean) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.isSimActive⁷⁺

isSimActive(slotId: number): Promise<boolean>

获取指定卡槽SIM卡是否激活。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.isSimActive(0).then((data: boolean) => {
    console.log(`isSimActive success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`isSimActive failed, promise: err->${JSON.stringify(err)}`);
});

sim.isSimActiveSync¹⁰⁺

isSimActiveSync(slotId: number): boolean

获取指定卡槽SIM卡是否激活。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

import sim from '@ohos.telephony.sim';

let isSimActive: boolean = sim.isSimActiveSync(0);
console.log(`the sim is active:` + isSimActive);

sim.getDefaultVoiceSlotId⁷⁺

getDefaultVoiceSlotId(callback: AsyncCallback<number>): void

获取默认语音业务的卡槽ID。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getDefaultVoiceSlotId((err: BusinessError, data: number) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.getDefaultVoiceSlotId⁷⁺

getDefaultVoiceSlotId(): Promise<number>

获取默认语音业务的卡槽ID。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

返回值：

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getDefaultVoiceSlotId().then((data: number) => {
    console.log(`getDefaultVoiceSlotId success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getDefaultVoiceSlotId failed, promise: err->${JSON.stringify(err)}`);
});

sim.hasOperatorPrivileges⁷⁺

hasOperatorPrivileges(slotId: number, callback: AsyncCallback<boolean>): void

检查应用（调用者）是否已被授予运营商权限。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.hasOperatorPrivileges(0, (err: BusinessError, data: boolean) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.hasOperatorPrivileges⁷⁺

hasOperatorPrivileges(slotId: number): Promise<boolean>

检查应用（调用者）是否已被授予运营商权限。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.hasOperatorPrivileges(0).then((data: boolean) => {
    console.log(`hasOperatorPrivileges success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`hasOperatorPrivileges failed, promise: err->${JSON.stringify(err)}`);
});

sim.getISOCountryCodeForSim

getISOCountryCodeForSim(slotId: number, callback: AsyncCallback<string>): void

获取指定卡槽SIM卡的ISO国家码。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getISOCountryCodeForSim(0, (err: BusinessError, data: string) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.getISOCountryCodeForSim

getISOCountryCodeForSim(slotId: number): Promise<string>

获取指定卡槽SIM卡的ISO国家码。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getISOCountryCodeForSim(0).then((data: string) => {
    console.log(`getISOCountryCodeForSim success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getISOCountryCodeForSim failed, promise: err->${JSON.stringify(err)}`);
});

sim.getISOCountryCodeForSimSync¹⁰⁺

getISOCountryCodeForSimSync(slotId: number): string

获取指定卡槽SIM卡的ISO国家码。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

import sim from '@ohos.telephony.sim';

let countryCode: string = sim.getISOCountryCodeForSimSync(0);
console.log(`the country ISO is:` + countryCode);

sim.getSimOperatorNumeric

getSimOperatorNumeric(slotId: number, callback: AsyncCallback<string>): void

获取指定卡槽SIM卡的归属PLMN（Public Land Mobile Network）号。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getSimOperatorNumeric(0, (err: BusinessError, data: string) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.getSimOperatorNumeric

getSimOperatorNumeric(slotId: number): Promise<string>

获取指定卡槽SIM卡的归属PLMN（Public Land Mobile Network）号。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getSimOperatorNumeric(0).then((data: string) => {
    console.log(`getSimOperatorNumeric success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getSimOperatorNumeric failed, promise: err->${JSON.stringify(err)}`);
});

sim.getSimOperatorNumericSync¹⁰⁺

getSimOperatorNumericSync(slotId: number): string

获取指定卡槽SIM卡的归属PLMN（Public Land Mobile Network）号。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

import sim from '@ohos.telephony.sim';

let numeric: string = sim.getSimOperatorNumericSync(0);
console.log(`the sim operator numeric is:` + numeric);

sim.getSimSpn

getSimSpn(slotId: number, callback: AsyncCallback<string>): void

获取指定卡槽SIM卡的服务提供商名称（Service Provider Name，SPN）。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getSimSpn(0, (err: BusinessError, data: string) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.getSimSpn

getSimSpn(slotId: number): Promise<string>

获取指定卡槽SIM卡的服务提供商名称（Service Provider Name，SPN）。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getSimSpn(0).then((data: string) => {
    console.log(`getSimSpn success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getSimSpn failed, promise: err->${JSON.stringify(err)}`);
});

sim.getSimSpnSync¹⁰⁺

getSimSpnSync(slotId: number): string

获取指定卡槽SIM卡的服务提供商名称（Service Provider Name，SPN）。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

import sim from '@ohos.telephony.sim';

let spn: string = sim.getSimSpnSync(0);
console.log(`the sim card spn is:` + spn);

sim.getSimState

getSimState(slotId: number, callback: AsyncCallback<SimState>): void

获取指定卡槽的SIM卡状态。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getSimState(0, (err: BusinessError, data: sim.SimState) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.getSimState

getSimState(slotId: number): Promise<SimState>

获取指定卡槽的SIM卡状态。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getSimState(0).then((data: sim.SimState) => {
    console.log(`getSimState success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getSimState failed, promise: err->${JSON.stringify(err)}`);
});

sim.getSimStateSync¹⁰⁺

getSimStateSync(slotId: number): SimState

获取指定卡槽的SIM卡状态。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

import sim from '@ohos.telephony.sim';

let simState: sim.SimState = sim.getSimStateSync(0);
console.log(`The sim state is:` + simState);

sim.getCardType⁷⁺

getCardType(slotId: number, callback: AsyncCallback<CardType>): void

获取指定卡槽SIM卡的卡类型。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getCardType(0, (err: BusinessError, data: sim.CardType) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.getCardType⁷⁺

getCardType(slotId: number): Promise<CardType>

获取指定卡槽SIM卡的卡类型。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getCardType(0).then((data: sim.CardType) => {
    console.log(`getCardType success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getCardType failed, promise: err->${JSON.stringify(err)}`);
});

sim.getCardTypeSync¹⁰⁺

getCardTypeSync(slotId: number): CardType

获取指定卡槽SIM卡的卡类型。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

import sim from '@ohos.telephony.sim';

let cardType: sim.CardType = sim.getCardTypeSync(0);
console.log(`the card type is:` + cardType);

sim.hasSimCard⁷⁺

hasSimCard(slotId: number, callback: AsyncCallback<boolean>): void

获取指定卡槽SIM卡是否插卡。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.hasSimCard(0, (err: BusinessError, data: boolean) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.hasSimCard⁷⁺

hasSimCard(slotId: number): Promise<boolean>

获取指定卡槽SIM卡是否插卡。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.hasSimCard(0).then((data: boolean) => {
    console.log(`hasSimCard success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`hasSimCard failed, promise: err->${JSON.stringify(err)}`);
});

sim.hasSimCardSync¹⁰⁺

hasSimCardSync(slotId: number): boolean

获取指定卡槽SIM卡是否插卡。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

import sim from '@ohos.telephony.sim';

let hasSimCard: boolean = sim.hasSimCardSync(0);
console.log(`has sim card: ` + hasSimCard);

sim.getSimAccountInfo¹⁰⁺

getSimAccountInfo(slotId: number, callback: AsyncCallback<IccAccountInfo>): void

获取SIM卡帐户信息。使用callback异步回调。

需要权限：ohos.permission.GET_TELEPHONY_STATE

说明：

仅需获取ICCID和号码信息时需要GET_TELEPHONY_STATE权限，ICCID和号码信息为敏感数据，不向三方应用开放。调用接口时，获取到的ICCID和号码信息为空。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getSimAccountInfo(0, (err:BusinessError , data: sim.IccAccountInfo) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.getSimAccountInfo¹⁰⁺

getSimAccountInfo(slotId: number): Promise<IccAccountInfo>

获取SIM卡帐户信息。使用Promise异步回调。

需要权限：ohos.permission.GET_TELEPHONY_STATE

说明：

仅需获取ICCID和号码信息时需要GET_TELEPHONY_STATE权限，ICCID和号码信息为敏感数据，不向三方应用开放。调用接口时，获取到的ICCID和号码信息为空。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getSimAccountInfo(0).then((data: sim.IccAccountInfo) => {
    console.log(`getSimAccountInfo success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getSimAccountInfo failed, promise: err->${JSON.stringify(err)}`);
});

sim.getActiveSimAccountInfoList¹⁰⁺

getActiveSimAccountInfoList(callback: AsyncCallback<Array<IccAccountInfo>>): void

获取激活SIM卡帐户信息列表。使用callback异步回调。

需要权限：ohos.permission.GET_TELEPHONY_STATE

说明：

仅需获取ICCID和号码信息时需要GET_TELEPHONY_STATE权限，ICCID和号码信息为敏感数据，不向三方应用开放。调用接口时，获取到的ICCID和号码信息为空。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getActiveSimAccountInfoList((err: BusinessError, data: Array<sim.IccAccountInfo>) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.getMaxSimCount⁷⁺

getMaxSimCount(): number

获取卡槽数量。

系统能力：SystemCapability.Telephony.CoreService

返回值：

示例：

import sim from '@ohos.telephony.sim';

console.log("Result: "+ sim.getMaxSimCount());

sim.getActiveSimAccountInfoList¹⁰⁺

getActiveSimAccountInfoList(): Promise<Array<IccAccountInfo>>

获取激活SIM卡帐户信息列表。使用Promise异步回调。

需要权限：ohos.permission.GET_TELEPHONY_STATE

说明：

仅需获取ICCID和号码信息时需要GET_TELEPHONY_STATE权限，ICCID和号码信息为敏感数据，不向三方应用开放。调用接口时，获取到的ICCID和号码信息为空。

系统能力：SystemCapability.Telephony.CoreService

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getActiveSimAccountInfoList().then((data: Array<sim.IccAccountInfo>) => {
    console.log(`getActiveSimAccountInfoList success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getActiveSimAccountInfoList failed, promise: err->${JSON.stringify(err)}`);
});

sim.getOpKey⁹⁺

getOpKey(slotId: number, callback: AsyncCallback<string>): void

获取指定卡槽中SIM卡的opkey。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

try {
    sim.getOpKey(0, (err: BusinessError, data: string) => {
    if (err) {
      console.error("getOpKey failed, err: " + JSON.stringify(err));
    } else {
      console.log('getOpKey successfully, data: ' + JSON.stringify(data));
    }
  });
} catch (err) {
  console.error("getOpKey err: " + JSON.stringify(err));
}

sim.getOpKey⁹⁺

getOpKey(slotId: number): Promise<string>

获取指定卡槽中SIM卡的opkey。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getOpKey(0).then((data: string) => {
    console.log(`getOpKey success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getOpKey failed, promise: err->${JSON.stringify(err)}`);
});

sim.getOpKeySync¹⁰⁺

getOpKeySync(slotId: number): string

获取指定卡槽中SIM卡的opkey。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

import sim from '@ohos.telephony.sim';

let data: string = sim.getOpKeySync(0);
console.log(`getOpKey success, promise: data->${JSON.stringify(data)}`);

sim.getOpName⁹⁺

getOpName(slotId: number, callback: AsyncCallback<string>): void

获取指定卡槽中SIM卡的OpName。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

try {
    sim.getOpName(0, (err: BusinessError, data: string) => {
    if (err) {
      console.error("getOpName failed, err: " + JSON.stringify(err));
    } else {
      console.log('getOpName successfully, data: ' + JSON.stringify(data));
    }
  });
} catch (err) {
  console.error("getOpName err: " + JSON.stringify(err));
}

sim.getOpName⁹⁺

getOpName(slotId: number): Promise<string>

获取指定卡槽中SIM卡的OpName。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getOpName(0).then((data: string) => {
    console.log(`getOpName success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getOpName failed, promise: err->${JSON.stringify(err)}`);
});

sim.getOpNameSync¹⁰⁺

getOpNameSync(slotId: number): string

获取指定卡槽中SIM卡的OpName。

系统能力：SystemCapability.Telephony.CoreService

参数：

返回值：

示例：

import sim from '@ohos.telephony.sim';

let data: string = sim.getOpNameSync(0);
console.log(`getOpName success, promise: data->${JSON.stringify(data)}`);

sim.getDefaultVoiceSimId¹⁰⁺

getDefaultVoiceSimId(callback: AsyncCallback<number>): void

获取默认语音业务的SIM卡ID。使用callback异步回调。

系统能力：SystemCapability.Telephony.CoreService

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

sim.getDefaultVoiceSimId((err: BusinessError, data: number) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sim.getDefaultVoiceSimId¹⁰⁺

getDefaultVoiceSimId(): Promise<number>

获取默认语音业务的SIM卡ID。使用Promise异步回调。

系统能力：SystemCapability.Telephony.CoreService

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import { BusinessError } from '@ohos.base';
import sim from '@ohos.telephony.sim';

let promise = sim.getDefaultVoiceSimId();
promise.then((data: number) => {
    console.log(`getDefaultVoiceSimId success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getDefaultVoiceSimId failed, promise: err->${JSON.stringify(err)}`);
});

SimState

SIM卡状态。

系统能力：SystemCapability.Telephony.CoreService

CardType⁷⁺

卡类型。

系统能力：SystemCapability.Telephony.CoreService

IccAccountInfo¹⁰⁺

Icc帐户信息。

系统能力：SystemCapability.Telephony.CoreService