PhoneAccountCapability 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
public enum PhoneAccountCapability
type PhoneAccountCapability =
- 繼承
-
PhoneAccountCapability
欄位
| 名稱 | 值 | Description |
|---|---|---|
| ConnectionManager | 1 | 標記表示這個電話帳號可以作為其他連線的連線管理者。 與此電話帳號相關的 ConnectionService 將被允許管理電話,包括使用其專有的電話實作(如 VoIP 通話)來撥打電話,取代電話堆疊。 當使用者選擇使用 SIM 卡電話堆疊撥打電話時,若使用者明確選擇該電話帳號作為預設連線管理器,則會優先嘗試與該電話帳號相關的 ConnectionService。 請參見 getCapabilities()
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| CallProvider | 2 | 標誌表示此電話帳號能撥打電話,取代傳統的SIM卡電話。 此帳戶將被視為與傳統SIM卡電話堆疊並列撥打電話的獨特方式。 此旗幟與 CAPABILITY_CONNECTION_MANAGER 不同,因為它不允許管理或撥打內建電話堆疊中的來電。 請參見 getCapabilities()
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| SimSubscription | 4 | 旗幟顯示此 PhoneAccount 代表內建的 PSTN SIM 訂閱。 只有 Android 框架能註冊具備此功能的電話帳號。 請參見 getCapabilities()
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| VideoCalling | 8 | 標記表示此電話帳號目前能進行視訊通話。 另請參閱CAPABILITY_SUPPORTS_VIDEO_CALLING,說明電話帳號是否支援視訊通話。 請參見 getCapabilities()
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| PlaceEmergencyCalls | 16 | 標記表示此電話帳號具備撥打緊急電話的能力。 預設情況下,所有 PSTN 電話帳號都能撥打緊急電話。 請參見 getCapabilities()
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| CallSubject | 64 | 標記表示此電話帳號支持通話主題。 這表示來電者可以指定一行簡短的主旨行來接外撥電話。 具備功能的接收裝置會在來電畫面顯示來電主體。 請參見 getCapabilities()
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| VideoCallingReliesOnPresence | 256 | 標記表示此電話帳號的視訊通話能力依賴於在線狀態。 只有當電話帳號也有CAPABILITY_VIDEO_CALLING時才應該設定。 注意:自 Android 12 起,使用ContactsContract.DataColumns.CARRIER_PRESENCE欄的 ContactsContract.DataColumns.CARRIER_PRESENCE_VT_CAPABLE 位元來表示聯絡人電話號碼是否支援視訊通話已被淘汰,僅應用於設定為 CarrierConfigManager.KEY_USE_RCS_PRESENCE_BOOL 的裝置。 在較新的裝置上,應用程式必須使用 RcsUceAdapter 來判斷聯絡人的電話號碼是否支援電信業者視訊通話。 請參見 getCapabilities()
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| SupportsVideoCalling | 1024 | 標記顯示此電話帳號支援視訊通話。 這並不代表 PhoneAccount 目前能進行視訊通話,而是表示它有能力進行視訊通話(但目前不一定)。 電話帳號是否能進行視訊通話,最終由CAPABILITY_VIDEO_CALLING決定,這也顯示該帳號目前是否具備視訊通話的能力。 舉例來說,某個電話帳號支援視訊通話(例如 CAPABILITY_SUPPORTS_VIDEO_CALLING),但目前缺乏網路連線導致無法進行視訊通話(例如 CAPABILITY_VIDEO_CALLING)。 請參見 getCapabilities()
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| SelfManaged | 2048 | 此常數在 API 等級 37 中被棄用。 想要整合電信框架的 VoIP 應用,應轉換至 CoreTelecom Jetpack 函式庫所封裝的新電信 VoIP API。 標記表示該電話帳號負責管理自身的連線。 此類 PhoneAccount 非常適合用於不希望使用預設電話 UX,但希望利用電信框架的通話與音訊路由功能的獨立通話應用程式。 設定後,由自我管理的 ConnectionService 所建立的連線不會被 InCallService API 的實作顯示。 因此,自我管理的 ConnectionService 有責任為其 Connections 提供使用者介面。 不過,自行管理的連線會在連接的藍牙裝置上顯示。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Rtt | 4096 | 標記表示此電話帳號能以RTT(即時簡訊)會話撥打電話。 設定後,電信會嘗試對指定應與 RTT 會話接通的外撥通話開啟 RTT 會話,通話中應用程式會顯示 RTT 的文字輸入欄位。 同樣地,通話中應用程式若設定此位元,則可在通話中請求開啟 RTT 會話。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| AdhocConferenceCalling | 16384 | 臨時會議通話是透過向 TelecomManager#startConference(List<Uri>, int videoState)提供地址清單,ConnectionService 負責同時連接所有指定參與者至會議。 這與由通話合併而成的會議(例如使用 Call.mergeConference())形成的會議形成不同。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| CallComposer | 32768 | 標記顯示此電話帳號是否能支援豐富通話的通話組合功能。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| SupportsVoiceCallingIndications | 65536 | 標誌表示此電話帳號提供基於SIM卡的語音通話,可能作為像 wi-fi 通話這類的OTT解決方案。 與CAPABILITY_SUPPORTS_VIDEO_CALLING類似,此功能表示該電話帳號具備撥打語音通話的能力(但不一定是目前)。 該電話帳號是否能撥打語音電話最終由CAPABILITY_VOICE_CALLING_AVAILABLE控制,這也顯示該電話帳號目前是否具備語音通話能力。 舉例來說,某個 PhoneAccount 支援撥打語音通話(例如 CAPABILITY_SUPPORTS_VOICE_CALLING_INDICATIONS),但目前網路連線不足導致無法撥打語音電話(例如 CAPABILITY_VOICE_CALLING_AVAILABLE)。 為了宣告此功能,該電話帳號也必須宣告CAPABILITY_SIM_SUBSCRIPTION或CAPABILITY_CONNECTION_MANAGER並符合相關要求。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| VoiceCallingAvailable | 131072 | 標記表示該電話帳號目前能撥打基於SIM卡的語音通話,類似CAPABILITY_VIDEO_CALLING。 另見CAPABILITY_SUPPORTS_VOICE_CALLING_INDICATIONS,該說明電話帳號是否支援撥打基於SIM卡的語音通話。 為了宣告此功能,該電話帳號也必須宣告CAPABILITY_SIM_SUBSCRIPTION或CAPABILITY_CONNECTION_MANAGER並符合相關要求。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| SupportsTransactionalOperations | 262144 | 標記表示此電話帳號支援交易式 TelecomManager.addCall API 以新增通話。 一款宣稱此功能的應用程式表示其支持更新且更靈活的通話註冊機制。 當此功能設定在電話帳戶上時,電信框架將修正其功能以納入CAPABILITY_SELF_MANAGED。 這讓應用程式能自行管理通話介面與生命週期,同時仍能與 Android 系統整合,進行音訊路由與通話管理。 此功能僅在您的應用程式使用 TelecomManager.addCall 方法來回報新來電與出電時新增。 如果您的應用程式使用 TelecomManager.addNewIncomingCall 或 TelecomManager.placeCall 這些舊有方法,則此功能不應使用。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| SupportsCallStreaming | 524288 | 標記表示這個 VoIP 應用程式 PhoneAccount 支援通話串流會話,透過串流應用程式將通話音訊串流到另一個遠端裝置。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| ChangeRttCallToAudioCall | 1048576 | 旗標表示此電話帳號能將即時簡訊通話(RTT)切換為語音通話。 設定後,通話中的應用程式會顯示「切換語音」選項。 只適用於有CAPABILITY_RTT的手機帳號。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| OptOutOfPremiumNetwork | 2097152 | 標記表示此電話帳號應選擇退出自動請求的高級網路功能。 此設計適用於具備複雜且客製化網路管理邏輯的應用程式,這些邏輯偏好自行處理網路請求,而非依賴系統的自動行為。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。