在 HarmonyOS NEXT 开发中，如何指定一个号码，拉起系统拨号页面

2025-04-02
北京
本文字数：1394 字
阅读完需：约 5 分钟

大家好，我是 V 哥。《鸿蒙 HarmonyOS 开发之路卷 1 ArkTS 篇》已经出版上市了哈，有需要的朋友可以关注一下，卷 2 应用开发篇也马上要出版了，V 哥正在紧锣密鼓的写鸿蒙开发实战卷 3 的教材，卷 3 主要以项目实战为主，都是以各种场景下的实现细节，比如如何使用 ArkTS 实现一个指定号码，拉起系统拨号页面。我们来看看这个要怎么实现，马上开整。

如果你搞过 Android 开发，你会比较清楚，Android 中有 Intent 的概念，可以通过 ACTION_DIAL 来调起拨号界面，并传递电话号码。而 HarmonyOS 有类似的机制，但具体实现方式可能不同。

在 HarmonyOS 中，应用间的交互通常通过 Want 来实现。Want 是一个对象，用于传递消息和请求。比如，启动另一个应用的能力可能需要构造一个 Want，指定要执行的动作和目标。对于拨号功能，可能需要使用系统预定义的 Action，比如“ohos.intent.action.DIAL”，然后携带电话号码的参数。何设置参数。假如电话号码的参数是一个 URI，比如“tel:123456789”，这样系统拨号应用就能识别并填入号码。

大概的实现步骤是这样的：

导入所需模块：使用 UIAbilityContext 来启动能力。
构造 Want 对象：设置动作为 ohos.intent.action.DIAL，并通过 URI 传递电话号码。
调用 startAbility 方法：使用上下文启动拨号界面。

实现代码是这样的：

import common from '@ohos.app.ability.common';
// 在按钮点击事件或其他触发点调用此方法private onDial() {  const phoneNumber = "1234567890"; // 替换为指定号码  const context = getContext() as common.UIAbilityContext; // 获取上下文
  // 构造Want对象  let want = {    action: 'ohos.intent.action.DIAL',    uri: `tel:${phoneNumber}` // 使用tel:协议  };
  // 启动拨号界面  context.startAbility(want)    .then(() => {      console.log('成功调起拨号页面');    })    .catch((err) => {      console.error(`调起失败，错误码: ${err.code}, 信息: ${err.message}`);    });}

复制代码

注意事项

URI 格式：确保电话号码以 tel:开头，如 tel:1234567890。
特殊字符处理：若号码包含特殊字符（如空格、+），使用 encodeURIComponent 处理：

const encodedNumber = encodeURIComponent("+86 123 4567");const uri = `tel:${encodedNumber}`;

复制代码

错误处理：捕获并处理 startAbility 可能抛出的异常，如无拨号应用等。
权限：仅拉起拨号界面无需额外权限，直接拨号可能需要 ohos.permission.PLACE_CALL 权限。

在 ArkUI 组件中使用：

@Entry@Componentstruct DialButton {  private phoneNumber: string = "13800138000";
  build() {    Button('拨打电话')      .onClick(() => {        this.dialPhoneNumber();      })  }
  private dialPhoneNumber() {    const context = getContext() as common.UIAbilityContext;    let want = {      action: 'ohos.intent.action.DIAL',      uri: `tel:${this.phoneNumber}`    };    context.startAbility(want)      .then(() => {/* 成功处理 */})      .catch(err => {/* 错误处理 */});  }}