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

相关文章

Spring Boot + MyBatis Plus 高效开发实战从入门到进阶优化(推荐)

《SpringBoot+MyBatisPlus高效开发实战从入门到进阶优化(推荐)》本文将详细介绍SpringBoot+MyBatisPlus的完整开发流程,并深入剖析分页查询、批量操作、动... 目录Spring Boot + MyBATis Plus 高效开发实战:从入门到进阶优化1. MyBatis

Python基于wxPython和FFmpeg开发一个视频标签工具

《Python基于wxPython和FFmpeg开发一个视频标签工具》在当今数字媒体时代,视频内容的管理和标记变得越来越重要,无论是研究人员需要对实验视频进行时间点标记,还是个人用户希望对家庭视频进行... 目录引言1. 应用概述2. 技术栈分析2.1 核心库和模块2.2 wxpython作为GUI选择的优

利用Python开发Markdown表格结构转换为Excel工具

《利用Python开发Markdown表格结构转换为Excel工具》在数据管理和文档编写过程中,我们经常使用Markdown来记录表格数据,但它没有Excel使用方便,所以本文将使用Python编写一... 目录1.完整代码2. 项目概述3. 代码解析3.1 依赖库3.2 GUI 设计3.3 解析 Mark

Linux上设置Ollama服务配置(常用环境变量)

《Linux上设置Ollama服务配置(常用环境变量)》本文主要介绍了Linux上设置Ollama服务配置(常用环境变量),Ollama提供了多种环境变量供配置,如调试模式、模型目录等,下面就来介绍一... 目录在 linux 上设置环境变量配置 OllamPOgxSRJfa手动安装安装特定版本查看日志在

利用Go语言开发文件操作工具轻松处理所有文件

《利用Go语言开发文件操作工具轻松处理所有文件》在后端开发中,文件操作是一个非常常见但又容易出错的场景,本文小编要向大家介绍一个强大的Go语言文件操作工具库,它能帮你轻松处理各种文件操作场景... 目录为什么需要这个工具?核心功能详解1. 文件/目录存javascript在性检查2. 批量创建目录3. 文件

SpringCloud之LoadBalancer负载均衡服务调用过程

《SpringCloud之LoadBalancer负载均衡服务调用过程》:本文主要介绍SpringCloud之LoadBalancer负载均衡服务调用过程,具有很好的参考价值,希望对大家有所帮助,... 目录前言一、LoadBalancer是什么?二、使用步骤1、启动consul2、客户端加入依赖3、以服务

基于Python开发批量提取Excel图片的小工具

《基于Python开发批量提取Excel图片的小工具》这篇文章主要为大家详细介绍了如何使用Python中的openpyxl库开发一个小工具,可以实现批量提取Excel图片,有需要的小伙伴可以参考一下... 目前有一个需求,就是批量读取当前目录下所有文件夹里的Excel文件,去获取出Excel文件中的图片,并

基于Python开发PDF转PNG的可视化工具

《基于Python开发PDF转PNG的可视化工具》在数字文档处理领域,PDF到图像格式的转换是常见需求,本文介绍如何利用Python的PyMuPDF库和Tkinter框架开发一个带图形界面的PDF转P... 目录一、引言二、功能特性三、技术架构1. 技术栈组成2. 系统架构javascript设计3.效果图

基于Python开发PDF转Doc格式小程序

《基于Python开发PDF转Doc格式小程序》这篇文章主要为大家详细介绍了如何基于Python开发PDF转Doc格式小程序,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 用python实现PDF转Doc格式小程序以下是一个使用Python实现PDF转DOC格式的GUI程序,采用T

使用Python开发一个图像标注与OCR识别工具

《使用Python开发一个图像标注与OCR识别工具》:本文主要介绍一个使用Python开发的工具,允许用户在图像上进行矩形标注,使用OCR对标注区域进行文本识别,并将结果保存为Excel文件,感兴... 目录项目简介1. 图像加载与显示2. 矩形标注3. OCR识别4. 标注的保存与加载5. 裁剪与重置图像