語言

NetCapability 列舉

定義

定義對應 Android NetworkCapabilities.NET_CAPABILITY_* 常數的值。

public enum NetCapability
type NetCapability = 
繼承
NetCapability

欄位

名稱 值 Description
Mms 0

表示這是一個能連到電信業者的MMSC發送和接收MMS訊息的網路。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_MMS

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

Supl 1

表示這是一個能存取電信業者 SUPL 伺服器的網路,該伺服器用於擷取 GPS 資訊。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_SUPL

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

Dun 2

表示這是一個能夠連達電信業者 DUN 或 tethering gateway 的網路。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_DUN

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

Fota 3

表示這是一個能連到電信業者FOTA入口網站的網路,該入口用於空中更新。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_FOTA

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

Ims 4

表示該網路能連接電信業者的 IMS 伺服器,用於網路註冊與訊號傳遞。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_IMS

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

Cbs 5

表示這是一個能連到電信業者CBS伺服器(用於電信業者專屬服務)的網路。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_CBS

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

WifiP2p 6

表示這是一個能夠直接連線 Wi-Fi 對等端的網路。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_WIFI_P2P

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

Ia 7

表示這是一個能夠連達電信業者初始連接伺服器的網路。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_IA

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

Rcs 8

表示這是一個能夠連接到電信業者 RCS 伺服器的網路,該伺服器用於豐富的通訊服務。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_RCS

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

Xcap 9

表示這是一個能連接到電信業者用於配置與控制的 XCAP 伺服器的網路。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_XCAP

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

Eims 10

表示該網路能連接電信業者的緊急IMS伺服器或其他服務,用於緊急通話時的網路訊號傳遞。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_EIMS

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

NotMetered 11

表示該網路未被計費。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_NOT_METERED

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

Internet 12

表示這個網路應該能連上網際網路。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_INTERNET

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

NotRestricted 13

表示此網路可供一般使用。 若未設定此點,應用程式不應嘗試在此網路上通訊。 請注意,這只是資訊提供,並非執法——執法是透過其他方式處理的。 預設設定。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_NOT_RESTRICTED

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

Trusted 14

表示使用者對此網路表示隱含信任。 這通常代表是 SIM 卡選擇的電信業者、插上乙太網路、配對的藍牙裝置,或使用者要求連接的 Wi-Fi 裝置。 不受信任的網路大概只限於未知的 WiFi AP。 預設設定。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_TRUSTED

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

NotVpn 15

表示這個網路不是 VPN。 此功能預設為 VPN 網路所設,且應明確清除。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_NOT_VPN

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

Validated 16

表示該網路的連線已成功驗證。 例如,對於有NET_CAPABILITY_INTERNET的網路,代表成功偵測到網際網路連線。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_VALIDATED

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

CaptivePortal 17

顯示這個網絡上次探測時發現有一個被囚禁的傳送門。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_CAPTIVE_PORTAL

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

NotRoaming 18

表示這個網路沒有漫遊。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_NOT_ROAMING

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

Foreground 19

表示該網路可供應用程式使用,而非為了快速切換而在背景維持的網路。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_FOREGROUND

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

NotCongested 20

表示這個網路並不擁擠。

當網路擁擠時,應用程式應延後可待處理的網路流量,例如上傳分析資料。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_NOT_CONGESTED

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

NotSuspended 21

表示該網路目前尚未被暫停。

當網路被暫停時,網路的 IP 位址及網路上建立的任何連線仍然有效,但網路暫時無法傳輸資料。 例如,當行動網路在穿越隧道時,訊號暫時中斷時,就可能發生這種情況。具備此能力的網路不會被暫停,因此預期能傳輸資料。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_NOT_SUSPENDED

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

Mcx 23

表示這是一個能夠連達電信業者關鍵任務伺服器的網路。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_MCX

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

TemporarilyNotMetered 25

表示此網路暫時未被計量。

此功能將設定於通常已計量但目前尚未計量的網路,例如因使用者所在區域而未計量。 此功能可隨時更改。 當它被移除時,應用程式必須負責停止任何不應在計量網路上發生的資料傳輸。 請注意,大多數應用程式應該改用NET_CAPABILITY_NOT_METERED。 如需詳細資訊,請參閱 https://developer.android.com/about/versions/11/features/5g#meteredness.

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_TEMPORARILY_NOT_METERED

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

Enterprise 29

表示此網路為企業用途。

5G URSP 規則可能規定所有資料應使用專門供企業使用的連線。 若請求企業能力,所有企業流量將經由該連線路由。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_ENTERPRISE

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

HeadUnit 32

表示此網路連接至汽車主機。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_HEAD_UNIT

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

Mmtel 33

表示此網路具備支援多媒體電話服務(MMTEL)的能力。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_MMTEL

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

PrioritizeLatency 34

表示這個網路應該能優先分配網路延遲。 針對Build.VERSION_CODES的應用程式。UPSIDE_DOWN_CAKE以上,使用 ConnectivityManager.requestNetwork 申請此功能需在自我認證的網路能力中宣告。 請參閱 NetworkRequest 以獲取自我認證文件。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_PRIORITIZE_LATENCY

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

PrioritizeBandwidth 35

表示這個網路應該能優先分配網際網路的頻寬。 針對Build.VERSION_CODES的應用程式。UPSIDE_DOWN_CAKE以上,使用 ConnectivityManager.requestNetwork 申請此功能需在自我認證的網路能力中宣告。 請參閱 NetworkRequest 以獲取自我認證文件。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_PRIORITIZE_BANDWIDTH

本頁部分內容為基於 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 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_LOCAL_NETWORK

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

NotBandwidthConstrained 37

表示這不是頻寬受限的網路。 從Build.VERSION_CODES開始。VANILLA_ICE_CREAM,此功能預設在 NetworkRequests 中設定,且對大多數網路皆為真。 如果網路缺乏此能力,則表示頻寬受限。 頻寬受限的網路無法支援高頻寬資料傳輸,請求並使用這些頻寬的應用程式必須確保其頻寬使用量低於 getLinkDownstreamBandwidthKbps() 和 getLinkUpstreamBandwidthKbps() 所回傳的值,並限制其網路使用頻率。 若應用程式在受限網路上執行高頻寬資料傳輸,或頻繁進行網路存取,系統可能會阻擋該應用程式對網路的存取。 系統可能會採取其他措施來減少受限網路的使用,例如停用非前台應用程式的網路存取。

Android 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_NOT_BANDWIDTH_CONSTRAINED

本頁部分內容為基於 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 參考資料。android.net.NetworkCapabilities.NET_CAPABILITY_PRIORITIZE_UNIFIED_COMMUNICATIONS

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

備註

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

適用於