输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档
指南
API
开放能力API
高级筛选
API version全部版本
设备全部
元服务API集不筛选
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
开发与测试开放能力API应用服务Call Service Kit（通话服务）ArkTS APIvoipCall (应用内通话管理)

voipCall (应用内通话管理)

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+
更新时间: 2026-08-29 09:41
本文导读
展开章节

本模块提供应用内通话管理功能，包括向系统上报来电、上报去电、上报通话状态以及获取用户点击事件等。

获取用户点击事件需使用voipCall.on在业务流程开始时提前订阅voipCallUiEvent事件，可于业务流程结束后使用voipCall.off结束订阅。

起始版本： 4.1.0(11)

导入模块

收起
自动换行
深色代码主题
复制
  1. import { voipCall } from '@kit.CallServiceKit';

VoipCallType

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

表示通话类型的枚举。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

展开
名称 值 说明
VOIP_CALL_VOICE 0 语音通话。
VOIP_CALL_VIDEO 1 视频通话。

VoipCallState

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

表示通话状态的枚举。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

展开
名称 值 说明
VOIP_CALL_STATE_IDLE 0 呼叫状态空闲。
VOIP_CALL_STATE_RINGING 1 呼叫传入状态。
VOIP_CALL_STATE_ACTIVE 2 激活呼叫状态。
VOIP_CALL_STATE_HOLDING 3 保持呼叫状态。
VOIP_CALL_STATE_DISCONNECTED 4 呼叫状态已断开。
VOIP_CALL_STATE_DIALING 5

拨号中。

起始版本: 5.0.0(12)
VOIP_CALL_STATE_ANSWERED 6

正在接听。

起始版本: 5.0.0(12)
VOIP_CALL_STATE_DISCONNECTING 7

正在断开。

起始版本: 5.0.0(12)

VoipCallUiEvent

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

表示通话事件的枚举。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

展开
名称 值 说明
VOIP_CALL_EVENT_NONE 0 无任何事件。
VOIP_CALL_EVENT_VOICE_ANSWER 1 通话语音接听事件。
VOIP_CALL_EVENT_VIDEO_ANSWER 2 通话视频接听事件。
VOIP_CALL_EVENT_REJECT 3 通话拒接事件。
VOIP_CALL_EVENT_HANGUP 4 通话挂断事件。
VOIP_CALL_EVENT_MUTED 5

静音事件。

起始版本: 5.0.0(12)
VOIP_CALL_EVENT_UNMUTED 6

取消静音事件。

起始版本: 5.0.0(12)
VOIP_CALL_EVENT_SPEAKER_ON 7

开启扬声器事件。

起始版本: 5.0.0(12)

（预留事件，暂未支持）
VOIP_CALL_EVENT_SPEAKER_OFF 8

关闭扬声器事件。

起始版本: 5.0.0(12)

（预留事件，暂未支持）
VOIP_CALL_EVENT_MUTE_RINGTONE 9

用户按键静音铃声事件。

起始版本: 6.0.2(22)

ErrorReason

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

表示错误码类型的枚举。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

展开
名称 值 说明
ERROR_NONE 0 无错误出现。
CELLULAR_CALL_EXISTS 1 当前已存在蜂窝通话。
VOIP_CALL_EXISTS 2 当前已存在其他应用内通话。
INVALID_CALL 3 通话无效，比如传入的callId未通过校验等。
USER_ANSWER_CELLULAR_FIRST 4 用户选择接听蜂窝。

VoipCallUiEventInfo

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

通话事件详细信息。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

展开
名称 类型 只读 可选 说明
callId string 否 否 应用内通话唯一ID。
voipCallUiEvent VoipCallUiEvent 否 否 应用内通话事件。
errorReason ErrorReason 否 否 应用内通话错误码。

VoipCallFailureCause

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

表示来电消息建立失败原因的枚举。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

展开
名称 值 说明
OTHER 0 其他失败原因。
ROUTE_BUSY 1 应用线路忙。
CONNECTION_FAILED 2 通话连接建立失败。

VoipCallAttribute

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

通话属性选项。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

展开
名称 类型 只读 可选 说明
callId string 否 否 应用内通话唯一ID。
voipCallType VoipCallType 否 否 应用内通话类型。
userName string 否 否 应用内通话用户昵称。
userProfile image.PixelMap 否 否

用户头像图片，需导入图像处理模块，详情见PixelMap。

支持传入的最大图片大小为221x221px，推荐传入的图片大小为112x112px。通过 PixelMap的getPixelBytesNumber接口获取到的图片大小要小于196608bit。
abilityName string 否 否 接听后需加载的应用界面ability名称。
voipCallState VoipCallState 否 否 应用内通话状态。
showBannerForIncomingCall boolean 否 是

支持应用上报来电/去电是否显示横幅通知。

true：应用设置来电显示横幅通知。

false：应用设置来电不显示横幅通知。

默认值为true。

起始版本: 5.0.0(12)
isConferenceCall boolean 否 是

通话是否为会议。

true：来电是会议。

false：来电不是会议。

默认值为false。

起始版本: 5.0.0(12)
isVoiceAnswerSupported boolean 否 是

视频来电/去电是否支持语音接听。

true：支持。

false：不支持。

默认值为true。

起始版本: 5.0.0(12)
isUserMuteRingToneAllowed boolean 否 是

是否支持用户按键静音来电铃声。

true：支持。

false：不支持。

默认值为false。

起始版本: 6.0.2(22)
isDialingAllowedDuringCarrierCall boolean 否 是

是否允许运营商通话中发起VoIP主叫。

true：允许。

false：不允许。

默认值为false。

起始版本: 6.0.2(22)

CallAudioEvent

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

表示静音、扬声器事件的枚举。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 5.0.0(12)

展开
名称 值 说明
AUDIO_EVENT_MUTED 0 静音。
AUDIO_EVENT_UNMUTED 1 取消静音。
AUDIO_EVENT_SPEAKER_ON 2 开启扬声器。
AUDIO_EVENT_SPEAKER_OFF 3 关闭扬声器。
AUDIO_EVENT_MIC_DISABLE 5

静音且不允许操作麦克风。

起始版本: 6.1.1(24)

模型约束：此接口仅可在Stage模型下使用。

voipCall.on('voipCallUiEvent')

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

on(type: 'voipCallUiEvent', callback: Callback<VoipCallUiEventInfo>): void

订阅voipCallUiEvent事件。使用Callback异步回调。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

参数：

展开
参数名 类型 必填 说明
type string 是 通话事件类型，参数固定为“voipCallUiEvent”。
callback Callback<VoipCallUiEventInfo> 是 回调函数，返回通话事件详细信息对象。

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

展开
错误码ID 错误信息
401 Parameter error. The type of parameter should match or the number of parameters must match.
1007200001 Invalid parameter value.
1007200002 Operation failed. Cannot connect to service.
1007200003 System internal error.
1007200999 Unknown error code.

示例：

收起
自动换行
深色代码主题
复制
  1. import { voipCall } from '@kit.CallServiceKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. voipCall.on('voipCallUiEvent', (data: voipCall.VoipCallUiEventInfo) => {
  5.   hilog.info(0x0000, 'testTag', `Succeeded in reading callback. CallId: ${data.callId}, voipCallUiEvent: ${data.voipCallUiEvent}`);
  6. });

voipCall.off('voipCallUiEvent')

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

off(type: 'voipCallUiEvent', callback?: Callback<VoipCallUiEventInfo>): void

取消订阅voipCallUiEvent事件。使用Callback异步回调。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

参数：

展开
参数名 类型 必填 说明
type string 是 通话事件类型，参数固定为“voipCallUiEvent”。
callback Callback<VoipCallUiEventInfo> 否 回调函数，返回通话事件详细信息对象。若不填，则取消当前应用监听该事件的所有回调函数。

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

展开
错误码ID 错误信息
401 Parameter error. The type of parameter should match or the number of parameters must match.
1007200001 Invalid parameter value.
1007200002 Operation failed. Cannot connect to service.
1007200003 System internal error.
1007200999 Unknown error code.

示例：

收起
自动换行
深色代码主题
复制
  1. import { voipCall } from '@kit.CallServiceKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. voipCall.off('voipCallUiEvent', (data: voipCall.VoipCallUiEventInfo) => {
  5.   hilog.info(0x0000, 'testTag', `Succeeded in reading callback. CallId: ${data.callId}, voipCallUiEvent: ${data.voipCallUiEvent}`);
  6. });

voipCall.reportIncomingCall

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

reportIncomingCall(voipCallAttribute: VoipCallAttribute): Promise<ErrorReason>

通知来电消息，如果应用来电消息建立失败，需调用reportIncomingCallError通知来电建立失败。需设置通话详细信息，见VoipCallAttribute。使用Promise异步回调。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

参数：

展开
参数名 类型 必填 说明
voipCallAttribute VoipCallAttribute 是 应用内通话详细信息如用户头像、用户昵称、通话唯一标识等，详情请参见VoipCallAttribute。（应用上报去电时，VoipCallAttribute中的voipCallState属性必须为VOIP_CALL_STATE_DIALING。）

返回值：

展开
类型 说明
Promise<ErrorReason> Promise对象，返回错误码类型。

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

展开
错误码ID 错误信息
401 Parameter error. The type of parameter should match or the number of parameters must match.
1007200001 Invalid parameter value.
1007200002 Operation failed. Cannot connect to service.
1007200003 System internal error.
1007200999 Unknown error code.

示例：

收起
自动换行
深色代码主题
复制
  1. import { image } from '@kit.ImageKit';
  2. import { voipCall } from '@kit.CallServiceKit';
  3. import { resourceManager } from '@kit.LocalizationKit';
  4. import { hilog } from '@kit.PerformanceAnalysisKit';
  5. import { UIAbility } from '@kit.AbilityKit';
  6. import { pushService } from '@kit.PushKit';
  7. 

  8. interface Content {
  9.   data: string;
  10.   callId: string;
  11. }
  12. 

  13. export default class VoipAbility extends UIAbility {
  14.   onCreate(): void {
  15.     hilog.info(0x0000, 'testTag', 'VoipExtAbility onCreate.');
  16.     try {
  17.       pushService.receiveMessage('VoIP', this, async (data) => {
  18.         let content: Content = JSON.parse(data.data);
  19.         let callId: string = content.callId;
  20. 

  21.         hilog.info(0x0000, 'testTag', 'Get voip message successfully: %{public}s', callId);
  22. 

  23.         // 此处为用户头像，需要创建PixelMap类型
  24.         const resourceMgr : resourceManager.ResourceManager = this.context.resourceManager;
  25.         const fileData : Uint8Array = await resourceMgr.getRawFileContent('example.png');
  26.         const buffer = fileData.buffer;
  27.         const imageSource : image.ImageSource = image.createImageSource(buffer);
  28.         const pixelMap : image.PixelMap = await imageSource.createPixelMap();
  29.         if (pixelMap) {
  30.           pixelMap.getImageInfo((err, imageInfo) => {
  31.             if (imageInfo) {
  32.               hilog.info(0x0000, 'testTag', `DemoPushMessageAbility imageInfo: ${imageInfo.size.width} * ${imageInfo.size.height}.`);
  33.             }
  34.           });
  35.         }
  36. 

  37.         // 构建通话详细信息的对象
  38.         let callInfo: voipCall.VoipCallAttribute = {
  39.           callId: callId,
  40.           voipCallType: voipCall.VoipCallType.VOIP_CALL_VOICE,
  41.           userName: "name",
  42.           userProfile: pixelMap,
  43.           abilityName: 'ability',
  44.           voipCallState: voipCall.VoipCallState.VOIP_CALL_STATE_RINGING
  45.         };
  46. 

  47.         // 通知来电消息
  48.         let error = await voipCall.reportIncomingCall(callInfo);
  49.         if (error != voipCall.ErrorReason.ERROR_NONE) {
  50.           hilog.error(0x0000, 'testTag', 'Failed to report incoming call: %{public}d', error);
  51.           return;
  52.         }
  53. 

  54.         hilog.info(0x0000, 'testTag', 'Get voip message end.');
  55.       });
  56.     } catch (err) {
  57.       let e: BusinessError = err as BusinessError;
  58.       hilog.error(0x0000, 'testTag', 'Failed to receive message: %{public}d %{public}s', e.code, e.message);
  59.     }
  60. 

  61.     hilog.info(0x0000, 'testTag', 'Succeeded in registering VoIP.');
  62.   }
  63. }

voipCall.reportOutgoingCall

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

reportOutgoingCall(voipCallAttribute: VoipCallAttribute): Promise<ErrorReason>

应用上报去电。需设置通话详细信息，见VoipCallAttribute。使用Promise异步回调。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 5.0.0(12)

参数：

展开
参数名 类型 必填 说明
voipCallAttribute VoipCallAttribute 是 应用内通话详细信息如用户头像、用户昵称、通话唯一标识等，详情请参见VoipCallAttribute。

返回值：

展开
类型 说明
Promise<ErrorReason> Promise对象，返回错误码类型。

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

展开
错误码ID 错误信息
401 Parameter error. The type of parameter should match or the number of parameters must match.
1007200001 Invalid parameter value.
1007200002 Operation failed. Cannot connect to service.
1007200003 System internal error.
1007200999 Unknown error code.

示例：

收起
自动换行
深色代码主题
复制
  1. import { image } from '@kit.ImageKit';
  2. import { voipCall } from '@kit.CallServiceKit';
  3. import { resourceManager } from '@kit.LocalizationKit';
  4. import { hilog } from '@kit.PerformanceAnalysisKit';
  5. import { UIAbility } from '@kit.AbilityKit';
  6. import { pushService } from '@kit.PushKit';
  7. 

  8. interface Content {
  9.   data: string;
  10.   callId: string;
  11. }
  12. 

  13. export default class VoipExtAbility extends UIAbility {
  14.   onCreate(): void {
  15.     hilog.info(0x0000, 'testTag', 'VoipExtAbility onCreate.');
  16.     try {
  17.       pushService.receiveMessage('VoIP', this, async (data) => {
  18.         let content: Content = JSON.parse(data.data);
  19.         let callId: string = content.callId;
  20. 

  21.         hilog.info(0x0000, 'testTag', 'Get voip message successfully: %{public}s', callId);
  22. 

  23.         // 此处为用户头像，需要创建PixelMap类型
  24.         const resourceMgr : resourceManager.ResourceManager = this.context.resourceManager;
  25.         const fileData : Uint8Array = await resourceMgr.getRawFileContent('example.png');
  26.         const buffer = fileData.buffer;
  27.         const imageSource : image.ImageSource = image.createImageSource(buffer);
  28.         const pixelMap : image.PixelMap = await imageSource.createPixelMap();
  29.         if (pixelMap) {
  30.           pixelMap.getImageInfo((err, imageInfo) => {
  31.             if (imageInfo) {
  32.               hilog.info(0x0000, 'testTag', `DemoPushMessageAbility imageInfo: ${imageInfo.size.width} * ${imageInfo.size.height}.`);
  33.             }
  34.           });
  35.         }
  36. 

  37.         // 构建通话详细信息的对象
  38.         let callInfo: voipCall.VoipCallAttribute = {
  39.           callId: callId,
  40.           voipCallType: voipCall.VoipCallType.VOIP_CALL_VOICE,
  41.           userName: "name",
  42.           userProfile: pixelMap,
  43.           abilityName: 'ability',
  44.           voipCallState: voipCall.VoipCallState.VOIP_CALL_STATE_DIALING
  45.         };
  46. 

  47.         // 通知去电消息
  48.         let error = await voipCall.reportOutgoingCall(callInfo);
  49.         if (error != voipCall.ErrorReason.ERROR_NONE) {
  50.           hilog.error(0x0000, 'testTag', 'Failed to report outgoing call: %{public}d', error);
  51.           return;
  52.         }
  53.         hilog.info(0x0000, 'testTag', 'Get voip message end.');
  54.       });
  55.     } catch (err) {
  56.       let e: BusinessError = err as BusinessError;
  57.       hilog.error(0x0000, 'testTag', 'Failed to receive message: %{public}d %{public}s', e.code, e.message);
  58.     }
  59.     
  60.     hilog.info(0x0000, 'testTag', 'Succeeded in registering VoIP.');
  61.   }
  62. }

voipCall.reportCallAudioEventChange

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

reportCallAudioEventChange(callId: string, callAudioEvent: CallAudioEvent): Promise<void>

应用上报通话中的静音、扬声器事件。使用Promise异步回调。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 5.0.0(12)

参数：

展开
参数名 类型 必填 说明
callId string 是 应用内通话唯一ID。
callAudioEvent CallAudioEvent 是 VoIP开/关静音、扬声器事件，详情请参见CallAudioEvent。

返回值：

展开
类型 说明
Promise<void> Promise对象。无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

展开
错误码ID 错误信息
401 Parameter error. The type of parameter should match or the number of parameters must match.
1007200001 Invalid parameter value.
1007200002 Operation failed. Cannot connect to service.
1007200003 System internal error.
1007200999 Unknown error code.

示例：

收起
自动换行
深色代码主题
复制
  1. import { voipCall } from '@kit.CallServiceKit';
  2. import { UIAbility } from '@kit.AbilityKit';
  3. import { pushService } from '@kit.PushKit';
  4. import { hilog } from '@kit.PerformanceAnalysisKit';
  5. 

  6. interface Content {
  7.   data: string;
  8.   callId: string;
  9. }
  10. 

  11. export default class VoipExtAbility extends UIAbility {
  12.   onCreate(): void {
  13.     hilog.info(0x0000, 'testTag', 'VoipExtAbility onCreate.');
  14.     try {
  15.       pushService.receiveMessage('VoIP', this, async (data) => {
  16.         let content: Content = JSON.parse(data.data);
  17.         let callId: string = content.callId;
  18. 

  19.         let callAudioEvent: voipCall.CallAudioEvent = voipCall.CallAudioEvent.AUDIO_EVENT_MUTED;
  20. 

  21.         // 上报通话中静音、扬声器事件
  22.         await voipCall.reportCallAudioEventChange(callId, callAudioEvent);
  23.         hilog.info(0x0000, 'testTag', `Succeeded in reporting call audio event change.`);
  24.       });
  25.     } catch (err) {
  26.       let e: BusinessError = err as BusinessError;
  27.       hilog.error(0x0000, 'testTag', 'Failed to receive message: %{public}d %{public}s', e.code, e.message);
  28.     }
  29.     
  30.     hilog.info(0x0000, 'testTag', 'Succeeded in registering VoIP.');
  31.   }
  32. }

voipCall.reportCallStateChange

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

reportCallStateChange(callId: string, callState: VoipCallState): Promise<void>

通知应用内通话状态变化，使用Promise异步回调。

该接口不能改变通话类型，例如，语音通话不能升级为视频通话，视频通话也不能降级为语音通话，如需上述升降级操作，请调用voipCall.reportCallStateChange。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

参数：

展开
参数名 类型 必填 说明
callId string 是 呼叫ID。
callState VoipCallState 是 通话状态，参考VoipCallState。

返回值：

展开
类型 说明
Promise<void> Promise对象。无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

展开
错误码ID 错误信息
401 Parameter error. The type of parameter should match or the number of parameters must match.
1007200001 Invalid parameter value.
1007200002 Operation failed. Cannot connect to service.
1007200003 System internal error.
1007200999 Unknown error code.

示例：

收起
自动换行
深色代码主题
复制
  1. import { voipCall } from '@kit.CallServiceKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. await voipCall.reportCallStateChange("callId123", voipCall.VoipCallState.VOIP_CALL_STATE_ACTIVE);
  5. hilog.info(0x0000, 'testTag', `Succeeded in reporting call state change.`);

voipCall.reportCallStateChange

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

reportCallStateChange(callId: string, callState: VoipCallState, callType: VoipCallType): Promise<void>

通知应用内通话状态变化，并指定通话类型，使用Promise异步回调。

对于视频来电语音接听、通话中视频降语音或者语音升视频，需要调用该接口，并传入正确的callType。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 5.0.0(12)

参数：

展开
参数名 类型 必填 说明
callId string 是 呼叫ID。
callState VoipCallState 是 通话状态，参考VoipCallState。
callType VoipCallType 是 通话类型，参考VoipCallType。

返回值：

展开
类型 说明
Promise<void> Promise对象。无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

展开
错误码ID 错误信息
401 Parameter error. The type of parameter should match or the number of parameters must match.
1007200001 Invalid parameter value.
1007200002 Operation failed. Cannot connect to service.
1007200003 System internal error.
1007200999 Unknown error code.

示例：

收起
自动换行
深色代码主题
复制
  1. import { voipCall } from '@kit.CallServiceKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. await voipCall.reportCallStateChange("callId123", voipCall.VoipCallState.VOIP_CALL_STATE_ACTIVE, voipCall.VoipCallType.VOIP_CALL_VOICE);
  5. hilog.info(0x0000, 'testTag', `Succeeded in reporting call state change.`);

voipCall.reportIncomingCallError

Phone5.0.0(12)+PC/2in16.1.1(24)+Tablet5.0.0(12)+Wearable6.0.0(20)+

reportIncomingCallError(callId: string, voipCallFailureCause: VoipCallFailureCause): Promise<void>

通知来电消息建立失败的原因，使用Promise异步回调。

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Telephony.VoipCallManager

起始版本： 4.1.0(11)

参数：

展开
参数名 类型 必填 说明
callId string 是 应用内通话唯一ID。
voipCallFailureCause VoipCallFailureCause 是 来电消息建立失败原因。

返回值：

展开
类型 说明
Promise<void> Promise对象。无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

展开
错误码ID 错误信息
401 Parameter error. The type of parameter should match or the number of parameters must match.
1007200001 Invalid parameter value.
1007200002 Operation failed. Cannot connect to service.
1007200003 System internal error.
1007200999 Unknown error code.

示例：

收起
自动换行
深色代码主题
复制
  1. import { voipCall } from '@kit.CallServiceKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. await voipCall.reportIncomingCallError("callId123", voipCall.VoipCallFailureCause.OTHER);
  5. hilog.info(0x0000, 'testTag', `Succeeded in reporting incoming call error.`);

voipCall.reportCallAttributeChange

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+

reportCallAttributeChange(voipCallAttribute: VoipCallAttribute): Promise<ErrorReason>

应用上报通话属性变化。在通话过程中，当通话属性发生变化时，应用可以调用该接口更新通话属性（当前版本允许通话类型、应用内通话用户昵称、用户头像图片、通话是否为会议）。使用Promise异步回调。

模型约束：该接口仅可在Stage模型下使用。

系统能力: SystemCapability.Telephony.VoipCallManager

起始版本： 26.0.0

参数：

展开
参数名 类型 必填 说明
voipCallAttribute VoipCallAttribute 是 应用内通话详细信息，包含需要更新的通话属性，详情请参见VoipCallAttribute。

返回值：

展开
类型 说明
Promise<ErrorReason> Promise对象，返回错误码。

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

展开
错误码ID 错误信息
1007200001 Invalid parameter value.
1007200002 Operation failed. Cannot connect to service.
1007200003 System internal error.

示例：

收起
自动换行
深色代码主题
复制
  1. import { voipCall } from '@kit.CallServiceKit';
  2. import { image } from '@kit.ImageKit';
  3. import { hilog } from '@kit.PerformanceAnalysisKit';
  4. 

  5. let newUserProfile = image.createPixelMapSync(new ArrayBuffer(100), { size: { width: 90, height: 90 } });
  6. let updatedAttribute: voipCall.VoipCallAttribute = {
  7.   callId: '1234567890',
  8.   voipCallType: voipCall.VoipCallType.VOIP_CALL_VOICE,
  9.   userName: 'UpdatedName',
  10.   userProfile: newUserProfile,
  11.   abilityName: 'VoipCallAbility',
  12.   voipCallState: voipCall.VoipCallState.VOIP_CALL_STATE_ACTIVE
  13. };
  14. 

  15. let error = await voipCall.reportCallAttributeChange(updatedAttribute);
  16. if (error == voipCall.ErrorReason.ERROR_NONE) {
  17.     hilog.info(0x0000, 'testTag', `Succeeded in reporting call attribute change.`);
  18. } else {
  19.     hilog.error(0x0000, 'testTag', 'Failed to report call attribute change: %{public}d', error);
  20. }
ArkTS API
CallerInfoQueryExtensionAbility (来去电信息查询扩展Ability)
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词