场景介绍
当应用需要发起一路呼叫给一个指定的号码时,使用本业务。呼叫可以是音频呼叫,也可以是视频呼叫。
如果设备支持同时插入两张 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);