鸿蒙开发电话服务：【@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。

相关文章

VSCode开发中有哪些好用的插件和快捷键

VSCode开发中有哪些好用的插件和快捷键

《VSCode开发中有哪些好用的插件和快捷键》作为全球最受欢迎的编程工具,VSCode的快捷键体系是提升开发效率的核心密码,：本文主要介绍VSCode开发中有哪些好用的插件和快捷键的相关资料,文中... 目录前言1、vscode插件1.1 Live-server1.2 Auto Rename Tag1.3
阅读更多...
Agent开发核心技术解析以及现代Agent架构设计

Agent开发核心技术解析以及现代Agent架构设计

《Agent开发核心技术解析以及现代Agent架构设计》在人工智能领域,Agent并非一个全新的概念,但在大模型时代,它被赋予了全新的生命力,简单来说,Agent是一个能够自主感知环境、理解任务、制定... 目录一、回归本源：到底什么是Agent？二、核心链路拆解：Agent的"大脑"与"四肢"1. 规划模
阅读更多...
Python实现快速扫描目标主机的开放端口和服务

Python实现快速扫描目标主机的开放端口和服务

《Python实现快速扫描目标主机的开放端口和服务》这篇文章主要为大家详细介绍了如何使用Python编写一个功能强大的端口扫描器脚本,实现快速扫描目标主机的开放端口和服务,感兴趣的小伙伴可以了解下... 目录功能介绍场景应用1. 网络安全审计2. 系统管理维护3. 网络故障排查4. 合规性检查报错处理1.
阅读更多...
精准寻车+鸿蒙有礼特别版均已上线! 华为鸿蒙HarmonyOS 6负一屏新升级

精准寻车+鸿蒙有礼特别版均已上线! 华为鸿蒙HarmonyOS 6负一屏新升级

《精准寻车+鸿蒙有礼特别版均已上线!华为鸿蒙HarmonyOS6负一屏新升级》不少朋友升级华为鸿蒙HarmonyOS6后，发现华为负一屏此次也新增了精准寻车功能，还为过往鸿蒙5.1及以上用户再度... 最近科技圈热议话题当属华为全新发布的Mate 80系列，这次不仅有全金属机身，第二代红枫影像和全新麒麟新品
阅读更多...
Python+wxPython开发一个文件属性比对工具

Python+wxPython开发一个文件属性比对工具

《Python+wxPython开发一个文件属性比对工具》在日常的文件管理工作中,我们经常会遇到同一个文件存在多个版本,或者需要验证备份文件与源文件是否一致,下面我们就来看看如何使用wxPython模... 目录引言项目背景与需求应用场景核心需求运行结果技术选型程序设计界面布局核心功能模块关键代码解析文件大
阅读更多...
C++多线程开发环境配置方法

C++多线程开发环境配置方法

《C++多线程开发环境配置方法》文章详细介绍了如何在Windows上安装MinGW-w64和VSCode,并配置环境变量和编译任务,使用VSCode创建一个C++多线程测试项目,并通过配置tasks.... 目录下载安装 MinGW-w64下载安装VS code创建测试项目配置编译任务创建 tasks.js
阅读更多...
nacos服务无法注册到nacos服务中心问题及解决

nacos服务无法注册到nacos服务中心问题及解决

《nacos服务无法注册到nacos服务中心问题及解决》本文详细描述了在Linux服务器上使用Tomcat启动Java程序时,服务无法注册到Nacos的排查过程,通过一系列排查步骤,发现问题出在Tom... 目录简介依赖异常情况排查断点调试原因解决NacosRegisterOnWar结果总结简介1、程序在
阅读更多...
一文详解Python如何开发游戏

一文详解Python如何开发游戏

《一文详解Python如何开发游戏》Python是一种非常流行的编程语言,也可以用来开发游戏模组,：本文主要介绍Python如何开发游戏的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下... 目录一、python简介二、Python 开发 2D 游戏的优劣势优势缺点三、Python 开发 3D
阅读更多...
Linux创建服务使用systemctl管理详解

Linux创建服务使用systemctl管理详解

《Linux创建服务使用systemctl管理详解》文章指导在Linux中创建systemd服务,设置文件权限为所有者读写、其他只读,重新加载配置,启动服务并检查状态,确保服务正常运行,关键步骤包括权... 目录创建服务 /usr/lib/systemd/system/设置服务文件权限：所有者读写js，其他
阅读更多...
基于Python开发Windows自动更新控制工具

基于Python开发Windows自动更新控制工具

《基于Python开发Windows自动更新控制工具》在当今数字化时代,操作系统更新已成为计算机维护的重要组成部分,本文介绍一款基于Python和PyQt5的Windows自动更新控制工具,有需要的可... 目录设计原理与技术实现系统架构概述数学建模工具界面完整代码实现技术深度分析多层级控制理论服务层控制注
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2