1# @ohos.telephony.call (拨打电话)（系统接口） 2 3该模块提供呼叫管理功能，包括拨打电话、跳转到拨号界面、获取通话状态、格式化电话号码等。 4 5如需订阅通话状态请使用[`observer.on('callStateChange')`](js-apis-observer.md#observeroncallstatechange)。 6 7>**说明：** 8> 9>本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 10> 当前页面仅包含本模块的系统接口，其他公开接口参见[@ohos.telephony.call (拨打电话)](js-apis-call.md) 11 12 13## 导入模块 14 15```ts 16import { call } from '@kit.TelephonyKit'; 17``` 18 19## call.dialCall<sup>9+</sup> 20 21dialCall\(phoneNumber: string, callback: AsyncCallback\<void\>\): void 22 23拨打电话。使用callback异步回调。 24 25**系统接口：** 此接口为系统接口。 26 27**需要权限**：ohos.permission.PLACE_CALL 28 29**系统能力**：SystemCapability.Telephony.CallManager 30 31**参数：** 32 33| 参数名 | 类型 | 必填 | 说明 | 34| ----------- | ---------------------------- | ---- | -------------------------------------- | 35| phoneNumber | string | 是 | 电话号码。 | 36| callback | AsyncCallback<void> | 是 | 以callback形式异步返回拨打电话的结果。 | 37 38**错误码：** 39 40以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 41 42| 错误码ID | 错误信息 | 43| -------- | -------------------------------------------- | 44| 201 | Permission denied. | 45| 202 | Non-system applications use system APIs. | 46| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 47| 8300001 | Invalid parameter value. | 48| 8300002 | Operation failed. Cannot connect to service. | 49| 8300003 | System internal error. | 50| 8300005 | Airplane mode is on. | 51| 8300006 | Network not in service. | 52| 8300999 | Unknown error code. | 53 54**示例：** 55 56```ts 57import { BusinessError } from '@kit.BasicServicesKit'; 58 59call.dialCall("138xxxxxxxx", (err: BusinessError) => { 60 if (err) { 61 console.error(`dialCall fail, err->${JSON.stringify(err)}`); 62 } else { 63 console.log(`dialCall success.`); 64 } 65}); 66``` 67 68 69## call.dialCall<sup>9+</sup> 70 71dialCall\(phoneNumber: string, options: DialCallOptions, callback: AsyncCallback\<void\>\): void 72 73拨打电话，可设置通话参数。使用callback异步回调。 74 75**系统接口：** 此接口为系统接口。 76 77**需要权限**：ohos.permission.PLACE_CALL 78 79**系统能力**：SystemCapability.Telephony.CallManager 80 81**参数：** 82 83| 参数名 | 类型 | 必填 | 说明 | 84| ----------- | ----------------------------------- | ---- | ----------------------------------- | 85| phoneNumber | string | 是 | 电话号码。 | 86| options | [DialCallOptions](#dialcalloptions9)| 是 | 通话参数，携带呼叫的其他配置信息。 | 87| callback | AsyncCallback<void> | 是 | 以callback形式异步返回拨打电话的结果。| 88 89**错误码：** 90 91以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 92 93| 错误码ID | 错误信息 | 94| -------- | -------------------------------------------- | 95| 201 | Permission denied. | 96| 202 | Non-system applications use system APIs. | 97| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 98| 8300001 | Invalid parameter value. | 99| 8300002 | Operation failed. Cannot connect to service. | 100| 8300003 | System internal error. | 101| 8300005 | Airplane mode is on. | 102| 8300006 | Network not in service. | 103| 8300999 | Unknown error code. | 104 105**示例：** 106 107```ts 108import { BusinessError } from '@kit.BasicServicesKit'; 109 110let dialCallOptions: call.DialCallOptions = { 111 accountId: 0, 112 videoState: 0, 113 dialScene: 0, 114 dialType: 0, 115} 116call.dialCall("138xxxxxxxx", dialCallOptions, (err: BusinessError) => { 117 if (err) { 118 console.error(`dialCall fail, err->${JSON.stringify(err)}`); 119 } else { 120 console.log(`dialCall success.`); 121 } 122}); 123``` 124 125 126## call.dialCall<sup>9+</sup> 127 128dialCall\(phoneNumber: string, options?: DialCallOptions\): Promise\<void\> 129 130拨打电话，可设置通话参数。使用Promise异步回调。 131 132**系统接口：** 此接口为系统接口。 133 134**需要权限**：ohos.permission.PLACE_CALL 135 136**系统能力**：SystemCapability.Telephony.CallManager 137 138**参数：** 139 140| 参数名 | 类型 | 必填 | 说明 | 141| ----------- | ----------------------------------- | ---- | -------------------------------------- | 142| phoneNumber | string | 是 | 电话号码。 | 143| options | [DialCallOptions](#dialcalloptions9)| 否 | 通话参数，携带呼叫的其他配置信息。<br/>不填该参数则默认使用如下配置，参考[DialCallOptions](#dialcalloptions9)。<br/>- 帐户Id：卡槽1 <br/>- 音视频类型：语音通话 <br/>- 拨号场景：普通呼叫 <br/>- 拨号类型：运营商通话 | 144 145**返回值：** 146 147| 类型 | 说明 | 148| ---------------------- | ---------------------------- | 149| Promise<void> | 以Promise形式异步返回拨号结果。| 150 151**错误码：** 152 153以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 154 155| 错误码ID | 错误信息 | 156| -------- | -------------------------------------------- | 157| 201 | Permission denied. | 158| 202 | Non-system applications use system APIs. | 159| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 160| 8300001 | Invalid parameter value. | 161| 8300002 | Operation failed. Cannot connect to service. | 162| 8300003 | System internal error. | 163| 8300005 | Airplane mode is on. | 164| 8300006 | Network not in service. | 165| 8300999 | Unknown error code. | 166 167**示例：** 168 169```ts 170import { BusinessError } from '@kit.BasicServicesKit'; 171 172let dialCallOptions: call.DialCallOptions = { 173 accountId: 0, 174 videoState: 0, 175 dialScene: 0, 176 dialType: 0, 177} 178call.dialCall("138xxxxxxxx", dialCallOptions).then(() => { 179 console.log(`dialCall success.`); 180}).catch((err: BusinessError) => { 181 console.error(`dialCall fail, promise: err->${JSON.stringify(err)}`); 182}); 183``` 184 185 186## call.muteRinger<sup>8+</sup> 187 188muteRinger\(callback: AsyncCallback\<void\>\): void 189 190如果来电铃声响起，设备将停止铃声。否则，此方法不起作用。使用callback异步回调。 191 192**系统接口：** 此接口为系统接口。 193 194**需要权限**：ohos.permission.SET_TELEPHONY_STATE 195 196**系统能力**：SystemCapability.Telephony.CallManager 197 198**参数：** 199 200| 参数名 | 类型 | 必填 | 说明 | 201| ----------- | ------------------------- | ---- | ---------- | 202| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回停止铃声的结果。 | 203 204**错误码：** 205 206以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 207 208| 错误码ID | 错误信息 | 209| -------- | -------------------------------------------- | 210| 201 | Permission denied. | 211| 202 | Non-system applications use system APIs. | 212| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 213| 8300001 | Invalid parameter value. | 214| 8300002 | Operation failed. Cannot connect to service. | 215| 8300003 | System internal error. | 216| 8300999 | Unknown error code. | 217 218**示例：** 219 220```ts 221import { BusinessError } from '@kit.BasicServicesKit'; 222 223call.muteRinger((err: BusinessError) => { 224 if (err) { 225 console.error(`muteRinger fail, err->${JSON.stringify(err)}`); 226 } else { 227 console.log(`muteRinger success.`); 228 } 229}); 230``` 231 232 233## call.muteRinger<sup>8+</sup> 234 235muteRinger\(\): Promise\<void\> 236 237如果来电铃声响起，设备将停止铃声。否则，此方法不起作用。使用Promise异步回调。 238 239**系统接口：** 此接口为系统接口。 240 241**需要权限**：ohos.permission.SET_TELEPHONY_STATE 242 243**系统能力**：SystemCapability.Telephony.CallManager 244 245**返回值：** 246 247| 类型 | 说明 | 248| ------------------- | --------------------------- | 249| Promise<void> | 以Promise形式异步返回结果。 | 250 251**错误码：** 252 253以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 254 255| 错误码ID | 错误信息 | 256| -------- | -------------------------------------------- | 257| 201 | Permission denied. | 258| 202 | Non-system applications use system APIs. | 259| 8300002 | Operation failed. Cannot connect to service. | 260| 8300003 | System internal error. | 261| 8300999 | Unknown error code. | 262 263**示例：** 264 265```ts 266import { BusinessError } from '@kit.BasicServicesKit'; 267 268call.muteRinger().then(() => { 269 console.log(`muteRinger success.`); 270}).catch((err: BusinessError) => { 271 console.error(`muteRinger fail, promise: err->${JSON.stringify(err)}`); 272}); 273``` 274 275 276## call.answerCall<sup>9+</sup> 277 278answerCall\(callId: number, callback: AsyncCallback\<void\>\): void 279 280接听来电。使用callback异步回调。 281 282**系统接口：** 此接口为系统接口。 283 284**需要权限**：ohos.permission.ANSWER_CALL 285 286**系统能力**：SystemCapability.Telephony.CallManager 287 288**参数：** 289 290| 参数名 | 类型 | 必填 | 说明 | 291| -------- | ------------------------- | ---- | ----------------------------------------------- | 292| callId | number | 是 | 呼叫Id。可以通过订阅callDetailsChange事件获得。 | 293| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回接听电话的结果。 | 294 295**错误码：** 296 297以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 298 299| 错误码ID | 错误信息 | 300| -------- | -------------------------------------------- | 301| 201 | Permission denied. | 302| 202 | Non-system applications use system APIs. | 303| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 304| 8300001 | Invalid parameter value. | 305| 8300002 | Operation failed. Cannot connect to service. | 306| 8300003 | System internal error. | 307| 8300999 | Unknown error code. | 308 309**示例：** 310 311```ts 312import { BusinessError } from '@kit.BasicServicesKit'; 313 314call.answerCall(1, (err: BusinessError) => { 315 if (err) { 316 console.error(`answerCall fail, err->${JSON.stringify(err)}`); 317 } else { 318 console.log(`answerCall success.`); 319 } 320}); 321``` 322 323 324## call.answerCall<sup>9+</sup> 325 326answerCall(callId?: number\): Promise\<void\> 327 328接听来电。使用Promise异步回调。 329 330**系统接口：** 此接口为系统接口。 331 332**需要权限**：ohos.permission.ANSWER_CALL 333 334**系统能力**：SystemCapability.Telephony.CallManager 335 336**参数：** 337 338| 参数名 | 类型 | 必填 | 说明 | 339| ------ | ------ | ---- | ------------------------------------------------------------ | 340| callId | number | 否 | 呼叫Id。可以通过订阅callDetailsChange事件获得。从API Version 9开始为可选参数。<br/>不填该参数则接通最近一通正在响铃的来电。| 341 342**返回值：** 343 344| 类型 | 说明 | 345| ------------------- | --------------------------- | 346| Promise<void> | 以Promise形式异步返回结果。 | 347 348**错误码：** 349 350以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 351 352| 错误码ID | 错误信息 | 353| -------- | -------------------------------------------- | 354| 201 | Permission denied. | 355| 202 | Non-system applications use system APIs. | 356| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 357| 8300001 | Invalid parameter value. | 358| 8300002 | Operation failed. Cannot connect to service. | 359| 8300003 | System internal error. | 360| 8300999 | Unknown error code. | 361 362**示例：** 363 364```ts 365import { BusinessError } from '@kit.BasicServicesKit'; 366 367call.answerCall(1).then(() => { 368 console.log(`answerCall success.`); 369}).catch((err: BusinessError) => { 370 console.error(`answerCall fail, promise: err->${JSON.stringify(err)}`); 371}); 372``` 373 374 375## call.answerCall<sup>9+</sup> 376 377answerCall\(callback: AsyncCallback\<void\>\): void 378 379接听来电。使用callback异步回调。 380 381**系统接口：** 此接口为系统接口。 382 383**需要权限**：ohos.permission.ANSWER_CALL 384 385**系统能力**：SystemCapability.Telephony.CallManager 386 387**参数：** 388 389| 参数名 | 类型 | 必填 | 说明 | 390| -------- | ------------------------- | ---- | ---------- | 391| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回接听电话的结果。 | 392 393**错误码：** 394 395以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 396 397| 错误码ID | 错误信息 | 398| -------- | -------------------------------------------- | 399| 201 | Permission denied. | 400| 202 | Non-system applications use system APIs. | 401| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 402| 8300001 | Invalid parameter value. | 403| 8300002 | Operation failed. Cannot connect to service. | 404| 8300003 | System internal error. | 405| 8300999 | Unknown error code. | 406 407**示例：** 408 409```ts 410import { BusinessError } from '@kit.BasicServicesKit'; 411 412call.answerCall((err: BusinessError) => { 413 if (err) { 414 console.error(`answerCall fail, err->${JSON.stringify(err)}`); 415 } else { 416 console.log(`answerCall success.`); 417 } 418}); 419``` 420 421 422## call.hangUpCall<sup>9+</sup> 423 424hangUpCall\(callId: number, callback: AsyncCallback\<void\>\): void 425 426挂断电话。使用callback异步回调。 427 428**系统接口：** 此接口为系统接口。 429 430**需要权限**：ohos.permission.ANSWER_CALL 431 432**系统能力**：SystemCapability.Telephony.CallManager 433 434**参数：** 435 436| 参数名 | 类型 | 必填 | 说明 | 437| -------- | ------------------------- | ---- | ----------------------------------------------- | 438| callId | number | 是 | 呼叫id。可以通过订阅callDetailsChange事件获得。 | 439| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回挂断电话的结果。 | 440 441**错误码：** 442 443以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 444 445| 错误码ID | 错误信息 | 446| -------- | -------------------------------------------- | 447| 201 | Permission denied. | 448| 202 | Non-system applications use system APIs. | 449| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 450| 8300001 | Invalid parameter value. | 451| 8300002 | Operation failed. Cannot connect to service. | 452| 8300003 | System internal error. | 453| 8300999 | Unknown error code. | 454 455**示例：** 456 457```ts 458import { BusinessError } from '@kit.BasicServicesKit'; 459 460call.hangUpCall(1, (err: BusinessError) => { 461 if (err) { 462 console.error(`hangUpCall fail, err->${JSON.stringify(err)}`); 463 } else { 464 console.log(`hangUpCall success.`); 465 } 466}); 467``` 468 469 470## call.hangUpCall<sup>9+</sup> 471 472hangUpCall\(callId?: number\): Promise\<void\> 473 474挂断电话。使用Promise异步回调。 475 476**系统接口：** 此接口为系统接口。 477 478**需要权限**：ohos.permission.ANSWER_CALL 479 480**系统能力**：SystemCapability.Telephony.CallManager 481 482**参数：** 483 484| 参数名 | 类型 | 必填 | 说明 | 485| ------ | ------ | ---- | ------------------------------------------------------------ | 486| callId | number | 否 | 呼叫id。可以通过订阅callDetailsChange事件获得。从API Version 9开始为可选参数。</br>不填该参数则挂断最近一通正在进行/拨号/连接的通话。| 487 488**返回值：** 489 490| 类型 | 说明 | 491| ------------------- | --------------------------- | 492| Promise<void> | 以Promise形式异步返回结果。 | 493 494**错误码：** 495 496以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 497 498| 错误码ID | 错误信息 | 499| -------- | -------------------------------------------- | 500| 201 | Permission denied. | 501| 202 | Non-system applications use system APIs. | 502| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 503| 8300001 | Invalid parameter value. | 504| 8300002 | Operation failed. Cannot connect to service. | 505| 8300003 | System internal error. | 506| 8300999 | Unknown error code. | 507 508**示例：** 509 510```ts 511import { BusinessError } from '@kit.BasicServicesKit'; 512 513call.hangUpCall(1).then(() => { 514 console.log(`hangUpCall success.`); 515}).catch((err: BusinessError) => { 516 console.error(`hangUpCall fail, promise: err->${JSON.stringify(err)}`); 517}); 518``` 519 520 521## call.hangUpCall<sup>9+</sup> 522 523hangUpCall\(callback: AsyncCallback\<void\>\): void 524 525挂断电话。使用callback异步回调。 526 527**系统接口：** 此接口为系统接口。 528 529**需要权限**：ohos.permission.ANSWER_CALL 530 531**系统能力**：SystemCapability.Telephony.CallManager 532 533**参数：** 534 535| 参数名 | 类型 | 必填 | 说明 | 536| -------- | ------------------------- | ---- | ---------- | 537| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回挂断电话的结果。 | 538 539**错误码：** 540 541以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 542 543| 错误码ID | 错误信息 | 544| -------- | -------------------------------------------- | 545| 201 | Permission denied. | 546| 202 | Non-system applications use system APIs. | 547| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 548| 8300001 | Invalid parameter value. | 549| 8300002 | Operation failed. Cannot connect to service. | 550| 8300003 | System internal error. | 551| 8300999 | Unknown error code. | 552 553 554**示例：** 555 556```ts 557import { BusinessError } from '@kit.BasicServicesKit'; 558 559call.hangUpCall((err: BusinessError) => { 560 if (err) { 561 console.error(`hangUpCall fail, err->${JSON.stringify(err)}`); 562 } else { 563 console.log(`hangUpCall success.`); 564 } 565}); 566``` 567 568 569## call.rejectCall<sup>9+</sup> 570 571rejectCall\(callId: number, callback: AsyncCallback\<void\>\): void 572 573拒绝来电。使用callback异步回调。 574 575**系统接口：** 此接口为系统接口。 576 577**需要权限**：ohos.permission.ANSWER_CALL 578 579**系统能力**：SystemCapability.Telephony.CallManager 580 581**参数：** 582 583| 参数名 | 类型 | 必填 | 说明 | 584| -------- | ------------------------- | ---- | ----------------------------------------------- | 585| callId | number | 是 | 呼叫Id。可以通过订阅callDetailsChange事件获得。 | 586| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回拒接电话的结果。 | 587 588**错误码：** 589 590以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 591 592| 错误码ID | 错误信息 | 593| -------- | -------------------------------------------- | 594| 201 | Permission denied. | 595| 202 | Non-system applications use system APIs. | 596| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 597| 8300001 | Invalid parameter value. | 598| 8300002 | Operation failed. Cannot connect to service. | 599| 8300003 | System internal error. | 600| 8300999 | Unknown error code. | 601 602 603**示例：** 604 605```ts 606import { BusinessError } from '@kit.BasicServicesKit'; 607 608call.rejectCall(1, (err: BusinessError) => { 609 if (err) { 610 console.error(`rejectCall fail, err->${JSON.stringify(err)}`); 611 } else { 612 console.log(`rejectCall success.`); 613 } 614}); 615``` 616 617 618## call.rejectCall<sup>9+</sup> 619 620rejectCall\(callId: number, options: RejectMessageOptions, callback: AsyncCallback\<void\>\): void 621 622拒绝来电。使用callback异步回调。 623 624**系统接口：** 此接口为系统接口。 625 626**需要权限**：ohos.permission.ANSWER_CALL 627 628**系统能力**：SystemCapability.Telephony.CallManager 629 630**参数：** 631 632| 参数名 | 类型 | 必填 | 说明 | 633| -------- | ---------------------------------------------- | ---- | ----------------------------------------------- | 634| callId | number | 是 | 呼叫Id。可以通过订阅callDetailsChange事件获得。 | 635| options | [RejectMessageOptions](#rejectmessageoptions7) | 是 | 拒绝消息选项。 | 636| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回拒接电话的结果。 | 637 638**错误码：** 639 640以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 641 642| 错误码ID | 错误信息 | 643| -------- | -------------------------------------------- | 644| 201 | Permission denied. | 645| 202 | Non-system applications use system APIs. | 646| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 647| 8300001 | Invalid parameter value. | 648| 8300002 | Operation failed. Cannot connect to service. | 649| 8300003 | System internal error. | 650| 8300999 | Unknown error code. | 651 652**示例：** 653 654```ts 655import { BusinessError } from '@kit.BasicServicesKit'; 656 657let rejectMessageOptions : call.RejectMessageOptions = { 658 messageContent: "拦截陌生号码" 659} 660call.rejectCall(1, rejectMessageOptions, (err: BusinessError) => { 661 if (err) { 662 console.error(`rejectCall fail, err->${JSON.stringify(err)}`); 663 } else { 664 console.log(`rejectCall success.`); 665 } 666}); 667``` 668 669 670## call.rejectCall<sup>9+</sup> 671 672rejectCall\(callId?: number, options?: RejectMessageOptions\): Promise\<void\> 673 674拒绝来电。使用Promise异步回调。 675 676**系统接口：** 此接口为系统接口。 677 678**需要权限**：ohos.permission.ANSWER_CALL 679 680**系统能力**：SystemCapability.Telephony.CallManager 681 682**参数：** 683 684| 参数名 | 类型 | 必填 | 说明 | 685| ------- | ---------------------------------------------- | ---- | ------------------------------------------------------------ | 686| callId | number | 否 | 呼叫Id。可以通过订阅callDetailsChange事件获得。从API Version 9开始为可选参数。<br/>不填该参数则拒接最近一通正在响铃的来电。| 687| options | [RejectMessageOptions](#rejectmessageoptions7) | 否 | 拒绝消息选项。不填该参数则不会发送拒接短信。| 688 689**返回值：** 690 691| 类型 | 说明 | 692| ------------------- | --------------------------- | 693| Promise<void> | 以Promise形式异步返回结果。 | 694 695**错误码：** 696 697以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 698 699| 错误码ID | 错误信息 | 700| -------- | -------------------------------------------- | 701| 201 | Permission denied. | 702| 202 | Non-system applications use system APIs. | 703| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 704| 8300001 | Invalid parameter value. | 705| 8300002 | Operation failed. Cannot connect to service. | 706| 8300003 | System internal error. | 707| 8300999 | Unknown error code. | 708 709**示例：** 710 711```ts 712import { BusinessError } from '@kit.BasicServicesKit'; 713 714let rejectMessageOptions: call.RejectMessageOptions = { 715 messageContent: "拦截陌生号码" 716} 717call.rejectCall(1, rejectMessageOptions).then(() => { 718 console.log(`rejectCall success.`); 719}).catch((err: BusinessError) => { 720 console.error(`rejectCall fail, promise: err->${JSON.stringify(err)}`); 721}); 722``` 723 724 725## call.rejectCall<sup>9+</sup> 726 727rejectCall\(callback: AsyncCallback\<void\>\): void 728 729拒绝来电。使用callback异步回调。 730 731**系统接口：** 此接口为系统接口。 732 733**需要权限**：ohos.permission.ANSWER_CALL 734 735**系统能力**：SystemCapability.Telephony.CallManager 736 737**参数：** 738 739| 参数名 | 类型 | 必填 | 说明 | 740| -------- | ------------------------- | ---- | ---------- | 741| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回拒接电话的结果。 | 742 743**错误码：** 744 745以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 746 747| 错误码ID | 错误信息 | 748| -------- | -------------------------------------------- | 749| 201 | Permission denied. | 750| 202 | Non-system applications use system APIs. | 751| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 752| 8300001 | Invalid parameter value. | 753| 8300002 | Operation failed. Cannot connect to service. | 754| 8300003 | System internal error. | 755| 8300999 | Unknown error code. | 756 757**示例：** 758 759```ts 760import { BusinessError } from '@kit.BasicServicesKit'; 761 762call.rejectCall((err: BusinessError) => { 763 if (err) { 764 console.error(`rejectCall fail, err->${JSON.stringify(err)}`); 765 } else { 766 console.log(`rejectCall success.`); 767 } 768}); 769``` 770 771 772## call.rejectCall<sup>9+</sup> 773 774rejectCall\(options: RejectMessageOptions, callback: AsyncCallback\<void\>\): void 775 776拒绝来电。使用callback异步回调。 777 778**系统接口：** 此接口为系统接口。 779 780**需要权限**：ohos.permission.ANSWER_CALL 781 782**系统能力**：SystemCapability.Telephony.CallManager 783 784**参数：** 785 786| 参数名 | 类型 | 必填 | 说明 | 787| -------- | ---------------------------------------------- | ---- | -------------- | 788| options | [RejectMessageOptions](#rejectmessageoptions7) | 是 | 拒绝消息选项。 | 789| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回拒接电话的结果。 | 790 791**错误码：** 792 793以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 794 795| 错误码ID | 错误信息 | 796| -------- | -------------------------------------------- | 797| 201 | Permission denied. | 798| 202 | Non-system applications use system APIs. | 799| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 800| 8300001 | Invalid parameter value. | 801| 8300002 | Operation failed. Cannot connect to service. | 802| 8300003 | System internal error. | 803| 8300999 | Unknown error code. | 804 805**示例：** 806 807```ts 808import { BusinessError } from '@kit.BasicServicesKit'; 809 810let rejectMessageOptions: call.RejectMessageOptions = { 811 messageContent: "拦截陌生号码" 812} 813call.rejectCall(rejectMessageOptions, (err: BusinessError) => { 814 if (err) { 815 console.error(`rejectCall fail, err->${JSON.stringify(err)}`); 816 } else { 817 console.log(`rejectCall success.`); 818 } 819}); 820``` 821 822 823## call.holdCall<sup>7+</sup> 824 825holdCall\(callId: number, callback: AsyncCallback\<void\>\): void 826 827保持通话。使用callback异步回调。 828 829**系统接口：** 此接口为系统接口。 830 831**需要权限**：ohos.permission.ANSWER_CALL 832 833**系统能力**：SystemCapability.Telephony.CallManager 834 835**参数：** 836 837| 参数名 | 类型 | 必填 | 说明 | 838| -------- | ------------------------- | ---- | ---------- | 839| callId | number | 是 | 呼叫Id。 | 840| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回保持电话的结果。 | 841 842**错误码：** 843 844以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 845 846| 错误码ID | 错误信息 | 847| -------- | -------------------------------------------- | 848| 201 | Permission denied. | 849| 202 | Non-system applications use system APIs. | 850| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 851| 8300001 | Invalid parameter value. | 852| 8300002 | Operation failed. Cannot connect to service. | 853| 8300003 | System internal error. | 854| 8300999 | Unknown error code. | 855 856**示例：** 857 858```ts 859import { BusinessError } from '@kit.BasicServicesKit'; 860 861call.holdCall(1, (err: BusinessError) => { 862 if (err) { 863 console.error(`holdCall fail, err->${JSON.stringify(err)}`); 864 } else { 865 console.log(`holdCall success.`); 866 } 867}); 868``` 869 870 871## call.holdCall<sup>7+</sup> 872 873holdCall\(callId: number\): Promise\<void\> 874 875保持通话。使用Promise异步回调。 876 877**系统接口：** 此接口为系统接口。 878 879**需要权限**：ohos.permission.ANSWER_CALL 880 881**系统能力**：SystemCapability.Telephony.CallManager 882 883**参数：** 884 885| 参数名 | 类型 | 必填 | 说明 | 886| ------ | ------ | ---- | -------- | 887| callId | number | 是 | 呼叫Id。 | 888 889**返回值：** 890 891| 类型 | 说明 | 892| ------------------- | --------------------------- | 893| Promise<void> | 以Promise形式异步返回结果。 | 894 895**错误码：** 896 897以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 898 899| 错误码ID | 错误信息 | 900| -------- | -------------------------------------------- | 901| 201 | Permission denied. | 902| 202 | Non-system applications use system APIs. | 903| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 904| 8300001 | Invalid parameter value. | 905| 8300002 | Operation failed. Cannot connect to service. | 906| 8300003 | System internal error. | 907| 8300999 | Unknown error code. | 908 909**示例：** 910 911```ts 912import { BusinessError } from '@kit.BasicServicesKit'; 913 914call.holdCall(1).then(() => { 915 console.log(`holdCall success.`); 916}).catch((err: BusinessError) => { 917 console.error(`holdCall fail, promise: err->${JSON.stringify(err)}`); 918}); 919``` 920 921## call.unHoldCall<sup>7+</sup> 922 923unHoldCall\(callId: number, callback: AsyncCallback\<void\>\): void 924 925取消保持通话。使用callback异步回调。 926 927**系统接口：** 此接口为系统接口。 928 929**需要权限**：ohos.permission.ANSWER_CALL 930 931**系统能力**：SystemCapability.Telephony.CallManager 932 933**参数：** 934 935| 参数名 | 类型 | 必填 | 说明 | 936| -------- | ------------------------- | ---- | ---------- | 937| callId | number | 是 | 呼叫Id。 | 938| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回取消保持电话的结果。 | 939 940**错误码：** 941 942以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 943 944| 错误码ID | 错误信息 | 945| -------- | -------------------------------------------- | 946| 201 | Permission denied. | 947| 202 | Non-system applications use system APIs. | 948| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 949| 8300001 | Invalid parameter value. | 950| 8300002 | Operation failed. Cannot connect to service. | 951| 8300003 | System internal error. | 952| 8300999 | Unknown error code. | 953 954**示例：** 955 956```ts 957import { BusinessError } from '@kit.BasicServicesKit'; 958 959call.unHoldCall(1, (err: BusinessError) => { 960 if (err) { 961 console.error(`unHoldCall fail, err->${JSON.stringify(err)}`); 962 } else { 963 console.log(`unHoldCall success.`); 964 } 965}); 966``` 967 968 969## call.unHoldCall<sup>7+</sup> 970 971unHoldCall\(callId: number\): Promise\<void\> 972 973取消保持通话。使用Promise异步回调。 974 975**系统接口：** 此接口为系统接口。 976 977**需要权限**：ohos.permission.ANSWER_CALL 978 979**系统能力**：SystemCapability.Telephony.CallManager 980 981**参数：** 982 983| 参数名 | 类型 | 必填 | 说明 | 984| ------ | ------ | ---- | -------- | 985| callId | number | 是 | 呼叫Id。 | 986 987**返回值：** 988 989| 类型 | 说明 | 990| ------------------- | --------------------------- | 991| Promise<void> | 以Promise形式异步返回结果。 | 992 993**错误码：** 994 995以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 996 997| 错误码ID | 错误信息 | 998| -------- | -------------------------------------------- | 999| 201 | Permission denied. | 1000| 202 | Non-system applications use system APIs. | 1001| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1002| 8300001 | Invalid parameter value. | 1003| 8300002 | Operation failed. Cannot connect to service. | 1004| 8300003 | System internal error. | 1005| 8300999 | Unknown error code. | 1006 1007**示例：** 1008 1009```ts 1010import { BusinessError } from '@kit.BasicServicesKit'; 1011 1012call.unHoldCall(1).then(() => { 1013 console.log(`unHoldCall success.`); 1014}).catch((err: BusinessError) => { 1015 console.error(`unHoldCall fail, promise: err->${JSON.stringify(err)}`); 1016}); 1017``` 1018 1019## call.switchCall<sup>7+</sup> 1020 1021switchCall\(callId: number, callback: AsyncCallback\<void\>\): void 1022 1023切换呼叫。使用callback异步回调。 1024 1025**系统接口：** 此接口为系统接口。 1026 1027**需要权限**：ohos.permission.ANSWER_CALL 1028 1029**系统能力**：SystemCapability.Telephony.CallManager 1030 1031**参数：** 1032 1033| 参数名 | 类型 | 必填 | 说明 | 1034| -------- | ------------------------- | ---- | ---------- | 1035| callId | number | 是 | 呼叫Id。 | 1036| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回交换电话的结果。 | 1037 1038**错误码：** 1039 1040以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1041 1042| 错误码ID | 错误信息 | 1043| -------- | -------------------------------------------- | 1044| 201 | Permission denied. | 1045| 202 | Non-system applications use system APIs. | 1046| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1047| 8300001 | Invalid parameter value. | 1048| 8300002 | Operation failed. Cannot connect to service. | 1049| 8300003 | System internal error. | 1050| 8300999 | Unknown error code. | 1051 1052**示例：** 1053 1054```ts 1055import { BusinessError } from '@kit.BasicServicesKit'; 1056 1057call.switchCall(1, (err: BusinessError) => { 1058 if (err) { 1059 console.error(`switchCall fail, err->${JSON.stringify(err)}`); 1060 } else { 1061 console.log(`switchCall success.`); 1062 } 1063}); 1064``` 1065 1066 1067## call.switchCall<sup>7+</sup> 1068 1069switchCall\(callId: number\): Promise\<void\> 1070 1071切换呼叫。使用Promise异步回调。 1072 1073**系统接口：** 此接口为系统接口。 1074 1075**需要权限**：ohos.permission.ANSWER_CALL 1076 1077**系统能力**：SystemCapability.Telephony.CallManager 1078 1079**参数：** 1080 1081| 参数名 | 类型 | 必填 | 说明 | 1082| ------ | ------ | ---- | -------- | 1083| callId | number | 是 | 呼叫Id。 | 1084 1085**返回值：** 1086 1087| 类型 | 说明 | 1088| ------------------- | --------------------------- | 1089| Promise<void> | 以Promise形式异步返回结果。 | 1090 1091**错误码：** 1092 1093以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1094 1095| 错误码ID | 错误信息 | 1096| -------- | -------------------------------------------- | 1097| 201 | Permission denied. | 1098| 202 | Non-system applications use system APIs. | 1099| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1100| 8300001 | Invalid parameter value. | 1101| 8300002 | Operation failed. Cannot connect to service. | 1102| 8300003 | System internal error. | 1103| 8300999 | Unknown error code. | 1104 1105**示例：** 1106 1107```ts 1108import { BusinessError } from '@kit.BasicServicesKit'; 1109 1110call.switchCall(1).then(() => { 1111 console.log(`switchCall success.`); 1112}).catch((err: BusinessError) => { 1113 console.error(`switchCall fail, promise: err->${JSON.stringify(err)}`); 1114}); 1115``` 1116 1117## call.combineConference<sup>11+</sup> 1118 1119combineConference\(callId: number, callback: AsyncCallback\<void\>\): void 1120 1121合并通话，将两通电话合并成会议电话。使用callback异步回调。 1122 1123**系统接口：** 此接口为系统接口。 1124 1125**系统能力**：SystemCapability.Telephony.CallManager 1126 1127**参数：** 1128 1129| 参数名 | 类型 | 必填 | 说明 | 1130| -------- | ------------------------- | ---- | ---------- | 1131| callId | number | 是 | 呼叫Id。 | 1132| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回合并会议的结果。 | 1133 1134**错误码：** 1135 1136以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1137 1138| 错误码ID | 错误信息 | 1139| -------- | -------------------------------------------- | 1140| 202 | Non-system applications use system APIs. | 1141| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1142| 801 | Capability not supported. | 1143| 8300001 | Invalid parameter value. | 1144| 8300002 | Operation failed. Cannot connect to service. | 1145| 8300003 | System internal error. | 1146| 8300007 | The number of conference calls exceeds the limit. | 1147 1148**示例：** 1149 1150```ts 1151import { BusinessError } from '@kit.BasicServicesKit'; 1152 1153call.combineConference(1, (err: BusinessError) => { 1154 if (err) { 1155 console.error(`combineConference fail, err->${JSON.stringify(err)}`); 1156 } else { 1157 console.log(`combineConference success.`); 1158 } 1159}); 1160``` 1161 1162 1163## call.combineConference<sup>11+</sup> 1164 1165combineConference\(callId: number\): Promise\<void\> 1166 1167合并通话，将两通电话合并成会议电话。使用Promise异步回调。 1168 1169**系统接口：** 此接口为系统接口。 1170 1171**系统能力**：SystemCapability.Telephony.CallManager 1172 1173**参数：** 1174 1175| 参数名 | 类型 | 必填 | 说明 | 1176| ------ | ------ | ---- | -------- | 1177| callId | number | 是 | 呼叫Id。 | 1178 1179**返回值：** 1180 1181| 类型 | 说明 | 1182| ------------------- | --------------------------- | 1183| Promise<void> | 以Promise形式异步返回结果。 | 1184 1185**错误码：** 1186 1187以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1188 1189| 错误码ID | 错误信息 | 1190| -------- | -------------------------------------------- | 1191| 202 | Non-system applications use system APIs. | 1192| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1193| 801 | Capability not supported. | 1194| 8300001 | Invalid parameter value. | 1195| 8300002 | Operation failed. Cannot connect to service. | 1196| 8300003 | System internal error. | 1197| 8300007 | The number of conference calls exceeds the limit. | 1198 1199**示例：** 1200 1201```ts 1202import { BusinessError } from '@kit.BasicServicesKit'; 1203 1204call.combineConference(1).then(() => { 1205 console.log(`combineConference success.`); 1206}).catch((err: BusinessError) => { 1207 console.error(`combineConference fail, promise: err->${JSON.stringify(err)}`); 1208}); 1209``` 1210 1211## call.kickOutFromConference<sup>10+</sup> 1212 1213kickOutFromConference\(callId: number, callback: AsyncCallback\<void\>\): void 1214 1215移出电话会议，将指定通话从会议电话中挂断。使用callback异步回调。 1216 1217**系统接口：** 此接口为系统接口。 1218 1219**需要权限**：ohos.permission.PLACE_CALL 1220 1221**系统能力**：SystemCapability.Telephony.CallManager 1222 1223**参数：** 1224 1225| 参数名 | 类型 | 必填 | 说明 | 1226| -------- | ------------------------- | ---- | ---------- | 1227| callId | number | 是 | 呼叫Id。 | 1228| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回移出会议的结果。 | 1229 1230**错误码：** 1231 1232以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1233 1234| 错误码ID | 错误信息 | 1235| -------- | -------------------------------------------- | 1236| 201 | Permission denied. | 1237| 202 | Non-system applications use system APIs. | 1238| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1239| 8300001 | Invalid parameter value. | 1240| 8300002 | Operation failed. Cannot connect to service. | 1241| 8300003 | System internal error. | 1242| 8300999 | Unknown error code. | 1243 1244**示例：** 1245 1246```ts 1247import { BusinessError } from '@kit.BasicServicesKit'; 1248 1249call.kickOutFromConference(1, (err: BusinessError) => { 1250 if (err) { 1251 console.error(`kickOutFromConference fail, err->${JSON.stringify(err)}`); 1252 } else { 1253 console.log(`kickOutFromConference success.`); 1254 } 1255}); 1256``` 1257 1258## call.kickOutFromConference<sup>10+</sup> 1259 1260kickOutFromConference\(callId: number\): Promise\<void\> 1261 1262移出电话会议，将指定通话从会议电话中挂断。使用Promise异步回调。 1263 1264**系统接口：** 此接口为系统接口。 1265 1266**需要权限**：ohos.permission.PLACE_CALL 1267 1268**系统能力**：SystemCapability.Telephony.CallManager 1269 1270**参数：** 1271 1272| 参数名 | 类型 | 必填 | 说明 | 1273| ------ | ------ | ---- | -------- | 1274| callId | number | 是 | 呼叫Id。 | 1275 1276**返回值：** 1277 1278| 类型 | 说明 | 1279| ------------------- | --------------------------- | 1280| Promise<void> | 以Promise形式异步返回结果。 | 1281 1282**错误码：** 1283 1284以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1285 1286| 错误码ID | 错误信息 | 1287| -------- | -------------------------------------------- | 1288| 201 | Permission denied. | 1289| 202 | Non-system applications use system APIs. | 1290| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1291| 8300001 | Invalid parameter value. | 1292| 8300002 | Operation failed. Cannot connect to service. | 1293| 8300003 | System internal error. | 1294| 8300999 | Unknown error code. | 1295 1296**示例：** 1297 1298```ts 1299import { BusinessError } from '@kit.BasicServicesKit'; 1300 1301call.kickOutFromConference(1).then(() => { 1302 console.log(`kickOutFromConference success.`); 1303}).catch((err: BusinessError) => { 1304 console.error(`kickOutFromConference fail, promise: err->${JSON.stringify(err)}`); 1305}); 1306``` 1307 1308## call.getMainCallId<sup>7+</sup> 1309 1310getMainCallId\(callId: number, callback: AsyncCallback\<number\>\): void 1311 1312获取主呼叫Id。使用callback异步回调。 1313 1314**系统接口：** 此接口为系统接口。 1315 1316**系统能力**：SystemCapability.Telephony.CallManager 1317 1318**参数：** 1319 1320| 参数名 | 类型 | 必填 | 说明 | 1321| -------- | --------------------------- | ---- | ------------------------ | 1322| callId | number | 是 | 呼叫Id。 | 1323| callback | AsyncCallback<number> | 是 | 回调函数。返回主呼叫Id。 | 1324 1325**错误码：** 1326 1327以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1328 1329| 错误码ID | 错误信息 | 1330| -------- | -------------------------------------------- | 1331| 202 | Non-system applications use system APIs. | 1332| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1333| 801 | Capability not supported. | 1334| 8300001 | Invalid parameter value. | 1335| 8300002 | Operation failed. Cannot connect to service. | 1336| 8300003 | System internal error. | 1337 1338 1339**示例：** 1340 1341```ts 1342import { BusinessError } from '@kit.BasicServicesKit'; 1343 1344call.getMainCallId(1, (err: BusinessError, data: number) => { 1345 if (err) { 1346 console.error(`getMainCallId fail, err->${JSON.stringify(err)}`); 1347 } else { 1348 console.log(`getMainCallId success, data->${JSON.stringify(data)}`); 1349 } 1350}); 1351``` 1352 1353 1354## call.getMainCallId<sup>7+</sup> 1355 1356getMainCallId\(callId: number\): Promise\<number\> 1357 1358获取主呼叫Id。使用Promise异步回调。 1359 1360**系统接口：** 此接口为系统接口。 1361 1362**系统能力**：SystemCapability.Telephony.CallManager 1363 1364**参数：** 1365 1366| 参数名 | 类型 | 必填 | 说明 | 1367| ------ | ------ | ---- | -------- | 1368| callId | number | 是 | 呼叫Id。 | 1369 1370**返回值：** 1371 1372| 类型 | 说明 | 1373| ------------------- | ------------------------------- | 1374| Promise<number> | 以Promise形式异步返回主呼叫Id。 | 1375 1376**错误码：** 1377 1378以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1379 1380| 错误码ID | 错误信息 | 1381| -------- | -------------------------------------------- | 1382| 202 | Non-system applications use system APIs. | 1383| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1384| 801 | Capability not supported. | 1385| 8300001 | Invalid parameter value. | 1386| 8300002 | Operation failed. Cannot connect to service. | 1387| 8300003 | System internal error. | 1388 1389 1390**示例：** 1391 1392```ts 1393import { BusinessError } from '@kit.BasicServicesKit'; 1394 1395call.getMainCallId(1).then((data: number) => { 1396 console.log(`getMainCallId success, promise: data->${JSON.stringify(data)}`); 1397}).catch((err: BusinessError) => { 1398 console.error(`getMainCallId fail, promise: err->${JSON.stringify(err)}`); 1399}); 1400``` 1401 1402## call.getSubCallIdList<sup>7+</sup> 1403 1404getSubCallIdList\(callId: number, callback: AsyncCallback\<Array\<string\>\>\): void 1405 1406获取子呼叫Id列表。使用callback异步回调。 1407 1408**系统接口：** 此接口为系统接口。 1409 1410**系统能力**：SystemCapability.Telephony.CallManager 1411 1412**参数：** 1413 1414| 参数名 | 类型 | 必填 | 说明 | 1415| -------- | ------------------------------ | ---- | ---------------------------- | 1416| callId | number | 是 | 呼叫Id。 | 1417| callback | AsyncCallback<Array<string\>\> | 是 | 回调函数。返回子呼叫Id列表。 | 1418 1419**错误码：** 1420 1421以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1422 1423| 错误码ID | 错误信息 | 1424| -------- | -------------------------------------------- | 1425| 202 | Non-system applications use system APIs. | 1426| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1427| 801 | Capability not supported. | 1428| 8300001 | Invalid parameter value. | 1429| 8300002 | Operation failed. Cannot connect to service. | 1430| 8300003 | System internal error. | 1431 1432**示例：** 1433 1434```ts 1435import { BusinessError } from '@kit.BasicServicesKit'; 1436 1437call.getSubCallIdList(1, (err: BusinessError, data: Array<string>) => { 1438 if (err) { 1439 console.error(`getSubCallIdList fail, err->${JSON.stringify(err)}`); 1440 } else { 1441 console.log(`getSubCallIdList success, data->${JSON.stringify(data)}`); 1442 } 1443}); 1444``` 1445 1446 1447## call.getSubCallIdList<sup>7+</sup> 1448 1449getSubCallIdList\(callId: number\): Promise\<Array\<string\>\> 1450 1451获取子呼叫Id列表。使用Promise异步回调。 1452 1453**系统接口：** 此接口为系统接口。 1454 1455**系统能力**：SystemCapability.Telephony.CallManager 1456 1457**参数：** 1458 1459| 参数名 | 类型 | 必填 | 说明 | 1460| ------ | ------ | ---- | -------- | 1461| callId | number | 是 | 呼叫Id。 | 1462 1463**返回值：** 1464 1465| 类型 | 说明 | 1466| ----------------------------- | ----------------------------------- | 1467| Promise<Array<string\>> | 以Promise形式异步返回子呼叫Id列表。 | 1468 1469**错误码：** 1470 1471以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1472 1473| 错误码ID | 错误信息 | 1474| -------- | -------------------------------------------- | 1475| 202 | Non-system applications use system APIs. | 1476| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1477| 801 | Capability not supported. | 1478| 8300001 | Invalid parameter value. | 1479| 8300002 | Operation failed. Cannot connect to service. | 1480| 8300003 | System internal error. | 1481 1482**示例：** 1483 1484```ts 1485import { BusinessError } from '@kit.BasicServicesKit'; 1486 1487call.getSubCallIdList(1).then((data: Array<string>) => { 1488 console.log(`getSubCallIdList success, promise: data->${JSON.stringify(data)}`); 1489}).catch((err: BusinessError) => { 1490 console.error(`getSubCallIdList fail, promise: err->${JSON.stringify(err)}`); 1491}); 1492``` 1493 1494## call.getCallIdListForConference<sup>7+</sup> 1495 1496getCallIdListForConference\(callId: number, callback: AsyncCallback\<Array\<string\>\>\): void 1497 1498获取会议的呼叫Id列表。使用callback异步回调。 1499 1500**系统接口：** 此接口为系统接口。 1501 1502**系统能力**：SystemCapability.Telephony.CallManager 1503 1504**参数：** 1505 1506| 参数名 | 类型 | 必填 | 说明 | 1507| -------- | ----------------------------------- | ---- | -------------------------------- | 1508| callId | number | 是 | 呼叫Id。 | 1509| callback | AsyncCallback<Array<string\>> | 是 | 回调函数。返回会议的呼叫Id列表。 | 1510 1511**错误码：** 1512 1513以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1514 1515| 错误码ID | 错误信息 | 1516| -------- | -------------------------------------------- | 1517| 202 | Non-system applications use system APIs. | 1518| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1519| 801 | Capability not supported. | 1520| 8300001 | Invalid parameter value. | 1521| 8300002 | Operation failed. Cannot connect to service. | 1522| 8300003 | System internal error. | 1523 1524**示例：** 1525 1526```ts 1527import { BusinessError } from '@kit.BasicServicesKit'; 1528 1529call.getCallIdListForConference(1, (err: BusinessError, data: Array<string>) => { 1530 if (err) { 1531 console.error(`getCallIdListForConference fail, err->${JSON.stringify(err)}`); 1532 } else { 1533 console.log(`getCallIdListForConference success, data->${JSON.stringify(data)}`); 1534 } 1535}); 1536``` 1537 1538 1539## call.getCallIdListForConference<sup>7+</sup> 1540 1541getCallIdListForConference\(callId: number\): Promise\<Array\<string\>\> 1542 1543获取会议的呼叫Id列表。使用Promise异步回调。 1544 1545**系统接口：** 此接口为系统接口。 1546 1547**系统能力**：SystemCapability.Telephony.CallManager 1548 1549**参数：** 1550 1551| 参数名 | 类型 | 必填 | 说明 | 1552| ------ | ------ | ---- | -------- | 1553| callId | number | 是 | 呼叫Id。 | 1554 1555**返回值：** 1556 1557| 类型 | 说明 | 1558| ----------------------------- | --------------------------------------- | 1559| Promise<Array<string\>> | 以Promise形式异步返回会议的呼叫Id列表。 | 1560 1561**错误码：** 1562 1563以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1564 1565| 错误码ID | 错误信息 | 1566| -------- | -------------------------------------------- | 1567| 202 | Non-system applications use system APIs. | 1568| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1569| 801 | Capability not supported. | 1570| 8300001 | Invalid parameter value. | 1571| 8300002 | Operation failed. Cannot connect to service. | 1572| 8300003 | System internal error. | 1573 1574**示例：** 1575 1576```ts 1577import { BusinessError } from '@kit.BasicServicesKit'; 1578 1579call.getCallIdListForConference(1).then((data: Array<string>) => { 1580 console.log(`getCallIdListForConference success, promise: data->${JSON.stringify(data)}`); 1581}).catch((err: BusinessError) => { 1582 console.error(`getCallIdListForConference fail, promise: err->${JSON.stringify(err)}`); 1583}); 1584``` 1585 1586## call.getCallWaitingStatus<sup>7+</sup> 1587 1588getCallWaitingStatus\(slotId: number, callback: AsyncCallback\<CallWaitingStatus\>\): void 1589 1590获取呼叫等待状态。使用callback异步回调。 1591 1592**系统接口：** 此接口为系统接口。 1593 1594**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1595 1596**系统能力**：SystemCapability.Telephony.CallManager 1597 1598**参数：** 1599 1600| 参数名 | 类型 | 必填 | 说明 | 1601| -------- | ----------------------------------------------------------- | ---- | ------------------------------------------------------------ | 1602| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1603| callback | AsyncCallback<[CallWaitingStatus](#callwaitingstatus7)\> | 是 | 回调函数。<br/>返回呼叫等待状态。<br/>- 0：禁用呼叫等待 <br/>- 1：启用呼叫等待 | 1604 1605**错误码：** 1606 1607以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1608 1609| 错误码ID | 错误信息 | 1610| -------- | -------------------------------------------- | 1611| 201 | Permission denied. | 1612| 202 | Non-system applications use system APIs. | 1613| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1614| 801 | Capability not supported. | 1615| 8300001 | Invalid parameter value. | 1616| 8300002 | Operation failed. Cannot connect to service. | 1617| 8300003 | System internal error. | 1618 1619**示例：** 1620 1621```ts 1622import { BusinessError } from '@kit.BasicServicesKit'; 1623 1624call.getCallWaitingStatus(0, (err: BusinessError, data: call.CallWaitingStatus) => { 1625 if (err) { 1626 console.error(`getCallWaitingStatus fail, err->${JSON.stringify(err)}`); 1627 } else { 1628 console.log(`getCallWaitingStatus success, data->${JSON.stringify(data)}`); 1629 } 1630}); 1631``` 1632 1633 1634## call.getCallWaitingStatus<sup>7+</sup> 1635 1636getCallWaitingStatus\(slotId: number\): Promise\<CallWaitingStatus\> 1637 1638获取呼叫等待状态。使用Promise异步回调。 1639 1640**系统接口：** 此接口为系统接口。 1641 1642**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1643 1644**系统能力**：SystemCapability.Telephony.CallManager 1645 1646**参数：** 1647 1648| 参数名 | 类型 | 必填 | 说明 | 1649| ------ | ------ | ---- | -------------------------------------- | 1650| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1651 1652**返回值：** 1653 1654| 类型 | 说明 | 1655| ------------------------------------------------------- | ------------------------------------------------------------ | 1656| Promise<[CallWaitingStatus](#callwaitingstatus7)> | 以Promise形式异步返回呼叫等待状态。<br/>- 0：禁用呼叫等待 <br/>- 1：启用呼叫等待 | 1657 1658**错误码：** 1659 1660以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1661 1662| 错误码ID | 错误信息 | 1663| -------- | -------------------------------------------- | 1664| 201 | Permission denied. | 1665| 202 | Non-system applications use system APIs. | 1666| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1667| 801 | Capability not supported. | 1668| 8300001 | Invalid parameter value. | 1669| 8300002 | Operation failed. Cannot connect to service. | 1670| 8300003 | System internal error. | 1671 1672**示例：** 1673 1674```ts 1675import { BusinessError } from '@kit.BasicServicesKit'; 1676 1677call.getCallWaitingStatus(0).then((data: call.CallWaitingStatus) => { 1678 console.log(`getCallWaitingStatus success, promise: data->${JSON.stringify(data)}`); 1679}).catch((err: BusinessError) => { 1680 console.error(`getCallWaitingStatus fail, promise: err->${JSON.stringify(err)}`); 1681}); 1682``` 1683 1684## call.setCallWaiting<sup>7+</sup> 1685 1686setCallWaiting\(slotId: number, activate: boolean, callback: AsyncCallback\<void\>\): void 1687 1688设置呼叫等待。使用callback异步回调。 1689 1690**系统接口：** 此接口为系统接口。 1691 1692**需要权限**：ohos.permission.SET_TELEPHONY_STATE 1693 1694**系统能力**：SystemCapability.Telephony.CallManager 1695 1696**参数：** 1697 1698| 参数名 | 类型 | 必填 | 说明 | 1699| -------- | -------------------- | ---- | ------------------------------------------------------------ | 1700| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1701| activate | boolean | 是 | 呼叫等待是否处于启用状态。<br/>- false：禁用呼叫等待<br/>- true：启用呼叫等待 | 1702| callback | AsyncCallback<void\> | 是 | 以回调函数的方式返回设置呼叫等待的结果。 | 1703 1704**错误码：** 1705 1706以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1707 1708| 错误码ID | 错误信息 | 1709| -------- | -------------------------------------------- | 1710| 201 | Permission denied. | 1711| 202 | Non-system applications use system APIs. | 1712| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1713| 801 | Capability not supported. | 1714| 8300001 | Invalid parameter value. | 1715| 8300002 | Operation failed. Cannot connect to service. | 1716| 8300003 | System internal error. | 1717 1718**示例：** 1719 1720```ts 1721import { BusinessError } from '@kit.BasicServicesKit'; 1722 1723call.setCallWaiting(0, true, (err: BusinessError) => { 1724 if (err) { 1725 console.error(`setCallWaiting fail, err->${JSON.stringify(err)}`); 1726 } else { 1727 console.log(`setCallWaiting success.`); 1728 } 1729}); 1730``` 1731 1732 1733## call.setCallWaiting<sup>7+</sup> 1734 1735setCallWaiting\(slotId: number, activate: boolean\): Promise\<void\> 1736 1737设置呼叫等待。使用Promise异步回调。 1738 1739**系统接口：** 此接口为系统接口。 1740 1741**需要权限**：ohos.permission.SET_TELEPHONY_STATE 1742 1743**系统能力**：SystemCapability.Telephony.CallManager 1744 1745**参数：** 1746 1747| 参数名 | 类型 | 必填 | 说明 | 1748| -------- | ------- | ---- | ------------------------------------------------------------ | 1749| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1750| activate | boolean | 是 | 呼叫等待是否处于启用状态。<br/>- false：禁用呼叫等待<br/>- true：启用呼叫等待 | 1751 1752**返回值：** 1753 1754| 类型 | 说明 | 1755| ------------------- | --------------------------- | 1756| Promise<void> | 以Promise形式异步返回结果。 | 1757 1758**错误码：** 1759 1760以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1761 1762| 错误码ID | 错误信息 | 1763| -------- | -------------------------------------------- | 1764| 201 | Permission denied. | 1765| 202 | Non-system applications use system APIs. | 1766| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1767| 801 | Capability not supported. | 1768| 8300001 | Invalid parameter value. | 1769| 8300002 | Operation failed. Cannot connect to service. | 1770| 8300003 | System internal error. | 1771 1772**示例：** 1773 1774```ts 1775import { BusinessError } from '@kit.BasicServicesKit'; 1776 1777call.setCallWaiting(0, true).then(() => { 1778 console.log(`setCallWaiting success.`); 1779}).catch((err: BusinessError) => { 1780 console.error(`setCallWaiting fail, promise: err->${JSON.stringify(err)}`); 1781}); 1782``` 1783 1784## call.startDTMF<sup>7+</sup> 1785 1786startDTMF\(callId: number, character: string, callback: AsyncCallback\<void\>\): void 1787 1788启动双音多频。使用callback异步回调。 1789 1790**系统接口：** 此接口为系统接口。 1791 1792**系统能力**：SystemCapability.Telephony.CallManager 1793 1794**参数：** 1795 1796| 参数名 | 类型 | 必填 | 说明 | 1797| --------- | -------------------- | ---- | ---------- | 1798| callId | number | 是 | 呼叫Id。 | 1799| character | string | 是 | DTMF码。 | 1800| callback | AsyncCallback<void\> | 是 | 以回调函数的方式返回启动双音多频的结果。 | 1801 1802**错误码：** 1803 1804以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1805 1806| 错误码ID | 错误信息 | 1807| -------- | -------------------------------------------- | 1808| 202 | Non-system applications use system APIs. | 1809| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1810| 801 | Capability not supported. | 1811| 8300001 | Invalid parameter value. | 1812| 8300002 | Operation failed. Cannot connect to service. | 1813| 8300003 | System internal error. | 1814 1815**示例：** 1816 1817```ts 1818import { BusinessError } from '@kit.BasicServicesKit'; 1819 1820call.startDTMF(1, "0", (err: BusinessError) => { 1821 if (err) { 1822 console.error(`startDTMF fail, err->${JSON.stringify(err)}`); 1823 } else { 1824 console.log(`startDTMF success.`); 1825 } 1826}); 1827``` 1828 1829 1830## call.startDTMF<sup>7+</sup> 1831 1832startDTMF\(callId: number, character: string\): Promise\<void\> 1833 1834启动双音多频。使用Promise异步回调。 1835 1836**系统接口：** 此接口为系统接口。 1837 1838**系统能力**：SystemCapability.Telephony.CallManager 1839 1840**参数：** 1841 1842| 参数名 | 类型 | 必填 | 说明 | 1843| --------- | ------ | ---- | -------- | 1844| callId | number | 是 | 呼叫Id。 | 1845| character | string | 是 | DTMF码。 | 1846 1847**返回值：** 1848 1849| 类型 | 说明 | 1850| ------------------- | ----------------------- | 1851| Promise<void> | 以Promise形式异步返回。 | 1852 1853**错误码：** 1854 1855以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1856 1857| 错误码ID | 错误信息 | 1858| -------- | -------------------------------------------- | 1859| 202 | Non-system applications use system APIs. | 1860| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1861| 801 | Capability not supported. | 1862| 8300001 | Invalid parameter value. | 1863| 8300002 | Operation failed. Cannot connect to service. | 1864| 8300003 | System internal error. | 1865 1866**示例：** 1867 1868```ts 1869import { BusinessError } from '@kit.BasicServicesKit'; 1870 1871call.startDTMF(1, "0").then(() => { 1872 console.log(`startDTMF success.`); 1873}).catch((err: BusinessError) => { 1874 console.error(`startDTMF fail, promise: err->${JSON.stringify(err)}`); 1875}); 1876``` 1877 1878## call.stopDTMF<sup>7+</sup> 1879 1880stopDTMF\(callId: number, callback: AsyncCallback\<void\>\): void 1881 1882停止双音多频。使用callback异步回调。 1883 1884**系统接口：** 此接口为系统接口。 1885 1886**系统能力**：SystemCapability.Telephony.CallManager 1887 1888**参数：** 1889 1890| 参数名 | 类型 | 必填 | 说明 | 1891| -------- | ------------------------- | ---- | ---------- | 1892| callId | number | 是 | 呼叫Id。 | 1893| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回停止双音多频的结果。 | 1894 1895**错误码：** 1896 1897以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1898 1899| 错误码ID | 错误信息 | 1900| -------- | -------------------------------------------- | 1901| 202 | Non-system applications use system APIs. | 1902| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1903| 801 | Capability not supported. | 1904| 8300001 | Invalid parameter value. | 1905| 8300002 | Operation failed. Cannot connect to service. | 1906| 8300003 | System internal error. | 1907 1908**示例：** 1909 1910```ts 1911import { BusinessError } from '@kit.BasicServicesKit'; 1912 1913call.stopDTMF(1, (err: BusinessError) => { 1914 if (err) { 1915 console.error(`stopDTMF fail, err->${JSON.stringify(err)}`); 1916 } else { 1917 console.log(`stopDTMF success.`); 1918 } 1919}); 1920``` 1921 1922 1923## call.stopDTMF<sup>7+</sup> 1924 1925stopDTMF\(callId: number\): Promise\<void\> 1926 1927停止双音多频。使用Promise异步回调。 1928 1929**系统接口：** 此接口为系统接口。 1930 1931**系统能力**：SystemCapability.Telephony.CallManager 1932 1933**参数：** 1934 1935| 参数名 | 类型 | 必填 | 说明 | 1936| ------ | ------ | ---- | -------- | 1937| callId | number | 是 | 呼叫Id。 | 1938 1939**返回值：** 1940 1941| 类型 | 说明 | 1942| ------------------- | --------------------------- | 1943| Promise<void> | 以Promise形式异步返回结果。 | 1944 1945**错误码：** 1946 1947以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1948 1949| 错误码ID | 错误信息 | 1950| -------- | -------------------------------------------- | 1951| 202 | Non-system applications use system APIs. | 1952| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 1953| 801 | Capability not supported. | 1954| 8300001 | Invalid parameter value. | 1955| 8300002 | Operation failed. Cannot connect to service. | 1956| 8300003 | System internal error. | 1957 1958**示例：** 1959 1960```ts 1961import { BusinessError } from '@kit.BasicServicesKit'; 1962 1963call.stopDTMF(1).then(() => { 1964 console.log(`stopDTMF success.`); 1965}).catch((err: BusinessError) => { 1966 console.error(`stopDTMF fail, promise: err->${JSON.stringify(err)}`); 1967}); 1968``` 1969 1970## call.postDialProceed<sup>11+</sup> 1971 1972postDialProceed\(callId: number, proceed: boolean, callback: AsyncCallback\<void\>\): void 1973 1974继续进行通话。使用callback异步回调。 1975 1976当用户呼叫号码为：“普通电话号码”+“;”+"DTMF字符"，例如“400xxxxxxx;123”，并且已经订阅了通话后延迟事件， 1977电话接通后，系统将上报通话后延迟事件，应用可以调用此接口选择是否发送DTMF音。 1978 1979**系统接口：** 此接口为系统接口。 1980 1981**需要权限**：ohos.permission.SET_TELEPHONY_STATE 1982 1983**系统能力**：SystemCapability.Telephony.CallManager 1984 1985**参数：** 1986 1987| 参数名 | 类型 | 必填 | 说明 | 1988| -------- | ------------------------- | ---- | -------------------------------------------------------------- | 1989| callId | number | 是 | 呼叫Id。 | 1990| proceed | boolean | 是 | 用户选择是否发送DTMF（Dual Tone Multi Frequency，双音多频）音。| 1991| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回继续进行通话的结果。 | 1992 1993**错误码：** 1994 1995以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 1996 1997| 错误码ID | 错误信息 | 1998| -------- | -------------------------------------------- | 1999| 201 | Permission denied. | 2000| 202 | Non-system applications use system APIs. | 2001| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2002| 801 | Capability not supported. | 2003| 8300001 | Invalid parameter value. | 2004| 8300002 | Operation failed. Cannot connect to service. | 2005| 8300003 | System internal error. | 2006 2007**示例：** 2008 2009```ts 2010import { BusinessError } from '@kit.BasicServicesKit'; 2011 2012call.postDialProceed(1, true, (err: BusinessError) => { 2013 console.log(`callback: err->${JSON.stringify(err)}`); 2014}); 2015``` 2016 2017 2018## call.postDialProceed<sup>11+</sup> 2019 2020postDialProceed\(callId: number, proceed: boolean\): Promise\<void\> 2021 2022继续进行通话。使用Promise异步回调。 2023 2024当用户呼叫号码为：“普通电话号码”+“;”+"DTMF字符"，例如“400xxxxxxx;123”，并且已经订阅了通话后延迟事件， 2025电话接通后，系统将上报通话后延迟事件，应用可以调用此接口选择是否发送DTMF音。 2026 2027**系统接口：** 此接口为系统接口。 2028 2029**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2030 2031**系统能力**：SystemCapability.Telephony.CallManager 2032 2033**参数：** 2034 2035| 参数名 | 类型 | 必填 | 说明 | 2036| -------- | ------------------------- | ---- | ----------------------- | 2037| callId | number | 是 | 呼叫Id。 | 2038| proceed | boolean | 是 | 用户选择是否发送DTMF音。| 2039 2040**返回值：** 2041 2042| 类型 | 说明 | 2043| ------------------- | --------------------------- | 2044| Promise<void> | 以Promise形式异步返回结果。 | 2045 2046**错误码：** 2047 2048以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2049 2050| 错误码ID | 错误信息 | 2051| -------- | -------------------------------------------- | 2052| 201 | Permission denied. | 2053| 202 | Non-system applications use system APIs. | 2054| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2055| 801 | Capability not supported. | 2056| 8300001 | Invalid parameter value. | 2057| 8300002 | Operation failed. Cannot connect to service. | 2058| 8300003 | System internal error. | 2059 2060**示例：** 2061 2062```ts 2063import { BusinessError } from '@kit.BasicServicesKit'; 2064 2065call.postDialProceed(1, true).then(() => { 2066 console.log(`postDialProceed success.`); 2067}).catch((err: BusinessError) => { 2068 console.error(`postDialProceed fail, promise: err->${JSON.stringify(err)}`); 2069}); 2070``` 2071 2072## call.isInEmergencyCall<sup>7+</sup> 2073 2074isInEmergencyCall\(callback: AsyncCallback\<boolean\>\): void 2075 2076判断是否正在处于紧急呼叫。使用callback异步回调。 2077 2078**系统接口：** 此接口为系统接口。 2079 2080**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2081 2082**系统能力**：SystemCapability.Telephony.CallManager 2083 2084**参数：** 2085 2086| 参数名 | 类型 | 必填 | 说明 | 2087| -------- | ---------------------------- | ---- | ---------- | 2088| callback | AsyncCallback<boolean> | 是 | 以回调函数的方式返回结果，true表示紧急号码，false表示非紧急号码。 | 2089 2090**错误码：** 2091 2092以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2093 2094| 错误码ID | 错误信息 | 2095| -------- | -------------------------------------------- | 2096| 201 | Permission denied. | 2097| 202 | Non-system applications use system APIs. | 2098| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2099| 8300001 | Invalid parameter value. | 2100| 8300002 | Operation failed. Cannot connect to service. | 2101| 8300003 | System internal error. | 2102| 8300999 | Unknown error code. | 2103 2104**示例：** 2105 2106```ts 2107import { BusinessError } from '@kit.BasicServicesKit'; 2108 2109call.isInEmergencyCall((err: BusinessError, data: boolean) => { 2110 if (err) { 2111 console.error(`isInEmergencyCall fail, err->${JSON.stringify(err)}`); 2112 } else { 2113 console.log(`isInEmergencyCall success, data->${JSON.stringify(data)}`); 2114 } 2115}); 2116``` 2117 2118 2119## call.isInEmergencyCall<sup>7+</sup> 2120 2121isInEmergencyCall\(\): Promise\<boolean\> 2122 2123判断是否正在处于紧急呼叫。使用Promise异步回调。 2124 2125**系统接口：** 此接口为系统接口。 2126 2127**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2128 2129**系统能力**：SystemCapability.Telephony.CallManager 2130 2131**返回值：** 2132 2133| 类型 | 说明 | 2134| ---------------------- | --------------------------- | 2135| Promise<boolean> | 以Promise形式异步返回结果，true表示正在处于紧急呼叫，false表示不处于紧急呼叫。 | 2136 2137**错误码：** 2138 2139以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2140 2141| 错误码ID | 错误信息 | 2142| -------- | -------------------------------------------- | 2143| 201 | Permission denied. | 2144| 202 | Non-system applications use system APIs. | 2145| 8300002 | Operation failed. Cannot connect to service. | 2146| 8300003 | System internal error. | 2147| 8300999 | Unknown error code. | 2148 2149**示例：** 2150 2151```ts 2152import { BusinessError } from '@kit.BasicServicesKit'; 2153 2154call.isInEmergencyCall().then((data: boolean) => { 2155 console.log(`isInEmergencyCall success, promise: data->${JSON.stringify(data)}`); 2156}).catch((err: BusinessError) => { 2157 console.error(`isInEmergencyCall fail, promise: err->${JSON.stringify(err)}`); 2158}); 2159``` 2160 2161## call.on('callDetailsChange')<sup>7+</sup> 2162 2163on\(type: 'callDetailsChange', callback: Callback\<CallAttributeOptions\>\): void 2164 2165订阅callDetailsChange事件。使用callback异步回调。 2166 2167**系统接口：** 此接口为系统接口。 2168 2169**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2170 2171**系统能力**：SystemCapability.Telephony.CallManager 2172 2173**参数：** 2174 2175| 参数名 | 类型 | 必填 | 说明 | 2176| -------- | ------------------------------------------------------- | ---- | -------------------------- | 2177| type | string | 是 | 通话时监听通话详情的变化，参数固定为'callDetailsChange'。 | 2178| callback | Callback<[CallAttributeOptions](#callattributeoptions7)> | 是 | 以回调函数的方式返回订阅callDetailsChange事件的结果。 | 2179 2180**错误码：** 2181 2182以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2183 2184| 错误码ID | 错误信息 | 2185| -------- | -------------------------------------------- | 2186| 201 | Permission denied. | 2187| 202 | Non-system applications use system APIs. | 2188| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2189| 8300001 | Invalid parameter value. | 2190| 8300002 | Operation failed. Cannot connect to service. | 2191| 8300003 | System internal error. | 2192| 8300999 | Unknown error code. | 2193 2194**示例：** 2195 2196```ts 2197call.on('callDetailsChange', (data: call.CallAttributeOptions) => { 2198 console.log(`callback: data->${JSON.stringify(data)}`); 2199}); 2200``` 2201 2202## call.on('callEventChange')<sup>8+</sup> 2203 2204on\(type: 'callEventChange', callback: Callback\<CallEventOptions\>\): void 2205 2206订阅callEventChange事件。使用callback异步回调。 2207 2208**系统接口：** 此接口为系统接口。 2209 2210**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2211 2212**系统能力**：SystemCapability.Telephony.CallManager 2213 2214**参数：** 2215 2216| 参数名 | 类型 | 必填 | 说明 | 2217| -------- | ------------------------------------------------ | ---- | -------------------------- | 2218| type | string | 是 | 通话时监听通话事件的变化，参数固定为'callEventChange'。 | 2219| callback | Callback<[CallEventOptions](#calleventoptions8)> | 是 | 以回调函数的方式返回订阅callEventChange事件的结果。 | 2220 2221**错误码：** 2222 2223以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2224 2225| 错误码ID | 错误信息 | 2226| -------- | -------------------------------------------- | 2227| 201 | Permission denied. | 2228| 202 | Non-system applications use system APIs. | 2229| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2230| 8300001 | Invalid parameter value. | 2231| 8300002 | Operation failed. Cannot connect to service. | 2232| 8300003 | System internal error. | 2233| 8300999 | Unknown error code. | 2234 2235**示例：** 2236 2237```ts 2238call.on('callEventChange', (data: call.CallEventOptions) => { 2239 console.log(`callback: data->${JSON.stringify(data)}`); 2240}); 2241``` 2242 2243## call.on('callDisconnectedCause')<sup>8+</sup> 2244 2245on\(type: 'callDisconnectedCause', callback: Callback\<DisconnectedDetails\>\): void 2246 2247订阅callDisconnectedCause事件。使用callback异步回调。 2248 2249**系统接口：** 此接口为系统接口。 2250 2251**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2252 2253**系统能力**：SystemCapability.Telephony.CallManager 2254 2255**参数：** 2256 2257| 参数名 | 类型 | 必填 | 说明 | 2258| -------- | ------------------------------------------------------ | ---- | -------------------------- | 2259| type | string | 是 | 通话时监听断开连接的原因，参数固定为'callDisconnectedCause'。 | 2260| callback | Callback<[DisconnectedDetails](#disconnecteddetails9)> | 是 | 以回调函数的方式返回订阅callDisconnectedCause事件的结果。 | 2261 2262**错误码：** 2263 2264以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2265 2266| 错误码ID | 错误信息 | 2267| -------- | -------------------------------------------- | 2268| 201 | Permission denied. | 2269| 202 | Non-system applications use system APIs. | 2270| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2271| 8300001 | Invalid parameter value. | 2272| 8300002 | Operation failed. Cannot connect to service. | 2273| 8300003 | System internal error. | 2274| 8300999 | Unknown error code. | 2275 2276**示例：** 2277 2278```ts 2279call.on('callDisconnectedCause', (data: call.DisconnectedDetails) => { 2280 console.log(`callback: data->${JSON.stringify(data)}`); 2281}); 2282``` 2283 2284## call.on('mmiCodeResult')<sup>9+</sup> 2285 2286on\(type: 'mmiCodeResult', callback: Callback\<MmiCodeResults\>\): void 2287 2288订阅mmiCodeResult事件。使用callback异步回调。 2289 2290**系统接口：** 此接口为系统接口。 2291 2292**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2293 2294**系统能力**：SystemCapability.Telephony.CallManager 2295 2296**参数：** 2297 2298| 参数名 | 类型 | 必填 | 说明 | 2299| -------- | -------------------------------------------- | ---- | --------------------- | 2300| type | string | 是 | 通话时监听MMI码结果，参数固定为'mmiCodeResult'。 | 2301| callback | Callback<[MmiCodeResults](#mmicoderesults9)> | 是 | 以回调函数的方式返回订阅mmiCodeResult事件的结果。| 2302 2303**错误码：** 2304 2305以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2306 2307| 错误码ID | 错误信息 | 2308| -------- | -------------------------------------------- | 2309| 201 | Permission denied. | 2310| 202 | Non-system applications use system APIs. | 2311| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2312| 8300001 | Invalid parameter value. | 2313| 8300002 | Operation failed. Cannot connect to service. | 2314| 8300003 | System internal error. | 2315| 8300999 | Unknown error code. | 2316 2317**示例：** 2318 2319```ts 2320call.on('mmiCodeResult', (data: call.MmiCodeResults) => { 2321 console.log(`callback: data->${JSON.stringify(data)}`); 2322}); 2323``` 2324 2325## call.off('callDetailsChange')<sup>7+</sup> 2326 2327off\(type: 'callDetailsChange', callback?: Callback\<CallAttributeOptions\>\): void 2328 2329取消订阅callDetailsChange事件。使用callback异步回调。 2330 2331**系统接口：** 此接口为系统接口。 2332 2333**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2334 2335**系统能力**：SystemCapability.Telephony.CallManager 2336 2337**参数：** 2338 2339| 参数名 | 类型 | 必填 | 说明 | 2340| -------- | -------------------------------------------------------- | ---- | ---------------------------------- | 2341| type | string | 是 | 通话结束时取消监听通话详情的变化，参数固定为'callDetailsChange'。 | 2342| callback | Callback<[CallAttributeOptions](#callattributeoptions7)> | 否 | 回调函数。不填该参数将不会收到取消订阅的处理结果。 | 2343 2344**错误码：** 2345 2346以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2347 2348| 错误码ID | 错误信息 | 2349| -------- | -------------------------------------------- | 2350| 201 | Permission denied. | 2351| 202 | Non-system applications use system APIs. | 2352| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2353| 8300001 | Invalid parameter value. | 2354| 8300002 | Operation failed. Cannot connect to service. | 2355| 8300003 | System internal error. | 2356| 8300999 | Unknown error code. | 2357 2358**示例：** 2359 2360```ts 2361call.off('callDetailsChange', (data: call.CallAttributeOptions) => { 2362 console.log(`callback: data->${JSON.stringify(data)}`); 2363}); 2364``` 2365 2366## call.off('callEventChange')<sup>8+</sup> 2367 2368off\(type: 'callEventChange', callback?: Callback\<CallEventOptions\>\): void 2369 2370取消订阅callEventChange事件。使用callback异步回调。 2371 2372**系统接口：** 此接口为系统接口。 2373 2374**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2375 2376**系统能力**：SystemCapability.Telephony.CallManager 2377 2378**参数：** 2379 2380| 参数名 | 类型 | 必填 | 说明 | 2381| -------- | ------------------------------------------------ | ---- | ---------------------------------- | 2382| type | string | 是 | 通话结束时取消监听通话事件的变化，参数固定为'callEventChange'。 | 2383| callback | Callback<[CallEventOptions](#calleventoptions8)> | 否 | 回调函数。不填该参数将不会收到取消订阅的处理结果。 | 2384 2385**错误码：** 2386 2387以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2388 2389| 错误码ID | 错误信息 | 2390| -------- | -------------------------------------------- | 2391| 201 | Permission denied. | 2392| 202 | Non-system applications use system APIs. | 2393| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2394| 8300001 | Invalid parameter value. | 2395| 8300002 | Operation failed. Cannot connect to service. | 2396| 8300003 | System internal error. | 2397| 8300999 | Unknown error code. | 2398 2399**示例：** 2400 2401```ts 2402call.off('callEventChange', (data: call.CallEventOptions) => { 2403 console.log(`callback: data->${JSON.stringify(data)}`); 2404}); 2405``` 2406 2407## call.off('callDisconnectedCause')<sup>8+</sup> 2408 2409off\(type: 'callDisconnectedCause', callback?: Callback\<DisconnectedDetails\>\): void 2410 2411取消订阅callDisconnectedCause事件。使用callback异步回调。 2412 2413**系统接口：** 此接口为系统接口。 2414 2415**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2416 2417**系统能力**：SystemCapability.Telephony.CallManager 2418 2419**参数：** 2420 2421| 参数名 | 类型 | 必填 | 说明 | 2422| -------- | ---------------------------------------------------------- | ---- | ------------------- | 2423| type | string | 是 | 调用断开连接的原因，参数固定为'callDisconnectedCause'。 | 2424| callback | Callback<[DisconnectedDetails](#disconnecteddetails9)> | 否 | 回调函数。不填该参数将不会收到取消订阅的处理结果。 | 2425 2426**错误码：** 2427 2428以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2429 2430| 错误码ID | 错误信息 | 2431| -------- | -------------------------------------------- | 2432| 201 | Permission denied. | 2433| 202 | Non-system applications use system APIs. | 2434| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2435| 8300001 | Invalid parameter value. | 2436| 8300002 | Operation failed. Cannot connect to service. | 2437| 8300003 | System internal error. | 2438| 8300999 | Unknown error code. | 2439 2440**示例：** 2441 2442```ts 2443call.off('callDisconnectedCause', (data: call.DisconnectedDetails) => { 2444 console.log(`callback: data->${JSON.stringify(data)}`); 2445}); 2446``` 2447 2448## call.off('mmiCodeResult')<sup>9+</sup> 2449 2450off\(type: 'mmiCodeResult', callback?: Callback\<MmiCodeResults\>\): void 2451 2452取消订阅mmiCodeResult事件。使用callback异步回调。 2453 2454**系统接口：** 此接口为系统接口。 2455 2456**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2457 2458**系统能力**：SystemCapability.Telephony.CallManager 2459 2460**参数：** 2461 2462| 参数名 | 类型 | 必填 | 说明 | 2463| -------- | ------------------------------------------------ | ---- | ----------- | 2464| type | string | 是 | MMI码结果，参数固定为'mmiCodeResult'。 | 2465| callback | Callback<[MmiCodeResults](#mmicoderesults9)> | 否 | 回调函数。不填该参数将不会收到取消订阅的处理结果。 | 2466 2467**错误码：** 2468 2469以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2470 2471| 错误码ID | 错误信息 | 2472| -------- | -------------------------------------------- | 2473| 201 | Permission denied. | 2474| 202 | Non-system applications use system APIs. | 2475| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2476| 8300001 | Invalid parameter value. | 2477| 8300002 | Operation failed. Cannot connect to service. | 2478| 8300003 | System internal error. | 2479| 8300999 | Unknown error code. | 2480 2481**示例：** 2482 2483```ts 2484call.off('mmiCodeResult', (data: call.MmiCodeResults) => { 2485 console.log(`callback: data->${JSON.stringify(data)}`); 2486}); 2487``` 2488 2489 2490## call.on('audioDeviceChange')<sup>10+</sup> 2491 2492on\(type: 'audioDeviceChange', callback: Callback\<AudioDeviceCallbackInfo\>\): void 2493 2494订阅通话音频设备切换事件。使用callback异步回调。 2495 2496**系统接口：** 此接口为系统接口。 2497 2498**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2499 2500**系统能力**：SystemCapability.Telephony.CallManager 2501 2502**参数：** 2503 2504| 参数名 | 类型 | 必填 | 说明 | 2505| -------- | ----------------------------------------------- | ---- | --------------------------------------------------- | 2506| type | string | 是 | 通话音频设备发生变化，参数固定为'audioDeviceChange'。 | 2507| callback | Callback<[AudioDeviceCallbackInfo](#audiodevicecallbackinfo10)> | 是 | 以回调函数的方式返回订阅通话音频设备切换事件的结果。 | 2508 2509**错误码：** 2510 2511以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2512 2513| 错误码ID | 错误信息 | 2514| -------- | -------------------------------------------- | 2515| 201 | Permission denied. | 2516| 202 | Non-system applications use system APIs. | 2517| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2518| 8300001 | Invalid parameter value. | 2519| 8300002 | Operation failed. Cannot connect to service. | 2520| 8300003 | System internal error. | 2521| 8300999 | Unknown error code. | 2522 2523**示例：** 2524 2525```ts 2526call.on('audioDeviceChange', (data: call.AudioDeviceCallbackInfo) => { 2527 console.log(`callback: data->${JSON.stringify(data)}`); 2528}); 2529``` 2530 2531 2532## call.off('audioDeviceChange')<sup>10+</sup> 2533 2534off\(type: 'audioDeviceChange', callback?: Callback\<AudioDeviceCallbackInfo\>\): void 2535 2536取消订阅audioDeviceChange事件。使用callback异步回调。 2537 2538**系统接口：** 此接口为系统接口。 2539 2540**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2541 2542**系统能力**：SystemCapability.Telephony.CallManager 2543 2544**参数：** 2545 2546| 参数名 | 类型 | 必填 | 说明 | 2547| -------- | ---------------------------------------------------------- | ---- | --------------------------------------------------- | 2548| type | string | 是 | 通话音频设备发生变化，参数固定为'audioDeviceChange'。 | 2549| callback | Callback<[AudioDeviceCallbackInfo](#audiodevicecallbackinfo10)> | 否 | 回调函数。不填该参数将不会收到取消订阅的处理结果。 | 2550 2551**错误码：** 2552 2553以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2554 2555| 错误码ID | 错误信息 | 2556| -------- | -------------------------------------------- | 2557| 201 | Permission denied. | 2558| 202 | Non-system applications use system APIs. | 2559| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2560| 8300001 | Invalid parameter value. | 2561| 8300002 | Operation failed. Cannot connect to service. | 2562| 8300003 | System internal error. | 2563| 8300999 | Unknown error code. | 2564 2565**示例：** 2566 2567```ts 2568call.off('audioDeviceChange', (data: call.AudioDeviceCallbackInfo) => { 2569 console.log(`callback: data->${JSON.stringify(data)}`); 2570}); 2571``` 2572 2573## call.on('postDialDelay')<sup>11+</sup> 2574 2575on\(type: 'postDialDelay', callback: Callback\<string\>\): void 2576 2577订阅拨号后延迟事件。使用callback异步回调。 2578 2579**系统接口：** 此接口为系统接口。 2580 2581**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2582 2583**系统能力**：SystemCapability.Telephony.CallManager 2584 2585**参数：** 2586 2587| 参数名 | 类型 | 必填 | 说明 | 2588| -------- | ----------------------------------------------- | ---- | --------------------------------------------------- | 2589| type | string | 是 | 拨号后延迟，参数固定为'postDialDelay'。 | 2590| callback | Callback<string> | 是 |以回调函数的方式返回订阅拨号后延迟事件的结果。 | 2591 2592**错误码：** 2593 2594以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2595 2596| 错误码ID | 错误信息 | 2597| -------- | -------------------------------------------- | 2598| 201 | Permission denied. | 2599| 202 | Non-system applications use system APIs. | 2600| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2601| 8300001 | Invalid parameter value. | 2602| 8300002 | Operation failed. Cannot connect to service. | 2603| 8300003 | System internal error. | 2604| 8300999 | Unknown error code. | 2605 2606**示例：** 2607 2608```ts 2609call.on('postDialDelay', (data: string) => { 2610 console.log(`callback: data->${JSON.stringify(data)}`); 2611}); 2612``` 2613 2614## call.off('postDialDelay')<sup>11+</sup> 2615 2616off\(type: 'postDialDelay', callback?: Callback\<string\>\): void 2617 2618取消订阅拨号后延迟事件。使用callback异步回调。 2619 2620**系统接口：** 此接口为系统接口。 2621 2622**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2623 2624**系统能力**：SystemCapability.Telephony.CallManager 2625 2626**参数：** 2627 2628| 参数名 | 类型 | 必填 | 说明 | 2629| -------- | ---------------------------------------------------------- | ---- | --------------------------------------------------- | 2630| type | string | 是 | 拨号后延迟，参数固定为'postDialDelay'。 | 2631| callback | Callback<string> | 否 | 回调函数。不填该参数将不会收到取消订阅的处理结果。 | 2632 2633**错误码：** 2634 2635以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2636 2637| 错误码ID | 错误信息 | 2638| -------- | -------------------------------------------- | 2639| 201 | Permission denied. | 2640| 202 | Non-system applications use system APIs. | 2641| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2642| 8300001 | Invalid parameter value. | 2643| 8300002 | Operation failed. Cannot connect to service. | 2644| 8300003 | System internal error. | 2645| 8300999 | Unknown error code. | 2646 2647**示例：** 2648 2649```ts 2650call.off('postDialDelay', (data: string) => { 2651 console.log(`callback: data->${JSON.stringify(data)}`); 2652}); 2653``` 2654 2655## call.isNewCallAllowed<sup>8+</sup> 2656 2657isNewCallAllowed\(callback: AsyncCallback\<boolean\>\): void 2658 2659判断是否允许再拨打一通新电话。使用callback异步回调。 2660 2661**系统接口：** 此接口为系统接口。 2662 2663**系统能力**：SystemCapability.Telephony.CallManager 2664 2665**参数：** 2666 2667| 参数名 | 类型 | 必填 | 说明 | 2668| -------- | ---------------------------- | ---- | ---------- | 2669| callback | AsyncCallback<boolean> | 是 | 以回调函数的方式返回结果，true表示允许拨打，false表示不可拨打。 | 2670 2671**错误码：** 2672 2673以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2674 2675| 错误码ID | 错误信息 | 2676| -------- | -------------------------------------------- | 2677| 202 | Non-system applications use system APIs. | 2678| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2679| 8300001 | Invalid parameter value. | 2680| 8300002 | Operation failed. Cannot connect to service. | 2681| 8300003 | System internal error. | 2682| 8300999 | Unknown error code. | 2683 2684**示例：** 2685 2686```ts 2687import { BusinessError } from '@kit.BasicServicesKit'; 2688 2689call.isNewCallAllowed((err: BusinessError, data: boolean) => { 2690 if (err) { 2691 console.error(`isNewCallAllowed fail, err->${JSON.stringify(err)}`); 2692 } else { 2693 console.log(`isNewCallAllowed success, data->${JSON.stringify(data)}`); 2694 } 2695}); 2696``` 2697 2698 2699## call.isNewCallAllowed<sup>8+</sup> 2700 2701isNewCallAllowed\(\): Promise\<boolean\> 2702 2703判断是否允许再拨打一通新电话。使用Promise异步回调。 2704 2705**系统接口：** 此接口为系统接口。 2706 2707**系统能力**：SystemCapability.Telephony.CallManager 2708 2709**返回值：** 2710 2711| 类型 | 说明 | 2712| ---------------------- | --------------------------- | 2713| Promise<boolean> | 以Promise形式异步返回结果，true表示允许拨打，false表示不可拨打。 | 2714 2715**错误码：** 2716 2717以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2718 2719| 错误码ID | 错误信息 | 2720| -------- | -------------------------------------------- | 2721| 202 | Non-system applications use system APIs. | 2722| 8300002 | Operation failed. Cannot connect to service. | 2723| 8300003 | System internal error. | 2724| 8300999 | Unknown error code. | 2725 2726**示例：** 2727 2728```ts 2729import { BusinessError } from '@kit.BasicServicesKit'; 2730 2731call.isNewCallAllowed().then((data: boolean) => { 2732 console.log(`isNewCallAllowed success, promise: data->${JSON.stringify(data)}`); 2733}).catch((err: BusinessError) => { 2734 console.error(`isNewCallAllowed fail, promise: err->${JSON.stringify(err)}`); 2735}); 2736``` 2737 2738## call.separateConference<sup>11+</sup> 2739 2740separateConference\(callId: number, callback: AsyncCallback\<void\>\): void 2741 2742分离会议电话。使用callback异步回调。 2743 2744**系统接口：** 此接口为系统接口。 2745 2746**系统能力**：SystemCapability.Telephony.CallManager 2747 2748**参数：** 2749 2750| 参数名 | 类型 | 必填 | 说明 | 2751| -------- | ------------------------- | ---- | ---------- | 2752| callId | number | 是 | 呼叫Id。 | 2753| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回分离会议电话的结果。 | 2754 2755**错误码：** 2756 2757以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2758 2759| 错误码ID | 错误信息 | 2760| -------- | -------------------------------------------- | 2761| 202 | Non-system applications use system APIs. | 2762| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2763| 8300001 | Invalid parameter value. | 2764| 8300002 | Operation failed. Cannot connect to service. | 2765| 8300003 | System internal error. | 2766| 8300008 | Conference call is not active. | 2767| 8300999 | Unknown error code. | 2768 2769**示例：** 2770 2771```ts 2772import { BusinessError } from '@kit.BasicServicesKit'; 2773 2774call.separateConference(1, (err: BusinessError) => { 2775 if (err) { 2776 console.error(`separateConference fail, err->${JSON.stringify(err)}`); 2777 } else { 2778 console.log(`separateConference success.`); 2779 } 2780}); 2781``` 2782 2783 2784## call.separateConference<sup>11+</sup> 2785 2786separateConference\(callId: number\): Promise\<void\> 2787 2788分离会议电话。使用Promise异步回调。 2789 2790**系统接口：** 此接口为系统接口。 2791 2792**系统能力**：SystemCapability.Telephony.CallManager 2793 2794**参数：** 2795 2796| 参数名 | 类型 | 必填 | 说明 | 2797| ------ | ------ | ---- | -------- | 2798| callId | number | 是 | 呼叫Id。 | 2799 2800**返回值：** 2801 2802| 类型 | 说明 | 2803| ------------------- | --------------------------- | 2804| Promise<void> | 以Promise形式异步返回结果。 | 2805 2806**错误码：** 2807 2808以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2809 2810| 错误码ID | 错误信息 | 2811| -------- | -------------------------------------------- | 2812| 202 | Non-system applications use system APIs. | 2813| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2814| 8300001 | Invalid parameter value. | 2815| 8300002 | Operation failed. Cannot connect to service. | 2816| 8300003 | System internal error. | 2817| 8300008 | Conference call is not active. | 2818| 8300999 | Unknown error code. | 2819 2820**示例：** 2821 2822```ts 2823import { BusinessError } from '@kit.BasicServicesKit'; 2824 2825call.separateConference(1).then(() => { 2826 console.log(`separateConference success.`); 2827}).catch((err: BusinessError) => { 2828 console.error(`separateConference fail, promise: err->${JSON.stringify(err)}`); 2829}); 2830``` 2831 2832## call.getCallRestrictionStatus<sup>8+</sup> 2833 2834getCallRestrictionStatus\(slotId: number, type: CallRestrictionType, callback: AsyncCallback\<RestrictionStatus\>\): void 2835 2836获取呼叫限制状态。使用callback异步回调。 2837 2838**系统接口：** 此接口为系统接口。 2839 2840**需要权限**：ohos.permission.GET_TELEPHONY_STATE 2841 2842**系统能力**：SystemCapability.Telephony.CallManager 2843 2844**参数：** 2845 2846| 参数名 | 类型 | 必填 | 说明 | 2847| -------- | ------------------------------------------------------------ | ---- | -------------------------------------- | 2848| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2849| type | [CallRestrictionType](#callrestrictiontype8) | 是 | 呼叫限制类型。 | 2850| callback | AsyncCallback<[RestrictionStatus](#restrictionstatus8)> | 是 | 回调函数。返回限制状态。 | 2851 2852**错误码：** 2853 2854以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2855 2856| 错误码ID | 错误信息 | 2857| -------- | -------------------------------------------- | 2858| 201 | Permission denied. | 2859| 202 | Non-system applications use system APIs. | 2860| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2861| 801 | Capability not supported. | 2862| 8300001 | Invalid parameter value. | 2863| 8300002 | Operation failed. Cannot connect to service. | 2864| 8300003 | System internal error. | 2865 2866**示例：** 2867 2868```ts 2869import { BusinessError } from '@kit.BasicServicesKit'; 2870 2871call.getCallRestrictionStatus(0, 1, (err: BusinessError, data: call.RestrictionStatus) => { 2872 if (err) { 2873 console.error(`getCallRestrictionStatus fail, err->${JSON.stringify(err)}`); 2874 } else { 2875 console.log(`getCallRestrictionStatus success, data->${JSON.stringify(data)}`); 2876 } 2877}); 2878``` 2879 2880 2881## call.getCallRestrictionStatus<sup>8+</sup> 2882 2883getCallRestrictionStatus\(slotId: number, type: CallRestrictionType\): Promise\<RestrictionStatus\> 2884 2885获取呼叫限制状态。使用Promise异步回调。 2886 2887**系统接口：** 此接口为系统接口。 2888 2889**需要权限**：ohos.permission.GET_TELEPHONY_STATE 2890 2891**系统能力**：SystemCapability.Telephony.CallManager 2892 2893**参数：** 2894 2895| 参数名 | 类型 | 必填 | 说明 | 2896| ------ | -------------------------------------------- | ---- | -------------------------------------- | 2897| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2898| type | [CallRestrictionType](#callrestrictiontype8) | 是 | 呼叫限制类型。 | 2899 2900**返回值：** 2901 2902| 类型 | 说明 | 2903| ------------------------------------------------------- | --------------------------- | 2904| Promise<[RestrictionStatus](#restrictionstatus8)> | 以Promise形式异步返回结果。 | 2905 2906**错误码：** 2907 2908以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2909 2910| 错误码ID | 错误信息 | 2911| -------- | -------------------------------------------- | 2912| 201 | Permission denied. | 2913| 202 | Non-system applications use system APIs. | 2914| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2915| 801 | Capability not supported. | 2916| 8300001 | Invalid parameter value. | 2917| 8300002 | Operation failed. Cannot connect to service. | 2918| 8300003 | System internal error. | 2919 2920**示例：** 2921 2922```ts 2923import { BusinessError } from '@kit.BasicServicesKit'; 2924 2925call.getCallRestrictionStatus(0, 1).then((data: call.RestrictionStatus) => { 2926 console.log(`getCallRestrictionStatus success, promise: data->${JSON.stringify(data)}`); 2927}).catch((err: BusinessError) => { 2928 console.error(`getCallRestrictionStatus fail, promise: err->${JSON.stringify(err)}`); 2929}); 2930``` 2931 2932## call.setCallRestriction<sup>8+</sup> 2933 2934setCallRestriction\(slotId: number, info: CallRestrictionInfo, callback: AsyncCallback\<void\>\): void 2935 2936设置呼叫限制状态。使用callback异步回调。 2937 2938**系统接口：** 此接口为系统接口。 2939 2940**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2941 2942**系统能力**：SystemCapability.Telephony.CallManager 2943 2944**参数：** 2945 2946| 参数名 | 类型 | 必填 | 说明 | 2947| -------- | ------------------------------------------- | ---- | -------------------------------------- | 2948| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2949| info | [CallRestrictionInfo](#callrestrictioninfo8) | 是 | 呼叫限制信息。 | 2950| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回设置呼叫限制状态的结果。 | 2951 2952**错误码：** 2953 2954以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 2955 2956| 错误码ID | 错误信息 | 2957| -------- | -------------------------------------------- | 2958| 201 | Permission denied. | 2959| 202 | Non-system applications use system APIs. | 2960| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 2961| 801 | Capability not supported. | 2962| 8300001 | Invalid parameter value. | 2963| 8300002 | Operation failed. Cannot connect to service. | 2964| 8300003 | System internal error. | 2965 2966**示例：** 2967 2968```ts 2969import { BusinessError } from '@kit.BasicServicesKit'; 2970 2971let callRestrictionInfo: call.CallRestrictionInfo = { 2972 type: call.CallRestrictionType.RESTRICTION_TYPE_ALL_OUTGOING, 2973 password: "123456", 2974 mode: call.CallRestrictionMode.RESTRICTION_MODE_ACTIVATION 2975} 2976call.setCallRestriction(0, callRestrictionInfo, (err: BusinessError) => { 2977 if (err) { 2978 console.error(`setCallRestriction fail, err->${JSON.stringify(err)}`); 2979 } else { 2980 console.log(`setCallRestriction success.`); 2981 } 2982}); 2983``` 2984 2985 2986## call.setCallRestriction<sup>8+</sup> 2987 2988setCallRestriction\(slotId: number, info: CallRestrictionInfo\): Promise\<void\> 2989 2990设置呼叫限制状态。使用Promise异步回调。 2991 2992**系统接口：** 此接口为系统接口。 2993 2994**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2995 2996**系统能力**：SystemCapability.Telephony.CallManager 2997 2998**参数：** 2999 3000| 参数名 | 类型 | 必填 | 说明 | 3001| ------ | -------------------------------------------- | ---- | -------------------------------------- | 3002| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3003| info | [CallRestrictionInfo](#callrestrictioninfo8) | 是 | 呼叫限制信息。 | 3004 3005**返回值：** 3006 3007| 类型 | 说明 | 3008| ------------------- | --------------------------- | 3009| Promise<void> | 以Promise形式异步返回结果。 | 3010 3011**错误码：** 3012 3013以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3014 3015| 错误码ID | 错误信息 | 3016| -------- | -------------------------------------------- | 3017| 201 | Permission denied. | 3018| 202 | Non-system applications use system APIs. | 3019| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3020| 801 | Capability not supported. | 3021| 8300001 | Invalid parameter value. | 3022| 8300002 | Operation failed. Cannot connect to service. | 3023| 8300003 | System internal error. | 3024 3025**示例：** 3026 3027```ts 3028import { BusinessError } from '@kit.BasicServicesKit'; 3029 3030let callRestrictionInfo: call.CallRestrictionInfo = { 3031 type: call.CallRestrictionType.RESTRICTION_TYPE_ALL_INCOMING, 3032 password: "123456", 3033 mode: call.CallRestrictionMode.RESTRICTION_MODE_ACTIVATION 3034} 3035call.setCallRestriction(0, callRestrictionInfo).then(() => { 3036 console.log(`setCallRestriction success.`); 3037}).catch((err: BusinessError) => { 3038 console.error(`setCallRestriction fail, promise: err->${JSON.stringify(err)}`); 3039}); 3040``` 3041 3042## call.setCallRestrictionPassword<sup>10+</sup> 3043 3044setCallRestrictionPassword\(slotId: number, oldPassword: string, newPassword: string, callback: AsyncCallback\<void\>\): void 3045 3046修改呼叫限制密码。使用callback异步回调。 3047 3048**系统接口：** 此接口为系统接口。 3049 3050**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3051 3052**系统能力**：SystemCapability.Telephony.CallManager 3053 3054**参数：** 3055 3056| 参数名 | 类型 | 必填 | 说明 | 3057| --------------- | ------------------------------------------- | ---- | ------------------------------------ | 3058| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3059| oldPassword | string | 是 | 呼叫限制旧密码。 | 3060| newPassword | string | 是 | 呼叫限制新密码。 | 3061| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回修改呼叫限制密码的结果。 | 3062 3063**错误码：** 3064 3065以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3066 3067| 错误码ID | 错误信息 | 3068| -------- | -------------------------------------------- | 3069| 201 | Permission denied. | 3070| 202 | Non-system applications use system APIs. | 3071| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3072| 801 | Capability not supported. | 3073| 8300001 | Invalid parameter value. | 3074| 8300002 | Operation failed. Cannot connect to service. | 3075| 8300003 | System internal error. | 3076 3077**示例：** 3078 3079```ts 3080import { BusinessError } from '@kit.BasicServicesKit'; 3081 3082call.setCallRestrictionPassword(0, "123456", "654321", (err: BusinessError) => { 3083 if (err) { 3084 console.error(`setCallRestrictionPassword fail, err->${JSON.stringify(err)}`); 3085 } else { 3086 console.log(`setCallRestrictionPassword success.`); 3087 } 3088}); 3089``` 3090 3091## call.setCallRestrictionPassword<sup>10+</sup> 3092 3093setCallRestrictionPassword\(slotId: number, oldPassword: string, newPassword: string\): Promise\<void\> 3094 3095修改呼叫限制密码。使用Promise异步回调。 3096 3097**系统接口：** 此接口为系统接口。 3098 3099**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3100 3101**系统能力**：SystemCapability.Telephony.CallManager 3102 3103**参数：** 3104 3105| 参数名 | 类型 | 必填 | 说明 | 3106| --------------- | ------------------------------------------- | ---- | ------------------------------------ | 3107| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3108| oldPassword | string | 是 | 呼叫限制旧密码。 | 3109| newPassword | string | 是 | 呼叫限制新密码。 | 3110 3111**返回值：** 3112 3113| 类型 | 说明 | 3114| ------------------- | --------------------------- | 3115| Promise<void> | 以Promise形式异步返回结果。 | 3116 3117**错误码：** 3118 3119以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3120 3121| 错误码ID | 错误信息 | 3122| -------- | -------------------------------------------- | 3123| 201 | Permission denied. | 3124| 202 | Non-system applications use system APIs. | 3125| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3126| 801 | Capability not supported. | 3127| 8300001 | Invalid parameter value. | 3128| 8300002 | Operation failed. Cannot connect to service. | 3129| 8300003 | System internal error. | 3130 3131**示例：** 3132 3133```ts 3134import { BusinessError } from '@kit.BasicServicesKit'; 3135 3136call.setCallRestrictionPassword(0, "123456", "654321").then(() => { 3137 console.log(`setCallRestrictionPassword success.`); 3138}).catch((err: BusinessError) => { 3139 console.error(`setCallRestrictionPassword fail, promise: err->${JSON.stringify(err)}`); 3140}); 3141``` 3142 3143## call.getCallTransferInfo<sup>8+</sup> 3144 3145getCallTransferInfo\(slotId: number, type: CallTransferType, callback: AsyncCallback\<CallTransferResult\>\): void 3146 3147获取呼叫转移信息。使用callback异步回调。 3148 3149**系统接口：** 此接口为系统接口。 3150 3151**需要权限**：ohos.permission.GET_TELEPHONY_STATE 3152 3153**系统能力**：SystemCapability.Telephony.CallManager 3154 3155**参数：** 3156 3157| 参数名 | 类型 | 必填 | 说明 | 3158| -------- | ------------------------------------------------------------ | ---- | -------------------------------------- | 3159| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3160| type | [CallTransferType](#calltransfertype8) | 是 | 呼叫转移类型。 | 3161| callback | AsyncCallback<[CallTransferResult](#calltransferresult8)> | 是 | 回调函数。返回呼叫转移信息。 | 3162 3163**错误码：** 3164 3165以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3166 3167| 错误码ID | 错误信息 | 3168| -------- | -------------------------------------------- | 3169| 201 | Permission denied. | 3170| 202 | Non-system applications use system APIs. | 3171| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3172| 801 | Capability not supported. | 3173| 8300001 | Invalid parameter value. | 3174| 8300002 | Operation failed. Cannot connect to service. | 3175| 8300003 | System internal error. | 3176 3177**示例：** 3178 3179```ts 3180import { BusinessError } from '@kit.BasicServicesKit'; 3181 3182call.getCallTransferInfo(0, call.CallTransferType.TRANSFER_TYPE_BUSY, (err: BusinessError, data: call.CallTransferResult) => { 3183 if (err) { 3184 console.error(`getCallTransferInfo fail, err->${JSON.stringify(err)}`); 3185 } else { 3186 console.log(`getCallTransferInfo success, data->${JSON.stringify(data)}`); 3187 } 3188}); 3189``` 3190 3191 3192## call.getCallTransferInfo<sup>8+</sup> 3193 3194getCallTransferInfo\(slotId: number, type: CallTransferType\): Promise\<CallTransferResult\> 3195 3196获取呼叫转移信息。使用Promise异步回调。 3197 3198**系统接口：** 此接口为系统接口。 3199 3200**需要权限**：ohos.permission.GET_TELEPHONY_STATE 3201 3202**系统能力**：SystemCapability.Telephony.CallManager 3203 3204**参数：** 3205 3206| 参数名 | 类型 | 必填 | 说明 | 3207| ------ | -------------------------------------- | ---- | -------------------------------------- | 3208| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3209| type | [CallTransferType](#calltransfertype8) | 是 | 呼叫转移类型。 | 3210 3211**返回值：** 3212 3213| 类型 | 说明 | 3214| --------------------------------------------------------- | --------------------------- | 3215| Promise<[CallTransferResult](#calltransferresult8)> | 以Promise形式异步返回结果。 | 3216 3217**错误码：** 3218 3219以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3220 3221| 错误码ID | 错误信息 | 3222| -------- | -------------------------------------------- | 3223| 201 | Permission denied. | 3224| 202 | Non-system applications use system APIs. | 3225| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3226| 801 | Capability not supported. | 3227| 8300001 | Invalid parameter value. | 3228| 8300002 | Operation failed. Cannot connect to service. | 3229| 8300003 | System internal error. | 3230 3231**示例：** 3232 3233```ts 3234import { BusinessError } from '@kit.BasicServicesKit'; 3235 3236call.getCallTransferInfo(0, call.CallTransferType.TRANSFER_TYPE_BUSY).then((data: call.CallTransferResult) => { 3237 console.log(`getCallTransferInfo success, promise: data->${JSON.stringify(data)}`); 3238}).catch((err: BusinessError) => { 3239 console.error(`getCallTransferInfo fail, promise: err->${JSON.stringify(err)}`); 3240}); 3241``` 3242 3243## call.setCallTransfer<sup>8+</sup> 3244 3245setCallTransfer\(slotId: number, info: CallTransferInfo, callback: AsyncCallback\<void\>\): void 3246 3247设置呼叫转移信息。使用callback异步回调。 3248 3249**系统接口：** 此接口为系统接口。 3250 3251**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3252 3253**系统能力**：SystemCapability.Telephony.CallManager 3254 3255**参数：** 3256 3257| 参数名 | 类型 | 必填 | 说明 | 3258| -------- | ------------------------------------- | ---- | -------------------------------------- | 3259| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3260| info | [CallTransferInfo](#calltransferinfo8) | 是 | 呼叫转移信息。 | 3261| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回设置呼叫转移信息的结果。 | 3262 3263**错误码：** 3264 3265以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3266 3267| 错误码ID | 错误信息 | 3268| -------- | -------------------------------------------- | 3269| 201 | Permission denied. | 3270| 202 | Non-system applications use system APIs. | 3271| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3272| 801 | Capability not supported. | 3273| 8300001 | Invalid parameter value. | 3274| 8300002 | Operation failed. Cannot connect to service. | 3275| 8300003 | System internal error. | 3276 3277**示例：** 3278 3279```ts 3280import { BusinessError } from '@kit.BasicServicesKit'; 3281 3282let callTransferInfo: call.CallTransferInfo = { 3283 transferNum: "111", 3284 type: call.CallTransferType.TRANSFER_TYPE_BUSY, 3285 settingType: call.CallTransferSettingType.CALL_TRANSFER_ENABLE 3286} 3287call.setCallTransfer(0, callTransferInfo, (err: BusinessError) => { 3288 if (err) { 3289 console.error(`setCallTransfer fail, err->${JSON.stringify(err)}`); 3290 } else { 3291 console.log(`setCallTransfer success.`); 3292 } 3293}); 3294``` 3295 3296 3297## call.setCallTransfer<sup>8+</sup> 3298 3299setCallTransfer\(slotId: number, info: CallTransferInfo\): Promise\<void\> 3300 3301设置呼叫转移信息。使用Promise异步回调。 3302 3303**系统接口：** 此接口为系统接口。 3304 3305**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3306 3307**系统能力**：SystemCapability.Telephony.CallManager 3308 3309**参数：** 3310 3311| 参数名 | 类型 | 必填 | 说明 | 3312| ------ | ------------------------------------- | ---- | -------------------------------------- | 3313| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3314| info | [CallTransferInfo](#calltransferinfo8) | 是 | 呼叫转移信息。 | 3315 3316**返回值：** 3317 3318| 类型 | 说明 | 3319| ------------------- | --------------------------- | 3320| Promise<void> | 以Promise形式异步返回结果。 | 3321 3322**错误码：** 3323 3324以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3325 3326| 错误码ID | 错误信息 | 3327| -------- | -------------------------------------------- | 3328| 201 | Permission denied. | 3329| 202 | Non-system applications use system APIs. | 3330| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3331| 801 | Capability not supported. | 3332| 8300001 | Invalid parameter value. | 3333| 8300002 | Operation failed. Cannot connect to service. | 3334| 8300003 | System internal error. | 3335 3336**示例：** 3337 3338```ts 3339import { BusinessError } from '@kit.BasicServicesKit'; 3340 3341let callTransferInfo: call.CallTransferInfo = { 3342 transferNum: "111", 3343 type: call.CallTransferType.TRANSFER_TYPE_BUSY, 3344 settingType: call.CallTransferSettingType.CALL_TRANSFER_ENABLE 3345} 3346call.setCallTransfer(0, callTransferInfo).then(() => { 3347 console.log(`setCallTransfer success.`); 3348}).catch((err: BusinessError) => { 3349 console.error(`setCallTransfer fail, promise: err->${JSON.stringify(err)}`); 3350}); 3351``` 3352 3353## call.isRinging<sup>8+</sup> 3354 3355isRinging\(callback: AsyncCallback\<boolean\>\): void 3356 3357判断是否正在响铃。使用callback异步回调。 3358 3359**系统接口：** 此接口为系统接口。 3360 3361**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3362 3363**系统能力**：SystemCapability.Telephony.CallManager 3364 3365**参数：** 3366 3367| 参数名 | 类型 | 必填 | 说明 | 3368| -------- | ---------------------------- | ---- | ---------- | 3369| callback | AsyncCallback<boolean> | 是 | 以回调函数的方式返回是否正在响铃的结果，true表示正在响铃，false表示没有在响铃。 | 3370 3371**错误码：** 3372 3373以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3374 3375| 错误码ID | 错误信息 | 3376| -------- | -------------------------------------------- | 3377| 201 | Permission denied. | 3378| 202 | Non-system applications use system APIs. | 3379| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3380| 8300001 | Invalid parameter value. | 3381| 8300002 | Operation failed. Cannot connect to service. | 3382| 8300003 | System internal error. | 3383| 8300999 | Unknown error code. | 3384 3385**示例：** 3386 3387```ts 3388import { BusinessError } from '@kit.BasicServicesKit'; 3389 3390call.isRinging((err: BusinessError, data: boolean) => { 3391 if (err) { 3392 console.error(`isRinging fail, err->${JSON.stringify(err)}`); 3393 } else { 3394 console.log(`isRinging success, data->${JSON.stringify(data)}`); 3395 } 3396}); 3397``` 3398 3399 3400## call.isRinging<sup>8+</sup> 3401 3402isRinging\(\): Promise\<boolean\> 3403 3404判断是否正在响铃。使用Promise异步回调。 3405 3406**系统接口：** 此接口为系统接口。 3407 3408**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3409 3410**系统能力**：SystemCapability.Telephony.CallManager 3411 3412**返回值：** 3413 3414| 类型 | 说明 | 3415| ---------------------- | --------------------------- | 3416| Promise<boolean> | 以Promise形式异步返回结果，true表示正在响铃，false表示没有响铃。 | 3417 3418**错误码：** 3419 3420以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3421 3422| 错误码ID | 错误信息 | 3423| -------- | -------------------------------------------- | 3424| 201 | Permission denied. | 3425| 202 | Non-system applications use system APIs. | 3426| 8300002 | Operation failed. Cannot connect to service. | 3427| 8300003 | System internal error. | 3428| 8300999 | Unknown error code. | 3429 3430**示例：** 3431 3432```ts 3433import { BusinessError } from '@kit.BasicServicesKit'; 3434 3435call.isRinging().then((data: boolean) => { 3436 console.log(`isRinging success, promise: data->${JSON.stringify(data)}`); 3437}).catch((err: BusinessError) => { 3438 console.error(`isRinging fail, promise: err->${JSON.stringify(err)}`); 3439}); 3440``` 3441 3442## call.setMuted<sup>8+</sup> 3443 3444setMuted\(callback: AsyncCallback\<void\>\): void 3445 3446设置通话中的静音。使用callback异步回调。 3447 3448**系统接口：** 此接口为系统接口。 3449 3450**系统能力**：SystemCapability.Telephony.CallManager 3451 3452**参数：** 3453 3454| 参数名 | 类型 | 必填 | 说明 | 3455| -------- | ------------------------- | ---- | ---------- | 3456| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回设置通话中的静音的结果。 | 3457 3458**错误码：** 3459 3460以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3461 3462| 错误码ID | 错误信息 | 3463| -------- | -------------------------------------------- | 3464| 202 | Non-system applications use system APIs. | 3465| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3466| 8300001 | Invalid parameter value. | 3467| 8300002 | Operation failed. Cannot connect to service. | 3468| 8300003 | System internal error. | 3469| 8300999 | Unknown error code. | 3470 3471**示例：** 3472 3473```ts 3474import { BusinessError } from '@kit.BasicServicesKit'; 3475 3476call.setMuted((err: BusinessError) => { 3477 if (err) { 3478 console.error(`setMuted fail, err->${JSON.stringify(err)}`); 3479 } else { 3480 console.log(`setMuted success.`); 3481 } 3482}); 3483``` 3484 3485 3486## call.setMuted<sup>8+</sup> 3487 3488setMuted\(\): Promise\<void\> 3489 3490设置通话中的静音。使用Promise异步回调。 3491 3492**系统接口：** 此接口为系统接口。 3493 3494**系统能力**：SystemCapability.Telephony.CallManager 3495 3496**返回值：** 3497 3498| 类型 | 说明 | 3499| ------------------- | --------------------------- | 3500| Promise<void> | 以Promise形式异步返回结果。 | 3501 3502**错误码：** 3503 3504以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3505 3506| 错误码ID | 错误信息 | 3507| -------- | -------------------------------------------- | 3508| 202 | Non-system applications use system APIs. | 3509| 8300002 | Operation failed. Cannot connect to service. | 3510| 8300003 | System internal error. | 3511| 8300999 | Unknown error code. | 3512 3513**示例：** 3514 3515```ts 3516import { BusinessError } from '@kit.BasicServicesKit'; 3517 3518call.setMuted().then(() => { 3519 console.log(`setMuted success.`); 3520}).catch((err: BusinessError) => { 3521 console.error(`setMuted fail, promise: err->${JSON.stringify(err)}`); 3522}); 3523``` 3524 3525## call.cancelMuted<sup>8+</sup> 3526 3527cancelMuted\(callback: AsyncCallback\<void\>\): void 3528 3529取消通话中的静音。使用callback异步回调。 3530 3531**系统接口：** 此接口为系统接口。 3532 3533**系统能力**：SystemCapability.Telephony.CallManager 3534 3535**参数：** 3536 3537| 参数名 | 类型 | 必填 | 说明 | 3538| -------- | ------------------------- | ---- | ---------- | 3539| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回取消通话中的静音的结果。 | 3540 3541**错误码：** 3542 3543以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3544 3545| 错误码ID | 错误信息 | 3546| -------- | -------------------------------------------- | 3547| 202 | Non-system applications use system APIs. | 3548| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3549| 8300001 | Invalid parameter value. | 3550| 8300002 | Operation failed. Cannot connect to service. | 3551| 8300003 | System internal error. | 3552| 8300999 | Unknown error code. | 3553 3554**示例：** 3555 3556```ts 3557import { BusinessError } from '@kit.BasicServicesKit'; 3558 3559call.cancelMuted((err: BusinessError) => { 3560 if (err) { 3561 console.error(`cancelMuted fail, err->${JSON.stringify(err)}`); 3562 } else { 3563 console.log(`cancelMuted success.`); 3564 } 3565}); 3566``` 3567 3568 3569## call.cancelMuted<sup>8+</sup> 3570 3571cancelMuted\(\): Promise\<void\> 3572 3573取消通话中的静音。使用Promise异步回调。 3574 3575**系统接口：** 此接口为系统接口。 3576 3577**系统能力**：SystemCapability.Telephony.CallManager 3578 3579**返回值：** 3580 3581| 类型 | 说明 | 3582| ------------------- | --------------------------- | 3583| Promise<void> | 以Promise形式异步返回结果。 | 3584 3585**错误码：** 3586 3587以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3588 3589| 错误码ID | 错误信息 | 3590| -------- | -------------------------------------------- | 3591| 202 | Non-system applications use system APIs. | 3592| 8300002 | Operation failed. Cannot connect to service. | 3593| 8300003 | System internal error. | 3594| 8300999 | Unknown error code. | 3595 3596**示例：** 3597 3598```ts 3599import { BusinessError } from '@kit.BasicServicesKit'; 3600 3601call.cancelMuted().then(() => { 3602 console.log(`cancelMuted success.`); 3603}).catch((err: BusinessError) => { 3604 console.error(`cancelMuted fail, promise: err->${JSON.stringify(err)}`); 3605}); 3606``` 3607 3608## call.setAudioDevice<sup>8+</sup> 3609 3610setAudioDevice\(device: AudioDevice, callback: AsyncCallback\<void\>\): void 3611 3612设置通话音频设备。使用callback异步回调。 3613 3614**系统接口：** 此接口为系统接口。 3615 3616**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3617 3618**系统能力**：SystemCapability.Telephony.CallManager 3619 3620**参数：** 3621 3622| 参数名 | 类型 | 必填 | 说明 | 3623| -------- | ---------------------------- | ---- | ---------- | 3624| device | [AudioDevice](#audiodevice10)| 是 | 音频设备。 | 3625| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回设置通话音频设备的结果。 | 3626 3627**错误码：** 3628 3629以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3630 3631| 错误码ID | 错误信息 | 3632| -------- | -------------------------------------------- | 3633| 201 | Permission denied. | 3634| 202 | Non-system applications use system APIs. | 3635| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3636| 8300001 | Invalid parameter value. | 3637| 8300002 | Operation failed. Cannot connect to service. | 3638| 8300003 | System internal error. | 3639| 8300999 | Unknown error code. | 3640 3641**示例：** 3642 3643```ts 3644import { BusinessError } from '@kit.BasicServicesKit'; 3645 3646let audioDevice: call.AudioDevice = { 3647 deviceType: call.AudioDeviceType.DEVICE_EARPIECE 3648} 3649call.setAudioDevice(audioDevice, (err: BusinessError) => { 3650 if (err) { 3651 console.error(`setAudioDevice fail, err->${JSON.stringify(err)}`); 3652 } else { 3653 console.log(`setAudioDevice success.`); 3654 } 3655}); 3656``` 3657 3658## call.setAudioDevice<sup>10+</sup> 3659 3660setAudioDevice\(device: AudioDevice): Promise\<void\> 3661 3662设置通话音频设备。使用Promise异步回调。 3663 3664**系统接口：** 此接口为系统接口。 3665 3666**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3667 3668**系统能力**：SystemCapability.Telephony.CallManager 3669 3670**参数：** 3671 3672| 参数名 | 类型 | 必填 | 说明 | 3673| -------- | ---------------------------- | ---- | ---------- | 3674| device | [AudioDevice](#audiodevice10)| 是 | 音频设备。 | 3675 3676**返回值：** 3677 3678| 类型 | 说明 | 3679| ------------------- | --------------------------- | 3680| Promise<void> | 以Promise形式异步返回结果。 | 3681 3682**错误码：** 3683 3684以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3685 3686| 错误码ID | 错误信息 | 3687| -------- | -------------------------------------------- | 3688| 201 | Permission denied. | 3689| 202 | Non-system applications use system APIs. | 3690| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3691| 8300001 | Invalid parameter value. | 3692| 8300002 | Operation failed. Cannot connect to service. | 3693| 8300003 | System internal error. | 3694| 8300999 | Unknown error code. | 3695 3696**示例：** 3697 3698```ts 3699import { BusinessError } from '@kit.BasicServicesKit'; 3700 3701let audioDevice: call.AudioDevice = { 3702 deviceType: call.AudioDeviceType.DEVICE_EARPIECE 3703} 3704call.setAudioDevice(audioDevice).then(() => { 3705 console.log(`setAudioDevice success.`); 3706}).catch((err: BusinessError) => { 3707 console.error(`setAudioDevice fail, promise: err->${JSON.stringify(err)}`); 3708}); 3709``` 3710 3711## call.joinConference<sup>8+</sup> 3712 3713joinConference\(mainCallId: number, callNumberList: Array\<string\>, callback: AsyncCallback\<void\>\): void 3714 3715加入会议。使用callback异步回调。 3716 3717**系统接口：** 此接口为系统接口。 3718 3719**系统能力**：SystemCapability.Telephony.CallManager 3720 3721**参数：** 3722 3723| 参数名 | 类型 | 必填 | 说明 | 3724| -------------- | ------------------------- | ---- | --------------- | 3725| mainCallId | number | 是 | 主通话Id。 | 3726| callNumberList | Array<string\> | 是 | 呼叫号码列表。 | 3727| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回加入会议的结果。 | 3728 3729**错误码：** 3730 3731以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3732 3733| 错误码ID | 错误信息 | 3734| -------- | -------------------------------------------- | 3735| 202 | Non-system applications use system APIs. | 3736| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3737| 8300001 | Invalid parameter value. | 3738| 8300002 | Operation failed. Cannot connect to service. | 3739| 8300003 | System internal error. | 3740| 8300999 | Unknown error code. | 3741 3742**示例：** 3743 3744```ts 3745import { BusinessError } from '@kit.BasicServicesKit'; 3746 3747let callNumberList: Array<string> = [ 3748 "138XXXXXXXX" 3749]; 3750call.joinConference(1, callNumberList, (err: BusinessError) => { 3751 if (err) { 3752 console.error(`joinConference fail, err->${JSON.stringify(err)}`); 3753 } else { 3754 console.log(`joinConference success.`); 3755 } 3756}); 3757``` 3758 3759## call.joinConference<sup>8+</sup> 3760 3761joinConference\(mainCallId: number, callNumberList: Array\<string\>\): Promise\<void\> 3762 3763加入会议。使用Promise异步回调。 3764 3765**系统接口：** 此接口为系统接口。 3766 3767**系统能力**：SystemCapability.Telephony.CallManager 3768 3769**参数：** 3770 3771| 参数名 | 类型 | 必填 | 说明 | 3772| -------------- | -------------- | ---- | --------------- | 3773| mainCallId | number | 是 | 主通话Id。 | 3774| callNumberList | Array<string\> | 是 | 呼叫号码列表。 | 3775 3776**返回值：** 3777 3778| 类型 | 说明 | 3779| ------------------- | --------------------------- | 3780| Promise<void> | 以Promise形式异步返回结果。 | 3781 3782**错误码：** 3783 3784以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3785 3786| 错误码ID | 错误信息 | 3787| -------- | -------------------------------------------- | 3788| 202 | Non-system applications use system APIs. | 3789| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3790| 8300001 | Invalid parameter value. | 3791| 8300002 | Operation failed. Cannot connect to service. | 3792| 8300003 | System internal error. | 3793| 8300999 | Unknown error code. | 3794 3795**示例：** 3796 3797```ts 3798import { BusinessError } from '@kit.BasicServicesKit'; 3799 3800let callNumberList: Array<string> = [ 3801 "138XXXXXXXX" 3802]; 3803call.joinConference(1, callNumberList).then(() => { 3804 console.log(`joinConference success.`); 3805}).catch((err: BusinessError) => { 3806 console.error(`joinConference fail, promise: err->${JSON.stringify(err)}`); 3807}); 3808``` 3809 3810## call.updateImsCallMode<sup>8+</sup> 3811 3812updateImsCallMode\(callId: number, mode: ImsCallMode, callback: AsyncCallback\<void\>\): void 3813 3814更新Ims呼叫模式。使用callback异步回调。 3815 3816**系统接口：** 此接口为系统接口。 3817 3818**系统能力**：SystemCapability.Telephony.CallManager 3819 3820**参数：** 3821 3822| 参数名 | 类型 | 必填 | 说明 | 3823| -------- | ---------------------------- | ---- | -------------- | 3824| callId | number | 是 | 呼叫Id。 | 3825| mode | [ImsCallMode](#imscallmode8) | 是 | Ims呼叫模式。 | 3826| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回更新Ims呼叫模式的结果。 | 3827 3828**错误码：** 3829 3830以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3831 3832| 错误码ID | 错误信息 | 3833| -------- | -------------------------------------------- | 3834| 202 | Non-system applications use system APIs. | 3835| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3836| 8300001 | Invalid parameter value. | 3837| 8300002 | Operation failed. Cannot connect to service. | 3838| 8300003 | System internal error. | 3839| 8300999 | Unknown error code. | 3840 3841**示例：** 3842 3843```ts 3844import { BusinessError } from '@kit.BasicServicesKit'; 3845 3846call.updateImsCallMode(1, 1, (err: BusinessError) => { 3847 if (err) { 3848 console.error(`updateImsCallMode fail, err->${JSON.stringify(err)}`); 3849 } else { 3850 console.log(`updateImsCallMode success.`); 3851 } 3852}); 3853``` 3854 3855## call.updateImsCallMode<sup>8+</sup> 3856 3857updateImsCallMode\(callId: number, mode: ImsCallMode\): Promise\<void\> 3858 3859更新Ims呼叫模式。使用Promise异步回调。 3860 3861**系统接口：** 此接口为系统接口。 3862 3863**系统能力**：SystemCapability.Telephony.CallManager 3864 3865**参数：** 3866 3867| 参数名 | 类型 | 必填 | 说明 | 3868| ------ | ---------------------------- | ---- | -------------- | 3869| callId | number | 是 | 呼叫Id。 | 3870| mode | [ImsCallMode](#imscallmode8) | 是 | Ims呼叫模式。 | 3871 3872**返回值：** 3873 3874| 类型 | 说明 | 3875| ------------------- | --------------------------- | 3876| Promise<void> | 以Promise形式异步返回结果。 | 3877 3878**错误码：** 3879 3880以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3881 3882| 错误码ID | 错误信息 | 3883| -------- | -------------------------------------------- | 3884| 202 | Non-system applications use system APIs. | 3885| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3886| 8300001 | Invalid parameter value. | 3887| 8300002 | Operation failed. Cannot connect to service. | 3888| 8300003 | System internal error. | 3889| 8300999 | Unknown error code. | 3890 3891**示例：** 3892 3893```ts 3894import { BusinessError } from '@kit.BasicServicesKit'; 3895 3896call.updateImsCallMode(1, 1).then(() => { 3897 console.log(`updateImsCallMode success.`); 3898}).catch((err: BusinessError) => { 3899 console.error(`updateImsCallMode fail, promise: err->${JSON.stringify(err)}`); 3900}); 3901``` 3902 3903## call.enableImsSwitch<sup>8+</sup> 3904 3905enableImsSwitch\(slotId: number, callback: AsyncCallback\<void\>\): void 3906 3907启用Ims开关。使用callback异步回调。 3908 3909**系统接口：** 此接口为系统接口。 3910 3911**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3912 3913**系统能力**：SystemCapability.Telephony.CallManager 3914 3915**参数：** 3916 3917| 参数名 | 类型 | 必填 | 说明 | 3918| -------- | ------------------------- | ---- | -------------------------------------- | 3919| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3920| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回启用Ims开关的结果。 | 3921 3922**错误码：** 3923 3924以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3925 3926| 错误码ID | 错误信息 | 3927| -------- | -------------------------------------------- | 3928| 201 | Permission denied. | 3929| 202 | Non-system applications use system APIs. | 3930| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3931| 8300001 | Invalid parameter value. | 3932| 8300002 | Operation failed. Cannot connect to service. | 3933| 8300003 | System internal error. | 3934| 8300999 | Unknown error code. | 3935 3936**示例：** 3937 3938```ts 3939import { BusinessError } from '@kit.BasicServicesKit'; 3940 3941call.enableImsSwitch(0, (err: BusinessError) => { 3942 if (err) { 3943 console.error(`enableImsSwitch fail, err->${JSON.stringify(err)}`); 3944 } else { 3945 console.log(`enableImsSwitch success.`); 3946 } 3947}); 3948``` 3949 3950## call.enableImsSwitch<sup>8+</sup> 3951 3952enableImsSwitch\(slotId: number\): Promise\<void\> 3953 3954启用Ims开关。使用Promise异步回调。 3955 3956**系统接口：** 此接口为系统接口。 3957 3958**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3959 3960**系统能力**：SystemCapability.Telephony.CallManager 3961 3962**参数：** 3963 3964| 参数名 | 类型 | 必填 | 说明 | 3965| ------ | ------ | ---- | -------------------------------------- | 3966| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3967 3968**返回值：** 3969 3970| 类型 | 说明 | 3971| ------------------- | --------------------------- | 3972| Promise<void> | 以Promise形式异步返回结果。 | 3973 3974**错误码：** 3975 3976以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 3977 3978| 错误码ID | 错误信息 | 3979| -------- | -------------------------------------------- | 3980| 201 | Permission denied. | 3981| 202 | Non-system applications use system APIs. | 3982| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 3983| 8300001 | Invalid parameter value. | 3984| 8300002 | Operation failed. Cannot connect to service. | 3985| 8300003 | System internal error. | 3986| 8300999 | Unknown error code. | 3987 3988**示例：** 3989 3990```ts 3991import { BusinessError } from '@kit.BasicServicesKit'; 3992 3993call.enableImsSwitch(0).then(() => { 3994 console.log(`enableImsSwitch success.`); 3995}).catch((err: BusinessError) => { 3996 console.error(`enableImsSwitch fail, promise: err->${JSON.stringify(err)}`); 3997}); 3998``` 3999 4000## call.disableImsSwitch<sup>8+</sup> 4001 4002disableImsSwitch\(slotId: number, callback: AsyncCallback\<void\>\): void 4003 4004禁用Ims开关。使用callback异步回调。 4005 4006**系统接口：** 此接口为系统接口。 4007 4008**需要权限**：ohos.permission.SET_TELEPHONY_STATE 4009 4010**系统能力**：SystemCapability.Telephony.CallManager 4011 4012**参数：** 4013 4014| 参数名 | 类型 | 必填 | 说明 | 4015| -------- | ------------------------- | ---- | -------------------------------------- | 4016| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 4017| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回禁用Ims开关的结果。 | 4018 4019**错误码：** 4020 4021以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4022 4023| 错误码ID | 错误信息 | 4024| -------- | -------------------------------------------- | 4025| 201 | Permission denied. | 4026| 202 | Non-system applications use system APIs. | 4027| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4028| 8300001 | Invalid parameter value. | 4029| 8300002 | Operation failed. Cannot connect to service. | 4030| 8300003 | System internal error. | 4031| 8300999 | Unknown error code. | 4032 4033**示例：** 4034 4035```ts 4036import { BusinessError } from '@kit.BasicServicesKit'; 4037 4038call.disableImsSwitch(0, (err: BusinessError) => { 4039 if (err) { 4040 console.error(`disableImsSwitch fail, err->${JSON.stringify(err)}`); 4041 } else { 4042 console.log(`disableImsSwitch success.`); 4043 } 4044}); 4045``` 4046 4047## call.disableImsSwitch<sup>8+</sup> 4048 4049disableImsSwitch\(slotId: number\): Promise\<void\> 4050 4051禁用Ims开关。使用Promise异步回调。 4052 4053**系统接口：** 此接口为系统接口。 4054 4055**需要权限**：ohos.permission.SET_TELEPHONY_STATE 4056 4057**系统能力**：SystemCapability.Telephony.CallManager 4058 4059**参数：** 4060 4061| 参数名 | 类型 | 必填 | 说明 | 4062| ------ | ------ | ---- | -------------------------------------- | 4063| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 4064 4065**返回值：** 4066 4067| 类型 | 说明 | 4068| ------------------- | --------------------------- | 4069| Promise<void> | 以Promise形式异步返回结果。 | 4070 4071**错误码：** 4072 4073以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4074 4075| 错误码ID | 错误信息 | 4076| -------- | -------------------------------------------- | 4077| 201 | Permission denied. | 4078| 202 | Non-system applications use system APIs. | 4079| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4080| 8300001 | Invalid parameter value. | 4081| 8300002 | Operation failed. Cannot connect to service. | 4082| 8300003 | System internal error. | 4083| 8300999 | Unknown error code. | 4084 4085**示例：** 4086 4087```ts 4088import { BusinessError } from '@kit.BasicServicesKit'; 4089 4090call.disableImsSwitch(0).then(() => { 4091 console.log(`disableImsSwitch success.`); 4092}).catch((err: BusinessError) => { 4093 console.error(`disableImsSwitch fail, promise: err->${JSON.stringify(err)}`); 4094}); 4095``` 4096 4097## call.isImsSwitchEnabled<sup>8+</sup> 4098 4099isImsSwitchEnabled\(slotId: number, callback: AsyncCallback\<boolean\>\): void 4100 4101判断Ims开关是否启用。使用callback异步回调。 4102 4103**系统接口：** 此接口为系统接口。 4104 4105**系统能力**：SystemCapability.Telephony.CallManager 4106 4107**参数：** 4108 4109| 参数名 | 类型 | 必填 | 说明 | 4110| -------- | ---------------------------- | ---- | -------------------------------------- | 4111| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 4112| callback | AsyncCallback<boolean> | 是 | 以回调函数的方式返回判断Ims开关是否启用的结果。true表示Ims开关启用，false表示未启用。 | 4113 4114**错误码：** 4115 4116以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4117 4118| 错误码ID | 错误信息 | 4119| -------- | -------------------------------------------- | 4120| 202 | Non-system applications use system APIs. | 4121| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4122| 8300001 | Invalid parameter value. | 4123| 8300002 | Operation failed. Cannot connect to service. | 4124| 8300003 | System internal error. | 4125| 8300999 | Unknown error code. | 4126 4127**示例：** 4128 4129```ts 4130import { BusinessError } from '@kit.BasicServicesKit'; 4131 4132call.isImsSwitchEnabled(0, (err: BusinessError, data: boolean) => { 4133 if (err) { 4134 console.error(`isImsSwitchEnabled fail, err->${JSON.stringify(err)}`); 4135 } else { 4136 console.log(`isImsSwitchEnabled success, data->${JSON.stringify(data)}`); 4137 } 4138}); 4139``` 4140 4141## call.isImsSwitchEnabled<sup>8+</sup> 4142 4143isImsSwitchEnabled\(slotId: number\): Promise\<boolean\> 4144 4145判断Ims开关是否启用。使用Promise异步回调。 4146 4147**系统接口：** 此接口为系统接口。 4148 4149**系统能力**：SystemCapability.Telephony.CallManager 4150 4151**参数：** 4152 4153| 参数名 | 类型 | 必填 | 说明 | 4154| ------ | ------ | ---- | -------------------------------------- | 4155| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 4156 4157**返回值：** 4158 4159| 类型 | 说明 | 4160| ------------------- | --------------------------- | 4161| Promise<boolean> | 以Promise形式异步返回结果，true表示Ims开关启用，false表示未启用。 | 4162 4163**错误码：** 4164 4165以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4166 4167| 错误码ID | 错误信息 | 4168| -------- | -------------------------------------------- | 4169| 202 | Non-system applications use system APIs. | 4170| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4171| 8300001 | Invalid parameter value. | 4172| 8300002 | Operation failed. Cannot connect to service. | 4173| 8300003 | System internal error. | 4174| 8300999 | Unknown error code. | 4175 4176**示例：** 4177 4178```ts 4179import { BusinessError } from '@kit.BasicServicesKit'; 4180 4181call.isImsSwitchEnabled(0).then((data: boolean) => { 4182 console.log(`isImsSwitchEnabled success, promise: data->${JSON.stringify(data)}`); 4183}).catch((err: BusinessError) => { 4184 console.error(`isImsSwitchEnabled fail, promise: err->${JSON.stringify(err)}`); 4185}); 4186``` 4187 4188## call.isImsSwitchEnabledSync<sup>12+</sup> 4189 4190isImsSwitchEnabledSync\(slotId: number\): boolean 4191 4192判断Ims开关是否启用。调用此API返回结果。 4193 4194**系统接口：** 此接口为系统接口。 4195 4196**系统能力**：SystemCapability.Telephony.CallManager 4197 4198**参数：** 4199 4200| 参数名 | 类型 | 必填 | 说明 | 4201| ------ | ------ | ---- | -------------------------------------- | 4202| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 4203 4204**返回值：** 4205 4206| 类型 | 说明 | 4207| ------- | ---------------------------------------------------- | 4208| boolean | 用来返回结果，true表示Ims开关启用，false表示未启用。 | 4209 4210**错误码：** 4211 4212以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4213 4214| 错误码ID | 错误信息 | 4215| -------- | ------------------------------------------------------------ | 4216| 202 | Non-system applications use system APIs. | 4217| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types; | 4218| 8300001 | Invalid parameter value. | 4219| 8300002 | Operation failed. Cannot connect to service. | 4220| 8300003 | System internal error. | 4221| 8300999 | Unknown error code. | 4222 4223**示例：** 4224 4225<!--code_no_check--> 4226 4227```ts 4228let slotId: number = 0; 4229try { 4230 let isEnabled: boolean = call.isImsSwitchEnabledSync(slotId); 4231 console.log(`isImsSwitchEnabledSync success : ${isEnabled}`); 4232} catch (error) { 4233 console.error(`isImsSwitchEnabledSync fail : err->${JSON.stringify(error)}`); 4234} 4235``` 4236 4237## call.closeUnfinishedUssd<sup>10+</sup> 4238 4239closeUnfinishedUssd\(slotId: number, callback: AsyncCallback\<void\>\): void 4240 4241取消未激活完成的非结构化补充数据业务。使用callback异步回调。 4242 4243**系统接口：** 此接口为系统接口。 4244 4245**需要权限**：ohos.permission.SET_TELEPHONY_STATE 4246 4247**系统能力**：SystemCapability.Telephony.CallManager 4248 4249**参数：** 4250 4251| 参数名 | 类型 | 必填 | 说明 | 4252| -------- | ------------------------- | ---- | -------------------------------------- | 4253| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 4254| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回取消未激活完成的非结构化补充数据业务的结果。 | 4255 4256**错误码：** 4257 4258以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4259 4260| 错误码ID | 错误信息 | 4261| -------- | -------------------------------------------- | 4262| 201 | Permission denied. | 4263| 202 | Non-system applications use system APIs. | 4264| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4265| 8300001 | Invalid parameter value. | 4266| 8300002 | Operation failed. Cannot connect to service. | 4267| 8300003 | System internal error. | 4268| 8300999 | Unknown error code. | 4269 4270**示例：** 4271 4272```ts 4273import { BusinessError } from '@kit.BasicServicesKit'; 4274 4275let slotId: number = 0; 4276call.closeUnfinishedUssd(slotId, (err: BusinessError) => { 4277 if (err) { 4278 console.error(`closeUnfinishedUssd fail, err->${JSON.stringify(err)}`); 4279 } else { 4280 console.log(`closeUnfinishedUssd success.`); 4281 } 4282}); 4283``` 4284 4285## call.closeUnfinishedUssd<sup>10+</sup> 4286 4287closeUnfinishedUssd\(slotId: number\): Promise\<void\> 4288 4289取消未激活完成的非结构化补充数据业务。使用Promise异步回调。 4290 4291**系统接口：** 此接口为系统接口。 4292 4293**需要权限**：ohos.permission.SET_TELEPHONY_STATE 4294 4295**系统能力**：SystemCapability.Telephony.CallManager 4296 4297**参数：** 4298 4299| 参数名 | 类型 | 必填 | 说明 | 4300| ------ | ------ | ---- | -------------------------------------- | 4301| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 4302 4303**返回值：** 4304 4305| 类型 | 说明 | 4306| ------------------- | --------------------------- | 4307| Promise<void> | 以Promise形式异步返回结果。 | 4308 4309**错误码：** 4310 4311以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4312 4313| 错误码ID | 错误信息 | 4314| -------- | -------------------------------------------- | 4315| 201 | Permission denied. | 4316| 202 | Non-system applications use system APIs. | 4317| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4318| 8300001 | Invalid parameter value. | 4319| 8300002 | Operation failed. Cannot connect to service. | 4320| 8300003 | System internal error. | 4321| 8300999 | Unknown error code. | 4322 4323**示例：** 4324 4325```ts 4326import { BusinessError } from '@kit.BasicServicesKit'; 4327 4328let slotId: number = 0; 4329call.closeUnfinishedUssd(slotId).then(() => { 4330 console.log(`closeUnfinishedUssd success.`); 4331}).catch((err: BusinessError) => { 4332 console.error(`closeUnfinishedUssd fail, promise: err->${JSON.stringify(err)}`); 4333}); 4334``` 4335 4336 4337## call.setVoNRState<sup>10+</sup> 4338 4339setVoNRState\(slotId: number, state: VoNRState, callback: AsyncCallback\<void\>\): void 4340 4341设置NR语音的开关状态。使用callback异步回调。 4342 4343**系统接口：** 此接口为系统接口。 4344 4345**需要权限**：ohos.permission.SET_TELEPHONY_STATE 4346 4347**系统能力**：SystemCapability.Telephony.CallManager 4348 4349**参数：** 4350 4351| 参数名 | 类型 | 必填 | 说明 | 4352| ----------- | ----------------------------- | ---- | ---------------------------------------------------- | 4353| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 4354| state | [VoNRState](#vonrstate10) | 是 | 开关状态。 | 4355| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回设置NR语音的开关状态的结果。 | 4356 4357**错误码：** 4358 4359以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4360 4361| 错误码ID | 错误信息 | 4362| -------- | -------------------------------------------- | 4363| 201 | Permission denied. | 4364| 202 | Non-system applications use system APIs. | 4365| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4366| 8300001 | Invalid parameter value. | 4367| 8300002 | Operation failed. Cannot connect to service. | 4368| 8300003 | System internal error. | 4369| 8300999 | Unknown error code. | 4370 4371**示例：** 4372 4373```ts 4374import { BusinessError } from '@kit.BasicServicesKit'; 4375 4376let slotId: number = 0; 4377let state: call.VoNRState = call.VoNRState.VONR_STATE_ON; 4378call.setVoNRState(slotId, state, (err: BusinessError) => { 4379 if (err) { 4380 console.error(`setVoNRState fail, err->${JSON.stringify(err)}`); 4381 } else { 4382 console.log(`setVoNRState success`); 4383 } 4384}); 4385``` 4386 4387 4388## call.setVoNRState<sup>10+</sup> 4389 4390setVoNRState\(slotId: number, state: VoNRState\): Promise\<void\> 4391 4392设置NR语音的开关状态。使用Promise异步回调。 4393 4394**系统接口：** 此接口为系统接口。 4395 4396**需要权限**：ohos.permission.SET_TELEPHONY_STATE 4397 4398**系统能力**：SystemCapability.Telephony.CallManager 4399 4400**参数：** 4401 4402| 参数名 | 类型 | 必填 | 说明 | 4403| ----------- | ----------------------------- | ---- | ------------------------------------------- | 4404| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2。 | 4405| state | [VoNRState](#vonrstate10) | 是 | 开关状态。 | 4406 4407**返回值：** 4408 4409| 类型 | 说明 | 4410| ---------------------- | --------------------------------------------- | 4411| Promise<void> | 以Promise形式异步返回结果。 | 4412 4413**错误码：** 4414 4415以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4416 4417| 错误码ID | 错误信息 | 4418| -------- | -------------------------------------------- | 4419| 201 | Permission denied. | 4420| 202 | Non-system applications use system APIs. | 4421| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4422| 8300001 | Invalid parameter value. | 4423| 8300002 | Operation failed. Cannot connect to service. | 4424| 8300003 | System internal error. | 4425| 8300999 | Unknown error code. | 4426 4427**示例：** 4428 4429```ts 4430import { BusinessError } from '@kit.BasicServicesKit'; 4431 4432let slotId: number = 0; 4433let state: call.VoNRState = call.VoNRState.VONR_STATE_ON; 4434call.setVoNRState(slotId, state).then(() => { 4435 console.log(`setVoNRState success`); 4436}).catch((err: BusinessError) => { 4437 console.error(`setVoNRState fail, promise: err->${JSON.stringify(err)}`); 4438}); 4439``` 4440 4441 4442## call.getVoNRState<sup>10+</sup> 4443 4444getVoNRState\(slotId: number, callback: AsyncCallback\<VoNRState\>\): void 4445 4446查询NR语音的开关状态。使用callback异步回调。 4447 4448**系统接口：** 此接口为系统接口。 4449 4450**需要权限**：ohos.permission.GET_TELEPHONY_STATE 4451 4452**系统能力**：SystemCapability.Telephony.CallManager 4453 4454**参数：** 4455 4456| 参数名 | 类型 | 必填 | 说明 | 4457| ----------- | --------------------------------------------- | ---- | ------------------------------------------------------ | 4458| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 4459| callback | AsyncCallback<[VoNRState](#vonrstate10)>| 是 | 回调函数。返回NR语音开关的状态。 | 4460 4461**错误码：** 4462 4463以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4464 4465| 错误码ID | 错误信息 | 4466| -------- | -------------------------------------------- | 4467| 201 | Permission denied. | 4468| 202 | Non-system applications use system APIs. | 4469| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4470| 8300001 | Invalid parameter value. | 4471| 8300002 | Operation failed. Cannot connect to service. | 4472| 8300003 | System internal error. | 4473| 8300999 | Unknown error code. | 4474 4475**示例：** 4476 4477```ts 4478import { BusinessError } from '@kit.BasicServicesKit'; 4479 4480let slotId: number = 0; 4481call.getVoNRState(slotId, (err: BusinessError, data: call.VoNRState) => { 4482 if (err) { 4483 console.error(`getVoNRState fail, err->${JSON.stringify(err)}`); 4484 } else { 4485 console.log(`getVoNRState success, data->${JSON.stringify(data)}`); 4486 } 4487}); 4488``` 4489 4490 4491## call.getVoNRState<sup>10+</sup> 4492 4493getVoNRState\(slotId: number\): Promise\<VoNRState\> 4494 4495查询NR语音的开关状态。使用Promise异步回调。 4496 4497**系统接口：** 此接口为系统接口。 4498 4499**需要权限**：ohos.permission.GET_TELEPHONY_STATE 4500 4501**系统能力**：SystemCapability.Telephony.CallManager 4502 4503**参数：** 4504 4505| 参数名 | 类型 | 必填 | 说明 | 4506| ----------- | ----------------------------- | ---- | ------------------------------------------- | 4507| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2。 | 4508 4509**返回值：** 4510 4511| 类型 | 说明 | 4512| ---------------------------------------- | ------------------------------------------- | 4513| Promise<[VoNRState](#vonrstate10)> | 以Promise形式异步返回开关状态。 | 4514 4515**错误码：** 4516 4517以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4518 4519| 错误码ID | 错误信息 | 4520| -------- | -------------------------------------------- | 4521| 201 | Permission denied. | 4522| 202 | Non-system applications use system APIs. | 4523| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4524| 8300001 | Invalid parameter value. | 4525| 8300002 | Operation failed. Cannot connect to service. | 4526| 8300003 | System internal error. | 4527| 8300999 | Unknown error code. | 4528 4529**示例：** 4530 4531```ts 4532import { BusinessError } from '@kit.BasicServicesKit'; 4533 4534let slotId: number = 0; 4535call.getVoNRState(slotId).then((data: call.VoNRState) => { 4536 console.log(`getVoNRState success, promise: data->${JSON.stringify(data)}`); 4537}).catch((err: BusinessError) => { 4538 console.error(`getVoNRState fail, promise: err->${JSON.stringify(err)}`); 4539}); 4540``` 4541 4542 4543## call.canSetCallTransferTime<sup>10+</sup> 4544 4545canSetCallTransferTime\(slotId: number, callback: AsyncCallback\<boolean\>\): void 4546 4547检查是否可以设置呼叫转移时间。使用callback异步回调。 4548 4549**系统接口：** 此接口为系统接口。 4550 4551**需要权限**：ohos.permission.GET_TELEPHONY_STATE 4552 4553**系统能力**：SystemCapability.Telephony.CallManager 4554 4555**参数：** 4556 4557| 参数名 | 类型 | 必填 | 说明 | 4558| ----------- | ----------------------------- | ---- | ----------------------------------------------------- | 4559| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 4560| callback | AsyncCallback<boolean> | 是 | 回调函数。返回true表示可以设置，返回false表示不可以设置。| 4561 4562**错误码：** 4563 4564以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4565 4566| 错误码ID | 错误信息 | 4567| -------- | -------------------------------------------- | 4568| 201 | Permission denied. | 4569| 202 | Non-system applications use system APIs. | 4570| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4571| 8300001 | Invalid parameter value. | 4572| 8300002 | Operation failed. Cannot connect to service. | 4573| 8300003 | System internal error. | 4574| 8300999 | Unknown error code. | 4575 4576**示例：** 4577 4578```ts 4579import { BusinessError } from '@kit.BasicServicesKit'; 4580 4581let slotId: number = 0; 4582call.canSetCallTransferTime(slotId, (err: BusinessError, data: boolean) => { 4583 if (err) { 4584 console.error(`canSetCallTransferTime fail, err->${JSON.stringify(err)}`); 4585 } else { 4586 console.log(`canSetCallTransferTime success, data->${JSON.stringify(data)}`); 4587 } 4588}); 4589``` 4590 4591 4592## call.canSetCallTransferTime<sup>10+</sup> 4593 4594canSetCallTransferTime\(slotId: number\): Promise\<boolean\> 4595 4596检查是否可以设置呼叫转移时间。使用Promise异步回调。 4597 4598**系统接口：** 此接口为系统接口。 4599 4600**需要权限**：ohos.permission.GET_TELEPHONY_STATE 4601 4602**系统能力**：SystemCapability.Telephony.CallManager 4603 4604**参数：** 4605 4606| 参数名 | 类型 | 必填 | 说明 | 4607| ----------- | ----------------------------- | ---- | ------------------------------------------- | 4608| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2。 | 4609 4610**返回值：** 4611 4612| 类型 | 说明 | 4613| ---------------------- | --------------------------------------------- | 4614| Promise<boolean> | 以Promise形式异步返回是否可以设置呼叫转移时间。返回true表示可以设置，返回false表示不可以设置。 | 4615 4616**错误码：** 4617 4618以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4619 4620| 错误码ID | 错误信息 | 4621| -------- | -------------------------------------------- | 4622| 201 | Permission denied. | 4623| 202 | Non-system applications use system APIs. | 4624| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4625| 8300001 | Invalid parameter value. | 4626| 8300002 | Operation failed. Cannot connect to service. | 4627| 8300003 | System internal error. | 4628| 8300999 | Unknown error code. | 4629 4630**示例：** 4631 4632```ts 4633import { BusinessError } from '@kit.BasicServicesKit'; 4634 4635let slotId: number = 0; 4636call.canSetCallTransferTime(slotId).then((data: boolean) => { 4637 console.log(`canSetCallTransferTime success, promise: data->${JSON.stringify(data)}`); 4638}).catch((err: BusinessError) => { 4639 console.error(`canSetCallTransferTime fail, promise: err->${JSON.stringify(err)}`); 4640}); 4641``` 4642 4643 4644## call.inputDialerSpecialCode<sup>10+</sup> 4645 4646inputDialerSpecialCode\(inputCode: string, callback: AsyncCallback\<void\>\): void 4647 4648暗码广播。使用callback异步回调。 4649 4650**系统接口：** 此接口为系统接口。 4651 4652**需要权限**：ohos.permission.PLACE_CALL 4653 4654**系统能力**：SystemCapability.Telephony.CallManager 4655 4656**参数：** 4657 4658| 参数名 | 类型 | 必填 | 说明 | 4659| ----------- | ---------------------------- | ---- | ----------------------------------------- | 4660| inputCode | string | 是 | 暗码。支持暗码字段, 如：*#*#2846579#*#*(工程菜单)。 | 4661| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回暗码广播的结果。 | 4662 4663**错误码：** 4664 4665以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4666 4667| 错误码ID | 错误信息 | 4668| -------- | -------------------------------------------- | 4669| 201 | Permission denied. | 4670| 202 | Non-system applications use system APIs. | 4671| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4672| 8300001 | Invalid parameter value. | 4673| 8300002 | Operation failed. Cannot connect to service. | 4674| 8300003 | System internal error. | 4675 4676**示例：** 4677 4678```ts 4679import { BusinessError } from '@kit.BasicServicesKit'; 4680 4681call.inputDialerSpecialCode('*#*#2846579#*#*', (err: BusinessError) => { 4682 if (err) { 4683 console.error(`inputDialerSpecialCode fail, err->${JSON.stringify(err)}`); 4684 } else { 4685 console.log(`inputDialerSpecialCode success`); 4686 } 4687}); 4688``` 4689 4690## call.inputDialerSpecialCode<sup>10+</sup> 4691 4692inputDialerSpecialCode\(inputCode: string\): Promise\<void\> 4693 4694暗码广播。使用Promise异步回调。 4695 4696**系统接口：** 此接口为系统接口。 4697 4698**需要权限**：ohos.permission.PLACE_CALL 4699 4700**系统能力**：SystemCapability.Telephony.CallManager 4701 4702**参数：** 4703 4704| 参数名 | 类型 | 必填 | 说明 | 4705| ----------- | ---------------------------- | ---- | ----------------------------------------- | 4706| inputCode | string | 是 | 暗码。支持暗码字段, 如：*#*#2846579#*#*(工程菜单)。 | 4707 4708**返回值：** 4709 4710| 类型 | 说明 | 4711| ------------------- | --------------------------- | 4712| Promise<void> | 以Promise形式异步返回结果。 | 4713 4714**错误码：** 4715 4716以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4717 4718| 错误码ID | 错误信息 | 4719| -------- | -------------------------------------------- | 4720| 201 | Permission denied. | 4721| 202 | Non-system applications use system APIs. | 4722| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4723| 8300001 | Invalid parameter value. | 4724| 8300002 | Operation failed. Cannot connect to service. | 4725| 8300003 | System internal error. | 4726 4727**示例：** 4728 4729```ts 4730import { BusinessError } from '@kit.BasicServicesKit'; 4731 4732try { 4733 call.inputDialerSpecialCode('*#*#2846579#*#*'); 4734 console.log(`inputDialerSpecialCode success`); 4735} catch (error) { 4736 console.error(`inputDialerSpecialCode fail, promise: err->${JSON.stringify(error)}`); 4737} 4738``` 4739 4740 4741## call.removeMissedIncomingCallNotification<sup>10+</sup> 4742 4743removeMissedIncomingCallNotification\(callback: AsyncCallback\<void\>\): void 4744 4745删除未接来电通知。使用callback异步回调。 4746 4747**系统接口：** 此接口为系统接口。 4748 4749**需要权限**：ohos.permission.SET_TELEPHONY_STATE, ohos.permission.READ_CALL_LOG 和 ohos.permission.WRITE_CALL_LOG 4750 4751**系统能力**：SystemCapability.Telephony.CallManager 4752 4753**参数：** 4754 4755| 参数名 | 类型 | 必填 | 说明 | 4756| ----------- | ---------------------------- | ---- | --------------------------------------- | 4757| callback | AsyncCallback<void> | 是 | 以回调函数的方式返回删除未接来电通知的结果。 | 4758 4759**错误码：** 4760 4761以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4762 4763| 错误码ID | 错误信息 | 4764| -------- | -------------------------------------------- | 4765| 201 | Permission denied. | 4766| 202 | Non-system applications use system APIs. | 4767| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 4768| 8300002 | Operation failed. Cannot connect to service. | 4769| 8300003 | System internal error. | 4770| 8300999 | Unknown error code. | 4771 4772**示例：** 4773 4774```ts 4775import { BusinessError } from '@kit.BasicServicesKit'; 4776 4777call.removeMissedIncomingCallNotification((err: BusinessError) => { 4778 if (err) { 4779 console.error(`removeMissedIncomingCallNotification failed, err->${JSON.stringify(err)}`); 4780 } else { 4781 console.log(`removeMissedIncomingCallNotification success`); 4782 } 4783}); 4784``` 4785 4786 4787## call.removeMissedIncomingCallNotification<sup>10+</sup> 4788 4789removeMissedIncomingCallNotification\(\): Promise\<void\> 4790 4791删除未接来电通知。使用Promise异步回调。 4792 4793**系统接口：** 此接口为系统接口。 4794 4795**需要权限**：ohos.permission.SET_TELEPHONY_STATE, ohos.permission.READ_CALL_LOG 和 ohos.permission.WRITE_CALL_LOG 4796 4797**系统能力**：SystemCapability.Telephony.CallManager 4798 4799**返回值：** 4800 4801| 类型 | 说明 | 4802| ------------------- | --------------------------- | 4803| Promise<void> | 以Promise形式异步返回结果。 | 4804 4805**错误码：** 4806 4807以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4808 4809| 错误码ID | 错误信息 | 4810| -------- | -------------------------------------------- | 4811| 201 | Permission denied. | 4812| 202 | Non-system applications use system APIs. | 4813| 8300002 | Operation failed. Cannot connect to service. | 4814| 8300003 | System internal error. | 4815| 8300999 | Unknown error code. | 4816 4817**示例：** 4818 4819```ts 4820import { BusinessError } from '@kit.BasicServicesKit'; 4821 4822call.removeMissedIncomingCallNotification().then(() => { 4823 console.log(`removeMissedIncomingCallNotification success`); 4824}).catch((err: BusinessError) => { 4825 console.error(`removeMissedIncomingCallNotification failed, promise: err->${JSON.stringify(err)}`); 4826}); 4827``` 4828 4829## call.sendCallUiEvent<sup>12+</sup> 4830 4831sendCallUiEvent\(callId: number, eventName: string\): Promise\<void\> 4832 4833发布通话界面事件。使用Promise异步回调。 4834 4835**系统接口：** 此接口为系统接口。 4836 4837**需要权限**：ohos.permission.SET_TELEPHONY_STATE 4838 4839**系统能力**：SystemCapability.Telephony.CallManager 4840 4841**参数：** 4842 4843| 参数名 | 类型 | 必填 | 说明 | 4844| --------- | ------ | ---- | -------- | 4845| callId | number | 是 | 呼叫Id。 | 4846| eventName | string | 是 | 事件名称。 | 4847 4848**返回值：** 4849 4850| 类型 | 说明 | 4851| ------------------- | ----------------------- | 4852| Promise<void> | 以Promise形式异步返回。 | 4853 4854**错误码：** 4855 4856以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 4857 4858| 错误码ID | 错误信息 | 4859| -------- | -------------------------------------------- | 4860| 202 | Non-system applications use system APIs. | 4861| 401 | Parameter error. | 4862| 801 | Capability not supported. | 4863| 8300001 | Invalid parameter value. | 4864| 8300002 | Operation failed. Cannot connect to service. | 4865| 8300003 | System internal error. | 4866 4867**示例：** 4868 4869```ts 4870import { BusinessError } from '@kit.BasicServicesKit'; 4871 4872let callId: number = 0; 4873call.sendCallUiEvent(callId, 'eventName').then(() => { 4874 console.log(`sendCallUiEvent success.`); 4875}).catch((err: BusinessError) => { 4876 console.error(`sendCallUiEvent fail, promise: err->${JSON.stringify(err)}`); 4877}); 4878``` 4879 4880## DialOptions 4881 4882拨打电话的可选参数。 4883 4884**系统能力**：SystemCapability.Telephony.CallManager 4885 4886| 名称 | 类型 | 必填 | 说明 | 4887| ------------------------ | ---------------------------------- | ---- | ----------------------------------------------------------------------------------------------- | 4888| accountId <sup>8+</sup> | number | 否 | 帐户Id。<br/>- 0：卡槽1<br/>- 1：卡槽2<br/>。此接口为系统接口。 | 4889| videoState <sup>8+</sup> | [VideoStateType](#videostatetype7) | 否 | 视频状态类型。此接口为系统接口。 | 4890| dialScene <sup>8+</sup> | [DialScene](#dialscene8) | 否 | 拨号场景。此接口为系统接口。 | 4891| dialType <sup>8+</sup> | [DialType](#dialtype8) | 否 | 拨号类型。此接口为系统接口。 | 4892 4893## DialCallOptions<sup>9+</sup> 4894 4895拨打电话的可选参数。 4896 4897**系统接口：** 此接口为系统接口。 4898 4899**系统能力**：SystemCapability.Telephony.CallManager 4900 4901| 名称 | 类型 | 必填 | 说明 | 4902| ------------------------ | ---------------------------------- | ---- | ------------------------------------------- | 4903| accountId <sup>9+</sup> | number | 否 | 帐户Id。<br/>- 0：卡槽1<br/>- 1：卡槽2<br/>。| 4904| videoState <sup>9+</sup> | [VideoStateType](#videostatetype7) | 否 | 视频状态类型。 | 4905| dialScene <sup>9+</sup> | [DialScene](#dialscene8) | 否 | 拨号场景。 | 4906| dialType <sup>9+</sup> | [DialType](#dialtype8) | 否 | 拨号类型。 | 4907 4908 4909## ImsCallMode<sup>8+</sup> 4910 4911IP多媒体系统调用模式。 4912 4913**系统接口：** 此接口为系统接口。 4914 4915**系统能力**：SystemCapability.Telephony.CallManager 4916 4917| 名称 | 值 | 说明 | 4918| ---------------------- | ---- | ------------------ | 4919| CALL_MODE_AUDIO_ONLY | 0 | 仅限音频呼叫 | 4920| CALL_MODE_SEND_ONLY | 1 | 仅发送呼叫 | 4921| CALL_MODE_RECEIVE_ONLY | 2 | 仅接收呼叫 | 4922| CALL_MODE_SEND_RECEIVE | 3 | 允许发送和接收呼叫 | 4923| CALL_MODE_VIDEO_PAUSED | 4 | 暂停视频呼叫 | 4924 4925## VoNRState<sup>10+</sup> 4926 49275G语音开关状态。 4928 4929**系统接口：** 此接口为系统接口。 4930 4931**系统能力**：SystemCapability.Telephony.CallManager 4932 4933| 名称 | 值 | 说明 | 4934| ---------------------- | ---- | ----------------- | 4935| VONR_STATE_OFF | 0 | 关闭状态 | 4936| VONR_STATE_ON | 1 | 打开状态 | 4937 4938## AudioDevice<sup>10+</sup> 4939 4940音频设备。 4941 4942**系统接口：** 此接口为系统接口。 4943 4944**系统能力**：SystemCapability.Telephony.CallManager 4945 4946| 名称 | 类型 | 必填 | 说明 | 4947| --------------------------------- | ------------------------------------- | ---- | ---------------- | 4948| deviceType <sup>10+</sup> | [AudioDeviceType](#audiodevicetype10) | 是 | 音频设备类型。 | 4949| address <sup>10+</sup> | string | 否 | 音频设备地址。 | 4950| deviceName <sup>11+</sup> | string | 否 | 音频设备名称。 | 4951 4952## AudioDeviceType<sup>10+</sup> 4953 4954音频设备类型。 4955 4956**系统接口：** 此接口为系统接口。 4957 4958**系统能力**：SystemCapability.Telephony.CallManager 4959 4960| 名称 | 值 | 说明 | 4961| -------------------- | ---- | ----------- | 4962| DEVICE_EARPIECE | 0 | 耳机设备 | 4963| DEVICE_SPEAKER | 1 | 扬声器设备 | 4964| DEVICE_WIRED_HEADSET | 2 | 有线耳机设备 | 4965| DEVICE_BLUETOOTH_SCO | 3 | 蓝牙SCO设备 | 4966| DEVICE_DISTRIBUTED_AUTOMOTIVE<sup>11+</sup> | 4 | 分布式车机设备| 4967 4968## AudioDeviceCallbackInfo<sup>10+</sup> 4969 4970音频设备信息。 4971 4972**系统接口：** 此接口为系统接口。 4973 4974**系统能力**：SystemCapability.Telephony.CallManager 4975 4976| 名称 | 类型 | 必填 | 说明 | 4977| --------------------------------- | ------------------------------------- | ---- | ---------------- | 4978| audioDeviceList <sup>10+</sup> | [Array\<AudioDevice\>](#audiodevice10) | 是 | 音频设备列表。 | 4979| currentAudioDevice <sup>10+</sup> | [AudioDevice](#audiodevice10) | 是 | 当前音频设备。 | 4980| isMuted <sup>10+</sup> | boolean | 是 | 是否静音。 | 4981 4982 4983## CallRestrictionType<sup>8+</sup> 4984 4985呼叫限制类型。 4986 4987**系统接口：** 此接口为系统接口。 4988 4989**系统能力**：SystemCapability.Telephony.CallManager 4990 4991| 名称 | 值 | 说明 | 4992| --------------------------------------------- | ---- | -------------------------- | 4993| RESTRICTION_TYPE_ALL_INCOMING | 0 | 限制所有呼入 | 4994| RESTRICTION_TYPE_ALL_OUTGOING | 1 | 限制所有呼出 | 4995| RESTRICTION_TYPE_INTERNATIONAL | 2 | 限制国际通话 | 4996| RESTRICTION_TYPE_INTERNATIONAL_EXCLUDING_HOME | 3 | 限制除归属国以外的国际通话 | 4997| RESTRICTION_TYPE_ROAMING_INCOMING | 4 | 限制漫游呼入 | 4998| RESTRICTION_TYPE_ALL_CALLS | 5 | 限制所有通话 | 4999| RESTRICTION_TYPE_OUTGOING_SERVICES | 6 | 限制传出业务 | 5000| RESTRICTION_TYPE_INCOMING_SERVICES | 7 | 限制呼入业务 | 5001 5002## CallTransferInfo<sup>8+</sup> 5003 5004呼叫转移信息。 5005 5006**系统接口：** 此接口为系统接口。 5007 5008**系统能力**：SystemCapability.Telephony.CallManager 5009 5010| 名称 | 类型 | 必填 | 说明 | 5011| ------------------------ | ---------------------------------------------------- | ---- | ---------------- | 5012| transferNum | string | 是 | 转移编号 | 5013| type | [CallTransferType](#calltransfertype8) | 是 | 呼叫转移类型 | 5014| settingType | [CallTransferSettingType](#calltransfersettingtype8) | 是 | 设置呼叫转移类型 | 5015| startHour<sup>9+</sup> | number | 否 | 开始时间的小时数 | 5016| startMinute<sup>9+</sup> | number | 否 | 开始时间的分钟数 | 5017| endHour<sup>9+</sup> | number | 否 | 结束时间的小时数 | 5018| endMinute<sup>9+</sup> | number | 否 | 结束时间的分钟数 | 5019 5020## CallTransferType<sup>8+</sup> 5021 5022呼叫转移类型。 5023 5024**系统接口：** 此接口为系统接口。 5025 5026**系统能力**：SystemCapability.Telephony.CallManager 5027 5028| 名称 | 值 | 说明 | 5029| --------------------------- | ---- | ------------ | 5030| TRANSFER_TYPE_UNCONDITIONAL | 0 | 无条件转移 | 5031| TRANSFER_TYPE_BUSY | 1 | 忙线转移 | 5032| TRANSFER_TYPE_NO_REPLY | 2 | 无回复转移 | 5033| TRANSFER_TYPE_NOT_REACHABLE | 3 | 无法访问转移 | 5034 5035## CallTransferSettingType<sup>8+</sup> 5036 5037设置呼叫转移类型。 5038 5039**系统接口：** 此接口为系统接口。 5040 5041**系统能力**：SystemCapability.Telephony.CallManager 5042 5043| 名称 | 值 | 说明 | 5044| -------------------------- | ---- | ------------ | 5045| CALL_TRANSFER_DISABLE | 0 | 禁用呼叫转移 | 5046| CALL_TRANSFER_ENABLE | 1 | 启用呼叫转移 | 5047| CALL_TRANSFER_REGISTRATION | 3 | 登记呼叫转移 | 5048| CALL_TRANSFER_ERASURE | 4 | 消除呼叫转移 | 5049 5050## CallAttributeOptions<sup>7+</sup> 5051 5052调用属性选项。 5053 5054**系统接口：** 此接口为系统接口。 5055 5056**系统能力**：SystemCapability.Telephony.CallManager 5057 5058| 名称 | 类型 | 必填 | 说明 | 5059| --------------- | ---------------------------------------- | ---- | -------------- | 5060| accountNumber | string | 是 | 帐号号码 | 5061| speakerphoneOn | boolean | 是 | 扬声器接通电话 | 5062| accountId | number | 是 | 帐户Id | 5063| videoState | [VideoStateType](#videostatetype7) | 是 | 视频状态类型 | 5064| startTime | number | 是 | 开始时间 | 5065| isEcc | boolean | 是 | 是否是Ecc | 5066| callType | [CallType](#calltype7) | 是 | 通话类型 | 5067| callId | number | 是 | 呼叫Id | 5068| callState | [DetailedCallState](#detailedcallstate7) | 是 | 详细呼叫状态 | 5069| conferenceState | [ConferenceState](#conferencestate7) | 是 | 会议状态 | 5070| voipCallAttribute<sup>11+</sup> | [VoipCallAttribute](#voipcallattribute11) | 否 | VoIP通话信息 | 5071| crsType<sup>11+</sup> | number | 是 | 视频彩振类型| 5072| originalCallType<sup>11+</sup> | number | 是 | 视频彩振原始呼叫类型| 5073| numberLocation<sup>12+</sup> | string | 否 | 号码归属地信息 | 5074| numberMarkInfo<sup>12+</sup> | [NumberMarkInfo](#numbermarkinfo12) | 否 | 号码标记信息 | 5075 5076## VoipCallAttribute<sup>11+</sup> 5077 5078VoIP通话信息。 5079 5080**系统接口：** 此接口为系统接口。 5081 5082**系统能力**：SystemCapability.Telephony.CallManager 5083 5084| 名称 | 类型 | 必填 | 说明 | 5085| --------------- | ------------------- | ---- | -------------- | 5086| voipCallId | string | 是 | VoIP通话唯一Id | 5087| userName | string | 是 | 用户昵称 | 5088| userProfile | [image.PixelMap](../apis-image-kit/js-apis-image.md#pixelmap7) | 是 | 用户头像图片 | 5089| extensionId | string | 是 | 三方应用进程Id | 5090| abilityName | string | 是 | 需加载的三方应用的界面ability | 5091| voipBundleName | string | 是 | 三方应用包名 | 5092| showBannerForIncomingCall<sup>12+</sup> | boolean | 否 | 上报来电时是否显示来电横幅 | 5093| isConferenceCall<sup>12+</sup> | boolean | 否 | 上报是否是电话会议 | 5094| isVoiceAnswerSupported<sup>12+</sup> | boolean | 否 | 上报来电时是否支持语音接听 | 5095 5096## ConferenceState<sup>7+</sup> 5097 5098会议状态。 5099 5100**系统接口：** 此接口为系统接口。 5101 5102**系统能力**：SystemCapability.Telephony.CallManager 5103 5104| 名称 | 值 | 说明 | 5105| ---------------------------- | ---- | -------------- | 5106| TEL_CONFERENCE_IDLE | 0 | 电话会议空闲 | 5107| TEL_CONFERENCE_ACTIVE | 1 | 电话会议激活 | 5108| TEL_CONFERENCE_DISCONNECTING | 2 | 电话会议断开 | 5109| TEL_CONFERENCE_DISCONNECTED | 3 | 电话会议已断开 | 5110 5111## CallType<sup>7+</sup> 5112 5113通话类型。 5114 5115**系统接口：** 此接口为系统接口。 5116 5117**系统能力**：SystemCapability.Telephony.CallManager 5118 5119| 名称 | 值 | 说明 | 5120| ------------- | ---- | ------------ | 5121| TYPE_CS | 0 | CS通话 | 5122| TYPE_IMS | 1 | IMS通话 | 5123| TYPE_OTT | 2 | OTT通话 | 5124| TYPE_ERR_CALL | 3 | 其他类型通话 | 5125| TYPE_VOIP<sup>11+</sup> | 4 | VoIP通话 | 5126 5127## VideoStateType<sup>7+</sup> 5128 5129视频状态类型。 5130 5131**系统接口：** 此接口为系统接口。 5132 5133**系统能力**：SystemCapability.Telephony.CallManager 5134 5135| 名称 | 值 | 说明 | 5136| ------------------------------------- | ---- | --------| 5137| TYPE_VOICE | 0 | 语音状态。 | 5138| TYPE_VIDEO_SEND_ONLY<sup>11+</sup> | 1 | 视频通话只发送数据状态。 | 5139| TYPE_VIDEO_RECEIVE_ONLY<sup>11+</sup> | 2 | 视频通话只接收数据状态。 | 5140| TYPE_VIDEO | 3 | 视频状态。 | 5141| TYPE_VIDEO_BIDIRECTIONAL<sup>11+</sup>| 4 | 视频通话接收发送数据状态。| 5142 5143## DetailedCallState<sup>7+</sup> 5144 5145详细的呼叫状态。 5146 5147**系统接口：** 此接口为系统接口。 5148 5149**系统能力**：SystemCapability.Telephony.CallManager 5150 5151| 名称 | 值 | 说明 | 5152| ------------------------- | ---- | -------------- | 5153| CALL_STATUS_ACTIVE | 0 | 激活呼叫状态 | 5154| CALL_STATUS_HOLDING | 1 | 保持呼叫状态 | 5155| CALL_STATUS_DIALING | 2 | 呼叫状态拨号 | 5156| CALL_STATUS_ALERTING | 3 | 电话报警状态 | 5157| CALL_STATUS_INCOMING | 4 | 呼叫传入状态 | 5158| CALL_STATUS_WAITING | 5 | 呼叫等待状态 | 5159| CALL_STATUS_DISCONNECTED | 6 | 呼叫状态已断开 | 5160| CALL_STATUS_DISCONNECTING | 7 | 呼叫状态断开 | 5161| CALL_STATUS_IDLE | 8 | 呼叫状态空闲 | 5162 5163## CallRestrictionInfo<sup>8+</sup> 5164 5165呼叫限制信息。 5166 5167**系统接口：** 此接口为系统接口。 5168 5169**系统能力**：SystemCapability.Telephony.CallManager 5170 5171| 名称 | 类型 | 必填 | 说明 | 5172| -------- | -------------------------------------------- | ---- | ------------ | 5173| type | [CallRestrictionType](#callrestrictiontype8) | 是 | 呼叫限制类型 | 5174| password | string | 是 | 密码 | 5175| mode | [CallRestrictionMode](#callrestrictionmode8) | 是 | 呼叫限制模式 | 5176 5177## CallRestrictionMode<sup>8+</sup> 5178 5179呼叫限制模式。 5180 5181**系统接口：** 此接口为系统接口。 5182 5183**系统能力**：SystemCapability.Telephony.CallManager 5184 5185| 名称 | 值 | 说明 | 5186| ----------------------------- | ---- | ------------ | 5187| RESTRICTION_MODE_DEACTIVATION | 0 | 限制模式停用 | 5188| RESTRICTION_MODE_ACTIVATION | 1 | 限制模式激活 | 5189 5190## CallEventOptions<sup>8+</sup> 5191 5192呼叫事件的可选参数。 5193 5194**系统接口：** 此接口为系统接口。 5195 5196**系统能力**：SystemCapability.Telephony.CallManager 5197 5198| 名称 | 类型 | 必填 | 说明 | 5199| ------- | ------------------------------------------ | ---- | -------------- | 5200| eventId | [CallAbilityEventId](#callabilityeventid8) | 是 | 呼叫能力事件Id | 5201 5202## CallAbilityEventId<sup>8+</sup> 5203 5204呼叫能力事件Id。 5205 5206**系统接口：** 此接口为系统接口。 5207 5208**系统能力**：SystemCapability.Telephony.CallManager 5209 5210| 名称 | 值 | 说明 | 5211| ------------------------------------- | ---- | --------------- | 5212| EVENT_DIAL_NO_CARRIER | 1 | 拨号无载波事件 | 5213| EVENT_INVALID_FDN_NUMBER | 2 | 无效的FDN号事件 | 5214| EVENT_HOLD_CALL_FAILED<sup>11+</sup> | 3 | 保持通话失败事件 | 5215| EVENT_SWAP_CALL_FAILED<sup>11+</sup> | 4 | 保持当前通话并接听等待中电话失败事件 | 5216| EVENT_COMBINE_CALL_FAILED<sup>11+</sup> | 5 | 合并通话失败 | 5217| EVENT_SPLIT_CALL_FAILED<sup>11+</sup> | 6 | 分离通话失败 | 5218| EVENT_SHOW_FULL_SCREEN<sup>12+</sup> | 7 | 全屏显示通话界面 | 5219| EVENT_SHOW_FLOAT_WINDOW<sup>12+</sup> | 8 | 悬浮窗显示通话界面 | 5220 5221## DialScene<sup>8+</sup> 5222 5223拨号场景。 5224 5225**系统接口：** 此接口为系统接口。 5226 5227**系统能力**：SystemCapability.Telephony.CallManager 5228 5229| 名称 | 值 | 说明 | 5230| --------------- | ---- | ------------ | 5231| CALL_NORMAL | 0 | 呼叫正常 | 5232| CALL_PRIVILEGED | 1 | 呼叫特权 | 5233| CALL_EMERGENCY | 2 | 拨打紧急电话 | 5234 5235## DialType<sup>8+</sup> 5236 5237拨号类型。 5238 5239**系统接口：** 此接口为系统接口。 5240 5241**系统能力**：SystemCapability.Telephony.CallManager 5242 5243| 名称 | 值 | 说明 | 5244| -------------------- | ---- | ---------------- | 5245| DIAL_CARRIER_TYPE | 0 | 载波拨号类型 | 5246| DIAL_VOICE_MAIL_TYPE | 1 | 语音邮件拨号类型 | 5247| DIAL_OTT_TYPE | 2 | OTT拨号类型 | 5248 5249## RejectMessageOptions<sup>7+</sup> 5250 5251拒绝消息可选参数。 5252 5253**系统接口：** 此接口为系统接口。 5254 5255**系统能力**：SystemCapability.Telephony.CallManager 5256 5257| 名称 | 类型 | 必填 | 说明 | 5258| -------------- | ------ | ---- | -------- | 5259| messageContent | string | 是 | 消息内容 | 5260 5261## CallTransferResult<sup>8+</sup> 5262 5263呼叫转移结果。 5264 5265**系统接口：** 此接口为系统接口。 5266 5267**系统能力**：SystemCapability.Telephony.CallManager 5268 5269| 名称 | 类型 | 必填 | 说明 | 5270| ------------------------ | ---------------------------------- | ---- | ---------------- | 5271| status | [TransferStatus](#transferstatus8) | 是 | 转移状态 | 5272| number | string | 是 | 号码 | 5273| startHour<sup>9+</sup> | number | 是 | 开始时间的小时数 | 5274| startMinute<sup>9+</sup> | number | 是 | 开始时间的分钟数 | 5275| endHour<sup>9+</sup> | number | 是 | 结束时间的小时数 | 5276| endMinute<sup>9+</sup> | number | 是 | 结束时间的分钟数 | 5277 5278## CallWaitingStatus<sup>7+</sup> 5279 5280呼叫等待状态。 5281 5282**系统接口：** 此接口为系统接口。 5283 5284**系统能力**：SystemCapability.Telephony.CallManager 5285 5286| 名称 | 值 | 说明 | 5287| -------------------- | ---- | ------------ | 5288| CALL_WAITING_DISABLE | 0 | 禁用呼叫等待 | 5289| CALL_WAITING_ENABLE | 1 | 启用呼叫等待 | 5290 5291## RestrictionStatus<sup>8+</sup> 5292 5293限制状态。 5294 5295**系统接口：** 此接口为系统接口。 5296 5297**系统能力**：SystemCapability.Telephony.CallManager 5298 5299| 名称 | 值 | 说明 | 5300| ------------------- | ---- | -------- | 5301| RESTRICTION_DISABLE | 0 | 禁用限制 | 5302| RESTRICTION_ENABLE | 1 | 启用限制 | 5303 5304## TransferStatus<sup>8+</sup> 5305 5306转移状态。 5307 5308**系统接口：** 此接口为系统接口。 5309 5310**系统能力**：SystemCapability.Telephony.CallManager 5311 5312| 名称 | 值 | 说明 | 5313| ---------------- | ---- | -------- | 5314| TRANSFER_DISABLE | 0 | 禁用转移 | 5315| TRANSFER_ENABLE | 1 | 启用转移 | 5316 5317## DisconnectedDetails<sup>9+</sup> 5318 5319通话结束原因。 5320 5321**系统接口：** 此接口为系统接口。 5322 5323**系统能力**：SystemCapability.Telephony.CallManager 5324 5325| 名称 | 类型 | 必填 | 说明 | 5326| ------- | ------------------------------------------ | ---- | --------------- | 5327| reason | [DisconnectedReason](#disconnectedreason8) | 是 | 通话结束原因 | 5328| message | string | 是 | 通话结束提示信息| 5329 5330## DisconnectedReason<sup>8+</sup> 5331 5332断开连接的详细信息。 5333 5334**系统接口：** 此接口为系统接口。 5335 5336**系统能力**：SystemCapability.Telephony.CallManager 5337 5338| 名称 | 值 | 说明 | 5339| ------------------------------------------------------------ | ---- | --------------------------------------- | 5340| UNASSIGNED_NUMBER | 1 | 未分配的号码(空号) | 5341| NO_ROUTE_TO_DESTINATION | 3 | 无至目的地的路由 | 5342| CHANNEL_UNACCEPTABLE | 6 | 不可接受的通路 | 5343| OPERATOR_DETERMINED_BARRING | 8 | 运营商闭锁 | 5344| CALL_COMPLETED_ELSEWHERE<sup>9+</sup> | 13 | 呼叫在其他地方完成 | 5345| NORMAL_CALL_CLEARING | 16 | 清除正常呼叫 | 5346| USER_BUSY | 17 | 用户忙 | 5347| NO_USER_RESPONDING | 18 | 无用户响应 | 5348| USER_ALERTING_NO_ANSWER | 19 | 已有用户提醒，但无应答 | 5349| CALL_REJECTED | 21 | 呼叫拒绝 | 5350| NUMBER_CHANGED | 22 | 号码改变 | 5351| CALL_REJECTED_DUE_TO_FEATURE_AT_THE_DESTINATION<sup>9+</sup> | 24 | 当由于目标地址（例如匿名）导致呼叫被拒绝 | 5352| FAILED_PRE_EMPTION<sup>9+</sup> | 25 | 抢占失败 | 5353| NON_SELECTED_USER_CLEARING<sup>9+</sup> | 26 | 非选定用户清除 | 5354| DESTINATION_OUT_OF_ORDER | 27 | 终点故障 | 5355| INVALID_NUMBER_FORMAT | 28 | 无效号码格式 | 5356| FACILITY_REJECTED<sup>9+</sup> | 29 | 增补业务拒绝 | 5357| RESPONSE_TO_STATUS_ENQUIRY<sup>9+</sup> | 30 | 对状态查询的响应 | 5358| NORMAL_UNSPECIFIED<sup>9+</sup> | 31 | 正常，未指定 | 5359| NO_CIRCUIT_CHANNEL_AVAILABLE<sup>9+</sup> | 34 | 无电路/通道可用 | 5360| NETWORK_OUT_OF_ORDER | 38 | 网络故障 | 5361| TEMPORARY_FAILURE | 41 | 临时故障 | 5362| SWITCHING_EQUIPMENT_CONGESTION<sup>9+</sup> | 42 | 交换设备拥塞 | 5363| ACCESS_INFORMATION_DISCARDED<sup>9+</sup> | 43 | 已丢弃访问信息 | 5364| REQUEST_CIRCUIT_CHANNEL_NOT_AVAILABLE<sup>9+</sup> | 44 | 请求的电路/通道不可用 | 5365| RESOURCES_UNAVAILABLE_UNSPECIFIED<sup>9+</sup> | 47 | 未指定资源不可用 | 5366| QUALITY_OF_SERVICE_UNAVAILABLE<sup>9+</sup> | 49 | 服务质量不可用 | 5367| REQUESTED_FACILITY_NOT_SUBSCRIBED<sup>9+</sup> | 50 | 请求的设施未订阅 | 5368| INCOMING_CALLS_BARRED_WITHIN_THE_CUG<sup>9+</sup> | 55 | CUG内禁止来电 | 5369| BEARER_CAPABILITY_NOT_AUTHORIZED<sup>9+</sup> | 57 | 未授权承载能力 | 5370| BEARER_CAPABILITY_NOT_PRESENTLY_AVAILABLE<sup>9+</sup> | 58 | 承载能力目前不可用 | 5371| SERVICE_OR_OPTION_NOT_AVAILABLE_UNSPECIFIED<sup>9+</sup> | 63 | 服务或选项不可用，未指定 | 5372| BEARER_SERVICE_NOT_IMPLEMENTED<sup>9+</sup> | 65 | 未实现承载服务 | 5373| ACM_EQUALTO_OR_GREATER_THAN_THE_MAXIMUM_VALUE<sup>9+</sup> | 68 | ACM大于或等于最大值 | 5374| REQUESTED_FACILITY_NOT_IMPLEMENTED<sup>9+</sup> | 69 | 请求的设施未实施 | 5375| ONLY_RESTRICTED_DIGITAL_INFO_BEARER_CAPABILITY_IS_AVAILABLE<sup>9+</sup> | 70 | 仅限BC有限数字信息可用 | 5376| SERVICE_OR_OPTION_NOT_IMPLEMENTED_UNSPECIFIED<sup>9+</sup> | 79 | 服务或选项未实施，未指定 | 5377| INVALID_TRANSACTION_IDENTIFIER_VALUE<sup>9+</sup> | 81 | 无效的业务标识符值 | 5378| USER_NOT_MEMBER_OF_CUG<sup>9+</sup> | 87 | 用户不是CUG成员 | 5379| INCOMPATIBLE_DESTINATION<sup>9+</sup> | 88 | 目标不兼容 | 5380| INVALID_TRANSIT_NETWORK_SELECTION<sup>9+</sup> | 91 | 选择的传输网络无效 | 5381| SEMANTICALLY_INCORRECT_MESSAGE<sup>9+</sup> | 95 | 语义错误的消息 | 5382| INVALID_MANDATORY_INFORMATION<sup>9+</sup> | 96 | 无效的强制信息 | 5383| MESSAGE_TYPE_NON_EXISTENT_OR_NOT_IMPLEMENTED<sup>9+</sup> | 97 | 消息类型不存在或未实现 | 5384| MESSAGE_TYPE_NOT_COMPATIBLE_WITH_PROTOCOL_STATE<sup>9+</sup> | 98 | 消息类型与协议状态不兼容 | 5385| INFORMATION_ELEMENT_NON_EXISTENT_OR_NOT_IMPLEMENTED<sup>9+</sup> | 99 | IE不存在或未实现 | 5386| CONDITIONAL_IE_ERROR<sup>9+</sup> | 100 | 条件IE错误 | 5387| MESSAGE_NOT_COMPATIBLE_WITH_PROTOCOL_STATE<sup>9+</sup> | 101 | 消息与协议状态不兼容 | 5388| RECOVERY_ON_TIMER_EXPIRED<sup>9+</sup> | 102 | 计时器过期时恢复计时器编号 | 5389| PROTOCOL_ERROR_UNSPECIFIED<sup>9+</sup> | 111 | 协议错误，未指定 | 5390| INTERWORKING_UNSPECIFIED<sup>9+</sup> | 127 | 互通，未指定 | 5391| CALL_BARRED<sup>9+</sup> | 240 | 呼叫被禁止 | 5392| FDN_BLOCKED<sup>9+</sup> | 241 | FDN受阻 | 5393| IMSI_UNKNOWN_IN_VLR<sup>9+</sup> | 242 | VLR中的IMSI未知 | 5394| IMEI_NOT_ACCEPTED<sup>9+</sup> | 243 | IMEI未被接受 | 5395| DIAL_MODIFIED_TO_USSD<sup>9+</sup> | 244 | 拨号修改为USSD | 5396| DIAL_MODIFIED_TO_SS<sup>9+</sup> | 245 | 拨号修改为USSD号 | 5397| DIAL_MODIFIED_TO_DIAL<sup>9+</sup> | 246 | 拨号已修改为正常 | 5398| RADIO_OFF<sup>9+</sup> | 247 | 无线电通讯已关闭 | 5399| OUT_OF_SERVICE<sup>9+</sup> | 248 | 停止服务 | 5400| NO_VALID_SIM<sup>9+</sup> | 249 | SIM卡无效 | 5401| RADIO_INTERNAL_ERROR<sup>9+</sup> | 250 | 无线电通讯内部错误 | 5402| NETWORK_RESP_TIMEOUT<sup>9+</sup> | 251 | 网络响应超时 | 5403| NETWORK_REJECT<sup>9+</sup> | 252 | 网络拒绝 | 5404| RADIO_ACCESS_FAILURE<sup>9+</sup> | 253 | 无线电接入故障 | 5405| RADIO_LINK_FAILURE<sup>9+</sup> | 254 | 无线电链路故障 | 5406| RADIO_LINK_LOST<sup>9+</sup> | 255 | 无线电链路丢失 | 5407| RADIO_UPLINK_FAILURE<sup>9+</sup> | 256 | 无线电上行链路故障 | 5408| RADIO_SETUP_FAILURE<sup>9+</sup> | 257 | 无线电通讯设置失败 | 5409| RADIO_RELEASE_NORMAL<sup>9+</sup> | 258 | 无线电释放正常 | 5410| RADIO_RELEASE_ABNORMAL<sup>9+</sup> | 259 | 无线电释放异常 | 5411| ACCESS_CLASS_BLOCKED<sup>9+</sup> | 260 | 访问类被阻止 | 5412| NETWORK_DETACH<sup>9+</sup> | 261 | 网络分离 | 5413| INVALID_PARAMETER | 1025 | 无效参数 | 5414| SIM_NOT_EXIT | 1026 | SIM卡未退出 | 5415| SIM_PIN_NEED | 1027 | 需要SIM卡PIN码 | 5416| CALL_NOT_ALLOW | 1029 | 不允许呼叫 | 5417| SIM_INVALID | 1045 | SIM卡无效 | 5418| UNKNOWN | 1279 | 未知原因 | 5419 5420## MmiCodeResults<sup>9+</sup> 5421 5422MMI码结果。 5423 5424**系统接口：** 此接口为系统接口。 5425 5426**系统能力**：SystemCapability.Telephony.CallManager 5427 5428| 名称 | 类型 | 必填 | 说明 | 5429| ------- | -------------------------------- | ---- | --------------- | 5430| result | [MmiCodeResult](#mmicoderesult9) | 是 | MMI码结果 | 5431| message | string | 是 | MMI码消息 | 5432 5433## MmiCodeResult<sup>9+</sup> 5434 5435MMI码结果。 5436 5437**系统接口：** 此接口为系统接口。 5438 5439**系统能力**：SystemCapability.Telephony.CallManager 5440 5441| 名称 | 值 | 说明 | 5442| ---------------- | ---- | ------------- | 5443| MMI_CODE_SUCCESS | 0 | 表示MMI码成功 | 5444| MMI_CODE_FAILED | 1 | 表示MMI码失败 | 5445 5446## call.answerCall<sup>11+</sup> 5447 5448answerCall(videoState: VideoStateType, callId: number\): Promise\<void\> 5449 5450接听来电。使用Promise异步回调。 5451 5452**系统接口：** 此接口为系统接口。 5453 5454**需要权限**：ohos.permission.ANSWER_CALL 5455 5456**系统能力**：SystemCapability.Telephony.CallManager 5457 5458**参数：** 5459 5460| 参数名 | 类型 | 必填 | 说明 | 5461| ----------------------- | ------------------- | ---- | ------------------------------------------------------------ | 5462| videoState| [VideoStateType](#videostatetype7)| 是 | 接听通话类型。 | 5463| callId | number | 是 | 呼叫Id。可以通过订阅callDetailsChange事件获得。 | 5464 5465**返回值：** 5466 5467| 类型 | 说明 | 5468| ------------------- | --------------------------- | 5469| Promise<void> | 以Promise形式异步返回接听电话结果。 | 5470 5471**错误码：** 5472 5473以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5474 5475| 错误码ID | 错误信息 | 5476| -------- | -------------------------------------------- | 5477| 201 | Permission denied. | 5478| 202 | Non-system applications use system APIs. | 5479| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5480| 8300001 | Invalid parameter value. | 5481| 8300002 | Operation failed. Cannot connect to service. | 5482| 8300003 | System internal error. | 5483| 8300999 | Unknown error code. | 5484 5485**示例：** 5486 5487```ts 5488import { BusinessError } from '@kit.BasicServicesKit'; 5489 5490call.answerCall(0, 1).then(() => { 5491 console.log(`answerCall success.`); 5492}).catch((err: BusinessError) => { 5493 console.error(`answerCall fail, promise: err->${JSON.stringify(err)}`); 5494}); 5495``` 5496 5497## call.cancelCallUpgrade<sup>11+</sup> 5498 5499cancelCallUpgrade\(callId: number\): Promise\<void\> 5500 5501视频通话升级过程中取消升级。使用Promise异步回调。 5502 5503**系统接口：** 此接口为系统接口。 5504 5505**需要权限**：ohos.permission.PLACE_CALL 5506 5507**系统能力**：SystemCapability.Telephony.CallManager 5508 5509**参数：** 5510 5511| 参数名 | 类型 | 必填 | 说明 | 5512| ------ | ---------------------------- | ---- | -------------- | 5513| callId | number | 是 | 呼叫Id。可以通过订阅callDetailsChange事件获得。| 5514 5515**返回值：** 5516 5517| 类型 | 说明 | 5518| ------------------- | --------------------------- | 5519| Promise<void> | 以Promise形式异步返回升级过程中取消视频升级结果。 | 5520 5521**错误码：** 5522 5523以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5524 5525| 错误码ID | 错误信息 | 5526| -------- | -------------------------------------------- | 5527| 201 | Permission denied. | 5528| 202 | Non-system applications use system APIs. | 5529| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5530| 8300001 | Invalid parameter value. | 5531| 8300002 | Operation failed. Cannot connect to service. | 5532| 8300003 | System internal error. | 5533| 8300999 | Unknown error code. | 5534 5535**示例：** 5536 5537```ts 5538import { BusinessError } from '@kit.BasicServicesKit'; 5539 5540call.cancelCallUpgrade(1).then(() => { 5541 console.log(`cancelCallUpgrade success.`); 5542}).catch((err: BusinessError) => { 5543 console.error(`cancelCallUpgrade fail, promise: err->${JSON.stringify(err)}`); 5544}); 5545``` 5546 5547## call.controlCamera<sup>11+</sup> 5548 5549controlCamera\(callId: number, cameraId: string\): Promise\<void\> 5550 5551设置使用指定的相机进行视频通话，cameraId为空表示关闭相机。使用Promise异步回调。 5552 5553**系统接口：** 此接口为系统接口。 5554 5555**需要权限**：ohos.permission.SET_TELEPHONY_STATE 5556 5557**系统能力**：SystemCapability.Telephony.CallManager 5558 5559**参数：** 5560 5561| 参数名 | 类型 | 必填 | 说明 | 5562| ------ | ---------------------------- | ---- | -------------- | 5563| callId | number | 是 | 呼叫Id。可以通过订阅callDetailsChange事件获得。 | 5564| cameraId | string | 是 | 相机Id。cameraId获取方式可参考[相机管理](../apis-camera-kit/js-apis-camera.md#getsupportedcameras)。| 5565 5566**返回值：** 5567 5568| 类型 | 说明 | 5569| ------------------- | --------------------------- | 5570| Promise<void> | 以Promise形式异步返回设置开启，关闭，切换相机结果。 | 5571 5572**错误码：** 5573 5574以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5575 5576| 错误码ID | 错误信息 | 5577| -------- | -------------------------------------------- | 5578| 201 | Permission denied. | 5579| 202 | Non-system applications use system APIs. | 5580| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5581| 8300001 | Invalid parameter value. | 5582| 8300002 | Operation failed. Cannot connect to service. | 5583| 8300003 | System internal error. | 5584| 8300999 | Unknown error code. | 5585 5586**示例：** 5587 5588```ts 5589import { BusinessError } from '@kit.BasicServicesKit'; 5590 5591call.controlCamera(1, "1").then(() => { 5592 console.log(`controlCamera success.`); 5593}).catch((err: BusinessError) => { 5594 console.error(`controlCamera fail, promise: err->${JSON.stringify(err)}`); 5595}); 5596``` 5597 5598## call.setPreviewSurface<sup>11+</sup> 5599 5600setPreviewSurface\(callId: number, surfaceId: string\): Promise\<void\> 5601 5602设置本端预览画面窗口。使用Promise异步回调。 5603 5604**系统接口：** 此接口为系统接口。 5605 5606**需要权限**：ohos.permission.SET_TELEPHONY_STATE 5607 5608**系统能力**：SystemCapability.Telephony.CallManager 5609 5610**参数：** 5611 5612| 参数名 | 类型 | 必填 | 说明 | 5613| ------ | ---------------------------- | ---- | -------------- | 5614| callId | number | 是 | 呼叫Id。可以通过订阅callDetailsChange事件获得。 | 5615| surfaceId | string | 是 | 预览窗口Id。surfaceId获取方式可参考[XComponent](../apis-arkui/arkui-ts/ts-basic-components-xcomponent.md#getxcomponentsurfaceid)。 | 5616 5617**返回值：** 5618 5619| 类型 | 说明 | 5620| ------------------- | --------------------------- | 5621| Promise<void> | 以Promise形式异步返回设置本端预览画面窗口结果。 | 5622 5623**错误码：** 5624 5625以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5626 5627| 错误码ID | 错误信息 | 5628| -------- | -------------------------------------------- | 5629| 201 | Permission denied. | 5630| 202 | Non-system applications use system APIs. | 5631| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5632| 8300001 | Invalid parameter value. | 5633| 8300002 | Operation failed. Cannot connect to service. | 5634| 8300003 | System internal error. | 5635| 8300999 | Unknown error code. | 5636 5637**示例：** 5638 5639```ts 5640import { BusinessError } from '@kit.BasicServicesKit'; 5641 5642call.setPreviewSurface(1, "surfaceId1").then(() => { 5643 console.log(`setPreviewSurface success.`); 5644}).catch((err: BusinessError) => { 5645 console.error(`setPreviewSurface fail, promise: err->${JSON.stringify(err)}`); 5646}); 5647``` 5648 5649## call.setDisplaySurface<sup>11+</sup> 5650 5651setDisplaySurface\(callId: number, surfaceId: string\): Promise\<void\> 5652 5653设置远端画面窗口。使用Promise异步回调。 5654 5655**系统接口：** 此接口为系统接口。 5656 5657**需要权限**：ohos.permission.SET_TELEPHONY_STATE 5658 5659**系统能力**：SystemCapability.Telephony.CallManager 5660 5661**参数：** 5662 5663| 参数名 | 类型 | 必填 | 说明 | 5664| ------ | ---------------------------- | ---- | -------------- | 5665| callId | number | 是 | 呼叫Id。可以通过订阅callDetailsChange事件获得。 | 5666| surfaceId | string | 是 | 画面窗口Id。surfaceId获取方式可参考[XComponent](../apis-arkui/arkui-ts/ts-basic-components-xcomponent.md#getxcomponentsurfaceid)。 | 5667 5668**返回值：** 5669 5670| 类型 | 说明 | 5671| ------------------- | --------------------------- | 5672| Promise<void> | 以Promise形式异步返回设置远端画面窗口结果。 | 5673 5674**错误码：** 5675 5676以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5677 5678| 错误码ID | 错误信息 | 5679| -------- | -------------------------------------------- | 5680| 201 | Permission denied. | 5681| 202 | Non-system applications use system APIs. | 5682| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5683| 8300001 | Invalid parameter value. | 5684| 8300002 | Operation failed. Cannot connect to service. | 5685| 8300003 | System internal error. | 5686| 8300999 | Unknown error code. | 5687 5688**示例：** 5689 5690```ts 5691import { BusinessError } from '@kit.BasicServicesKit'; 5692 5693call.setDisplaySurface(1, "surfaceId1").then(() => { 5694 console.log(`setDisplaySurface success.`); 5695}).catch((err: BusinessError) => { 5696 console.error(`setDisplaySurface fail, promise: err->${JSON.stringify(err)}`); 5697}); 5698``` 5699 5700## call.setDeviceDirection<sup>11+</sup> 5701 5702setDeviceDirection\(callId: number, deviceDirection: DeviceDirection\): Promise\<void\> 5703 5704设置视频通话画面显示方向为设备方向。使用Promise异步回调。 5705 5706**系统接口：** 此接口为系统接口。 5707 5708**需要权限**：ohos.permission.SET_TELEPHONY_STATE 5709 5710**系统能力**：SystemCapability.Telephony.CallManager 5711 5712**参数：** 5713 5714| 参数名 | 类型 | 必填 | 说明 | 5715| ------ | ----------------------------------------------- | ---- | -------------- | 5716| callId | number | 是 | 呼叫Id。可以通过订阅callDetailsChange事件获得。| 5717| deviceDirection | [DeviceDirection](#devicedirection11) | 是 | 画面方向。该参数根据设备方向获取 | 5718 5719**返回值：** 5720 5721| 类型 | 说明 | 5722| ------------------- | --------------------------- | 5723| Promise<void> | 以Promise形式异步返回设置视频通话画面方向结果。 | 5724 5725**错误码：** 5726 5727以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5728 5729| 错误码ID | 错误信息 | 5730| -------- | -------------------------------------------- | 5731| 201 | Permission denied. | 5732| 202 | Non-system applications use system APIs. | 5733| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5734| 8300001 | Invalid parameter value. | 5735| 8300002 | Operation failed. Cannot connect to service. | 5736| 8300003 | System internal error. | 5737| 8300999 | Unknown error code. | 5738 5739**示例：** 5740 5741```ts 5742import { BusinessError } from '@kit.BasicServicesKit'; 5743 5744call.setDeviceDirection(1, 0).then(() => { 5745 console.log(`setDeviceDirection success.`); 5746}).catch((err: BusinessError) => { 5747 console.error(`setDeviceDirection fail, promise: err->${JSON.stringify(err)}`); 5748}); 5749``` 5750 5751## call.on('imsCallModeChange')<sup>11+</sup> 5752 5753on\(type: 'imsCallModeChange', callback: Callback\<ImsCallModeInfo\>\): void 5754 5755订阅imsCallModeChange事件。使用callback异步回调。 5756 5757**系统接口：** 此接口为系统接口。 5758 5759**需要权限**：ohos.permission.SET_TELEPHONY_STATE 5760 5761**系统能力**：SystemCapability.Telephony.CallManager 5762 5763**参数：** 5764 5765| 参数名 | 类型 | 必填 | 说明 | 5766| -------- | ------------------------------------------ | ---- | -------------------------- | 5767| type | string | 是 | 视频通话时监听通话模式的变化，参数固定为'imsCallModeChange'。 | 5768| callback | Callback<[ImsCallModeInfo](#imscallmode8)> | 是 | 以回调函数的方式返回订阅imsCallModeChange事件的结果。 | 5769 5770**错误码：** 5771 5772以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5773 5774| 错误码ID | 错误信息 | 5775| -------- | -------------------------------------------- | 5776| 201 | Permission denied. | 5777| 202 | Non-system applications use system APIs. | 5778| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5779| 8300001 | Invalid parameter value. | 5780| 8300002 | Operation failed. Cannot connect to service. | 5781| 8300003 | System internal error. | 5782| 8300999 | Unknown error code. | 5783 5784**示例：** 5785 5786```ts 5787import { BusinessError } from '@kit.BasicServicesKit'; 5788 5789call.on('imsCallModeChange', (data: call.ImsCallModeInfo) => { 5790 console.log(`callback: data->${JSON.stringify(data)}`); 5791}); 5792``` 5793 5794## call.off('imsCallModeChange')<sup>11+</sup> 5795 5796off\(type: 'imsCallModeChange', callback?: Callback\<ImsCallModeInfo\>\): void 5797 5798取消订阅imsCallModeChange事件。使用callback异步回调。 5799 5800**系统接口：** 此接口为系统接口。 5801 5802**需要权限**：ohos.permission.SET_TELEPHONY_STATE 5803 5804**系统能力**：SystemCapability.Telephony.CallManager 5805 5806**参数：** 5807 5808| 参数名 | 类型 | 必填 | 说明 | 5809| -------- | ------------------------------------------ | ---- | ---------------------------------- | 5810| type | string | 是 | 视频通话时取消监听通话模式的变化，参数固定为'imsCallModeChange'。 | 5811| callback | Callback<[ImsCallModeInfo](#imscallmode8)> | 否 | 回调函数。不填该参数将不会收到取消订阅的处理结果。 | 5812 5813**错误码：** 5814 5815以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5816 5817| 错误码ID | 错误信息 | 5818| -------- | -------------------------------------------- | 5819| 201 | Permission denied. | 5820| 202 | Non-system applications use system APIs. | 5821| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5822| 8300001 | Invalid parameter value. | 5823| 8300002 | Operation failed. Cannot connect to service. | 5824| 8300003 | System internal error. | 5825| 8300999 | Unknown error code. | 5826 5827**示例：** 5828 5829```ts 5830import { BusinessError } from '@kit.BasicServicesKit'; 5831 5832call.off('imsCallModeChange', (data: call.ImsCallModeInfo) => { 5833 console.log(`callback: data->${JSON.stringify(data)}`); 5834}); 5835``` 5836 5837## call.on('callSessionEvent')<sup>11+</sup> 5838 5839on\(type: 'callSessionEvent', callback: Callback\<CallSessionEvent\>\): void 5840 5841订阅callSessionEvent事件。使用callback异步回调。 5842 5843**系统接口：** 此接口为系统接口。 5844 5845**需要权限**：ohos.permission.SET_TELEPHONY_STATE 5846 5847**系统能力**：SystemCapability.Telephony.CallManager 5848 5849**参数：** 5850 5851| 参数名 | 类型 | 必填 | 说明 | 5852| -------- | ------------------------------------------------- | ---- | -------------------------- | 5853| type | string | 是 | 视频通话时监听通话事件，参数固定为'callSessionEvent'。 | 5854| callback | Callback<[CallSessionEvent](#callsessionevent11)> | 是 | 以回调函数的方式返回订阅callSessionEvent事件的结果。 | 5855 5856**错误码：** 5857 5858以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5859 5860| 错误码ID | 错误信息 | 5861| -------- | -------------------------------------------- | 5862| 201 | Permission denied. | 5863| 202 | Non-system applications use system APIs. | 5864| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5865| 8300001 | Invalid parameter value. | 5866| 8300002 | Operation failed. Cannot connect to service. | 5867| 8300003 | System internal error. | 5868| 8300999 | Unknown error code. | 5869 5870**示例：** 5871 5872```ts 5873import { BusinessError } from '@kit.BasicServicesKit'; 5874 5875call.on('callSessionEvent', (data: call.CallSessionEvent) => { 5876 console.log(`callback: data->${JSON.stringify(data)}`); 5877}); 5878``` 5879 5880## call.off('callSessionEvent')<sup>11+</sup> 5881 5882off\(type: 'callSessionEvent', callback?: Callback\<CallSessionEvent\>\): void 5883 5884取消订阅callSessionEvent事件。使用callback异步回调。 5885 5886**系统接口：** 此接口为系统接口。 5887 5888**需要权限**：ohos.permission.SET_TELEPHONY_STATE 5889 5890**系统能力**：SystemCapability.Telephony.CallManager 5891 5892**参数：** 5893 5894| 参数名 | 类型 | 必填 | 说明 | 5895| -------- | ------------------------------------------ | ---- | ---------------------------------- | 5896| type | string | 是 | 视频通话时取消监听通话事件，参数固定为'callSessionEvent'。 | 5897| callback | Callback<[CallSessionEvent](#callsessionevent11)> | 否 | 回调函数。不填该参数将不会收到取消订阅的处理结果。 | 5898 5899**错误码：** 5900 5901以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5902 5903| 错误码ID | 错误信息 | 5904| -------- | -------------------------------------------- | 5905| 201 | Permission denied. | 5906| 202 | Non-system applications use system APIs. | 5907| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5908| 8300001 | Invalid parameter value. | 5909| 8300002 | Operation failed. Cannot connect to service. | 5910| 8300003 | System internal error. | 5911| 8300999 | Unknown error code. | 5912 5913**示例：** 5914 5915```ts 5916import { BusinessError } from '@kit.BasicServicesKit'; 5917 5918call.off('callSessionEvent', (data: call.CallSessionEvent) => { 5919 console.log(`callback: data->${JSON.stringify(data)}`); 5920}); 5921``` 5922 5923## call.on('peerDimensionsChange')<sup>11+</sup> 5924 5925on\(type: 'peerDimensionsChange', callback: Callback\<PeerDimensionsDetail\>\): void 5926 5927订阅peerDimensionsChange事件。使用callback异步回调。 5928 5929**系统接口：** 此接口为系统接口。 5930 5931**需要权限**：ohos.permission.SET_TELEPHONY_STATE 5932 5933**系统能力**：SystemCapability.Telephony.CallManager 5934 5935**参数：** 5936 5937| 参数名 | 类型 | 必填 | 说明 | 5938| -------- | --------------------------------------------------------- | ---- | -------------------------- | 5939| type | string | 是 | 视频通话时监听对端画面分辨率的变化，参数固定为'peerDimensionsChange'。 | 5940| callback | Callback<[PeerDimensionsDetail](#peerdimensionsdetail11)> | 是 | 以回调函数的方式返回订阅peerDimensionsChange事件的结果。 | 5941 5942**错误码：** 5943 5944以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5945 5946| 错误码ID | 错误信息 | 5947| -------- | -------------------------------------------- | 5948| 201 | Permission denied. | 5949| 202 | Non-system applications use system APIs. | 5950| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5951| 8300001 | Invalid parameter value. | 5952| 8300002 | Operation failed. Cannot connect to service. | 5953| 8300003 | System internal error. | 5954| 8300999 | Unknown error code. | 5955 5956**示例：** 5957 5958```ts 5959import { BusinessError } from '@kit.BasicServicesKit'; 5960 5961call.on('peerDimensionsChange', (data: call.PeerDimensionsDetail) => { 5962 console.log(`callback: data->${JSON.stringify(data)}`); 5963}); 5964``` 5965 5966## call.off('peerDimensionsChange')<sup>11+</sup> 5967 5968off\(type: 'peerDimensionsChange', callback?: Callback\<PeerDimensionsDetail\>\): void 5969 5970取消订阅peerDimensionsChange事件。使用callback异步回调。 5971 5972**系统接口：** 此接口为系统接口。 5973 5974**需要权限**：ohos.permission.SET_TELEPHONY_STATE 5975 5976**系统能力**：SystemCapability.Telephony.CallManager 5977 5978**参数：** 5979 5980| 参数名 | 类型 | 必填 | 说明 | 5981| -------- | --------------------------------------------------------- | ---- | -------------------------- | 5982| type | string | 是 | 视频通话时监听对端画面分辨率的变化，参数固定为'peerDimensionsChange'。 | 5983| callback | Callback<[PeerDimensionsDetail](#peerdimensionsdetail11)> | 否 | 回调函数。不填该参数将不会收到取消订阅的处理结果。 | 5984 5985**错误码：** 5986 5987以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 5988 5989| 错误码ID | 错误信息 | 5990| -------- | -------------------------------------------- | 5991| 201 | Permission denied. | 5992| 202 | Non-system applications use system APIs. | 5993| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 5994| 8300001 | Invalid parameter value. | 5995| 8300002 | Operation failed. Cannot connect to service. | 5996| 8300003 | System internal error. | 5997| 8300999 | Unknown error code. | 5998 5999**示例：** 6000 6001```ts 6002import { BusinessError } from '@kit.BasicServicesKit'; 6003 6004call.off('peerDimensionsChange', (data: call.PeerDimensionsDetail) => { 6005 console.log(`callback: data->${JSON.stringify(data)}`); 6006}); 6007``` 6008 6009## call.on('cameraCapabilitiesChange')<sup>11+</sup> 6010 6011on\(type: 'cameraCapabilitiesChange', callback: Callback\<CameraCapabilities\>\): void 6012 6013订阅cameraCapabilitiesChange事件。使用callback异步回调。 6014 6015**系统接口：** 此接口为系统接口。 6016 6017**需要权限**：ohos.permission.SET_TELEPHONY_STATE 6018 6019**系统能力**：SystemCapability.Telephony.CallManager 6020 6021**参数：** 6022 6023| 参数名 | 类型 | 必填 | 说明 | 6024| -------- | ------------------------------------------------------| ---- | -------------------------- | 6025| type | string | 是 | 视频通话时监听本端相机画面分辨率的变化，参数固定为'cameraCapabilitiesChange'。 | 6026| callback | Callback<[CameraCapabilities](#cameracapabilities11)> | 是 | 以回调函数的方式返回订阅cameraCapabilitiesChange事件的结果。 | 6027 6028**错误码：** 6029 6030以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 6031 6032| 错误码ID | 错误信息 | 6033| -------- | -------------------------------------------- | 6034| 201 | Permission denied. | 6035| 202 | Non-system applications use system APIs. | 6036| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 6037| 8300001 | Invalid parameter value. | 6038| 8300002 | Operation failed. Cannot connect to service. | 6039| 8300003 | System internal error. | 6040| 8300999 | Unknown error code. | 6041 6042**示例：** 6043 6044```ts 6045call.on('cameraCapabilitiesChange', (data: call.CameraCapabilities) => { 6046 console.log(`callback: data->${JSON.stringify(data)}`); 6047}); 6048``` 6049 6050## call.off('cameraCapabilitiesChange')<sup>11+</sup> 6051 6052off\(type: 'cameraCapabilitiesChange', callback?: Callback\<CameraCapabilities\>\): void 6053 6054取消订阅cameraCapabilitiesChange事件。使用callback异步回调。 6055 6056**系统接口：** 此接口为系统接口。 6057 6058**需要权限**：ohos.permission.SET_TELEPHONY_STATE 6059 6060**系统能力**：SystemCapability.Telephony.CallManager 6061 6062**参数：** 6063 6064| 参数名 | 类型 | 必填 | 说明 | 6065| -------- | ----------------------------------------------------- | ---- | ---------------------------------- | 6066| type | string | 是 | 视频通话时取消监听本端相机画面分辨率的变化，参数固定为'cameraCapabilitiesChange'。 | 6067| callback | Callback<[CameraCapabilities](#cameracapabilities11)> | 否 | 回调函数。不填该参数将不会收到取消订阅的处理结果。 | 6068 6069**错误码：** 6070 6071以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](errorcode-telephony.md)和[通用错误码](../errorcode-universal.md)。 6072 6073| 错误码ID | 错误信息 | 6074| -------- | -------------------------------------------- | 6075| 201 | Permission denied. | 6076| 202 | Non-system applications use system APIs. | 6077| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2. Incorrect parameters types;| 6078| 8300001 | Invalid parameter value. | 6079| 8300002 | Operation failed. Cannot connect to service. | 6080| 8300003 | System internal error. | 6081| 8300999 | Unknown error code. | 6082 6083**示例：** 6084 6085```ts 6086call.off('cameraCapabilitiesChange', (data: call.CameraCapabilities) => { 6087 console.log(`callback: data->${JSON.stringify(data)}`); 6088}); 6089``` 6090 6091## VideoRequestResultType<sup>11+</sup> 6092 6093视频通话升降级请求结果类型。 6094 6095**系统接口：** 此接口为系统接口。 6096 6097**系统能力**：SystemCapability.Telephony.CallManager 6098 6099| 名称 | 值 | 说明 | 6100| ------------------------------------------ | ------ | --------| 6101| TYPE_REQUEST_SUCCESS | 0 | 请求成功。 | 6102| TYPE_REQUEST_FAILURE | 1 | 请求失败。 | 6103| TYPE_REQUEST_INVALID | 2 | 请求无效。 | 6104| TYPE_REQUEST_TIMED_OUT | 3 | 请求超时。 | 6105| TYPE_REQUEST_REJECTED_BY_REMOTE | 4 | 请求被拒绝。 | 6106| TYPE_REQUEST_UPGRADE_CANCELED | 5 | 请求升级取消。 | 6107| TYPE_DOWNGRADE_RTP_OR_RTCP_TIMEOUT | 100 | 视频通话降级RTP或RTCP超时。 | 6108| TYPE_DOWNGRADE_RTP_AND_RTCP_TIMEOUT | 101 | 视频通话降级RTP和RTCP超时。 | 6109 6110## DeviceDirection<sup>11+</sup> 6111 6112视频通话画面方向类型。 6113 6114**系统接口：** 此接口为系统接口。 6115 6116**系统能力**：SystemCapability.Telephony.CallManager 6117 6118| 名称 | 值 | 说明 | 6119| -------------------- | ------ | --------| 6120| DEVICE_DIRECTION_0 | 0 | 视频画面0度方向。 | 6121| DEVICE_DIRECTION_90 | 90 | 视频画面90度方向。 | 6122| DEVICE_DIRECTION_180 | 180 | 视频画面180度方向。 | 6123| DEVICE_DIRECTION_270 | 270 | 视频画面270度方向。 | 6124 6125## CallSessionEventId<sup>11+</sup> 6126 6127视频通话事件类型。 6128 6129**系统接口：** 此接口为系统接口。 6130 6131**系统能力**：SystemCapability.Telephony.CallManager 6132 6133| 名称 | 值 | 说明 | 6134| ------------------------------ | ------ | --------| 6135| EVENT_CONTROL_CAMERA_FAILURE | 0 | 相机设置失败。 | 6136| EVENT_CONTROL_CAMERA_READY | 1 | 相机设置成功。 | 6137| EVENT_DISPLAY_SURFACE_RELEASED | 100 | 远端画面窗口释放。 | 6138| EVENT_PREVIEW_SURFACE_RELEASED | 101 | 本端画面窗口释放。 | 6139 6140## ImsCallModeInfo<sup>11+</sup> 6141 6142视频通话模式信息。 6143 6144**系统接口：** 此接口为系统接口。 6145 6146**系统能力**：SystemCapability.Telephony.CallManager 6147 6148| 名称 | 类型 | 必填 | 说明 | 6149| ------- | -------------------------------------------------- | ---- | ------------- | 6150| callId | number | 是 | 呼叫Id。 | 6151| isRequestInfo| boolean | 是 | 该信息是否为请求信息。| 6152| imsCallMode | [ImsCallMode](#imscallmode8) | 是 | 视频通话模式。 | 6153| result | [VideoRequestResultType](#videorequestresulttype11)| 是 | 通话结束提示信息。| 6154 6155## CallSessionEvent<sup>11+</sup> 6156 6157视频通话事件信息。 6158 6159**系统接口：** 此接口为系统接口。 6160 6161**系统能力**：SystemCapability.Telephony.CallManager 6162 6163| 名称 | 类型 | 必填 | 说明 | 6164| ------- | -------------------------------------------------- | ---- | ------------- | 6165| callId | number | 是 | 呼叫Id。 | 6166| eventId | [CallSessionEventId](#callsessioneventid11) | 是 | 视频通话事件。 | 6167 6168## PeerDimensionsDetail<sup>11+</sup> 6169 6170视频通话对端画面分辨率信息。 6171 6172**系统接口：** 此接口为系统接口。 6173 6174**系统能力**：SystemCapability.Telephony.CallManager 6175 6176| 名称 | 类型 | 必填 | 说明 | 6177| ------- | ------------ | ---- | ------------- | 6178| callId | number | 是 | 呼叫Id。 | 6179| width | number | 是 | 对端画面图像尺寸宽(像素)。 | 6180| height | number | 是 | 对端画面图像尺寸高(像素)。 | 6181 6182## CameraCapabilities<sup>11+</sup> 6183 6184视频通话本端相机画面分辨率信息。 6185 6186**系统接口：** 此接口为系统接口。 6187 6188**系统能力**：SystemCapability.Telephony.CallManager 6189 6190| 名称 | 类型 | 必填 | 说明 | 6191| ------- | ------------ | ---- | ------------- | 6192| callId | number | 是 | 呼叫Id。 | 6193| width | number | 是 | 本端画面图像尺寸宽(像素)。 | 6194| height | number | 是 | 本端画面图像尺寸高(像素)。 | 6195 6196## NumberMarkInfo<sup>12+</sup> 6197 6198电话号码的标记信息。 6199 6200**系统接口：** 此接口为系统接口。 6201 6202**系统能力**：SystemCapability.Telephony.CallManager 6203 6204| 名称 | 类型 | 必填 | 说明 | 6205| ------- | ------------ | ---- | ------------- | 6206| markType | [MarkType](#marktype12) | 是 | 号码的标记类型。 | 6207| markContent | string | 否 | 号码的标记内容，markType为MARK_TYPE_ENTERPRISE时，该字段返回信息为“姓名 工号”。 | 6208| markCount | number | 否 | 号码的标记次数。 | 6209| markSource | string | 否 | 号码的标记来源供应商。 | 6210| isCloud | boolean | 否 | 号码的标记是否来自云端。 | 6211| markDetails<sup>14+</sup> | string | 否 | 号码标记的详细信息，markType为MARK_TYPE_ENTERPRISE时，该字段返回信息为“部门 职位”。 | 6212 6213## MarkType<sup>12+</sup> 6214 6215号码标记的类型。 6216 6217**系统接口：** 此接口为系统接口。 6218 6219**系统能力**：SystemCapability.Telephony.CallManager 6220 6221| 名称 | 值 | 说明 | 6222| ------------------------------ | ------ | --------| 6223| MARK_TYPE_NONE | 0 | 没有标记 | 6224| MARK_TYPE_CRANK | 1 | 骚扰电话 | 6225| MARK_TYPE_FRAUD | 2 | 诈骗电话 | 6226| MARK_TYPE_EXPRESS | 3 | 快递送餐 | 6227| MARK_TYPE_PROMOTE_SALES | 4 | 广告推销 | 6228| MARK_TYPE_HOUSE_AGENT | 5 | 房产中介 | 6229| MARK_TYPE_INSURANCE | 6 | 保险理财 | 6230| MARK_TYPE_TAXI | 7 | 出租车 | 6231| MARK_TYPE_CUSTOM | 8 | 用户自定义 | 6232| MARK_TYPE_OTHERS | 9 | 其他 | 6233| MARK_TYPE_YELLOW_PAGE | 10 | 黄页 | 6234| MARK_TYPE_ENTERPRISE<sup>14+</sup> | 11 | 企业联系人 | 6235