`uni.makePhoneCall` 是 uni-app 提供的一个 API,用于拨打电话

718 阅读2分钟

uni.makePhoneCall 是 uni-app 提供的一个 API,用于拨打电话。通过此接口,可以直接从应用内启动拨号界面,并将电话号码传递给拨号程序。

使用说明

此 API 能让你的应用触发设备的电话功能,拨打指定的电话号码。它在实现客服电话、紧急联络等功能时非常实用。

API 结构

uni.makePhoneCall({
    phoneNumber: '', // 需要拨打的电话号码
    success: function () {
        // 接口调用成功的回调函数
    },
    fail: function (err) {
        // 接口调用失败的回调函数
    },
    complete: function () {
        // 接口调用结束的回调函数(无论成功或失败都会执行)
    }
});

参数说明

  • phoneNumber(String):必填,需要拨打的电话号码。
  • success(Function):可选,接口调用成功的回调函数。
  • fail(Function):可选,接口调用失败的回调函数。
  • complete(Function):可选,接口调用结束的回调函数(无论成功或失败都会执行)。

示例代码

以下是一个使用 uni.makePhoneCall 拨打电话的示例:

uni.makePhoneCall({
    phoneNumber: '10086', // 示例电话号码
    success: function () {
        console.log('拨打电话成功');
    },
    fail: function (err) {
        console.error('拨打电话失败', err);
    }
});

在这个示例中,调用 uni.makePhoneCall() 时传递了电话号码 10086,这将会尝试拨打该电话。

注意事项

  • 确保你的应用具有拨打电话的权限(在 App 和部分平台上可能需要)。
  • 由于直接拨打电话可能涉及用户隐私和安全问题,建议在调用前明确告知用户并获得他们的同意。
  • 不同平台可能对该 API 的支持有所差异,具体请参考 uni-app 官方文档 以及对应平台的开发文档。

此功能在开发时需谨慎使用,确保符合应用的用户体验和法律法规要求。