HarmonyOS ——Telephony Kit（蜂窝通信服务）教程

哈喽！大家好，我是青蓝逐码的云杰，好久没有写文章啦！这段时间发生好多的事情------我们组织上架了两款元服务------萤火故事屋和止欲，感兴趣的同学可以进入我们的官网或者相关的文章(止欲)和(萤火故事屋)。

同时我也去准备了华为极客松，2个星期的极限编码让我们的小伙伴也燃尽了！

好的！言归正传！今天来玩点什么呢------Telephony Kit（蜂窝通信服务）

Telephony Kit（蜂窝通信服务）

Telephony Kit（蜂窝通信服务）提供一系列API帮助开发者开发通讯类应用，这次我介绍两个两种比较常见的场景:拨打电话和短信发送

• call模块（拨打电话）：系统应用可以直接拨打电话，在应用界面显示通话；三方应用可以拉起系统电话应用，跳转至拨号界面，从而实现拨打电话的功能，具体可参考拨打电话开发指导。除此之外，应用还可以通过call模块，实现格式化电话号码、判断是否紧急号码等功能。
• sms模块（短信服务）：应用可以实现创建、发送短信消息的功能，具体可参考发送短信开发指导。除此之外，应用还可以实现获取、设置短信服务中心地址，和检查当前设备是否具备短信发送和接收能力等功能。

拨打电话

场景介绍

开发者可以通过以下方式实现拨打电话的功能：对于三方应用，开发者可以使用makeCall接口，拉起系统电话应用，用户可以自行呼出通话。

服务限制

1. 仅支持在标准系统上运行。
2. 设备需插入可用的SIM卡。

开发步骤

1. 调用hasVoiceCapability，确认当前设备是否支持拨号

    // 调用查询能力接口
    let isSupport = call.hasVoiceCapability();

2. 调用makeCall接口，跳转到拨号界面并显示待拨号的号码

// 如果设备支持呼叫能力，则继续跳转到拨号界面，并显示拨号的号码
// 从API15开始支持tel格式电话号码，如："tel:156......"
call.makeCall("156......", (err: BusinessError) => {
 if (!err) {
   console.log("make call success.");
 } else {
   console.log("make call fail, err is:" + JSON.stringify(err));
 }
});

3. 订阅通话业务状态变化。

参数

名称	值	说明
CALL_STATE_UNKNOWN	-1	无效状态，当获取呼叫状态失败时返回。
CALL_STATE_IDLE	0	表示没有正在进行的呼叫。
CALL_STATE_RINGING	1	表示来电正在振铃或等待。
CALL_STATE_OFFHOOK	2	表示至少有一个呼叫处于拨号、通话中或呼叫保持状态，并且没有新的来电振铃或等待。

// 订阅通话业务状态变化（可选）
class SlotId {slotId: number = 0}
class CallStateCallback {
  state: call.CallState = call.CallState.CALL_STATE_UNKNOWN;
  number: string = "";
}
let slotId: SlotId = {slotId: 0}
observer.on("callStateChange", slotId, (data: CallStateCallback) => {
  console.log("call state change, data is:" + JSON.stringify(data));
});

4. 完整代码

// import需要的模块
import { call, observer } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';
@Entry
@Component
struct Index {

  build() {
    Column() {
Button('拨打电话')
  .onClick(()=>{
    // 调用查询能力接口
    let isSupport = call.hasVoiceCapability();
    if (isSupport) {
      // 如果设备支持呼叫能力，则继续跳转到拨号界面，并显示拨号的号码
      // 从API15开始支持tel格式电话号码，如："tel:13xxxx"
      call.makeCall("10086", (err: BusinessError) => {
        if (!err) {
          console.log("make call success.");
        } else {
          console.log("make call fail, err is:" + JSON.stringify(err));
        }
      });
      // 订阅通话业务状态变化（可选）
      class SlotId {slotId: number = 0}
      class CallStateCallback {
        state: call.CallState = call.CallState.CALL_STATE_UNKNOWN;
        number: string = "";
      }
      let slotId: SlotId = {slotId: 0}
      observer.on("callStateChange", slotId, (data: CallStateCallback) => {
        console.log("call state change, data is:" + JSON.stringify(data));
      });
    }
  })
    }
    .height('100%')
    .width('100%')
    .justifyContent(FlexAlign.Center)
  }
}

5. 效果展示

短信服务

短信服务模块提供了管理短信的一些基础能力，包括创建/发送短信、获取/设置发送短信的默认SIM卡槽ID、获取/设置短信服务中心地址，以及检查当前设备是否具备短信发送和接收能力等。

基本概念

• 短信服务

  即SMS（Short Messaging Service），是一种存储和转发服务。用户的移动电话可以通过它进行相互收发短信，内容以文本、数字或二进制非文本数据为主。发送方的信息通过短信服务中心进行储存并转发给接收方。

• 短信服务中心

  即SMSC（Short Message Service Center），负责在基站和移动设备间中继、储存或转发短消息。移动设备到短信服务中心的协议能传输来自移动设备或朝向移动设备的短消息，协议内容遵从GSM 03.40协议。

• 协议数据单元

  即PDU（Protocol Data Unit），PDU模式收发短信可以使用3种编码：7-bit、8-bit和UCS-2编码。7-bit编码用于发送普通的ASCII字符，8-bit编码通常用于发送数据短信，UCS-2编码用于发送Unicode字符。

编码阶段

发送短信的接口需要系统权限才可调用，三方应用如果有发送短信需求，需要在应用内实现跳转到短信编辑的功能，并且需要携带编辑内容和收件人号码，可以通过调用元能力startAbility接口指定号码并跳转到发送短信页面的方式实现。

1. 代码展示

import { common, Want } from '@kit.AbilityKit';

export class Contact {
  contactsName: string;
  telephone: number;

  constructor(contactsName: string, telephone: number) {
    this.contactsName = contactsName;
    this.telephone = telephone;
  }
}


@Entry
@Component
struct Index {
  private context = this.getUIContext().getHostContext() as common.UIAbilityContext;

  startMMSAbilityExplicit() {
    // 这里完善联系人和号码；姓名主要是通过手机号来查询实际联系人名称，因此这种方式还是以手机号码为主。
    let params: Array<Object> = [new Contact("", 10086)];


    let want: Want = {
      bundleName: "com.ohos.mms",
      abilityName: "com.ohos.mms.MainAbility",
      parameters: {
        contactObjects: JSON.stringify(params),
        pageFlag: "conversation",
        // 这里填写短信内容。
        content: "青蓝逐码"
      }
    };


    this.context.startAbilityForResult(want).then((data) => {
      console.log("Success" + JSON.stringify(data));
    }).catch(() => {
      console.log("error");
    });
  }

  build() {
    Row() {
      Column() {
        Button('发送短信')
          .onClick(() => {
            this.startMMSAbilityExplicit();
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}

2. 效果展示

总结

今天我们简单学习了项目中经常可能会用到的两种通信方式，如果有疑问欢迎私信或者评论区留言~

关于青蓝逐码组织

如果你兴趣想要了解更多的鸿蒙应用开发细节和最新资讯 ，甚至你想要做出一款属于自己的应用！欢迎在评论区留言或者私信，可以加入技术交流群。