NetCapability 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
定義對應 Android NetworkCapabilities.NET_CAPABILITY_* 常數的值。
public enum NetCapability
type NetCapability =
- 繼承
-
NetCapability
欄位
| 名稱 | 值 | Description |
|---|---|---|
| Mms | 0 | 表示這是一個能連到電信業者的MMSC發送和接收MMS訊息的網路。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Supl | 1 | 表示這是一個能存取電信業者 SUPL 伺服器的網路,該伺服器用於擷取 GPS 資訊。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Dun | 2 | 表示這是一個能夠連達電信業者 DUN 或 tethering gateway 的網路。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Fota | 3 | 表示這是一個能連到電信業者FOTA入口網站的網路,該入口用於空中更新。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Ims | 4 | 表示該網路能連接電信業者的 IMS 伺服器,用於網路註冊與訊號傳遞。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Cbs | 5 | 表示這是一個能連到電信業者CBS伺服器(用於電信業者專屬服務)的網路。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| WifiP2p | 6 | 表示這是一個能夠直接連線 Wi-Fi 對等端的網路。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Ia | 7 | 表示這是一個能夠連達電信業者初始連接伺服器的網路。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Rcs | 8 | 表示這是一個能夠連接到電信業者 RCS 伺服器的網路,該伺服器用於豐富的通訊服務。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Xcap | 9 | 表示這是一個能連接到電信業者用於配置與控制的 XCAP 伺服器的網路。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Eims | 10 | 表示該網路能連接電信業者的緊急IMS伺服器或其他服務,用於緊急通話時的網路訊號傳遞。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| NotMetered | 11 | 表示該網路未被計費。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Internet | 12 | 表示這個網路應該能連上網際網路。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| NotRestricted | 13 | 表示此網路可供一般使用。 若未設定此點,應用程式不應嘗試在此網路上通訊。 請注意,這只是資訊提供,並非執法——執法是透過其他方式處理的。 預設設定。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Trusted | 14 | 表示使用者對此網路表示隱含信任。 這通常代表是 SIM 卡選擇的電信業者、插上乙太網路、配對的藍牙裝置,或使用者要求連接的 Wi-Fi 裝置。 不受信任的網路大概只限於未知的 WiFi AP。 預設設定。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| NotVpn | 15 | 表示這個網路不是 VPN。 此功能預設為 VPN 網路所設,且應明確清除。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Validated | 16 | 表示該網路的連線已成功驗證。 例如,對於有NET_CAPABILITY_INTERNET的網路,代表成功偵測到網際網路連線。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| CaptivePortal | 17 | 顯示這個網絡上次探測時發現有一個被囚禁的傳送門。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| NotRoaming | 18 | 表示這個網路沒有漫遊。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Foreground | 19 | 表示該網路可供應用程式使用,而非為了快速切換而在背景維持的網路。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| NotCongested | 20 | 表示這個網路並不擁擠。 當網路擁擠時,應用程式應延後可待處理的網路流量,例如上傳分析資料。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| NotSuspended | 21 | 表示該網路目前尚未被暫停。 當網路被暫停時,網路的 IP 位址及網路上建立的任何連線仍然有效,但網路暫時無法傳輸資料。 例如,當行動網路在穿越隧道時,訊號暫時中斷時,就可能發生這種情況。具備此能力的網路不會被暫停,因此預期能傳輸資料。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Mcx | 23 | 表示這是一個能夠連達電信業者關鍵任務伺服器的網路。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| TemporarilyNotMetered | 25 | 表示此網路暫時未被計量。 此功能將設定於通常已計量但目前尚未計量的網路,例如因使用者所在區域而未計量。 此功能可隨時更改。 當它被移除時,應用程式必須負責停止任何不應在計量網路上發生的資料傳輸。 請注意,大多數應用程式應該改用NET_CAPABILITY_NOT_METERED。 如需詳細資訊,請參閱 https://developer.android.com/about/versions/11/features/5g#meteredness.
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Enterprise | 29 | 表示此網路為企業用途。 5G URSP 規則可能規定所有資料應使用專門供企業使用的連線。 若請求企業能力,所有企業流量將經由該連線路由。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| HeadUnit | 32 | 表示此網路連接至汽車主機。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| Mmtel | 33 | 表示此網路具備支援多媒體電話服務(MMTEL)的能力。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| PrioritizeLatency | 34 | 表示這個網路應該能優先分配網路延遲。 針對Build.VERSION_CODES的應用程式。UPSIDE_DOWN_CAKE以上,使用 ConnectivityManager.requestNetwork 申請此功能需在自我認證的網路能力中宣告。 請參閱 NetworkRequest 以獲取自我認證文件。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| PrioritizeBandwidth | 35 | 表示這個網路應該能優先分配網際網路的頻寬。 針對Build.VERSION_CODES的應用程式。UPSIDE_DOWN_CAKE以上,使用 ConnectivityManager.requestNetwork 申請此功能需在自我認證的網路能力中宣告。 請參閱 NetworkRequest 以獲取自我認證文件。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| LocalNetwork | 36 | 表示該網路為區域網路。 區域網路是指裝置不直接從網路取得 IP 位址,而是自行宣告 IP 位址的網路。 區域網路的例子包括:USB 共享網路或裝置共享網際網路連線的 Wi-Fi 熱點網路;執行緒網路,目前裝置為執行緒邊界路由器;Wi-Fi P2P 網路,目前裝置是群組擁有者。 用於取得網際網路接取的網路從來不是本地網路。 針對 SDK Build.VERSION_CODES 之前的應用程式。除非網路在 NetworkRequests 中明確設定NET_CAPABILITY_LOCAL_NETWORK,否則VANILLA_ICE_CREAM不會看到具備此功能的網路。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| NotBandwidthConstrained | 37 | 表示這不是頻寬受限的網路。 從Build.VERSION_CODES開始。VANILLA_ICE_CREAM,此功能預設在 NetworkRequests 中設定,且對大多數網路皆為真。 如果網路缺乏此能力,則表示頻寬受限。 頻寬受限的網路無法支援高頻寬資料傳輸,請求並使用這些頻寬的應用程式必須確保其頻寬使用量低於 getLinkDownstreamBandwidthKbps() 和 getLinkUpstreamBandwidthKbps() 所回傳的值,並限制其網路使用頻率。 若應用程式在受限網路上執行高頻寬資料傳輸,或頻繁進行網路存取,系統可能會阻擋該應用程式對網路的存取。 系統可能會採取其他措施來減少受限網路的使用,例如停用非前台應用程式的網路存取。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
| PrioritizeUnifiedCommunications | 38 | 表示此網路已優化用於即時統一通訊,如 Over-the-Top(OTT)語音與視訊通話。 此功能專為處理 Over-the-Top(OTT)語音與視訊通話的應用設計。 它不適用於非 OTT 應用。 此能力向系統表明,網路可能提供專用片以處理高優先權、低延遲的資料路徑。 它可以有兩種使用方式:當系統偵測到有效的 OTT 通話以提升服務品質(QoS)時,可以代表符合資格的應用程式請求具備此能力的網路;OTT 應用程式可直接使用 ConnectivityManager.requestNetwork(NetworkRequest, PendingIntent) 請求具備此功能的網路。 此功能是網路的提示,並不保證該功能會被用於任何通話。 針對Build.VERSION_CODES的應用程式。UPSIDE_DOWN_CAKE以上,使用 ConnectivityManager.requestNetwork 申請此功能需在自我認證的網路能力中宣告。 請參閱 NetworkRequest 以獲取自我認證文件。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。 |
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。