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

相关文章

Django开发时如何避免频繁发送短信验证码（python图文代码）

Django开发时如何避免频繁发送短信验证码（python图文代码）

《Django开发时如何避免频繁发送短信验证码（python图文代码）》Django开发时,为防止频繁发送验证码,后端需用Redis限制请求频率,结合管道技术提升效率,通过生产者消费者模式解耦业务逻辑... 目录避免频繁发送 验证码1. www.chinasem.cn避免频繁发送 验证码逻辑分析2. 避免频繁
阅读更多...
Spring Boot集成/输出/日志级别控制/持久化开发实践

Spring Boot集成/输出/日志级别控制/持久化开发实践

《SpringBoot集成/输出/日志级别控制/持久化开发实践》SpringBoot默认集成Logback,支持灵活日志级别配置（INFO/DEBUG等）,输出包含时间戳、级别、类名等信息,并可通过... 目录一、日志概述1.1、Spring Boot日志简介1.2、日志框架与默认配置1.3、日志的核心作用
阅读更多...
PyQt5 GUI 开发的基础知识

PyQt5 GUI 开发的基础知识

《PyQt5GUI开发的基础知识》Qt是一个跨平台的C++图形用户界面开发框架,支持GUI和非GUI程序开发,本文介绍了使用PyQt5进行界面开发的基础知识,包括创建简单窗口、常用控件、窗口属性设... 目录简介第一个PyQt程序最常用的三个功能模块控件QPushButton（按钮）控件QLable（纯文本
阅读更多...
Spring Boot 与微服务入门实战详细总结

Spring Boot 与微服务入门实战详细总结

《SpringBoot与微服务入门实战详细总结》本文讲解SpringBoot框架的核心特性如快速构建、自动配置、零XML与微服务架构的定义、演进及优缺点,涵盖开发环境准备和HelloWorld实战... 目录一、Spring Boot 核心概述二、微服务架构详解1. 微服务的定义与演进2. 微服务的优缺点三
阅读更多...
基于Python开发一个图像水印批量添加工具

基于Python开发一个图像水印批量添加工具

《基于Python开发一个图像水印批量添加工具》在当今数字化内容爆炸式增长的时代,图像版权保护已成为创作者和企业的核心需求,本方案将详细介绍一个基于PythonPIL库的工业级图像水印解决方案,有需要... 目录一、系统架构设计1.1 整体处理流程1.2 类结构设计（扩展版本）二、核心算法深入解析2.1 自
阅读更多...
RabbitMQ消息总线方式刷新配置服务全过程

RabbitMQ消息总线方式刷新配置服务全过程

《RabbitMQ消息总线方式刷新配置服务全过程》SpringCloudBus通过消息总线与MQ实现微服务配置统一刷新,结合GitWebhooks自动触发更新,避免手动重启,提升效率与可靠性,适用于配... 目录前言介绍环境准备代码示例测试验证总结前言介绍在微服务架构中，为了更方便的向微服务实例广播消息，
阅读更多...
关于DNS域名解析服务

关于DNS域名解析服务

《关于DNS域名解析服务》：本文主要介绍关于DNS域名解析服务,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录DNS系统的作用及类型DNS使用的协议及端口号DNS系统的分布式数据结构DNS的分布式互联网解析库域名体系结构两种查询方式DNS服务器类型统计构建DNS域
阅读更多...
Linux中SSH服务配置的全面指南

Linux中SSH服务配置的全面指南

《Linux中SSH服务配置的全面指南》作为网络安全工程师,SSH（SecureShell）服务的安全配置是我们日常工作中不可忽视的重要环节,本文将从基础配置到高级安全加固,全面解析SSH服务的各项参... 目录概述基础配置详解端口与监听设置主机密钥配置认证机制强化禁用密码认证禁止root直接登录实现双因素
阅读更多...
java向微信服务号发送消息的完整步骤实例

java向微信服务号发送消息的完整步骤实例

《java向微信服务号发送消息的完整步骤实例》：本文主要介绍java向微信服务号发送消息的相关资料,包括申请测试号获取appID/appsecret、关注公众号获取openID、配置消息模板及代码... 目录步骤1. 申请测试系统2. 公众号账号信息3. 关注测试号二维码4. 消息模板接口5. Java测试
阅读更多...
SpringBoot开发中十大常见陷阱深度解析与避坑指南

SpringBoot开发中十大常见陷阱深度解析与避坑指南

《SpringBoot开发中十大常见陷阱深度解析与避坑指南》在SpringBoot的开发过程中,即使是经验丰富的开发者也难免会遇到各种棘手的问题,本文将针对SpringBoot开发中十大常见的“坑... 目录引言一、配置总出错？是不是同时用了.properties和.yml？二、换个位置配置就失效？搞清楚加
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2