Connection 類別

定義

命名空間:: Android.Telecom

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

代表一通電話或連接到承載語音和/或視訊流量的遠端端點。

[Android.Runtime.Register("android/telecom/Connection", ApiSince=23, DoNotGenerateAcw=true)]
public abstract class Connection : Android.Telecom.Conferenceable

[<Android.Runtime.Register("android/telecom/Connection", ApiSince=23, DoNotGenerateAcw=true)>]
type Connection = class
    inherit Conferenceable

繼承: Object

JavaObject

Object

Conferenceable
Connection

屬性: RegisterAttribute

備註

代表一通電話或連接到承載語音和/或視訊流量的遠端端點。

實作會建立一個Connection自訂子類別，並將其以或 ConnectionService#onCreateIncomingConnection(PhoneAccountHandle, ConnectionRequest)的回傳值ConnectionService#onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)回傳給框架。實作者負責更新的狀態 Connection，並必須呼叫 #destroy() 以向框架發出訊號，表示該已不再使用， Connection 相關資源可被恢復。

子 Connection 類別覆蓋了 on* 方法，以提供 ConnectionService呼叫功能的實作。 on*這些方法由電信公司呼叫，以告知該實例Connection特定Connection動作的資訊。

基本呼叫支援需要覆蓋以下方法：#onAnswer()、、 #onDisconnect()#onReject()，#onAbort()

若 Connection 有，則 #CAPABILITY_SUPPORT_HOLD#onHold() 與方法應被覆寫以提供保持支持 #onUnhold()Connection。

若 a Connection 支援視訊通話的變體（例如 CAPABILITY_SUPPORTS_VT_* 功能位 #onAnswer(int) 元），則應被覆寫以支援視訊通話接聽。

其中 a Connection 具有 #PROPERTY_IS_EXTERNAL_CALL 和 #CAPABILITY_CAN_PULL_CALL， #onPullExternalCall() 應被覆寫以提供拉取外部呼叫的支援。

在某處 Connection ，應該會被覆蓋的電話會議 #onSeparate() 。

根據是否涉及電信相關的通話，還有其他 on* 多種實作方法 Connection 可供選擇。例如，如果處理來自的 InCallService 呼叫事件， #onCallEvent(String, Bundle) 則應被覆寫。另一個例子是 #onExtrasChanged(Bundle)，若Connection想利用和 Call#putExtras(Bundle) 方法提供的Call#removeExtras(String...)額外資訊，則應覆寫該參數。

Java 文件 android.telecom.Connection。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
Connection()	建立新的連結。
Connection(IntPtr, JniHandleOwnership)	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。

欄位

名稱	Description
AudioCodecAmr	已淘汰. 自適應多速率音訊編碼器。
AudioCodecAmrWb	已淘汰. 自適應多速率寬頻音訊編碼器。
AudioCodecEvrc	已淘汰. 增強型可變速率編碼器。
AudioCodecEvrcB	已淘汰. 增強型可變速率編碼器B。
AudioCodecEvrcNw	已淘汰. 增強型可變速率 Narrowband-Wideband 編解碼器。
AudioCodecEvrcWb	已淘汰. 增強型可變速率寬頻編解碼器。
AudioCodecEvsFb	已淘汰. 增強語音服務全頻音頻編碼器。
AudioCodecEvsNb	已淘汰. 增強語音服務窄頻音訊編碼器。
AudioCodecEvsSwb	已淘汰. 增強語音服務 Super-Wideband 音訊編解碼器。
AudioCodecEvsWb	已淘汰. 增強語音服務寬頻音訊編碼器。
AudioCodecG711a	已淘汰. ITU-T G711A 音訊編解碼器。
AudioCodecG711ab	已淘汰. ITU-T G711AB 音訊編解碼器。
AudioCodecG711u	已淘汰. ITU-T G711U 音訊編碼器。
AudioCodecG722	已淘汰. ITU-T G722 音訊編碼器。
AudioCodecG723	已淘汰. ITU-T G723 音訊編碼器。
AudioCodecG729	已淘汰. ITU-T G729 音訊編碼器。
AudioCodecGsmEfr	已淘汰. GSM 增強 Full-Rate 音訊編解碼器，也稱為 GSM-EFR，GSM 06。
AudioCodecGsmFr	已淘汰. GSM Full-Rate 音訊編解碼器，也稱為 GSM-FR、GSM 06。
AudioCodecGsmHr	已淘汰. GSM 半費率音訊編碼器。
AudioCodecNone	已淘汰. 表示音訊編解碼器目前未指定或未知。
AudioCodecQcelp13k	已淘汰. 高通編碼激發線性預測 13 千位元音訊編碼器。
CapabilityAddParticipant	已淘汰. 設定時，表示支援 `Connection` 透過直接 `#onAddConferenceParticipants(List)`加入參與者來啟動電話會議。
CapabilityRemotePartySupportsRtt	已淘汰. 顯示遠端方是否支援 RTT 至 UI。
CapabilityTransfer	已淘汰. 表示此號碼 `Connection` 可轉接至其他號碼。
CapabilityTransferConsultative	已淘汰. 表示這 `Connection` 能對另一 `Connection` 部同樣具備此功能的進行諮詢轉移。
EventCallHoldFailed	連線事件用於通知電信通話的保留操作失敗。
EventCallMergeFailed	連接事件用於通知 `InCallService`s 兩通通話合併失敗。
EventCallPullFailed	用於通知 `InCallService`s 拉取外部通話失敗的連線事件。
EventCallRemotelyHeld	連線事件用於通知 `InCallService`s 何時通話已被遠端方暫停。
EventCallRemotelyUnheld	連線事件用於通知 `InCallService`s，當遠端通話（見 `#EVENT_CALL_REMOTELY_HELD`）已被遠端方解除接線時。
EventCallResumeFailed	連接事件用於通知電信公司通話恢復操作失敗。
EventCallSwitchFailed	連接事件用於通知電信通話中的交換操作失敗。
EventDisconnectFailed	連接事件用於通知電信在通話合併過程中斷線請求失敗。
EventMergeComplete	連接事件用於通知 `InCallService`s，何時將連接合併到會議的過程完成。
EventMergeStart	連接事件用來通知 `InCallService`s 何時開始將 Connection 合併成會議的過程。
EventOnHoldToneEnd	連線事件用來通知電信應該停止等待音。
EventOnHoldToneStart	連接事件用來通知電信應該播放等待音。
EventRttAudioIndicationChanged	連接事件用於通知 RTT `InCallService` 音訊指示已變更。
ExtraAnsweringDropsFgCall	在 in `Connection` 狀態上設定`Connection#STATE_RINGING`布林連線額外鍵，表示接聽通話會導致當前當前的前台通話被中斷。
ExtraAnsweringDropsFgCallAppName	在狀態`Connection`上設定`Connection#STATE_RINGING`額外鍵，指示負責當前前景通話的第三方應用程式名稱。
ExtraAudioCodec	目前使用的 `Connection`音訊編解碼器（若已知）。
ExtraAudioCodecBandwidthKhz	浮點連線額外鍵用於儲存音訊編解碼器頻寬（以 khz）表示當前 `Connection`。
ExtraAudioCodecBitrateKbps	浮點連接額外金鑰用於儲存音訊 `Connection`編解碼器位元率（kbps），目前。
ExtraCallSubject	連線額外鍵用於儲存來電主體。
ExtraChildAddress	連線額外金鑰用於儲存與目前連線相關的子號碼。
ExtraIsRttAudioPresent	在傳遞給 `Connection#sendConnectionEvent` 的額外資料上設定布林連線額外鍵，表示當額外值為真時，RTT 呼叫中有音訊。
ExtraLastForwardedNumber	連接額外金鑰用於儲存與目前連線相關的最後轉發號碼。
ExtraLastKnownCellIdentity	最後已知的基地識別金鑰 `CellIdentity` 用於緊急呼叫時填補地理位置標頭。
ExtraSipInvite	字串連線額外金鑰，用於儲存 IMS 通話來電的 SIP 邀請欄位
PropertyAssistedDialing	已淘汰. 由框架設定，表示連線正在使用輔助撥號。
PropertyCrossSim	已淘汰. 連線使用跨SIM技術。
PropertyHasCdmaVoicePrivacy	已淘汰. 表示該連線已啟用 CDMA 增強語音隱私。
PropertyHighDefAudio	已淘汰. 連線方式是使用高畫質音訊。
PropertyIsAdhocConference	已淘汰. 框架設定為表示通話為臨時電話會議。
PropertyIsExternalCall	已淘汰. 當為時，表示在`Connection`局部中實際上不存在。`ConnectionService`
PropertyIsRtt	已淘汰. 框架設定為表示連線中有活躍的 RTT 會話。
PropertyIsTetheredCall	已淘汰. 由 a `ConnectionService` 設定為表示該 `Connection` 通話與主要裝置同步的有線通話。
PropertyNetworkIdentifiedEmergencyCall	已淘汰. 框架設定為表示網路已識別連線為緊急呼叫。
PropertySelfManaged	已淘汰. 由框架設定，表示該系統 `Connection` 源自自我管理 `ConnectionService`的。
PropertyWifi	已淘汰. 連線是用 WIFI。
StateAudioProcessing	已淘汰. 通話狀態在網路中仍然活躍，但通話音訊被本地裝置上的應用程式截取。
StateSimulatedRinging	已淘汰. 在進入 `#STATE_AUDIO_PROCESSING`。
VerificationStatusFailed	已淘汰. 表示網路驗證失敗。
VerificationStatusNotVerified	已淘汰. 表示網路無法進行驗證。
VerificationStatusPassed	已淘汰. 表示網路驗證通過了。

屬性

名稱	Description
Address	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
AddressPresentation	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
AudioModeIsVoip	請求框架在此連線中使用 VOIP 音訊模式。
AudioProcessingUseCase	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
CallAudioState	此會員已被棄用。
CallerDisplayName	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
CallerDisplayNamePresentation	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
CallerNumberVerificationStatus	取得 ATIS-1000082 中來電電話號碼的驗證狀態。 -或- 設定來電電話號碼的驗證狀態，該號碼在 ATIS-1000082 中識別。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Conference	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
Conferenceables	回傳可用於該連結的連結或會議。 -或- 類似於 `#setConferenceableConnections(java.util.List)`，會列出可與此連接進行聯繫的連結或會議。
ConnectionCapabilities	回傳連線的能力，作為常數的位元遮罩 `CAPABILITY_` 。 -或- 將連線能力設為CAPABILITY_`常數的位元遮罩`。
ConnectionProperties	回傳連線的屬性，作為常數的位元遮罩 `PROPERTY_` 。 -或- 將連線屬性設定為PROPERTY_`常數的位元遮罩`。
CurrentCallEndpoint	取得目前的 CallEndpoint。
DisconnectCause	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
Extras	回傳與此連線相關的額外內容。 -或- 設定一些可與此 `Connection`相關聯的額外值。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)
JniPeerMembers	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
RingbackRequested	回傳此連線是否請求系統代為播放回鈴音。 -或- 請求框架播放回鈴音。
State	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
StatusHints	在通話中介面中設定標籤和圖示狀態顯示。
ThresholdClass	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
ThresholdType	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
VideoState	回傳連線的視訊狀態。

方法

名稱	Description
CapabilitiesToString(ConnectionCapability)	將一組能力位元（`CAPABILITY_*`）呈現為人類可讀的字串。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)
CreateCanceledConnection()	回傳 a `Connection` ，代表連線嘗試被取消。
CreateFailedConnection(DisconnectCause)	回傳 a `Connection` ，代表連線嘗試失敗。
Destroy()	拆毀連結物件。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)
Equals(Object)	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetVideoProvider()	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
HandleRttUpgradeResponse(Connection+RttTextStream)	通知此連線先前遠端發起的 RTT 升級請求 `#sendRemoteRttRequest`回應。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
NotifyConferenceMergeFailed()	A打電話 `ConnectionService` 通知電信公司申請 `Conference#onMerge()` 失敗。
OnAbort()	通知此連線中止請求。
OnAddConferenceParticipants(IList<Uri>)	支援透過直接將參與者加入正在進行的通話來啟動電話會議。
OnAnswer()	通知此連線（位於 `#STATE_RINGING`，）有請求接受。
OnAnswer(VideoProfileState)	通知此連線（位於 `#STATE_RINGING`，）有請求接受。
OnAvailableCallEndpointsChanged(IList<CallEndpoint>)	通知此連線可用的呼叫端點已被更改。
OnCallAudioStateChanged(CallAudioState)	通知此連結該 `#getCallAudioState()` 房產有新價值。
OnCallEndpointChanged(CallEndpoint)	通知此連線音訊端點已被更改。
OnCallEvent(String, Bundle)	通知此連線一個 `Call` 事件由 `InCallService`。
OnDeflect(Uri)	通知此位於 `#STATE_RINGING`的 Connection，有請求偏轉。
OnDisconnect()	通知此連線有請求斷線。
OnExtrasChanged(Bundle)	通知此 `Connection` 地，關於外面額外內容 `ConnectionService`的變更。
OnHandoverComplete()	通知此 `Connection` 訊息交接已完成。
OnHold()	通知此連線請求暫停。
OnMuteStateChanged(Boolean)	通知此連線其音訊靜音狀態已被更改。
OnPlayDtmfTone(Char)	通知此連線有請求播放 DTMF 音調。
OnPostDialContinue(Boolean)	通知此連線用戶是否希望繼續撥號後的 DTMF 代碼。
OnPullExternalCall()	通知此連線有請求拉取外部呼叫至本地裝置。
OnReject()	通知這個屬於 `#STATE_RINGING`的連線，有拒絕請求。
OnReject(Int32)	通知這個屬於 `#STATE_RINGING`的連線，有拒絕請求。
OnReject(String)	以訊息通知此連線（該連線在 `#STATE_RINGING`中）有拒絕請求。
OnSeparate()	通知本連結申請脫離母會議。
OnShowIncomingCallUi()	通知此`Connection`事，其`ConnectionService`負責顯示其來電使用者介面。`Connection`
OnSilence()	通知此連線請求靜音鈴聲。
OnStartRtt(Connection+RttTextStream)	通知使用者 `Connection` 已申請 RTT 會話。
OnStateChanged(CallState)	通知此連線內部狀態變更。
OnStopDtmfTone()	通知此連線請求停止目前播放的任何 DTMF 音調。
OnStopRtt()	通知此 `Connection` 訊息應終止任何現有的RTT通訊通道。
OnTrackedByNonUiService(Boolean)	通知這個連結何時會被非使用者介面 `InCallService`追蹤。
OnTransfer(Connection)	通知此連線開始向另一個連線進行諮詢性轉移的請求。
OnTransfer(Uri, Boolean)	通知此連線有轉接至目標號碼的請求。
OnUnhold()	通知此連線有請求退出暫停狀態。
OnUsingAlternativeUi(Boolean)	告知此連線何時會被追蹤 `InCallService` ，該連線可提供通話介面。
PropertiesToString(Int32)	將一組屬性位元（`PROPERTY_*`）渲染成人類可讀的字串。
PutExtras(Bundle)	這還加了點額外內容 `Connection`。
QueryLocationForEmergency(Int64, String, IExecutor, IOutcomeReceiver)	查詢裝置位置以便撥打緊急電話。
RemoveExtras(IList<String>)	移除了這些 `Connection`額外的內容。
RemoveExtras(String[])	移除了這些 `Connection`額外的內容。
RequestBluetoothAudio(BluetoothDevice)	請求音訊路由到特定的藍牙裝置。
RequestCallEndpointChange(CallEndpoint, IExecutor, IOutcomeReceiver)	請求音訊路由到特定的呼叫端點。
SendConnectionEvent(String, Bundle)	會將與此`Connection`相關事件及相關事件額外內容傳送到。`InCallService`
SendRemoteRttRequest()	通知聽眾，通話遠端已申請升級，將 RTT 會話納入通話中。
SendRttInitiationFailure(RttSessionModifyResult)	通知聽眾先前請求的 RTT 會話`ConnectionRequest#isRequestingRtt()#onStartRtt(RttTextStream)`已失敗。
SendRttInitiationSuccess()	通知聽眾先前請求的 RTT 會話`ConnectionRequest#isRequestingRtt()#onStartRtt(RttTextStream)`已成功。
SendRttSessionRemotelyTerminated()	通知聽眾目前活躍的 RTT 會話已被遠端終端終止。
SetActive()	將狀態設為主動（例如：
SetAddress(Uri, Presentation)	設定房產價值 `#getAddress()` 。
SetAudioProcessing(Int32)	將狀態設定為音訊處理（例如：
SetAudioRoute(CallAudioRoute)	設定音訊路由（喇叭、藍牙等）。
SetCallerDisplayName(String, Presentation)	設定來電顯示名稱（CNAP）。
SetConferenceableConnections(IList<Connection>)	設定可與此連結建立的連結。
SetDialing()	將狀態設定為撥號（例如：
SetDisconnected(DisconnectCause)	將狀態設為斷開。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetInitialized()	將狀態設為初始化（連線已設定並準備使用）。
SetInitializing()	設定初始化狀態（此連線尚未準備好使用）。
SetNextPostDialChar(Char)	通知聽眾此系統 `Connection` 已處理一個字元，處於撥號後開始狀態。
SetOnHold()	設定狀態為待機狀態。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)
SetPostDialWait(String)	告知聽眾此處 `Connection` 為撥號後等待狀態。
SetPulling()	將狀態設為拉取（例如：
SetRinging()	將狀態設為響鈴（例如：
SetSimulatedRinging()	將狀態設為模擬環鈴，使用者在進入 `#STATE_AUDIO_PROCESSING`後會呈現。
SetVideoProvider(Connection+VideoProvider)	設定視訊連線供應商。
SetVideoState(VideoProfileState)	設定連線的視訊狀態。
StateToString(ConnectionState)	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	代表一通電話或連接到承載語音和/或視訊流量的遠端端點。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於