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

2024-06-17 02:12

本文主要是介绍鸿蒙开发电话服务:【@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

相关文章

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

基于Qt开发一个简单的OFD阅读器

《基于Qt开发一个简单的OFD阅读器》这篇文章主要为大家详细介绍了如何使用Qt框架开发一个功能强大且性能优异的OFD阅读器,文中的示例代码讲解详细,有需要的小伙伴可以参考一下... 目录摘要引言一、OFD文件格式解析二、文档结构解析三、页面渲染四、用户交互五、性能优化六、示例代码七、未来发展方向八、结论摘要

你的华为手机升级了吗? 鸿蒙NEXT多连推5.0.123版本变化颇多

《你的华为手机升级了吗?鸿蒙NEXT多连推5.0.123版本变化颇多》现在的手机系统更新可不仅仅是修修补补那么简单了,华为手机的鸿蒙系统最近可是动作频频,给用户们带来了不少惊喜... 为了让用户的使用体验变得很好,华为手机不仅发布了一系列给力的新机,还在操作系统方面进行了疯狂的发力。尤其是近期,不仅鸿蒙O

在 VSCode 中配置 C++ 开发环境的详细教程

《在VSCode中配置C++开发环境的详细教程》本文详细介绍了如何在VisualStudioCode(VSCode)中配置C++开发环境,包括安装必要的工具、配置编译器、设置调试环境等步骤,通... 目录如何在 VSCode 中配置 C++ 开发环境:详细教程1. 什么是 VSCode?2. 安装 VSCo

C#图表开发之Chart详解

《C#图表开发之Chart详解》C#中的Chart控件用于开发图表功能,具有Series和ChartArea两个重要属性,Series属性是SeriesCollection类型,包含多个Series对... 目录OverviChina编程ewSeries类总结OverviewC#中,开发图表功能的控件是Char

鸿蒙开发搭建flutter适配的开发环境

《鸿蒙开发搭建flutter适配的开发环境》文章详细介绍了在Windows系统上如何创建和运行鸿蒙Flutter项目,包括使用flutterdoctor检测环境、创建项目、编译HAP包以及在真机上运... 目录环境搭建创建运行项目打包项目总结环境搭建1.安装 DevEco Studio NEXT IDE

Python开发围棋游戏的实例代码(实现全部功能)

《Python开发围棋游戏的实例代码(实现全部功能)》围棋是一种古老而复杂的策略棋类游戏,起源于中国,已有超过2500年的历史,本文介绍了如何用Python开发一个简单的围棋游戏,实例代码涵盖了游戏的... 目录1. 围棋游戏概述1.1 游戏规则1.2 游戏设计思路2. 环境准备3. 创建棋盘3.1 棋盘类

这15个Vue指令,让你的项目开发爽到爆

1. V-Hotkey 仓库地址: github.com/Dafrok/v-ho… Demo: 戳这里 https://dafrok.github.io/v-hotkey 安装: npm install --save v-hotkey 这个指令可以给组件绑定一个或多个快捷键。你想要通过按下 Escape 键后隐藏某个组件,按住 Control 和回车键再显示它吗?小菜一碟: <template

Hadoop企业开发案例调优场景

需求 (1)需求:从1G数据中,统计每个单词出现次数。服务器3台,每台配置4G内存,4核CPU,4线程。 (2)需求分析: 1G / 128m = 8个MapTask;1个ReduceTask;1个mrAppMaster 平均每个节点运行10个 / 3台 ≈ 3个任务(4    3    3) HDFS参数调优 (1)修改:hadoop-env.sh export HDFS_NAMENOD