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