public final class Call
extends Object
java.lang.Object | |
↳ | android.telecom.Call |
代表通话应用应该呈现给用户的持续通话。
Nested classes |
|
---|---|
class |
Call.Callback
|
class |
Call.Details
|
Constants |
|
---|---|
String |
AVAILABLE_PHONE_ACCOUNTS 检索可选 |
int |
STATE_ACTIVE 积极支持对话时的状态 |
int |
STATE_CONNECTING 传出的初始状态 |
int |
STATE_DIALING 拨打远程号码时,拨出 |
int |
STATE_DISCONNECTED
|
int |
STATE_DISCONNECTING
|
int |
STATE_HOLDING
|
int |
STATE_NEW 新创建时的状态为 |
int |
STATE_RINGING 来电 |
int |
STATE_SELECT_PHONE_ACCOUNT 出射的状态 |
Public methods |
|
---|---|
void |
answer(int videoState) 指示此 |
void |
conference(Call callToConferenceWith) 指示此 |
void |
disconnect() 指示此 |
List<String> |
getCannedTextResponses() 获取预先配置的预先配置的消息响应列表,作为通过文本消息拒绝此 |
List<Call> |
getChildren() 获得此次会议的子女 |
List<Call> |
getConferenceableCalls() 返回与此 |
Call.Details |
getDetails() 获取包含通话详细信息的对象。 |
Call |
getParent() 在会议中获得此 |
String |
getRemainingPostDialSequence() 获得此 |
int |
getState() 获得这个 |
InCallService.VideoCall |
getVideoCall() 获取可用于显示来自此 |
void |
hold() 指示此 |
void |
mergeConference() 合并会议中的通话。 |
void |
phoneAccountSelected(PhoneAccountHandle accountHandle, boolean setDefault) 通知此 |
void |
playDtmfTone(char digit) 指示此 |
void |
postDialContinue(boolean proceed) 指示此 |
void |
registerCallback(Call.Callback callback) 注册一个回调到这个 |
void |
registerCallback(Call.Callback callback, Handler handler) 注册一个回调到这个 |
void |
reject(boolean rejectWithMessage, String textMessage) 指示 |
void |
splitFromConference() 指示此 |
void |
stopDtmfTone() 指示此 |
void |
swapConference() 在此会议中交换电话。 |
String |
toString() 返回对象的字符串表示形式。 |
void |
unhold() 指示此 |
void |
unregisterCallback(Call.Callback callback) 取消注册此 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
String AVAILABLE_PHONE_ACCOUNTS
检索可选PhoneAccount
的电信的关键是可以与其额外的呼叫捆绑在一起。 用于将电话帐户显示在用户的前端,以便选择电话帐户(例如)拨打电话。
常量值:“selectPhoneAccountAccounts”
int STATE_CONNECTING
传出的初始状态Call
。 如果失败,则通常转换为成功呼叫的STATE_DIALING
状态或STATE_DISCONNECTED
。
常量值:9(0x00000009)
int STATE_DISCONNECTED
Call
当没有进一步的语音或其他通信正在传输时,远端已经或将不可避免地被告知 Call
不再处于活动状态,并且本地数据传输已经或不可避免地将释放与此 Call
相关的资源。
常量值:7(0x00000007)
int STATE_DISCONNECTING
Call
当用户发起呼叫断开连接时的状态,但该呼叫尚未被基础ConnectionService
断开。 通话的下一个状态是(可能) STATE_DISCONNECTED
。
常量值:10(0x0000000a)
int STATE_SELECT_PHONE_ACCOUNT
出射的状态 Call
用户等待选择时 PhoneAccount
通过它来发出呼叫。
常量值:8(0x00000008)
void answer (int videoState)
指示此 STATE_RINGING
Call
回答。
Parameters | |
---|---|
videoState |
int : The video state in which to answer the call. |
void conference (Call callToConferenceWith)
指示此 Call
进入会议。
Parameters | |
---|---|
callToConferenceWith |
Call : The other call with which to conference. |
List<String> getCannedTextResponses ()
获取预先配置的预先配置的消息响应列表,作为通过文本消息拒绝此 Call
方式。
Returns | |
---|---|
List<String> |
A list of canned text message responses. |
也可以看看:
List<Call> getChildren ()
获得此次会议的子女 Call
,如果有的话。
Returns | |
---|---|
List<Call> |
The children of this Call if this Call is a conference, or an empty List otherwise. |
List<Call> getConferenceableCalls ()
返回允许此 Call
参加会议的 Call
列表。
Returns | |
---|---|
List<Call> |
The list of conferenceable Call s. |
Call.Details getDetails ()
获取包含通话详细信息的对象。
Returns | |
---|---|
Call.Details |
A Call.Details object. Depending on the state of the Call , the result may be null . |
Call getParent ()
在会议中获得此 Call
的家长,如果有的话。
Returns | |
---|---|
Call |
The parent Call , or null if this Call is not a child of any conference Call s. |
String getRemainingPostDialSequence ()
获得此 Call
剩余的拨号后序列(如果有的话)。
Returns | |
---|---|
String |
The remaining post-dial sequence, or null if there is no post-dial sequence remaining or this Call is not in a post-dial state. |
int getState ()
获得这个 Call
的状态。
Returns | |
---|---|
int |
A state value, chosen from the STATE_* constants. |
InCallService.VideoCall getVideoCall ()
获取可用于显示来自此 Call
视频的对象。
Returns | |
---|---|
InCallService.VideoCall |
An Call.VideoCall . |
void mergeConference ()
合并会议中的通话。 见CAPABILITY_MERGE_CONFERENCE
。
void phoneAccountSelected (PhoneAccountHandle accountHandle, boolean setDefault)
通知此Call
已选择一个帐户并继续拨打电话。 可选择将此帐户设置为默认帐户。
Parameters | |
---|---|
accountHandle |
PhoneAccountHandle
|
setDefault |
boolean
|
void playDtmfTone (char digit)
指示此Call
播放双音多频信号(DTMF)音。 立即停止指定呼叫中正在播放的任何其他DTMF音。
Parameters | |
---|---|
digit |
char : A character representing the DTMF digit for which to play the tone. This value must be one of '0' through '9' , '*' or '#' . |
void postDialContinue (boolean proceed)
指示此Call
继续播放拨号后DTMF字符串。 拨号后DTMF字符串是拨打电话号码后输入的一串数字,拨打后立即作为DTMF音发送到接收方,一旦建立连接。 如果DTMF字符串包含DTMF_CHARACTER_PAUSE
符号,则此Call
将在预定义的时间段内暂时暂停播放音调。 如果DTMF字符串包含DTMF_CHARACTER_WAIT
符号,则此Call
将暂停播放音调并通过onPostDialWait(Call, String)
通知回onPostDialWait(Call, String)
。 此时,通话应用程序应向用户显示此状态的指示以及继续后续序列的可供性。 当用户决定继续postDialContinue(boolean)
序列时,通话应用程序应该调用postDialContinue(boolean)
方法。
Parameters | |
---|---|
proceed |
boolean : Whether or not to continue with the post-dial sequence. |
void registerCallback (Call.Callback callback)
注册一个回调到这个 Call
。
Parameters | |
---|---|
callback |
Call.Callback : A Callback . |
void registerCallback (Call.Callback callback, Handler handler)
注册回调到这个 Call
。
Parameters | |
---|---|
callback |
Call.Callback : A Callback . |
handler |
Handler : A handler which command and status changes will be delivered to. |
void reject (boolean rejectWithMessage, String textMessage)
指示此 STATE_RINGING
Call
拒绝。
Parameters | |
---|---|
rejectWithMessage |
boolean : Whether to reject with a text message. |
textMessage |
String : An optional text message with which to respond. |
void stopDtmfTone ()
指示此Call
停止当前正在播放的任何双音多频信号(DTMF)音。 通过拨打playDtmfTone(char)
播放DTMF音。 如果当前没有DTMF音色正在播放,则此方法不会执行任何操作。
void swapConference ()
在此会议中交换电话。 见CAPABILITY_SWAP_CONFERENCE
。
String toString ()
返回对象的字符串表示形式。 一般来说, toString
方法会返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |
void unregisterCallback (Call.Callback callback)
从此 Call
取消注册回调。
Parameters | |
---|---|
callback |
Call.Callback : A Callback . |