鸿蒙开发电话服务：【@ohos.telephony.sim (SIM卡管理)】

2024-06-17 02:12
文章标签 服务 开发 电话 sim 鸿蒙 ohos 卡管理 telephony

本文主要是介绍鸿蒙开发电话服务：【@ohos.telephony.sim (SIM卡管理)】，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

SIM卡管理

说明：

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

导入模块

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

sim.isSimActive7+

isSimActive(slotId: number, callback: AsyncCallback): void

获取指定卡槽SIM卡是否激活，使用callback方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2
callbackAsyncCallback是回调函数。

示例：

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

sim.isSimActive7+

isSimActive(slotId: number): Promise

获取指定卡槽SIM卡是否激活，使用Promise方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2

返回值：

类型说明
Promise以Promise形式返回指定卡槽是否激活，如果激活返回true。

示例：

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

sim.getDefaultVoiceSlotId7+

getDefaultVoiceSlotId(callback: AsyncCallback): void

获取默认语音业务的卡槽ID，使用callback方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
callbackAsyncCallback是回调函数。

示例：

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

sim.getDefaultVoiceSlotId7+

getDefaultVoiceSlotId(): Promise

获取默认语音业务的卡槽ID，使用Promise方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

返回值：

类型说明
Promise以Promise形式返回默认语音业务的卡槽ID。

示例：

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

sim.hasOperatorPrivileges7+

hasOperatorPrivileges(slotId: number, callback: AsyncCallback): void

检查应用（调用者）是否已被授予运营商权限，使用callback方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2
callbackAsyncCallback是回调函数。

示例：

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

sim.hasOperatorPrivileges7+

hasOperatorPrivileges(slotId: number): Promise

检查应用（调用者）是否已被授予运营商权限，使用Promise方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2

返回值：

类型说明
Promise以Promise形式返回检查应用（调用者）是否已被授予运营商权限。

示例：

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

sim.getISOCountryCodeForSim

getISOCountryCodeForSim(slotId: number, callback: AsyncCallback): void

获取指定卡槽SIM卡的ISO国家码，使用callback方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2
callbackAsyncCallback是回调函数。返回国家码，例如：CN（中国）。

示例：

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

sim.getISOCountryCodeForSim

getISOCountryCodeForSim(slotId: number): Promise

获取指定卡槽SIM卡的ISO国家码，使用Promise方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2

返回值：

类型说明
Promise以Promise形式返回获取指定卡槽SIM卡的ISO国家码，例如：CN（中国）。

示例：

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

sim.getSimOperatorNumeric

getSimOperatorNumeric(slotId: number, callback: AsyncCallback): void

获取指定卡槽SIM卡的归属PLMN（Public Land Mobile Network）号，使用callback方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2
callbackAsyncCallback是回调函数。

示例：

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

sim.getSimOperatorNumeric

getSimOperatorNumeric(slotId: number): Promise

获取指定卡槽SIM卡的归属PLMN（Public Land Mobile Network）号，使用Promise方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2

返回值：

类型说明
Promise以Promise形式返回获取指定卡槽SIM卡的归属PLMN号。

示例：

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

sim.getSimSpn

getSimSpn(slotId: number, callback: AsyncCallback): void

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

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2
callbackAsyncCallback是回调函数。

示例：

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

sim.getSimSpn

getSimSpn(slotId: number): Promise

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

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2

返回值：

类型说明
Promise以Promise形式返回获取指定卡槽SIM卡的SPN。

示例：

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

sim.getSimState

getSimState(slotId: number, callback: AsyncCallback): void

获取指定卡槽的SIM卡状态，使用callback方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2
callbackAsyncCallback<[SimState]>是回调函数。参考SimState。

示例：

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

sim.getSimState

getSimState(slotId: number): Promise

获取指定卡槽的SIM卡状态，使用Promise方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2

返回值：

类型说明
Promise<[SimState]>以Promise形式返回获取指定卡槽的SIM卡状态。

示例：

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

sim.getCardType7+

getCardType(slotId: number, callback: AsyncCallback): void

获取指定卡槽SIM卡的卡类型，使用callback方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2
callbackAsyncCallback<[CardType]>是回调函数。

示例：

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

sim.getCardType7+

getCardType(slotId: number): Promise

获取指定卡槽SIM卡的卡类型，使用Promise方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2

返回值：

类型说明
Promise<[CardType]>以Promise形式返回指定卡槽SIM卡的卡类型。

示例：

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

sim.hasSimCard7+

hasSimCard(slotId: number, callback: AsyncCallback): void

获取指定卡槽SIM卡是否插卡，使用callback方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2
callbackAsyncCallback是回调函数。

示例：

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

sim.hasSimCard7+

hasSimCard(slotId: number): Promise

获取指定卡槽SIM卡是否插卡，使用Promise方式作为异步方法。

系统能力：SystemCapability.Communication.CoreService

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。 - 0：卡槽1 - 1：卡槽2

返回值：

类型说明
Promise以Promise形式返回指定卡槽是否插卡，如果插卡返回true。

示例：

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

sim.getMaxSimCount7+

getMaxSimCount(): number

获取卡槽数量。

系统能力：SystemCapability.Communication.CoreService

返回值：

类型说明
number卡槽数量。

示例：

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

SimState

SIM卡状态。

系统能力：以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称值说明
SIM_STATE_UNKNOWN0SIM卡状态未知，即无法获取准确的状态。
SIM_STATE_NOT_PRESENT1表示SIM卡处于not present状态，即卡槽中没有插入SIM卡。
SIM_STATE_LOCKED2表示SIM卡处于locked状态，即SIM卡被PIN、PUK或网络锁锁定。
SIM_STATE_NOT_READY3表示SIM卡处于not ready状态，即SIM卡在位但无法正常工作。
SIM_STATE_READY4表示SIM卡处于ready状态，即SIM卡在位且工作正常。
SIM_STATE_LOADED5表示SIM卡处于loaded状态，即SIM卡在位且所有卡文件加载完毕。

CardType7+

卡类型。

系统能力：以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称值说明
UNKNOWN_CARD-1未知类型
SINGLE_MODE_SIM_CARD10单SIM卡
SINGLE_MODE_USIM_CARD20单USIM卡
SINGLE_MODE_RUIM_CARD30单RUIM卡
DUAL_MODE_CG_CARD40双卡模式C+G
CT_NATIONAL_ROAMING_CARD41中国电信内部漫游卡
CU_DUAL_MODE_CARD42中国联通双模卡
DUAL_MODE_TELECOM_LTE_CARD43双模式电信LTE卡
DUAL_MODE_UG_CARD50双模式UG卡
SINGLE_MODE_ISIM_CARD8+60单一ISIM卡类型

这篇关于鸿蒙开发电话服务：【@ohos.telephony.sim (SIM卡管理)】的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1068205。

相关文章

Android 悬浮窗开发示例((动态权限请求 | 前台服务和通知 | 悬浮窗创建 )

Android 悬浮窗开发示例((动态权限请求 | 前台服务和通知 | 悬浮窗创建 )

《Android悬浮窗开发示例((动态权限请求|前台服务和通知|悬浮窗创建)》本文介绍了Android悬浮窗的实现效果,包括动态权限请求、前台服务和通知的使用,悬浮窗权限需要动态申请并引导... 目录一、悬浮窗 动态权限请求1、动态请求权限2、悬浮窗权限说明3、检查动态权限4、申请动态权限5、权限设置完毕后
阅读更多...
TP-Link PDDNS服将于务6月30日正式停运:用户需转向第三方DDNS服务

TP-Link PDDNS服将于务6月30日正式停运:用户需转向第三方DDNS服务

《TP-LinkPDDNS服将于务6月30日正式停运:用户需转向第三方DDNS服务》近期，路由器制造巨头普联（TP-Link）在用户群体中引发了一系列重要变动,上个月，公司发出了一则通知，明确要求所... 路由器厂商普联（TP-Link）上个月发布公告要求所有用户必须完成实名认证后才能继续使用普联提供的 D
阅读更多...
基于Python开发PPTX压缩工具

基于Python开发PPTX压缩工具

《基于Python开发PPTX压缩工具》在日常办公中,PPT文件往往因为图片过大而导致文件体积过大,不便于传输和存储,所以本文将使用Python开发一个PPTX压缩工具,需要的可以了解下... 目录引言全部代码环境准备代码结构代码实现运行结果引言在日常办公中，PPT文件往往因为图片过大而导致文件体积过大，
阅读更多...
微服务架构之使用RabbitMQ进行异步处理方式

微服务架构之使用RabbitMQ进行异步处理方式

《微服务架构之使用RabbitMQ进行异步处理方式》本文介绍了RabbitMQ的基本概念、异步调用处理逻辑、RabbitMQ的基本使用方法以及在SpringBoot项目中使用RabbitMQ解决高并发... 目录一.什么是RabbitMQ？二.异步调用处理逻辑：三.RabbitMQ的基本使用1.安装2.架构
阅读更多...
使用DeepSeek API 结合VSCode提升开发效率

使用DeepSeek API 结合VSCode提升开发效率

《使用DeepSeekAPI结合VSCode提升开发效率》：本文主要介绍DeepSeekAPI与VisualStudioCode(VSCode)结合使用,以提升软件开发效率,具有一定的参考价值... 目录引言准备工作安装必要的 VSCode 扩展配置 DeepSeek API1. 创建 API 请求文件2.
阅读更多...
Java中使用Java Mail实现邮件服务功能示例

Java中使用Java Mail实现邮件服务功能示例

《Java中使用JavaMail实现邮件服务功能示例》：本文主要介绍Java中使用JavaMail实现邮件服务功能的相关资料,文章还提供了一个发送邮件的示例代码,包括创建参数类、邮件类和执行结... 目录前言一、历史背景二编程、pom依赖三、API说明（一）Session （会话）（二）Message编程客
阅读更多...
windos server2022的配置故障转移服务的图文教程

windos server2022的配置故障转移服务的图文教程

《windosserver2022的配置故障转移服务的图文教程》本文主要介绍了windosserver2022的配置故障转移服务的图文教程,以确保服务和应用程序的连续性和可用性,文中通过图文介绍的非... 目录准备环境：步骤故障转移群集是 Windows Server 2022 中提供的一种功能，用于在多个
阅读更多...
基于Python开发电脑定时关机工具

基于Python开发电脑定时关机工具

《基于Python开发电脑定时关机工具》这篇文章主要为大家详细介绍了如何基于Python开发一个电脑定时关机工具,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1. 简介2. 运行效果3. 相关源码1. 简介这个程序就像一个“忠实的管家”，帮你按时关掉电脑，而且全程不需要你多做
阅读更多...
解决systemctl reload nginx重启Nginx服务报错:Job for nginx.service invalid问题

解决systemctl reload nginx重启Nginx服务报错:Job for nginx.service invalid问题

《解决systemctlreloadnginx重启Nginx服务报错:Jobfornginx.serviceinvalid问题》文章描述了通过`systemctlstatusnginx.se... 目录systemctl reload nginx重启Nginx服务报错:Job for nginx.javas
阅读更多...
Java中的Opencv简介与开发环境部署方法

Java中的Opencv简介与开发环境部署方法

《Java中的Opencv简介与开发环境部署方法》OpenCV是一个开源的计算机视觉和图像处理库,提供了丰富的图像处理算法和工具,它支持多种图像处理和计算机视觉算法,可以用于物体识别与跟踪、图像分割与... 目录1.Opencv简介Opencv的应用2.Java使用OpenCV进行图像操作opencv安装j
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2