!15884 电话接口更新

Merge pull request !15884 from wangziming/master

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

@@ -14,12 +14,16 @@
 import call from '@ohos.telephony.call';
 ```
 
-## call.dial
+## call.dial<sup>(deprecated)</sup>
 
 dial\(phoneNumber: string, callback: AsyncCallback<boolean\>\): void
 
 拨打电话。使用callback异步回调。
 
+>**说明：** 
+>
+>从API version 6 开始支持，从API version 9 开始废弃，建议使用[dialCall](#calldialcall9)替代。
+
 **需要权限**：ohos.permission.PLACE_CALL
 
 **系统能力**：SystemCapability.Telephony.CallManager
@@ -40,12 +44,16 @@ call.dial("138xxxxxxxx", (err, data) => {
 ```
 
 
-## call.dial
+## call.dial<sup>(deprecated)</sup>
 
 dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean\>\): void
 
 拨打电话，可设置通话参数。使用callback异步回调。
 
+>**说明：** 
+>
+>从API version 6 开始支持，从API version 9 开始废弃，建议使用[dialCall](#calldialcall9)替代。
+
 **需要权限**：ohos.permission.PLACE_CALL
 
 **系统能力**：SystemCapability.Telephony.CallManager
@@ -69,12 +77,16 @@ call.dial("138xxxxxxxx", {
 ```
 
 
-## call.dial
+## call.dial<sup>(deprecated)</sup>
 
 dial\(phoneNumber: string, options?: DialOptions\): Promise<boolean\>
 
 拨打电话，可设置通话参数。使用Promise异步回调。
 
+>**说明：** 
+>
+>从API version 6 开始支持，从API version 9 开始废弃，建议使用[dialCall](#calldialcall9)替代。
+
 **需要权限**：ohos.permission.PLACE_CALL
 
 **系统能力**：SystemCapability.Telephony.CallManager
@@ -223,12 +235,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)}`);
+});
 ```
 
 
@@ -815,9 +829,9 @@ promise.then(data => {
 ```
 
 
-## call.answer<sup>7+</sup>
+## call.answerCall<sup>9+</sup>
 
-answer\(callId: number, callback: AsyncCallback<void\>\): void
+answerCall\(callId: number, callback: AsyncCallback<void\>\): void
 
 接听来电。使用callback异步回调。
 
@@ -848,15 +862,15 @@ answer\(callId: number, callback: AsyncCallback<void\>\): void
 **示例：**
 
 ```js
-call.answer(1, (err, data) => {
+call.answerCall(1, (err, data) => {
     console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
 });
 ```
 
 
-## call.answer<sup>7+</sup>
+## call.answerCall<sup>9+</sup>
 
-answer(callId?: number\): Promise<void\>
+answerCall(callId?: number\): Promise<void\>
 
 接听来电。使用Promise异步回调。
 
@@ -892,20 +906,20 @@ answer(callId?: number\): Promise<void\>
 **示例：**
 
 ```js
-let promise = call.answer(1);
+let promise = call.answerCall(1);
 promise.then(data => {
-    console.log(`answer success, promise: data->${JSON.stringify(data)}`);
+    console.log(`answerCall success, promise: data->${JSON.stringify(data)}`);
 }).catch(err => {
-    console.error(`answer fail, promise: err->${JSON.stringify(err)}`);
+    console.error(`answerCall fail, promise: err->${JSON.stringify(err)}`);
 });
 ```
 
 
-## call.hangup<sup>7+</sup>
+## call.answerCall<sup>9+</sup>
 
-hangup\(callId: number, callback: AsyncCallback<void\>\): void
+answerCall\(callback: AsyncCallback<void\>\): void
 
-挂断电话。使用callback异步回调。
+接听来电。使用callback异步回调。
 
 **系统接口：** 此接口为系统接口。
 
@@ -915,10 +929,9 @@ hangup\(callId: number, callback: AsyncCallback<void\>\): void
 
 **参数：**
 
-| 参数名   | 类型                      | 必填 | 说明                                            |
-| -------- | ------------------------- | ---- | ----------------------------------------------- |
-| callId   | number                    | 是   | 呼叫id。可以通过订阅callDetailsChange事件获得。 |
-| callback | AsyncCallback&lt;void&gt; | 是   | 回调函数。                                      |
+| 参数名   | 类型                      | 必填 | 说明       |
+| -------- | ------------------------- | ---- | ---------- |
+| callback | AsyncCallback&lt;void&gt; | 是   | 回调函数。 |
 
 **错误码：**
 
@@ -934,17 +947,17 @@ hangup\(callId: number, callback: AsyncCallback<void\>\): void
 **示例：**
 
 ```js
-call.hangup(1, (err, data) => {
+call.answerCall((err, data) => {
     console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
 });
 ```
 
 
-## call.answer<sup>9+</sup>
+## call.hangUpCall<sup>9+</sup>
 
-answer\(callback: AsyncCallback<void\>\): void
+hangUpCall\(callId: number, callback: AsyncCallback<void\>\): void
 
-接听来电。使用callback异步回调。
+挂断电话。使用callback异步回调。
 
 **系统接口：** 此接口为系统接口。
 
@@ -954,9 +967,10 @@ answer\(callback: AsyncCallback<void\>\): void
 
 **参数：**
 
-| 参数名   | 类型                      | 必填 | 说明       |
-| -------- | ------------------------- | ---- | ---------- |
-| callback | AsyncCallback&lt;void&gt; | 是   | 回调函数。 |
+| 参数名   | 类型                      | 必填 | 说明                                            |
+| -------- | ------------------------- | ---- | ----------------------------------------------- |
+| callId   | number                    | 是   | 呼叫id。可以通过订阅callDetailsChange事件获得。 |
+| callback | AsyncCallback&lt;void&gt; | 是   | 回调函数。                                      |
 
 **错误码：**
 
@@ -972,15 +986,15 @@ answer\(callback: AsyncCallback<void\>\): void
 **示例：**
 
 ```js
-call.answer((err, data) => {
+call.hangUpCall(1, (err, data) => {
     console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
 });
 ```
 
 
-## call.hangup<sup>7+</sup>
+## call.hangUpCall<sup>9+</sup>
 
-hangup\(callId?: number\): Promise<void\>
+hangUpCall\(callId?: number\): Promise<void\>
 
 挂断电话。使用Promise异步回调。
 
@@ -1016,18 +1030,18 @@ hangup\(callId?: number\): Promise<void\>
 **示例：**
 
 ```js
-let promise = call.hangup(1);
+let promise = call.hangUpCall(1);
 promise.then(data => {
-    console.log(`hangup success, promise: data->${JSON.stringify(data)}`);
+    console.log(`hangUpCall success, promise: data->${JSON.stringify(data)}`);
 }).catch(err => {
-    console.error(`hangup fail, promise: err->${JSON.stringify(err)}`);
+    console.error(`hangUpCall fail, promise: err->${JSON.stringify(err)}`);
 });
 ```
 
 
-## call.hangup<sup>9+</sup>
+## call.hangUpCall<sup>9+</sup>
 
-hangup\(callback: AsyncCallback<void\>\): void
+hangUpCall\(callback: AsyncCallback<void\>\): void
 
 挂断电话。使用callback异步回调。
 
@@ -1058,15 +1072,15 @@ hangup\(callback: AsyncCallback<void\>\): void
 **示例：**
 
 ```js
-call.hangup((err, data) => {
+call.hangUpCall((err, data) => {
     console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
 });
 ```
 
 
-## call.reject<sup>7+</sup>
+## call.rejectCall<sup>9+</sup>
 
-reject(callId: number, callback: AsyncCallback\<void>): void
+rejectCall(callId: number, callback: AsyncCallback\<void>): void
 
 拒绝来电。使用callback异步回调。
 
@@ -1098,15 +1112,15 @@ reject(callId: number, callback: AsyncCallback\<void>): void
 **示例：**
 
 ```js
-call.reject(1, (err, data) => {
+call.rejectCall(1, (err, data) => {
     console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
 });
 ```
 
 
-## call.reject<sup>7+</sup>
+## call.rejectCall<sup>9+</sup>
 
-reject\(callId: number, options: RejectMessageOptions, callback: AsyncCallback<void\>\): void
+rejectCall\(callId: number, options: RejectMessageOptions, callback: AsyncCallback<void\>\): void
 
 拒绝来电。使用callback异步回调。
 
@@ -1141,15 +1155,15 @@ reject\(callId: number, options: RejectMessageOptions, callback: AsyncCallback<v
 let rejectMessageOptions={
     messageContent: "拦截陌生号码"
 }
-call.reject(1, rejectMessageOptions, (err, data) => {
+call.rejectCall(1, rejectMessageOptions, (err, data) => {
     console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
 });
 ```
 
 
-## call.reject<sup>7+</sup>
+## call.rejectCall<sup>9+</sup>
 
-reject(callId?: number, options?: RejectMessageOptions\): Promise<void\>
+rejectCall(callId?: number, options?: RejectMessageOptions\): Promise<void\>
 
 拒绝来电。使用Promise异步回调。
 
@@ -1198,9 +1212,9 @@ promise.then(data => {
 ```
 
 
-## call.reject<sup>9+</sup>
+## call.rejectCall<sup>9+</sup>
 
-reject\(callback: AsyncCallback<void\>\): void
+rejectCall\(callback: AsyncCallback<void\>\): void
 
 拒绝来电。使用callback异步回调。
 
@@ -1230,15 +1244,15 @@ reject\(callback: AsyncCallback<void\>\): void
 **示例：**
 
 ```js
-call.reject((err, data) => {
+call.rejectCall((err, data) => {
     console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
 });
 ```
 
 
-## call.reject<sup>9+</sup>
+## call.rejectCall<sup>9+</sup>
 
-reject\(options: RejectMessageOptions, callback: AsyncCallback<void\>\): void
+rejectCall\(options: RejectMessageOptions, callback: AsyncCallback<void\>\): void
 
 拒绝来电。使用callback异步回调。
 
@@ -1272,7 +1286,7 @@ reject\(options: RejectMessageOptions, callback: AsyncCallback<void\>\): void
 let rejectMessageOptions={
     messageContent: "拦截陌生号码"
 }
-call.reject(rejectMessageOptions, (err, data) => {
+call.rejectCall(rejectMessageOptions, (err, data) => {
     console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
 });
 ```