From df34a63376907a02133c849fcc75aa850ebd5ce7 Mon Sep 17 00:00:00 2001 From: dingxiaochen Date: Sat, 18 Mar 2023 14:29:35 +0800 Subject: [PATCH] fix docs. Signed-off-by: dingxiaochen --- .../reference/apis/js-apis-call.md | 25 ++-- .../reference/apis/js-apis-observer.md | 117 ++++++++++++++++++ 2 files changed, 131 insertions(+), 11 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-call.md b/zh-cn/application-dev/reference/apis/js-apis-call.md index eda0fa7800..1ec8998050 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-call.md +++ b/zh-cn/application-dev/reference/apis/js-apis-call.md @@ -132,10 +132,10 @@ dialCall\(phoneNumber: string, callback: AsyncCallback\): void **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ----------- | ---------------------------- | ---- | --------------------------------------- | -| phoneNumber | string | 是 | 电话号码。 | -| callback | AsyncCallback<boolean> | 是 | 回调函数，返回true为成功，false为失败。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- |---------------------------| ---- | --------------------------------------- | +| phoneNumber | string | 是 | 电话号码。 | +| callback | AsyncCallback<void> | 是 | 以callback形式异步返回跳转拨号界面的结果。 | **错误码：** @@ -171,11 +171,11 @@ dialCall\(phoneNumber: string, options: DialCallOptions, callback: AsyncCallback **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ----------- | ----------------------------------- | ---- | ------------------------------------ | -| phoneNumber | string | 是 | 电话号码。 | -| options | [DialCallOptions](#dialcalloptions9)| 是 | 通话参数，携带呼叫的其他配置信息。 | -| callback | AsyncCallback<boolean> | 是 | 回调函数，返回true为成功，false为失败。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------- |--------------------------------------| ---- | ------------------------------------ | +| phoneNumber | string | 是 | 电话号码。 | +| options | [DialCallOptions](#dialcalloptions9) | 是 | 通话参数，携带呼叫的其他配置信息。 | +| callback | AsyncCallback<void> | 是 | 以callback形式异步返回跳转拨号界面的结果。 | **错误码：** @@ -219,7 +219,7 @@ dialCall\(phoneNumber: string, options?: DialCallOptions\): Promise | 参数名 | 类型 | 必填 | 说明 | | ----------- | ----------------------------------- | ---- | -------------------------------------- | | phoneNumber | string | 是 | 电话号码。 | -| options | [DialCallOptions](#dialcalloptions9)| 否 | 通话参数，选择为语音通话还是视频通话。 | +| options | [DialCallOptions](#dialcalloptions9)| 否 | 通话参数，携带呼叫的其他配置信息。 | **错误码：** @@ -236,7 +236,10 @@ dialCall\(phoneNumber: string, options?: DialCallOptions\): Promise ```js let promise = call.dialCall("138xxxxxxxx", { - extras: false + accountId: 0, + videoState: 0, + dialScene: 0, + dialType: 0, }); promise.then(data => { console.log(`dialCall success, promise: data->${JSON.stringify(data)}`); 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 17238e3671..8308c6f274 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-observer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-observer.md @@ -239,6 +239,123 @@ observer.off('signalInfoChange', callback); observer.off('signalInfoChange'); ``` +## observer.on('cellInfoChange') + +on\(type: \'cellInfoChange\', callback: Callback\): void; + +订阅小区信息变化事件，使用callback方式作为异步方法。 + +**系统接口：** 此接口为系统接口。 + +**需要权限**：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION + +**系统能力**：SystemCapability.Telephony.StateRegistry + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------------------------- | ---- |------------------------------------------------------------| +| type | string | 是 | 小区信息变化事件 | +| callback | Callback\<[CellInformation](js-apis-radio.md#CellInformation)\> | 是 | 回调函数。参考radio的[CellInformation](js-apis-radio.md#CellInformation) | + +**错误码：** + +| 错误码ID | 错误信息 | +| -------- | -------------------------------------------- | +| 201 | Permission denied. | +| 401 | Parameter error. | +| 8300001 | Invalid parameter value. | +| 8300002 | Operation failed. Cannot connect to service. | +| 8300003 | System internal error. | +| 8300999 | Unknown error code. | + +**示例：** + +```js +observer.on('cellInfoChange', data => { + console.log("on cellInfoChange, data:" + JSON.stringify(data)); +}); +``` + + +## observer.on('cellInfoChange') + +on\(type: \'cellInfoChange\', options: { slotId: number }, callback: Callback\): void; + +订阅指定卡槽位的小区信息变化事件，使用callback方式作为异步方法。 + +**系统接口：** 此接口为系统接口。 + +**需要权限**：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION + +**系统能力**：SystemCapability.Telephony.StateRegistry + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ------ |--------------------------------------------------| ---- |------------------------------------------------------------| +| type | string | 是 | 小区变化事件 | +| slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | +| callback | Callback\<[CellInformation](js-apis-radio.md#CellInformation)\> | 是 | 回调函数。参考radio的[CellInformation](js-apis-radio.md#CellInformation) | + +**错误码：** + +| 错误码ID | 错误信息 | +| -------- | -------------------------------------------- | +| 201 | Permission denied. | +| 401 | Parameter error. | +| 8300001 | Invalid parameter value. | +| 8300002 | Operation failed. Cannot connect to service. | +| 8300003 | System internal error. | +| 8300999 | Unknown error code. | + +**示例：** + +```js +observer.on('cellInfoChange', {slotId: 0}, data => { + console.log("on cellInfoChange, data:" + JSON.stringify(data)); +}); +``` + + +## observer.off('cellInfoChange') + +off\(type: \'cellInfoChange\', callback?: Callback\): void; + +取消订阅小区信息变化事件，使用callback方式作为异步方法。 + +>**说明：** +> +>可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。 + +**系统能力**：SystemCapability.Telephony.StateRegistry + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------------------------- | ---- | ------------------------------------------------------------ | +| type | string | 是 | 网络状态变化事件 | +| callback | Callback\<[CellInformation](js-apis-radio.md#CellInformation)\> | 否 | 回调函数。参考radio的[CellInformation](js-apis-radio.md#CellInformation) | + +| 错误码ID | 错误信息 | +| -------- | -------------------------------------------- | +| 401 | Parameter error. | +| 8300001 | Invalid parameter value. | +| 8300002 | Operation failed. Cannot connect to service. | +| 8300003 | System internal error. | +| 8300999 | Unknown error code. | + +**示例：** + +```js +let callback = data => { + console.log("on cellInfoChange, data:" + JSON.stringify(data)); +} +observer.on('cellInfoChange', callback); +// 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。 +observer.off('cellInfoChange', callback); +observer.off('cellInfoChange'); +``` ## observer.on('callStateChange') -- GitLab