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