!16020 电话接口更新

Merge pull request !16020 from wangziming/OpenHarmony-3.2-Release

zh-cn/application-dev/reference/apis/js-apis-call.md

@@ -20,6 +20,10 @@ dial\(phoneNumber: string, callback: AsyncCallback<boolean\>\): void
 
 拨打电话。使用callback异步回调。
 
+>**说明：** 
+>
+>从API version 6 开始支持，从API version 9 开始废弃，建议使用[dialCall](#calldialcall9)替代。
+
 **需要权限**：ohos.permission.PLACE_CALL
 
 **系统能力**：SystemCapability.Telephony.CallManager
@@ -46,6 +50,10 @@ dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean
 
 拨打电话，可设置通话参数。使用callback异步回调。
 
+>**说明：** 
+>
+>从API version 6 开始支持，从API version 9 开始废弃，建议使用[dialCall](#calldialcall9)替代。
+
 **需要权限**：ohos.permission.PLACE_CALL
 
 **系统能力**：SystemCapability.Telephony.CallManager
@@ -75,6 +83,10 @@ dial\(phoneNumber: string, options?: DialOptions\): Promise<boolean\>
 
 拨打电话，可设置通话参数。使用Promise异步回调。
 
+>**说明：** 
+>
+>从API version 6 开始支持，从API version 9 开始废弃，建议使用[dialCall](#calldialcall9)替代。
+
 **需要权限**：ohos.permission.PLACE_CALL
 
 **系统能力**：SystemCapability.Telephony.CallManager
@@ -232,12 +244,14 @@ dialCall\(phoneNumber: string, options?: DialCallOptions\): Promise<void\>
 **示例：**
 
 ```js
-try {
-    call.dialCall('138xxxxxxxx');
+let promise = call.dialCall("138xxxxxxxx", {
+    extras: false
+});
+promise.then(data => {
     console.log(`dialCall success, promise: data->${JSON.stringify(data)}`);
-} catch (error) {
-    console.log(`dialCall fail, promise: err->${JSON.stringify(error)}`);
-}
+}).catch(err => {
+    console.error(`dialCall fail, promise: err->${JSON.stringify(err)}`);
+});
 ```
 
 
@@ -836,7 +850,7 @@ promise.then(data => {
 ```
 
 
-## call.answerCall<sup>7+</sup>
+## call.answerCall<sup>9+</sup>
 
 answerCall\(callId: number, callback: AsyncCallback<void\>\): void
 
@@ -876,7 +890,7 @@ call.answerCall(1, (err, data) => {
 ```
 
 
-## call.answerCall<sup>7+</sup>
+## call.answerCall<sup>9+</sup>
 
 answerCall(callId?: number\): Promise<void\>
 
@@ -963,7 +977,7 @@ call.answerCall((err, data) => {
 ```
 
 
-## call.hangUpCall<sup>7+</sup>
+## call.hangUpCall<sup>9+</sup>
 
 hangUpCall\(callId: number, callback: AsyncCallback<void\>\): void
 
@@ -1003,7 +1017,7 @@ call.hangUpCall(1, (err, data) => {
 ```
 
 
-## call.hangUpCall<sup>7+</sup>
+## call.hangUpCall<sup>9+</sup>
 
 hangUpCall\(callId?: number\): Promise<void\>
 
@@ -1132,7 +1146,7 @@ call.rejectCall(1, (err, data) => {
 ```
 
 
-## call.rejectCall<sup>7+</sup>
+## call.rejectCall<sup>9+</sup>
 
 rejectCall\(callId: number, options: RejectMessageOptions, callback: AsyncCallback<void\>\): void
 
@@ -1176,7 +1190,7 @@ call.rejectCall(1, rejectMessageOptions, (err, data) => {
 ```
 
 
-## call.rejectCall<sup>7+</sup>
+## call.rejectCall<sup>9+</sup>
 
 rejectCall(callId?: number, options?: RejectMessageOptions\): Promise<void\>