CallStateObserver

java.lang.Object
- ohos.dcall.CallStateObserver

```
public class CallStateObserver
extends Object
```
An observer class used to monitor call service state updates.
The call service states include the call state, voice mailbox state, and unconditional call forwarding (CFU) setting state. To monitor a specific type of updates, you must inherit this class and override the methods corresponding to OBSERVE_flags in mask transferred by DistributedCallManager#addObserver. These methods will be invoked when the corresponding service state updates and the observer is added to monitor the updates.

从以下版本开始:

3

字段概要

字段
限定符和类型	字段	说明
`static int`	`CALL_STATE_IDLE`	Indicates that there is no ongoing call.
`static int`	`CALL_STATE_OFFHOOK`	Indicates that a least one call is in the dialing, active, or hold state, and there is no new incoming call ringing or waiting.
`static int`	`CALL_STATE_RINGING`	Indicates that an incoming call is ringing or waiting.
`static int`	`CALL_STATE_UNKNOWN`	Indicates an invalid state, which is used when the call state fails to be obtained.
`static int`	`OBSERVE_MASK_CALL_FORWARDING_UNCONDITIONAL_INDICATOR`	Indicates a mask that monitors CFU setting updates.
`static int`	`OBSERVE_MASK_CALL_STATE`	Indicates a mask that monitors call state updates.
`static int`	`OBSERVE_MASK_VOICE_MAIL_MESSAGE_INDICATOR`	Indicates a mask that monitors voice mailbox state updates.

构造器概要

构造器
构造器	说明
`CallStateObserver()`	Creates an observer instance for receiving call service state updates in any slot.
`CallStateObserver(int slot)`	Creates an observer instance for receiving call service state updates in a specified slot.
`CallStateObserver(int slot, EventRunner runner)`	Creates an observer instance for receiving call service state updates in a specified slot.

方法概要

所有方法实例方法具体方法
限定符和类型	方法	说明
`void`	`onCallStateUpdated(int state, String number)`	Receives a call state change.
`void`	`onCfuIndicatorUpdated(boolean enable)`	Receives a CFU setting update.
`void`	`onVoiceMailMsgIndicatorUpdated(boolean isExist)`	Receives a voice mailbox state change.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - CALL_STATE_IDLE
```
public static final int CALL_STATE_IDLE
```
    Indicates that there is no ongoing call.
    
    另请参阅:
    
    常量字段值
  - CALL_STATE_OFFHOOK
```
public static final int CALL_STATE_OFFHOOK
```
    Indicates that a least one call is in the dialing, active, or hold state, and there is no new incoming call ringing or waiting.
    
    另请参阅:
    
    常量字段值
  - CALL_STATE_RINGING
```
public static final int CALL_STATE_RINGING
```
    Indicates that an incoming call is ringing or waiting.
    
    另请参阅:
    
    常量字段值
  - CALL_STATE_UNKNOWN
```
public static final int CALL_STATE_UNKNOWN
```
    Indicates an invalid state, which is used when the call state fails to be obtained.
    
    另请参阅:
    
    常量字段值
  - OBSERVE_MASK_CALL_FORWARDING_UNCONDITIONAL_INDICATOR
```
public static final int OBSERVE_MASK_CALL_FORWARDING_UNCONDITIONAL_INDICATOR
```
    Indicates a mask that monitors CFU setting updates.
    Applications must have the ohos.permission.GET_TELEPHONY_STATE permission to register this event.
    
    另请参阅:
    
    onCfuIndicatorUpdated(boolean), 常量字段值
  - OBSERVE_MASK_CALL_STATE
```
public static final int OBSERVE_MASK_CALL_STATE
```
    Indicates a mask that monitors call state updates.
    
    另请参阅:
    
    onCallStateUpdated(int, java.lang.String), 常量字段值
  - OBSERVE_MASK_VOICE_MAIL_MESSAGE_INDICATOR
```
public static final int OBSERVE_MASK_VOICE_MAIL_MESSAGE_INDICATOR
```
    Indicates a mask that monitors voice mailbox state updates.
    Applications must have the ohos.permission.GET_TELEPHONY_STATE permission to register this event.
    
    另请参阅:
    
    onVoiceMailMsgIndicatorUpdated(boolean), 常量字段值
- 构造器详细资料
  - CallStateObserver
```
public CallStateObserver()
                  throws IllegalArgumentException
```
    Creates an observer instance for receiving call service state updates in any slot.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if there is no EventRunner that can process the callback.
  - CallStateObserver
```
public CallStateObserver(int slot)
                  throws IllegalArgumentException
```
    Creates an observer instance for receiving call service state updates in a specified slot.
    
    参数:
    
    slot - Indicates the ID of the slot. The value 0 indicates slot 1, and the value 1 indicates slot 2.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if there is no EventRunner that can process the callback.
  - CallStateObserver
```
public CallStateObserver(int slot,
                         EventRunner runner)
                  throws IllegalArgumentException
```
    Creates an observer instance for receiving call service state updates in a specified slot. The callback will be processed using the input EventRunner.
    
    参数:
    
    slot - Indicates the ID of the slot. The value 0 indicates slot 1, and the value 1 indicates slot 2.
    
    runner - Indicates the EventRunner to process the callback.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if there is no EventRunner that can process the callback.
- 方法详细资料
  - onVoiceMailMsgIndicatorUpdated
```
public void onVoiceMailMsgIndicatorUpdated(boolean isExist)
```
    Receives a voice mailbox state change. This callback is invoked when the voice mailbox state of a specified card updates and the observer is added to monitor the updates.
    
    参数:
    
    isExist - Specifies whether a voice mailbox message exists. The value true indicates that a voice mailbox message exists, and the value false indicates that no voice mailbox message exists.
  - onCfuIndicatorUpdated
```
public void onCfuIndicatorUpdated(boolean enable)
```
    Receives a CFU setting update. This callback is invoked when the CFU setting of a specified card updates and the observer is added to monitor the updates.
    
    参数:
    
    enable - Specifies whether the CFU function is enabled. The value true indicates that the CFU function is enabled, and the value false indicates that the CFU function is disabled.
  - onCallStateUpdated
```
public void onCallStateUpdated(int state,
                               String number)
```
    Receives a call state change. This callback is invoked when the call state of a specified card updates and the observer is added to monitor the updates.
    参数:
    state - Indicates the call state. The following call states are possible:
    
    CallStateObserver#CALL_STATE_IDLE
    CallStateObserver#CALL_STATE_RINGING
    CallStateObserver#CALL_STATE_OFFHOOK
    number - Indicates the called number. The value is an empty string if the application does not have the ohos.permission#READ_CALL_LOG READ_CALL_LOG permission.

类 CallStateObserver

字段概要

构造器概要

方法概要

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

字段详细资料

CALL_STATE_IDLE

CALL_STATE_OFFHOOK

CALL_STATE_RINGING

CALL_STATE_UNKNOWN

OBSERVE_MASK_CALL_FORWARDING_UNCONDITIONAL_INDICATOR

OBSERVE_MASK_CALL_STATE

OBSERVE_MASK_VOICE_MAIL_MESSAGE_INDICATOR

构造器详细资料

CallStateObserver

CallStateObserver

CallStateObserver

方法详细资料

onVoiceMailMsgIndicatorUpdated

onCfuIndicatorUpdated

onCallStateUpdated