鸿蒙OS开发文档鸿蒙OS 发起一路呼叫

2024-02-25 开发教程鸿蒙OS开发文档匿名 2℃

场景介绍

当应用需要发起一路呼叫给一个指定的号码时，使用本业务。呼叫可以是音频呼叫，也可以是视频呼叫。

如果设备支持同时插入两张 SIM 卡，且拨打电话时两张SIM 卡均在位，呼叫时会弹出弹框让用户选择从卡 1 还是卡 2 呼出。

接口说明

DistributedCallManager 为开发者提供呼叫管理功能，具体功能分类如下表。

功能分类	接口名	描述	所需权限
能力获取	hasVoiceCapability()	检查当前设备是否支持语音呼叫。	无
获取管理对象	getInstance(Context context)	获取呼叫管理对象。	无
发起呼叫	dial(String number, boolean isVideoCall)	发起音频或视频呼叫。	ohos.permission.PLACE_CALL
观察通话业务状态变化	addObserver(CallStateObserver observer, int mask)	观察通话业务状态变化。	ohos.permission.READ_CALL_LOG（获取通话号码需要该权限）

开发步骤

调用 DistributedCallManager 的 getInstance 接口，创建/获取呼叫管理对象。

调用 hasVoiceCapability() 接口获取当前设备呼叫能力，如果支持继续下一步；如果不支持则无法发起呼叫。

发起一路呼叫。

注册观察呼叫状态变化。

// 创建呼叫管理对象
   DistributedCallManager dcManager = DistributedCallManager.getInstance(context);
   // 调用查询能力接口
   if (!dcManager.hasVoiceCapability()) {
       return;
   }
   // 如果设备支持呼叫能力，则继续发起呼叫
   dcManager.dial(destinationNum, isVideoCall);
   // 创建继承CallStateObserver的类MyCallStateObserver
   class MyCallStateObserver extends CallStateObserver {
       // 构造方法，在当前线程的runner中执行回调，slotId需要传入要观察的卡槽ID（0或1）
       MyCallStateObserver(int slotId) {
           super(slotId);
       }
       // 构造方法，在执行runner中执行回调，slotId需要传入要观察的卡槽ID（0或1）
       MyCallStateObserver(int slotId, EventRunner runner) {
           super(slotId, runner);
       }
       // 通话状态变化的回调方法
       @Override
       public void onCallStateUpdated(int state, String number) {
           ...
       }
   }
   // 执行回调的runner
   EventRunner runner = EventRunner.create();
   // 创建MyCallStateObserver的对象
   MyCallStateObserver observer = new MyCallStateObserver(slotId, runner);
   // 观察OBSERVE_CALL_STATE的变化
   dcManager.addObserver(observer, CallStateObserver.OBSERVE_CALL_STATE);

上一节：鸿蒙OS 电话服务概述

下一节：鸿蒙OS 发送一条文本信息

"鸿蒙OS开发文档"的目录

鸿蒙OS开发文档 鸿蒙OS 发起一路呼叫

场景介绍

接口说明

开发步骤

鸿蒙OS开发文档鸿蒙OS 发起一路呼叫