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

Object

Conferenceable
Connection

屬性: RegisterAttribute

備註

表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。

實作會建立的Connection自定義子類別，並將它當做或ConnectionService#onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)的ConnectionService#onCreateIncomingConnection(PhoneAccountHandle, ConnectionRequest)傳回值傳回至架構。接著，實作會負責更新的狀態 Connection，而且必須呼叫來向架構發出 #destroy() 訊號，表示 Connection 不再使用，而且可能會復原相關聯的資源。

的 Connection 子類別會覆寫 on* 方法，以提供 ConnectionService呼叫功能的實作。 on*電信會呼叫方法，以通知實例該Connection實例Connection的特定動作。

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

Connection如果具有 #CAPABILITY_SUPPORT_HOLD，#onHold()則應該覆寫和 #onUnhold() 方法，以提供的Connection保留支援。

如果支援 Connection 視訊通話的變化（例如 CAPABILITY_SUPPORTS_VT_* 功能位）， #onAnswer(int) 則應覆寫以支援以視訊通話的形式接聽通話。

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...) 方法提供的額外資訊，則應該覆寫此範例。

的 android.telecom.ConnectionJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

Connection()	建立新的連線。
Connection(IntPtr, JniHandleOwnership)	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。

欄位

AudioCodecAmr	已淘汰. 調適型多重速率音訊編解碼器。
AudioCodecAmrWb	已淘汰. 調適型多重速率寬頻音訊編解碼器。
AudioCodecEvrc	已淘汰. 增強型變數速率編解碼器。
AudioCodecEvrcB	已淘汰. 增強型變數速率編解碼器 B。
AudioCodecEvrcNw	已淘汰. 增強的可變速率窄帶-寬頻編解碼器。
AudioCodecEvrcWb	已淘汰. 增強的可變速率寬頻編解碼器。
AudioCodecEvsFb	已淘汰. 增強語音服務全帶音訊編解碼器。
AudioCodecEvsNb	已淘汰. 增強的語音服務窄帶音訊編解碼器。
AudioCodecEvsSwb	已淘汰. 增強的語音服務超級寬頻音訊編解碼器。
AudioCodecEvsWb	已淘汰. 增強的語音服務Wideband音訊編解碼器。
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 增強全速率音訊編解碼器，也稱為 GSM-EFR，GSM 06。
AudioCodecGsmFr	已淘汰. GSM 全速率音訊編解碼器，也稱為 GSM-FR，GSM 06。
AudioCodecGsmHr	已淘汰. GSM 半速率音訊編解碼器。
AudioCodecNone	已淘汰. 表示音訊編解碼器目前未指定或未知。
AudioCodecQcelp13k	已淘汰. 高通程式代碼興奮線性預測 13 千位音訊編解碼器。
CapabilityAddParticipant	已淘汰. 設定時，表示這 `Connection` 支援使用 `#onAddConferenceParticipants(List)`直接新增參與者來啟動電話。
CapabilityRemotePartySupportsRtt	已淘汰. 指出遠端合作物件是否支援 RTT 至 UI。
EventCallHoldFailed	連線事件，用來通知電信呼叫上的保留作業失敗。
EventCallMergeFailed	當合併兩個呼叫失敗時，用來通知 `InCallService`s 的連接事件。
EventCallPullFailed	提取外部呼叫失敗時，用來通知 `InCallService`s 的連接事件。
EventCallRemotelyHeld	連線事件，用來通知 `InCallService`當遠端合作物件已保留呼叫時。
EventCallRemotelyUnheld	連線事件，用來告知 `InCallService`s 何時遠端保存的通話（請參閱 `#EVENT_CALL_REMOTELY_HELD`）已被遠端合作物件保留。
EventCallSwitchFailed	當呼叫上的交換器作業失敗時，用來通知 Telecom 的連線事件。
EventMergeComplete	連接事件，用來通知 `InCallService`何時將 Connection 合併至會議的程式已完成。
EventMergeStart	線上事件，用來告知 `InCallService`s 何時開始將連線合併至會議的程式。
EventOnHoldToneEnd	用來通知 Telecom 的連線事件應該停止保留音調。
EventOnHoldToneStart	用來通知電信的連線事件應該播放保留音調。
EventRttAudioIndicationChanged	用來通知 `InCallService` RTT 音訊指示已變更的連接事件。
ExtraAnsweringDropsFgCall	在狀態中`ConnectionConnection#STATE_RINGING`設定布爾連接額外索引鍵，表示接聽呼叫會導致目前的使用中前景呼叫中斷。
ExtraAnsweringDropsFgCallAppName	在狀態中 `Connection` 設定的 `Connection#STATE_RINGING` 字串連接字串額外金鑰，表示負責目前前景呼叫的第三方應用程式名稱。
ExtraAudioCodec	如果已知，用於目前 `Connection`的音訊編解碼器。
ExtraAudioCodecBandwidthKhz	用於將音訊編解碼器頻寬儲存在 khz 中的浮點數連線額外金鑰，用於目前 `Connection`。
ExtraAudioCodecBitrateKbps	用於將音訊編解碼器比特率儲存為目前 `Connection`的浮點數連接額外索引鍵。
ExtraCallSubject	用來儲存來電主旨的連接額外密鑰。
ExtraChildAddress	用來儲存與目前連線相關聯的子編號的連接額外密鑰。
ExtraIsRttAudioPresent	傳遞 `Connection#sendConnectionEvent` 至的額外項目上設定布爾連接額外索引鍵，表示當額外值為 true 時，RTT 呼叫上會出現音訊。
ExtraLastForwardedNumber	用來儲存與目前連線相關聯的最後一個轉寄號碼的連接額外密鑰。
ExtraLastKnownCellIdentity	最後一個已知的數據格識別密鑰 `CellIdentity` ，用於填入地理位置標頭，以防發生緊急電話。
ExtraSipInvite	用於儲存 IMS 通話來電之 SIP 邀請欄位的字串連接字串
PropertyAssistedDialing	已淘汰. 由架構設定，表示連線正在使用輔助撥號。
PropertyCrossSim	已淘汰. 聯機使用跨 sim 卡技術。
PropertyHasCdmaVoicePrivacy	已淘汰. 表示連線已啟用CDMA增強語音隱私權。
PropertyHighDefAudio	已淘汰. 線上使用高畫質音訊。
PropertyIsAdhocConference	已淘汰. 由架構設定，表示通話為臨機會議。
PropertyIsExternalCall	已淘汰. 設定時，表示 `Connection` 實際上不存在的 `ConnectionService`。
PropertyIsRtt	已淘汰. 由架構設定，表示連線具有與其相關聯的作用中 RTT 工作階段。
PropertyNetworkIdentifiedEmergencyCall	已淘汰. 由架構設定，表示網路已將連線識別為緊急電話。
PropertySelfManaged	已淘汰. 由架構設定，表示 `Connection` 源自自我管理的 `ConnectionService`。
PropertyWifi	已淘汰. 聯機使用 WIFI。
VerificationStatusFailed	已淘汰. 表示網路驗證失敗。
VerificationStatusNotVerified	已淘汰. 表示網路無法執行驗證。
VerificationStatusPassed	已淘汰. 表示網路通過的驗證。

屬性

Address	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。
AddressPresentation	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。
AudioModeIsVoip	要求架構針對此聯機使用 VOIP 音訊模式。
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	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
JniPeerMembers	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。
PeerReference	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
RingbackRequested	傳回此連線是否要求系統代表其播放回音。 -或- 要求架構播放迴響音調。
State	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。
StatusHints	設定標籤和圖示狀態，以顯示在通話內UI中。
ThresholdClass	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。
ThresholdType	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。
VideoState	傳回連線的視訊狀態。

方法

CapabilitiesToString(ConnectionCapability)	將一組功能位（`CAPABILITY_*`）轉譯為人類可讀取的字串。
Clone()	建立並傳回這個對象的複本。 (繼承來源 Object)
CreateCanceledConnection()	`Connection`傳回，表示已取消的連接嘗試。
CreateFailedConnection(DisconnectCause)	`Connection`傳回，表示失敗的連接嘗試。
Destroy()	卸除 Connection 物件。
Dispose()	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
Dispose(Boolean)	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
GetVideoProvider()	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。
HandleRttUpgradeResponse(Connection+RttTextStream)	通知此連線回應先前透過 `#sendRemoteRttRequest`傳送的遠端起始 RTT 升級要求。
JavaFinalize()	當垃圾收集決定不再參考物件時，垃圾收集行程在物件上呼叫。 (繼承來源 Object)
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
NotifyConferenceMergeFailed()	由 `ConnectionService` 呼叫以通知電信 `Conference#onMerge()` 要求失敗。
OnAbort()	通知這個要求中止的要求連線。
OnAddConferenceParticipants(IList<Uri>)	支援直接將參與者新增至進行中的通話來啟動電話。
OnAnswer()	通知此連線，其位於中 `#STATE_RINGING`，要求接受。
OnAnswer(VideoProfileState)	通知此連線，其位於中 `#STATE_RINGING`，要求接受。
OnAvailableCallEndpointsChanged(IList<CallEndpoint>)	通知此連線，指出可用的呼叫端點已變更。
OnCallAudioStateChanged(CallAudioState)	通知這個 Connection， `#getCallAudioState()` 屬性有新的值。
OnCallEndpointChanged(CallEndpoint)	通知此連線音訊端點已變更。
OnCallEvent(String, Bundle)	通知從 `InCallService`起始之事件的這個 Connection`Call`。
OnDeflect(Uri)	通知此連線，其位於 `#STATE_RINGING`中，要求偏轉。
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)	當非 UI `InCallService`將追蹤或不會追蹤此連線時，通知此連線機。
OnUnhold()	通知此要求的連線以結束保留狀態。
OnUsingAlternativeUi(Boolean)	通知此連線何時會或不會由 `InCallService` 提供 InCall UI 的追蹤。
PropertiesToString(Int32)	將一組屬性位（`PROPERTY_*`）轉譯為人類可讀取的字串。
PutExtras(Bundle)	將額外專案新增到這個 `Connection`。
QueryLocationForEmergency(Int64, String, IExecutor, IOutcomeReceiver)	查詢裝置的位置，以撥打緊急電話。
RemoveExtras(IList<String>)	從這個 `Connection`移除額外專案。
RemoveExtras(String[])	從這個 `Connection`移除額外專案。
RequestBluetoothAudio(BluetoothDevice)	要求特定藍牙裝置的音訊路由。
RequestCallEndpointChange(CallEndpoint, IExecutor, IOutcomeReceiver)	要求特定 CallEndpoint 的音訊路由。
SendConnectionEvent(String, Bundle)	將與這個 `Connection` 相關聯事件與相關聯事件額外項目傳送至 `InCallService`。
SendRemoteRttRequest()	通知接聽程式，呼叫的遠端端已要求升級，以在呼叫中包含 RTT 工作階段。
SendRttInitiationFailure(RttSessionModifyResult)	通知接聽程式先前透過或 `#onStartRtt(RttTextStream)` 要求的 RTT 工作階段`ConnectionRequest#isRequestingRtt()`失敗。
SendRttInitiationSuccess()	通知接聽程式先前透過或 `#onStartRtt(RttTextStream)` 成功要求的 RTT 作業階段`ConnectionRequest#isRequestingRtt()`。
SendRttSessionRemotelyTerminated()	通知接聽程式，目前作用中的 RTT 工作階段已由 coll 的遠端端終止。
SetActive()	將狀態設定為使用中（e.
SetAddress(Uri, Presentation)	設定 `#getAddress()` 屬性的值。
SetAudioRoute(CallAudioRoute)	設定音訊路由（喇叭、藍牙等。
SetCallerDisplayName(String, Presentation)	設定呼叫端顯示名稱（CNAP）。
SetConferenceableConnections(IList<Connection>)	設定此連線可進行會議的連接。
SetDialing()	將狀態設定為撥號（e.
SetDisconnected(DisconnectCause)	將狀態設定為已中斷連線。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetInitialized()	將狀態設定為已初始化（已設定連線，現在已準備好使用）。
SetInitializing()	將狀態設定為初始化（此連線尚未準備好使用）。
SetNextPostDialChar(Char)	通知接聽程式，這 `Connection` 已處理撥號后啟動狀態中的字元。
SetOnHold()	將狀態設定為保留狀態。
SetPostDialWait(String)	通知接聽程式，這是 `Connection` 處於撥號后等候狀態。
SetPulling()	將狀態設定為提取（e.
SetRinging()	將狀態設定為響鈴（e.
SetVideoProvider(Connection+VideoProvider)	設定影片連線提供者。
SetVideoState(VideoProfileState)	設定連線的視訊狀態。
StateToString(ConnectionState)	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。
ToArray<T>()	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
Wait()	讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)

明確介面實作

IJavaPeerable.Disposed()	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
IJavaPeerable.Finalized()	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。
GetJniTypeName(IJavaPeerable)	表示與遠端端點的通話或連線，該端點會攜帶語音和/或視訊流量。

適用於

共用方式為

Connection 類別

定義

備註

建構函式

欄位

屬性

方法

明確介面實作

擴充方法

適用於

其他資源