鸿蒙开发实战【通话管理】-电子发烧友网

简介

通话管理模块主要管理CS（Circuit Switch，电路交换）、IMS（IP Multimedia Subsystem，IP多媒体子系统）和OTT（over the top，OTT解决方案）三种类型的通话，负责申请通话所需要的音视频资源，并处理多路通话时产生的各种冲突。通话管理主要分为UI交互、服务管理、系统通话管理、通话音频管理、通话视频管理和蓝牙通话管理六大模块，各模块简介如下：

UI交互模块：负责和通话UI交互，如UI调用接口拨号，上报来电等状态给UI。
服务管理模块：负责启动和初始化系统通话管理服务。
系统通话管理模块：负责处理通话下行操作（如拨号、接听、挂断等）和上行状态（来电状态、呼叫等待状态等）的处理，并解决通话过程中产生的冲突。
通话音频管理模块：负责通话时需要的音频资源的申请和释放，依赖多媒体子系统，需要调用多媒体子系统接口进行音频相关的操作。
通话视频管理模块：负责通话时需要的视频资源的申请和释放，依赖多媒体子系统，需要调用多媒体子系统接口进行视频相关的操作。
蓝牙通话管理模块：负责通话时需要的蓝牙资源的申请和释放，并处理蓝牙设备发起的通话操作，如接听和挂断等。

其主要的结构及流程如下图所示：

图 1 通话管理模块架构图

约束

开发语言：JavaScript。
软件上，需要与以下子系统和服务配合使用：安全子系统，多媒体子系统，软总线基础通信子系统(蓝牙模块)，Telephony核心服务（core_service），蜂窝通话服务（cellular_call）。
硬件上，需要搭载的设备支持以下硬件：扬声器或听筒、麦克风。

接口说明

表 1 通话管理对外提供的接口

[]()[]()接口内容	[]()[]()接口描述	[]()[]()所需权限
[]()[]()function dial(phoneNumber: string, options: DialOptions, callback: AsyncCallback): void;	[]()[]()拨号接口，调用此接口可以进行拨号操作	[]()[]()ohos.permission.PLACE_CALL

表 2 拨号接口参数说明

[]()[]()参数	[]()[]()描述
[]()[]()phoneNumber: string	[]()[]()电话号码
[]()[]()options: DialOptions	[]()[]()扩展参数（详见下表）
[]()[]()callback: AsyncCallback	[]()[]()异步执行结果，true表示执行成功，false表示执行失败

表 3 options: DialOptions参数说明

[]()[]()参数	[]()[]()类型	[]()[]()描述	[]()[]()是否必填	[]()[]()默认值
[]()[]()extras	[]()[]()boolean	[]()[]()false：音频 true：视频	[]()[]()否	[]()[]()false

使用说明

拨打电话接口调用流程及示例代码

构造phoneNumber和options参数；
可以通过callback或者Promise的方式调用dial接口。

该接口为异步接口，相关执行结果会从callback中返回。

import call from "@ohos.telephony.call";

let phoneNumber = "12312312312";

// 调用接口【callback方式】
call.dial(phoneNumber, {extras: false}, (err, value) = > {
  if (err) {
    // 接口调用失败，err非空
    console.error(`failed to dial because ${err.message}`);
    return;
  }
  // 接口调用成功，err为空
  console.log(`success to dial: ${value}`);
});

// 调用接口【Promise方式】
let promise = call.dial(phoneNumber, {extras: false});
promise.then((value) = > {
  // 接口调用成功，此处可以实现成功场景分支代码。
  console.log(`success to dial: ${value}`);
}).catch((err) = > {
  // 接口调用失败，此处可以实现失败场景分支代码。
  console.error(`failed to dial because ${err.message}`);
});