本文将详细介绍HarmonyOS中 @ohos.telephony.call
模块,并重点讲解如何使用 makeCall
函数实现拨打电话功能。
1. 模块简介
@ohos.telephony.call
模块是HarmonyOS电话子系统的一部分,提供了管理电话呼叫的功能,包括:
- 拨打电话
- 跳转到拨号界面
- 获取通话状态
- 格式化电话号码
2. 拨打电话:makeCall
函数解析
makeCall
函数用于跳转到系统拨号界面,并显示待拨出的电话号码。它提供了两种异步回调方式:回调函数
和 Promise
。
2.1 使用回调函数:
call.makeCall(phoneNumber: string, callback: AsyncCallback<void>): void
- 参数:
phoneNumber
: (必填) 字符串类型,表示要拨打的电话号码。callback
: (必填)AsyncCallback<void>
类型,异步回调函数,用于接收拨号结果。
- 示例:
import call from '@ohos.telephony.call';
call.makeCall("138xxxxxxxx", (err) => {
if (err) {
console.error(`拨号失败: ${JSON.stringify(err)}`);
} else {
console.log(`已跳转到拨号界面`);
}
});
2.2 使用 Promise:
call.makeCall(phoneNumber: string): Promise<void>
- 参数:
phoneNumber
: (必填) 字符串类型,表示要拨打的电话号码。
- 返回值:
Promise<void>
类型,用于处理拨号结果。 - 示例:
import call from '@ohos.telephony.call';
let promise = call.makeCall("138xxxxxxxx");
promise.then(() => {
console.log(`已跳转到拨号界面`);
}).catch(err => {
console.error(`拨号失败: ${JSON.stringify(err)}`);
});
3. 错误码
makeCall
函数执行失败时,可以通过 err
对象获取错误信息。 常见的错误码包括:
错误码ID | 错误信息 |
---|---|
401 | 参数错误 |
8300001 | 无效的参数值 |
8300002 | 操作失败,无法连接到服务 |
8300003 | 系统内部错误 |
8300999 | 未知错误 |
4. 总结
@ohos.telephony.call
模块为开发者提供了便捷的电话呼叫管理功能。 使用 makeCall
函数,开发者可以轻松实现拨打电话的功能,并根据需要选择回调函数或 Promise 方式处理拨号结果。