openharmony 鸿蒙 js-apis-esim-sys

2025-06-16 浏览 (1)

@ohos.telephony.esim (eSIM卡管理) (系统接口)

穿戴设备支持eSIM，电话服务提供API给eSIM卡管理和eSIM卡服务使用。

说明：

本模块首批接口从API version 18开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 当前页面仅包含本模块的系统接口，其他公开接口参见@ohos.telephony.esim (eSIM卡管理)。

导入模块

import { eSIM } from '@kit.TelephonyKit';

eSIM.getEid18+

getEid(slotId: number): Promise<string>

获取指定卡槽标识eUICC硬件的EID。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

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

返回值：

类型说明
Promise<string>返回指定卡槽标识eUICC硬件的EID。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { eSIM } from '@kit.TelephonyKit';

let eid: string = eSIM.getEid(0);
console.log(`the EID is:` + eid);

eSIM.getOsuStatus18+

getOsuStatus(slotId: number): Promise<OsuStatus>

获取指定卡槽操作系统升级的状态。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

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

返回值：

类型说明
Promise<OsuStatus>Promise对象，返回操作系统升级的状态。
1. 正在升级。
2. 升级失败。
3. 升级成功。
4. 当前版本是最新版本。
5. 升级服务不可用。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.getOsuStatus(0).then(() => {
    console.log(`getOsuStatus invoking succeeded.`);
}).catch((err: BusinessError) => {
    console.error(`getOsuStatus, promise: err->${JSON.stringify(err)}`);
});

eSIM.startOsu18+

startOsu(slotId: number): Promise<OsuStatus>

如果指定卡槽的操作系统不是最新的，则执行操作系统升级。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

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

返回值：

类型说明
Promise<OsuStatus>Promise对象，返回操作系统升级的状态。
1. 正在升级。
2. 升级失败。
3. 升级成功。
4. 当前版本是最新版本。
5. 升级服务不可用。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.startOsu(0).then(() => {
    console.log(`startOsu invoking succeeded.`);
}).catch((err: BusinessError) => {
    console.error(`startOsu, ErrorState: err->${JSON.stringify(err)}`);
});

eSIM.getDownloadableProfileMetadata18+

getDownloadableProfileMetadata(slotId: number, portIndex: number, profile: DownloadableProfile, forceDisableProfile: boolean): Promise<GetDownloadableProfileMetadataResult>

填充可下载配置文件的元数据。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
portIndexnumber是插槽的端口索引。
profileDownloadableProfile是可下载的配置文件信息。
forceDisableProfileboolean是如果值为true，则必须停用活动SIM才能执行操作。如果值为false，则提示用户首先同意此操作。

返回值：

类型说明
Promise<GetDownloadableProfileMetadataResult>Promise对象，返回填充可下载配置文件的元数据。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

let profile: eSIM.DownloadableProfile={
  activationCode:'1',
  confirmationCode:'1',
  carrierName:'test',
  accessRules:[{
    certificateHashHexStr:'test',
    packageName:'com.example.testcoreservice',
    accessType:0
  }]
};

eSIM.getDownloadableProfileMetadata(0, 0, profile, true).then((data: eSIM.GetDownloadableProfileMetadataResult) => {
    console.log(`getDownloadableProfileMetadata, GetDownloadableProfileMetadataResult: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getDownloadableProfileMetadata, GetDownloadableProfileMetadataResult: err->${JSON.stringify(err)}`);
});

eSIM.getDownloadableProfiles18+

getDownloadableProfiles(slotId: number, portIndex: number, forceDisableProfile: boolean): Promise<GetDownloadableProfilesResult>

获取可用的可下载配置文件列表。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
portIndexnumber是插槽的端口索引。
forceDisableProfileboolean是如果值为true，则必须停用活动SIM才能执行操作。如果值为false，则提示用户首先同意此操作。

返回值：

类型说明
Promise<GetDownloadableProfilesResult>Promise对象，返回可下载配置文件列表。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.getDownloadableProfiles(0, 0, true).then((data: eSIM.GetDownloadableProfilesResult) => {
    console.log(`getDownloadableProfiles, GetDownloadableProfilesResult: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getDownloadableProfiles, GetDownloadableProfilesResult: err->${JSON.stringify(err)}`);
});

eSIM.downloadProfile18+

downloadProfile(slotId: number, portIndex: number, profile: DownloadableProfile, configuration: DownloadConfiguration): Promise<DownloadProfileResult>

下载配置文件。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
portIndexnumber是插槽的端口索引。
profileDownloadableProfile是可下载的配置文件信息。
configurationDownloadConfiguration是下载的配置信息。

返回值：

类型说明
Promise<DownloadProfileResult>Promise对象，返回下载配置文件的结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

let profile: eSIM.DownloadableProfile={
  activationCode:'1',
  confirmationCode:'1',
  carrierName:'test',
  accessRules:[{
    certificateHashHexStr:'test',
    packageName:'com.example.testcoreservice',
    accessType:0
  }]
};

let configuration: eSIM.DownloadConfiguration = {
  switchAfterDownload: true,
  forceDisableProfile: true,
  isAlowPpr: true,
};

eSIM.downloadProfile(0, 0, profile, configuration).then((data: eSIM.DownloadProfileResult) => {
    console.log(`downloadProfile, DownloadProfileResult: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`downloadProfile, DownloadProfileResult: err->${JSON.stringify(err)}`);
});

eSIM.getEuiccProfileInfoList18+

getEuiccProfileInfoList(slotId: number): Promise<GetEuiccProfileInfoListResult>

获取配置文件信息列表。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

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

返回值：

类型说明
Promise<GetEuiccProfileInfoListResult>Promise对象，返回配置文件信息列表。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.getEuiccProfileInfoList(0).then((data: eSIM.GetEuiccProfileInfoListResult) => {
    console.log(`getEuiccProfileInfoList, GetEuiccProfileInfoListResult: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getEuiccProfileInfoList, GetEuiccProfileInfoListResult: err->${JSON.stringify(err)}`);
});

eSIM.getEuiccInfo18+

getEuiccInfo(slotId: number): Promise<EuiccInfo>

获取eUICC信息。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

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

返回值：

类型说明
Promise<EuiccInfo>Promise对象，返回eUicc信息。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.getEuiccInfo(0).then((data: eSIM.EuiccInfo) => {
    console.log(`getEuiccInfo, EuiccInfo: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getEuiccInfo, EuiccInfo: err->${JSON.stringify(err)}`);
});

eSIM.deleteProfile18+

deleteProfile(slotId: number, iccid: string): Promise<ResultCode>

删除配置文件。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
iccidstring是配置文件的Id。

返回值：

类型说明
Promise<ResultCode>Promise对象，返回删除配置文件的结果码。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.deleteProfile(0, testId).then(() => {
    console.log(`deleteProfile invoking succeeded.`);
}).catch((err: BusinessError) => {
    console.error(`deleteProfile, ErrorState: err->${JSON.stringify(err)}`);
});

eSIM.switchToProfile18+

switchToProfile(slotId: number, portIndex: number, iccid: string, forceDisableProfile: boolean): Promise<ResultCode>

切换到(启用)给定的配置文件。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
portIndexnumber是插槽的端口索引。
iccidstring是配置文件的Id。
forceDisableProfileboolean是如果值为true，则必须停用活动SIM才能执行操作。如果值为false，则提示用户首先同意此操作。

返回值：

类型说明
Promise<ResultCode>Promise对象，返回切换配置文件的结果码。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.switchToProfile(0, 0, testId, true).then(() => {
    console.log(`switchToProfile invoking succeeded.`);
}).catch((err: BusinessError) => {
    console.error(`switchToProfile, ErrorState: err->${JSON.stringify(err)}`);
});

eSIM.setProfileNickname18+

setProfileNickname(slotId: number, iccid: string, nickname: string): Promise<ResultCode>

设置给定配置文件的昵称。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
iccidstring是配置文件的Id。
nicknamestring是昵称。

返回值：

类型说明
Promise<ResultCode>Promise对象，返回设置昵称的结果码。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.setProfileNickname(0, testId, testName).then(() => {
    console.log(`setProfileNickname invoking succeeded.`);
}).catch((err: BusinessError) => {
    console.error(`setProfileNickname, ErrorState: err->${JSON.stringify(err)}`);
});

eSIM.resetMemory18+

resetMemory(slotId: number, options?: ResetOption): Promise<ResultCode>

清除所有特定配置文件并重置eUICC。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
optionsResetOption否重置状态。

返回值：

类型说明
Promise<ResultCode>Promise对象，返回重置的结果码。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.resetMemory(0).then(() => {
    console.log(`resetMemory invoking succeeded.`);
}).catch((err: BusinessError) => {
    console.error(`resetMemory, ErrorState: err->${JSON.stringify(err)}`);
});

eSIM.reserveProfilesForFactoryRestore18+

reserveProfilesForFactoryRestore(slotId: number): Promise<ResultCode>

恢复出厂设置，并保留profiles。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

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

返回值：

类型说明
Promise<ResultCode>Promise对象，返回恢复出厂设置的结果码。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.reserveProfilesForFactoryRestore(0).then(() => {
    console.log(`reserveProfilesForFactoryRestore invoking succeeded.`);
}).catch((err: BusinessError) => {
    console.error(`reserveProfilesForFactoryRestore, ErrorState: err->${JSON.stringify(err)}`);
});

eSIM.setDefaultSmdpAddress18+

setDefaultSmdpAddress(slotId: number, address: string): Promise<ResultCode>

设置或更新eUICC中存储的默认SM-DP+地址。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
addressstring是要设置的默认SM-DP+地址。

返回值：

类型说明
Promise<ResultCode>Promise对象，返回设置默认SM-DP+地址的结果码。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.setDefaultSmdpAddress(0, testAddress).then(() => {
    console.log(`setDefaultSmdpAddress invoking succeeded.`);
}).catch((err: BusinessError) => {
    console.error(`setDefaultSmdpAddress, ErrorState: err->${JSON.stringify(err)}`);
});

eSIM.getDefaultSmdpAddress18+

getDefaultSmdpAddress(slotId: number): Promise<string>

获取存储在eUICC中的默认SM-DP+地址。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

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

返回值：

类型说明
Promise<string>Promise对象，返回SM-DP+地址。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.getDefaultSmdpAddress(0).then((data: string) => {
    console.log(`getDefaultSmdpAddress, result: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getDefaultSmdpAddress, ErrorState: err->${JSON.stringify(err)}`);
});

eSIM.cancelSession18+

cancelSession(slotId: number, transactionId: string, cancelReason: CancelReason): Promise<ResultCode>

取消会话。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_TELEPHONY_ESIM_STATE

系统能力：SystemCapability.Telephony.CoreService.Esim

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
transactionIdstring是业务ID。
cancelReasonCancelReason是取消会话的原因。

返回值：

类型说明
Promise<ResultCode>Promise对象，返回取消会话的结果码。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Invalid parameter value.
801Capability not supported.
3120001Service connection failed.
3120002System internal error.

示例：

import { BusinessError } from '@kit.BasicServicesKit';
import { eSIM } from '@kit.TelephonyKit';

eSIM.cancelSession(0, testId, CancelReason::CANCEL_REASON_END_USER_REJECTION).then((data: string) => {
    console.log(`cancelSession, result: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`cancelSession execution failed: err->${JSON.stringify(err)}`);
});

AccessRule18+

访问规则。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称类型必填说明
certificateHashHexStrstring是证书哈希的十六进制字符串。
packageNamestring是规则适用的程序包名称。
accessTypenumber是规则的类型。

DownloadableProfile18+

可下载的配置文件。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称类型必填说明
activationCodestring是激活码。对于不基于激活码的配置文件，可能为空。
confirmationCodestring否确认码。
carrierNamestring否订阅名称。
accessRulesArray<AccessRule>否访问规则数组。

GetDownloadableProfileMetadataResult18+

获取可下载配置文件的元数据。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称类型必填说明
downloadableProfileDownloadableProfile是可下载的配置文件信息。
pprTypenumber是配置文件策略规则类型。
pprFlagboolean是配置文件策略规则标记。
iccidstring是配置文件的iccId。
serviceProviderNamestring是配置文件的服务提供商名称。
profileNamestring是配置文件名称。
profileClassProfileClass是配置文件类。
solvableErrorsSolvableErrors是可解决的错误。
responseResultResultCode是操作结果码。

GetDownloadableProfilesResult18+

获取默认可下载配置文件的列表。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称类型必填说明
responseResultResultCode是返回操作结果码。
downloadableProfilesArray<DownloadableProfile>是可下载配置文件数组。

DownloadProfileResult18+

下载配置文件的结果。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称类型必填说明
responseResultResultCode是操作结果码。
solvableErrorsSolvableErrors是可解决错误。
cardIdnumber是获取卡Id。

GetEuiccProfileInfoListResult18+

获取配置文件信息列表。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称类型必填说明
responseResultResultCode是返回操作结果码。
profilesArray<EuiccProfile>是配置文件数组。
isRemovableboolean是获取eUICC是否可移除。

OperatorId18+

获取eUICC芯片/设备的相关信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称类型必填说明
mccstring是移动国家代码。
mncstring是网络代码。
gid1string是组id级别1。
gid2string是组id级别2。

EuiccProfile18+

配置文件信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称类型必填说明
iccidstring是配置文件的iccId。
nickNamestring是昵称。
serviceProviderNamestring是配置文件的服务提供商名称。
profileNamestring是配置文件名称。
stateProfileState是配置文件的状态。
profileClassProfileClass是配置文件类。
operatorIdOperatorId是配置文件的操作ID。
policyRulesPolicyRules是配置文件策略。
accessRulesArray<AccessRule>是配置文件规则。

EuiccInfo18+

euicc信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称类型必填说明
osVersionstring是系统版本。

ResetOption18+

重置状态。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称值说明
DELETE_OPERATIONAL_PROFILES1删除所有操作配置文件。
DELETE_FIELD_LOADED_TEST_PROFILES1 << 1删除所有字段加载的测试配置文件。
RESET_DEFAULT_SMDP_ADDRESS1 << 2重置默认SM-DP+地址。

OsuStatus18+

操作系统升级状态。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称值说明
EUICC_UPGRADE_IN_PROGRESS1升级中。
EUICC_UPGRADE_FAILED2升级失败。
EUICC_UPGRADE_SUCCESSFUL3升级成功。
EUICC_UPGRADE_ALREADY_LATEST4当前为最新版本，无需升级 。
EUICC_UPGRADE_SERVICE_UNAVAILABLE5升级服务不可用。

ResultCode18+

结果码。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称值说明
RESULT_SOLVABLE_ERRORS-2用户必须解决可解决的错误。
RESULT_MUST_DISABLE_PROFILE-1必须禁用活动配置文件才能执行操作。
RESULT_OK0成功。
RESULT_GET_EID_FAILED201获取EID失败。
RESULT_ACTIVATION_CODE_CHANGED203最终用户确认后，激活码将被更改。
RESULT_ACTIVATION_CODE_INVALID204激活码无效。
RESULT_SMDP_ADDRESS_INVALID205SM-DP+服务器地址非法。
RESULT_EUICC_INFO_INVALID206无效的eUICC信息。
RESULT_TLS_HANDSHAKE_FAILED207TLS握手失败。
RESULT_CERTIFICATE_IO_ERROR208证书网络连接错误。
RESULT_CERTIFICATE_RESPONSE_TIMEOUT209证书地址无效或响应超时。
RESULT_AUTHENTICATION_FAILED210鉴权失败。
RESULT_RESPONSE_HTTP_FAILED211HTTP响应失败。
RESULT_CONFIRMATION_CODE_INCORRECT212确认码不正确。
RESULT_EXCEEDED_CONFIRMATION_CODE_TRY_LIMIT213已达到最大确认码尝试次数。
RESULT_NO_PROFILE_ON_SERVER214服务器上没有可供下载的配置文件。
RESULT_TRANSACTION_ID_INVALID215事务ID无效。
RESULT_SERVER_ADDRESS_INVALID216服务器地址无效。
RESULT_GET_BOUND_PROFILE_PACKAGE_FAILED217获取BPP失败。
RESULT_USER_CANCEL_DOWNLOAD218最终用户取消下载。
RESULT_SERVER_UNAVAILABLE220运营商服务器不可用。
RESULT_PROFILE_NON_DELETE223PPR禁止删除文件。
RESULT_SMDP_ADDRESS_INCORRECT226认证响应服务器地址不匹配。
RESULT_ANALYZE_AUTHENTICATION_SERVER_RESPONSE_FAILED228解析服务器身份验证响应错误。
RESULT_ANALYZE_AUTHENTICATION_CLIENT_RESPONSE_FAILED229解析客户端身份验证响应错误。
RESULT_ANALYZE_AUTHENTICATION_CLIENT_MATCHING_ID_REFUSED231由于匹配ID被拒绝，解析客户端身份验证响应错误。
RESULT_PROFILE_TYPE_ERROR_AUTHENTICATION_STOPPED233由于配置文件类型中的错误，身份验证已停止。
RESULT_CARRIER_SERVER_REFUSED_ERRORS249运营商服务器拒绝原因码为3.8的错误。
RESULT_CERTIFICATE_INVALID251证书无效。
RESULT_OUT_OF_MEMORY263由于内存不足，配置文件安装失败。
RESULT_PPR_FORBIDDEN268PPR规则禁止此操作。
RESULT_NOTHING_TO_DELETE270没有可删除的配置文件。
RESULT_PPR_NOT_MATCH276与PPR约束不匹配。
RESULT_CAT_BUSY283会话正在进行。
RESULT_PROFILE_EID_INVALID284此eSIM配置文件已被使用或无效。
RESULT_DOWNLOAD_TIMEOUT287下载超时。
RESULT_SGP_22_OTHER400SGP.22中定义的其他错误。

CancelReason18+

取消会话的原因。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称值说明
CANCEL_REASON_END_USER_REJECTION0最终用户已拒绝下载。
CANCEL_REASON_POSTPONED1下载已推迟，稍后可以重新启动。
CANCEL_REASON_TIMEOUT2下载已超时，稍后可以重新启动。
CANCEL_REASON_PPR_NOT_ALLOWED3由于eUICC上的授权表或其他已安装的配置文件不允许其策略规则，因此无法安装。

ProfileState18+

配置文件状态。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称值说明
PROFILE_STATE_UNSPECIFIED-1未设置配置文件状态。
PROFILE_STATE_DISABLED0禁用配置文件。
PROFILE_STATE_ENABLED1已启用配置文件。

ProfileClass18+

配置文件类。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称值说明
PROFILE_CLASS_UNSPECIFIED-1未设置配置文件类。
PROFILE_CLASS_TEST0测试配置文件。
PROFILE_CLASS_PROVISIONING1预加载在eUICC上的配置文件。
PROFILE_CLASS_OPERATIONAL2可预加载或下载的操作配置文件。

PolicyRules18+

配置文件的策略规则。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称值说明
POLICY_RULE_DISABLE_NOT_ALLOWED1启用此配置文件后，将无法禁用。
POLICY_RULE_DELETE_NOT_ALLOWED1 << 1无法删除此配置文件。
POLICY_RULE_DISABLE_AND_DELETE1 << 2禁用后应删除此配置文件。

SolvableErrors18+

可解决错误码。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称值说明
SOLVABLE_ERROR_NEED_CONFIRMATION_CODE1 << 0下载过程需要用户输入确认码。
SOLVABLE_ERROR_NEED_POLICY_RULE1 << 1下载过程需要用户同意才能允许配置文件策略规则。

DownloadConfiguration18+

下载过程中的属性配置。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.CoreService.Esim

名称类型必填说明
switchAfterDownloadboolean是下载成功后是否启用配置文件。
forceDisableProfileboolean是是否强制禁用模板。
isPprAllowedboolean是指定用户是否允许服务提供商在被告知其限制后实施此配置文件策略规则。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Telephony Kit（蜂窝通信服务）

harmony 鸿蒙Telephony_NetworkState

harmony 鸿蒙电话子系统错误码

harmony 鸿蒙js-apis-call-sys

harmony 鸿蒙@ohos.telephony.call (拨打电话)

harmony 鸿蒙@ohos.telephony.esim (eSIM卡管理)

harmony 鸿蒙@ohos.telephony.observer (observer)(系统接口)

harmony 鸿蒙@ohos.telephony.observer (observer)

harmony 鸿蒙@ohos.telephony.radio (网络搜索)（系统接口）

harmony 鸿蒙@ohos.telephony.radio (网络搜索)

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/XYSOVR