-

场景介绍

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

如果设备支持同时插入两张 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(获取通话号码需要该权限)

开发步骤

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

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

  1. 发起一路呼叫。

  1. 注册观察呼叫状态变化。

   // 创建呼叫管理对象
   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);