From 023927b510dfda36c8edc8af53c5a6865532b1b2 Mon Sep 17 00:00:00 2001 From: clevercong Date: Fri, 1 Jul 2022 17:17:14 +0800 Subject: [PATCH] update js reference. Signed-off-by: clevercong --- .../reference/apis/js-apis-net-connection.md | 98 ++++++++- .../reference/apis/js-apis-observer.md | 10 +- .../reference/apis/js-apis-radio.md | 52 ++--- .../reference/apis/js-apis-sim.md | 194 +++++++++--------- .../reference/apis/js-apis-sms.md | 32 +-- .../reference/apis/js-apis-telephony-data.md | 18 +- 6 files changed, 249 insertions(+), 155 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-net-connection.md b/zh-cn/application-dev/reference/apis/js-apis-net-connection.md index 15cc2ce900..04edc27a16 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-net-connection.md +++ b/zh-cn/application-dev/reference/apis/js-apis-net-connection.md @@ -1,5 +1,6 @@ # 网络连接管理 +网络连接管理提供管理网络一些基础能力，包括获取默认激活的数据网络、获取所有激活数据网络列表、开启关闭飞行模式、获取网络能力信息等功能。 > **说明：** > @@ -79,7 +80,7 @@ hasDefaultNet(callback: AsyncCallback\): void ```js connection.hasDefaultNet(function (error, has) { console.log(JSON.stringify(error)) - console.log(has) + console.log('has: ' + has) }) ``` @@ -101,7 +102,7 @@ hasDefaultNet(): Promise\ ```js connection.hasDefaultNet().then(function (has) { - console.log(has) + console.log('has: ' + has) }) ``` @@ -446,6 +447,97 @@ connection.getAddressesByName(host).then(function (addresses) { }) ``` + +## connection.enableAirplaneMode + +enableAirplaneMode(callback: AsyncCallback\): void + +开启飞行模式，使用callback方式作为异步方法。 + +**系统能力**：SystemCapability.Communication.NetManager.Core + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------------------------------- | ---- | ------------------ | +| callback | AsyncCallback\ | 是 | 回调函数。 | + +**示例：** + +```js +connection.enableAirplaneMode(function (error) { + console.log(JSON.stringify(error)) +}) +``` + +## connection.enableAirplaneMode + +enableAirplaneMode(): Promise\ + +开启飞行模式，使用Promise方式作为异步方法。 + +**系统能力**：SystemCapability.Communication.NetManager.Core + +**返回值：** + +| 类型 | 说明 | +| ------------------------------------------- | ----------------------------- | +| Promise\ | 以Promise形式返回结果。 | + +**示例：** + +```js +connection.enableAirplaneMode().then(function (error) { + console.log(JSON.stringify(error)) +}) +``` + + +## connection.disableAirplaneMode + +disableAirplaneMode(callback: AsyncCallback\): void + +关闭飞行模式，使用callback方式作为异步方法。 + +**系统能力**：SystemCapability.Communication.NetManager.Core + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------------------------------- | ---- | ------------------ | +| callback | AsyncCallback\ | 是 | 回调函数。 | + +**示例：** + +```js +connection.disableAirplaneMode(function (error) { + console.log(JSON.stringify(error)) +}) +``` + +## connection.disableAirplaneMode + +disableAirplaneMode(): Promise\ + +关闭飞行模式，使用Promise方式作为异步方法。 + +**系统能力**：SystemCapability.Communication.NetManager.Core + +**返回值：** + +| 类型 | 说明 | +| ------------------------------------------- | ----------------------------- | +| Promise\ | 以Promise形式返回结果。 | + +**示例：** + +```js +connection.disableAirplaneMode().then(function (error) { + console.log(JSON.stringify(error)) +}) +``` + + ## connection.createNetConnection createNetConnection(netSpecifier?: NetSpecifier, timeout?: number): NetConnection @@ -476,7 +568,7 @@ let netConnection = connection.createNetConnection() // 关注蜂窝网络 let netConnectionCellular = connection.createNetConnection({ netCapabilities: { - bearerTypes: [NetBearType.BEARER_CELLULAR] + bearerTypes: [connection.NetBearType.BEARER_CELLULAR] } }) ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-observer.md b/zh-cn/application-dev/reference/apis/js-apis-observer.md index c8ede5b932..197d48f44c 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-observer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-observer.md @@ -1,5 +1,7 @@ # observer +本模块提供订阅管理功能，包括订阅网络状态变化事件、订阅信号状态变化事件、订阅通话状态变化事件、订阅蜂窝数据链路连接状态、订阅蜂窝数据业务的上下行数据流状态、订阅sim状态更改事件，取消订阅网络状态变化事件、取消订阅信号状态变化事件、取消订阅通话状态变化事件、移除订阅蜂窝数据链路连接状态、移除订阅蜂窝数据业务的上下行数据流状态、移除订阅sim状态更改事件等。 + >**说明：** > >本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -70,8 +72,6 @@ off\(type: \'networkStateChange\', callback?: Callback\): void; 取消订阅网络状态变化事件，使用callback方式作为异步方法。 -**需要权限**：ohos.permission.GET_NETWORK_INFO - >**说明：** > >可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。 @@ -184,8 +184,6 @@ on(type: 'callStateChange', callback: Callback\<{ state: CallState, number: stri 订阅通话状态变化事件，使用callback方式作为异步方法。 -**需要权限**：ohos.permission.READ_CALL_LOG - **系统能力**：SystemCapability.Telephony.StateRegistry **参数：** @@ -210,8 +208,6 @@ on(type: 'callStateChange', options: { slotId: number }, callback: Callback<{ st 订阅通话状态变化事件，使用callback方式作为异步方法。 -**需要权限**：ohos.permission.READ_CALL_LOG - **系统能力**：SystemCapability.Telephony.StateRegistry **参数：** @@ -237,8 +233,6 @@ off(type: 'callStateChange', callback?: Callback<{ state: CallState, number: str 取消订阅通话状态变化事件，使用callback方式作为异步方法。 -**需要权限**：ohos.permission.READ_CALL_LOG - >**说明：** > >可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-radio.md b/zh-cn/application-dev/reference/apis/js-apis-radio.md index d0114c0344..6606a064a0 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-radio.md +++ b/zh-cn/application-dev/reference/apis/js-apis-radio.md @@ -1,5 +1,7 @@ # 网络搜索 +网络搜索模块提供管理网络搜索的一些基础功能，包括获取当前接入的CS域和PS域无线接入技术、获取网络状态、获取当前选网模式、获取注册网络所在国家的ISO国家码、获取主卡所在卡槽的索引号、获取指定SIM卡槽对应的注册网络信号强度信息列表、获取运营商名称、获取设备的指定卡槽的IMEI、获取设备的指定卡槽的MEID、获取设备的指定卡槽的唯一设备ID，判断当前设备是否支持5G\(NR\)、判断主卡的Radio是否打开等。 + >**说明：** > >本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -562,18 +564,18 @@ setPrimarySlotId(slotId: number, callback: AsyncCallback): void 设置主卡所在卡槽的索引号，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ---- | -------------------------------------- | | slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | -| callback | AsyncCallback\ | 是 | 回调函数。当设置成功，err为undefined，否则为错误对象。 | +| callback | AsyncCallback\ | 是 | 回调函数。 | **示例：** @@ -591,12 +593,12 @@ setPrimarySlotId\(slotId: number\): Promise\ 设置主卡所在卡槽的索引号，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -607,7 +609,7 @@ setPrimarySlotId\(slotId: number\): Promise\ | 类型 | 说明 | | --------------- | ------------------------------- | -| Promise\ | 无返回结果的Promise对象。 | +| Promise\ | 以Promise形式异步返回设置结果。 | **示例：** @@ -627,12 +629,12 @@ getIMEI(callback: AsyncCallback): void 获取设备的指定卡槽的IMEI，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -654,12 +656,12 @@ getIMEI(slotId: number, callback: AsyncCallback): void 获取设备的指定卡槽的IMEI，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -683,12 +685,12 @@ getIMEI(slotId?: number): Promise 获取设备的指定卡槽的IMEI，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -699,7 +701,7 @@ getIMEI(slotId?: number): Promise | 类型 | 说明 | | ----------------- | ------------------------------------------ | -| Promise\ | Promise对象。返回IMEI；如果IMEI不存在，则返回空字符串。 | +| Promise\ | 返回IMEI；如果IMEI不存在，则返回空字符串。 | **示例：** @@ -719,12 +721,12 @@ getMEID(callback: AsyncCallback): void 获取设备的指定卡槽的MEID，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -746,12 +748,12 @@ getMEID(slotId: number, callback: AsyncCallback): void 获取设备的指定卡槽的MEID，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -775,12 +777,12 @@ getMEID(slotId?: number): Promise 获取设备的指定卡槽的MEID，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -811,12 +813,12 @@ getUniqueDeviceId(callback: AsyncCallback): void 获取设备的指定卡槽的唯一设备ID，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -838,12 +840,12 @@ getUniqueDeviceId(slotId: number, callback: AsyncCallback): void 获取设备的指定卡槽的唯一设备ID，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -867,12 +869,12 @@ getUniqueDeviceId(slotId?: number): Promise 获取设备的指定卡槽的唯一设备ID，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-sim.md b/zh-cn/application-dev/reference/apis/js-apis-sim.md index 8bc1352215..dc126d262e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-sim.md +++ b/zh-cn/application-dev/reference/apis/js-apis-sim.md @@ -1,5 +1,7 @@ # SIM卡管理 +SIM卡管理模块提供了SIM卡管理的基础能力，包括获取指定卡槽SIM卡的名称、号码、ISO国家码、归属PLMN号、服务提供商名称、SIM卡状态、卡类型、是否插卡、是否激活、锁状态，设置指定卡槽SIM卡显示的名称、号码、锁状态，激活、禁用指定卡槽SIM卡，更改Pin密码，以及解锁指定卡槽SIM卡密码、SIM卡密码的解锁密码等。 + >**说明：** > >本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -509,18 +511,18 @@ getSimAccountInfo(slotId: number, callback: AsyncCallback): voi 获取SIM卡账户信息，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------------------------------- | ---- | -------------------------------------- | | slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | -| callback | AsyncCallback\<[IccAccountInfo](#IccAccountInfo7)\> | 是 | 回调函数。参考[IccAccountInfo](#IccAccountInfo7)。 | +| callback | AsyncCallback\<[IccAccountInfo](#IccAccountInfo7)\> | 是 | 回调函数。 | **示例：** @@ -537,12 +539,12 @@ getSimAccountInfo(slotId: number): Promise 获取SIM卡账户信息，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -572,12 +574,12 @@ getActiveSimAccountInfoList(callback: AsyncCallback>): vo 获取活跃SIM卡账户信息列表，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -599,12 +601,12 @@ getActiveSimAccountInfoList(): Promise>; 获取活跃SIM卡账户信息列表，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **返回值：** | 类型 | 说明 | @@ -628,12 +630,12 @@ setDefaultVoiceSlotId(slotId: number, callback: AsyncCallback): void 设置默认语音业务的卡槽ID，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -656,12 +658,12 @@ setDefaultVoiceSlotId(slotId: number): Promise\ 设置默认语音业务的卡槽ID，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -670,9 +672,9 @@ setDefaultVoiceSlotId(slotId: number): Promise\ **返回值：** -| 类型 | 说明 | -| -------------- | ------------------------------- | -| Promise\ | 无返回结果的Promise对象。 | +| 类型 | 说明 | +| --------------- | ------------------------------- | +| Promise\ | 以Promise形式异步返回设置结果。 | **示例：** @@ -691,12 +693,12 @@ setShowName\(slotId: number, name: string,callback: AsyncCallback\): void 设置指定卡槽SIM卡显示的名称，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -720,12 +722,12 @@ setShowName\(slotId: number, name: string\): Promise\ 设置指定卡槽SIM卡显示的名称，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -735,9 +737,9 @@ setShowName\(slotId: number, name: string\): Promise\ **返回值：** -| 类型 | 说明 | -| -------------- | ------------------------------- | -| Promise\ | 无返回结果的Promise对象。 | +| 类型 | 说明 | +| --------------- | ------------------------------- | +| Promise\ | 以Promise形式异步返回设置结果。 | **示例：** @@ -757,12 +759,12 @@ getShowName(slotId: number, callback: AsyncCallback): void 获取指定卡槽SIM卡的名称，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -785,12 +787,12 @@ getShowName(slotId: number): Promise 获取指定卡槽SIM卡的名称，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -820,12 +822,12 @@ setShowNumber\(slotId: number, number: string,callback: AsyncCallback\): 设置指定卡槽SIM卡的号码，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -850,12 +852,12 @@ setShowNumber\(slotId: number,number: string\): Promise\ 设置指定卡槽SIM卡的号码，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -867,7 +869,7 @@ setShowNumber\(slotId: number,number: string\): Promise\ | 类型 | 说明 | | -------------- | ------------------------------- | -| Promise\ | 无返回结果的Promise对象。 | +| Promise | 以Promise形式异步返回设置结果。 | **示例：** @@ -887,12 +889,12 @@ getShowNumber(slotId: number,callback: AsyncCallback): void 获取指定卡槽SIM卡的号码，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -915,12 +917,12 @@ getShowNumber(slotId: number): Promise 获取指定卡槽SIM卡的号码，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -950,12 +952,12 @@ activateSim(slotId: number, callback: AsyncCallback): void 激活指定卡槽SIM卡，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -978,12 +980,12 @@ activateSim(slotId: number): Promise\ 激活指定卡槽SIM卡，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -992,9 +994,9 @@ activateSim(slotId: number): Promise\ **返回值：** -| 类型 | 说明 | -| -------------- | ------------------------------- | -| Promise\ | 无返回结果的Promise对象。 | +| 类型 | 说明 | +| --------------- | ------------------------------- | +| Promise\ | 以Promise形式异步返回设置结果。 | **示例：** @@ -1013,12 +1015,12 @@ deactivateSim(slotId: number, callback: AsyncCallback): void 禁用指定卡槽SIM卡，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -1041,12 +1043,12 @@ deactivateSim(slotId: number): Promise\ 禁用指定卡槽SIM卡，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -1055,9 +1057,9 @@ deactivateSim(slotId: number): Promise\ **返回值：** -| 类型 | 说明 | -| -------------- | ------------------------------- | -| Promise\ | 无返回结果的Promise对象。 | +| 类型 | 说明 | +| --------------- | ------------------------------- | +| Promise\ | 以Promise形式异步返回设置结果。 | **示例：** @@ -1076,12 +1078,12 @@ setLockState(slotId: number, options: LockInfo, callback: AsyncCallback 设置指定卡槽SIM卡的锁状态，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -1147,10 +1149,10 @@ getLockState(slotId: number, lockType: LockType, callback: AsyncCallback 获取指定卡槽SIM卡的锁状态，使用callback方式作为异步方法。 -该接口为系统接口。 - **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -1208,12 +1210,12 @@ alterPin(slotId: number, newPin: string, oldPin: string, callback: AsyncCallback 更改Pin密码，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -1238,12 +1240,12 @@ alterPin(slotId: number, newPin: string, oldPin: string): Promise 解锁指定卡槽SIM卡密码，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -1409,12 +1411,12 @@ unlockPuk(slotId: number,newPin: string,puk: string ,callback: AsyncCallback { 解锁指定卡槽SIM卡密码，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -1510,12 +1512,12 @@ unlockPin2(slotId: number,pin2: string): Promise<LockStatusResponse\> 解锁指定卡槽SIM卡密码，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -1547,12 +1549,12 @@ unlockPuk2(slotId: number,newPin2: string,puk2: string ,callback: AsyncCallback< 解锁指定卡槽SIM卡密码的解锁密码，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -1579,12 +1581,12 @@ unlockPuk2slotId: number,newPin2: string,puk2: string): Promise<LockStatusRes 解锁指定卡槽SIM卡密码的解锁密码，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CoreService +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -1671,10 +1673,10 @@ SIM卡状态。 锁类型。 -该接口为系统接口。 - **系统能力**：以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。 +**系统API**：该接口为系统接口，三方应用不支持调用。 + | 名称 | 值 | 说明 | | -------- | ---- | ----------- | | PIN_LOCK | 1 | SIM卡密码锁 | @@ -1684,10 +1686,10 @@ SIM卡状态。 锁状态。 -该接口为系统接口。 - **系统能力**：以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。 +**系统API**：该接口为系统接口，三方应用不支持调用。 + | 名称 | 值 | 说明 | | -------- | ---- | ---------- | | LOCK_OFF | 0 | 锁关闭状态 | @@ -1697,10 +1699,10 @@ SIM卡状态。 定制锁类型。 -该接口为系统接口。 - **系统能力**：以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。 +**系统API**：该接口为系统接口，三方应用不支持调用。 + | 名称 | 值 | 说明 | | ------------ | ---- | ----------------------------------------------- | | PN_PIN_LOCK | 0 | 定制网络PIN锁*(参照 3GPP TS 22.022 [33])* | @@ -1718,10 +1720,10 @@ SIM卡状态。 锁状态响应。 -该接口为系统接口。 - **系统能力**：以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。 +**系统API**：该接口为系统接口，三方应用不支持调用。 + | 名称 | 类型 | 说明 | | --------------- | ------ | ------------------ | | result | number | 当前操作的结果 | @@ -1731,10 +1733,10 @@ SIM卡状态。 锁状态响应。 -该接口为系统接口。 - **系统能力**：以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。 +**系统API**：该接口为系统接口，三方应用不支持调用。 + | 名称 | 类型 | 说明 | | -------- | --------- | ------ | | lockType | LockType | 锁类型 | @@ -1745,10 +1747,10 @@ SIM卡状态。 锁状态响应。 -该接口为系统接口。 - **系统能力**：以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。 +**系统API**：该接口为系统接口，三方应用不支持调用。 + | 名称 | 类型 | 说明 | | -------- | ------------- | ------------ | | lockType | PersoLockType | 定制锁的类型 | @@ -1758,10 +1760,10 @@ SIM卡状态。 Icc账户信息。 -该接口为系统接口。 - **系统能力**：以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。 +**系统API**：该接口为系统接口，三方应用不支持调用。 + | 名称 | 类型 | 说明 | | ---------- | ------- | ---------------- | | simId | number | SIM卡ID | diff --git a/zh-cn/application-dev/reference/apis/js-apis-sms.md b/zh-cn/application-dev/reference/apis/js-apis-sms.md index c42d853bdc..71f7336817 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-sms.md +++ b/zh-cn/application-dev/reference/apis/js-apis-sms.md @@ -1,5 +1,7 @@ # 短信服务 +短信服务提供了管理短信的一些基础能力，包括创建、发送短信，获取、设置发送短信的默认SIM卡槽ID，获取、设置短信服务中心（SMSC）地址，以及检查当前设备是否具备短信发送和接收能力等。 + >**说明：** > >本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -162,12 +164,12 @@ setDefaultSmsSlotId\(slotId: number,callback: AsyncCallback<void>\): void 设置发送短信的默认SIM卡槽ID，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.SmsMms +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -190,12 +192,12 @@ setDefaultSmsSlotId\(slotId: number\): Promise<void> 设置发送短信的默认SIM卡槽ID，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.SmsMms +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -204,9 +206,9 @@ setDefaultSmsSlotId\(slotId: number\): Promise<void> **返回值：** -| 类型 | 说明 | -| -------------- | ------------------------------- | -| Promise\ | 无返回结果的Promise对象。 | +| 类型 | 说明 | +| --------------- | ------------------------------- | +| Promise\ | 以Promise形式异步返回设置结果。 | **示例：** @@ -225,12 +227,12 @@ setSmscAddr\(slotId: number, smscAddr: string, callback: AsyncCallback\): 设置短信服务中心（SMSC）地址，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限 **系统能力**：SystemCapability.Telephony.SmsMms +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -256,12 +258,12 @@ setSmscAddr\(slotId: number, smscAddr: string\): Promise\ 设置短信服务中心（SMSC）地址，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限 **系统能力**：SystemCapability.Telephony.SmsMms +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -295,12 +297,12 @@ getSmscAddr\(slotId: number, callback: AsyncCallback\): void 获取短信服务中心（SMSC）地址，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限 **系统能力**：SystemCapability.Telephony.SmsMms +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -324,12 +326,12 @@ getSmscAddr\(slotId: number\): Promise 获取短信服务中心（SMSC）地址，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限 **系统能力**：SystemCapability.Telephony.SmsMms +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-telephony-data.md b/zh-cn/application-dev/reference/apis/js-apis-telephony-data.md index 9bf205e19b..135435af3b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-telephony-data.md +++ b/zh-cn/application-dev/reference/apis/js-apis-telephony-data.md @@ -1,5 +1,7 @@ # 蜂窝数据 +蜂窝数据提供了移动数据管理能力，包括获取、设置默认移动数据的SIM卡，获取蜂窝数据业务的上下行和分组交换域（PS域）的连接状态，以及检查蜂窝数据业务和漫游是否启用等。 + >**说明：** > >本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -67,18 +69,18 @@ setDefaultCellularDataSlotId(slotId: number,callback: AsyncCallback\): vo 设置默认移动数据的SIM卡，使用callback方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CellularData +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ---- | ------------------------------------------------------------ | | slotId | number | 是 | SIM卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
- -1：清除默认配置。 | -| callback | AsyncCallback\ | 是 | 回调函数。当设置成功，err为undefined，否则为错误对象。 | +| callback | AsyncCallback\ | 是 | 回调函数。 | **示例：** @@ -94,12 +96,12 @@ setDefaultCellularDataSlotId(slotId: number): Promise\ 设置默认移动数据的SIM卡，使用Promise方式作为异步方法。 -该接口为系统接口。 - **需要权限**：ohos.permission.SET_TELEPHONY_STATE **系统能力**：SystemCapability.Telephony.CellularData +**系统API**：该接口为系统接口，三方应用不支持调用。 + **参数：** | 参数名 | 类型 | 必填 | 说明 | @@ -108,9 +110,9 @@ setDefaultCellularDataSlotId(slotId: number): Promise\ **返回值：** -| 类型 | 说明 | -| -------------- | ------------------------------- | -| Promise<\void\> | 无返回结果的Promise对象。 | +| 类型 | 说明 | +| --------------- | ------------------------------- | +| Promise\ | 以Promise形式异步返回设置结果。 | **示例：** -- GitLab