SIM卡管理

導(dǎo)入模塊

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

sim.isSimActive7+

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

獲取指定卡槽SIM卡是否激活。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

示例：

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

sim.isSimActive7+

isSimActive(slotId: number): Promise<boolean>

獲取指定卡槽SIM卡是否激活。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

返回值：

示例：

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

sim.getDefaultVoiceSlotId7+

getDefaultVoiceSlotId(callback: AsyncCallback<number>): void

獲取默認(rèn)語音業(yè)務(wù)的卡槽ID。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

示例：

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

sim.getDefaultVoiceSlotId7+

getDefaultVoiceSlotId(): Promise<number>

獲取默認(rèn)語音業(yè)務(wù)的卡槽ID。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

返回值：

示例：

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

sim.hasOperatorPrivileges7+

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

檢查應(yīng)用（調(diào)用者）是否已被授予運(yùn)營商權(quán)限。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.hasOperatorPrivileges7+

hasOperatorPrivileges(slotId: number): Promise<boolean>

檢查應(yīng)用（調(diào)用者）是否已被授予運(yùn)營商權(quán)限。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getISOCountryCodeForSim

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

獲取指定卡槽SIM卡的ISO國家碼。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getISOCountryCodeForSim

getISOCountryCodeForSim(slotId: number): Promise<string>

獲取指定卡槽SIM卡的ISO國家碼。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getSimOperatorNumeric

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

獲取指定卡槽SIM卡的歸屬PLMN（Public Land Mobile Network）號。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

sim.getSimOperatorNumeric(0, (err, data) => {
    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異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getSimSpn

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

獲取指定卡槽SIM卡的服務(wù)提供商名稱（Service Provider Name，SPN）。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getSimSpn

getSimSpn(slotId: number): Promise<string>

獲取指定卡槽SIM卡的服務(wù)提供商名稱（Service Provider Name，SPN）。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getSimState

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

獲取指定卡槽的SIM卡狀態(tài)。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getSimState

getSimState(slotId: number): Promise<SimState>

獲取指定卡槽的SIM卡狀態(tài)。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getCardType7+

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

獲取指定卡槽SIM卡的卡類型。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getCardType7+

getCardType(slotId: number): Promise<CardType>

獲取指定卡槽SIM卡的卡類型。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.hasSimCard7+

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

獲取指定卡槽SIM卡是否插卡。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.hasSimCard7+

hasSimCard(slotId: number): Promise<boolean>

獲取指定卡槽SIM卡是否插卡。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getMaxSimCount7+

getMaxSimCount(): number

獲取卡槽數(shù)量。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

返回值：

示例：

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

sim.getOpKey9+

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

獲取指定卡槽中SIM卡的opkey。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getOpKey9+

getOpKey(slotId: number): Promise<string>

獲取指定卡槽中SIM卡的opkey。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getOpName9+

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

獲取指定卡槽中SIM卡的OpName。使用callback異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

sim.getOpName9+

getOpName(slotId: number): Promise<string>

獲取指定卡槽中SIM卡的OpName。使用Promise異步回調(diào)。

系統(tǒng)能力：SystemCapability.Telephony.CoreService

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請參見ohos.telephony(電話子系統(tǒng))錯(cuò)誤碼錯(cuò)誤碼。

示例：

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

SimState

SIM卡狀態(tài)。

系統(tǒng)能力：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.CoreService。

CardType7+

卡類型。

系統(tǒng)能力：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.CoreService。