程序包 ohos.dcall

类 DistributedCallManager

java.lang.Object

ohos.dcall.DistributedCallManager

public class DistributedCallManager
extends Object

Provides distributed call management.

Applications can use the methods provided in this class to perform basic call management, including obtaining the current call state, registering and deregistering call components, and manages incoming and outgoing calls. Before managing calls, applications must call DistributedCallManager#getInstance(Context) to obtain a DistributedCallManager instance.

Some methods of this class are permission-protected. If your application is not granted the required permission, access to these protected methods is denied. The required permissions are provided in the description of a specific method.

从以下版本开始:

3

方法概要

限定符和类型	方法	说明
void	addObserver(CallStateObserver observer, int mask)	Adds an observer to monitor call service state changes.
boolean	dial(String number, boolean isVideoCall)	Makes a call.
void	displayCallScreen(boolean showDialpad)	Switches the call screen to the foreground.
int	getCallState()	Obtains the call state.
static DistributedCallManager	getInstance(Context context)	Obtains an instance of DistributedCallManager.
boolean	hasCall()	Checks whether a call is ongoing.
boolean	hasVoiceCapability()	Checks whether a device supports voice calls.
boolean	isVideoCallingEnabled()	Checks whether video calling is enabled on this device.
void	removeObserver(CallStateObserver observer)	Removes an observer to cancel monitoring call service state changes.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

getInstance

public static DistributedCallManager getInstance(Context context)

Obtains an instance of DistributedCallManager.

参数:

context - Indicates the context of the application.

返回:

Returns the instance of DistributedCallManager.

从以下版本开始:

3

hasCall

public boolean hasCall()

Checks whether a call is ongoing.

返回:

Returns true if at least one call is not in the CallStateObserver#CALL_STATE_IDLE state; returns false otherwise.

dial

public boolean dial(String number,
                    boolean isVideoCall)

Makes a call.

Applications must have the SystemPermission.PLACE_CALL permission to call this method.

参数:

number - Indicates the called number.

isVideoCall - Indicates whether the call to be made is a video call. The value false indicates a voice call.

返回:

Returns true if the call request is successful; returns false otherwise. Note that the value true indicates only the successful processing of the request; it does not mean that the call is or can be connected.

displayCallScreen

public void displayCallScreen(boolean showDialpad)

Switches the call screen to the foreground.

The system performs the switching only if there is an ongoing call.

参数:

showDialpad - Indicates whether the dialer is displayed on the call screen.

getCallState

public int getCallState()

Obtains the call state.

If an incoming call is ringing or waiting, the system returns CallStateObserver#CALL_STATE_RINGING. If at least one call is in the active, hold, or dialing state, the system returns CallStateObserver#CALL_STATE_OFFHOOK. In other cases, the system returns CallStateObserver#CALL_STATE_IDLE.

返回:

Returns the call state.

hasVoiceCapability

public boolean hasVoiceCapability()

Checks whether a device supports voice calls.

The system checks whether the device has the capability to initiate a circuit switching (CS) or IP multimedia subsystem domain (IMS) call on a telephone service network. If the device supports only packet switching (even if the device supports OTT calls), false is returned.

返回:

Returns true if the device supports voice calls; returns false otherwise.

从以下版本开始:

4

addObserver

public void addObserver(CallStateObserver observer,
                        int mask)

Adds an observer to monitor call service state changes.

参数:

observer - Indicates a CallStateObserver instance to add.

mask - Indicates the call service state to monitor. The state is indicated by the flag bit or combination starting with CallStateObserver OBSERVE_.

抛出:

SecurityException - Throws this exception if the application does not have the ohos.permission.GET_TELEPHONY_STATE permission.

removeObserver

public void removeObserver(CallStateObserver observer)

Removes an observer to cancel monitoring call service state changes.

After the observer added by running addObserver(ohos.dcall.CallStateObserver,int) is deleted, the system no longer receives call service state changes.

参数:

observer - Indicates a CallStateObserver instance to delete.

isVideoCallingEnabled

public boolean isVideoCallingEnabled()

Checks whether video calling is enabled on this device.

返回:

Returns true if video calling is enabled; returns false otherwise.

从以下版本开始:

3