自訂狀態列系統圖示

狀態列是 Android 系統 UI 的元件，會持續向使用者顯示重要資訊。本頁面說明如何自訂狀態列系統圖示。如要進一步瞭解疊加資源，請參閱「自訂系統 UI」。

狀態列

圖 1. 狀態列。

特定圖示的重疊圖示

下列目錄提供狀態列中顯示項目的大部分資源：

/platform/frameworks/base/packages/SystemUI/res/drawable

單一圖示

用法 資源 意義
警報器 stat_sys_alarm 已設定鬧鐘。
stat_sys_alarm_dim 裝置處於 Zen 模式。
投放 stat_sys_cast 裝置正在投放至其他裝置。
藍牙 stat_sys_data_bluetooth 藍牙已啟用。
stat_sys_data_bluetooth_connected 至少連結了一個藍牙裝置。
數據節省模式 stat_sys_data_saver 裝置處於數據節省模式。
零打擾 stat_sys_dnd 裝置處於「零打擾」模式。
乙太網路 stat_sys_ethernet 裝置已透過乙太網路連線。
stat_sys_ethernet_fully
耳機 stat_sys_headset 已連線至耳機。
stat_sys_headset_mic 已連接的耳機有麥克風。
無線基地台 stat_sys_hotspot 無線基地台已啟用。
stat_sys_managed_profile_status 設定檔正在受管理。
鈴聲 stat_sys_ringer_silent 裝置處於靜音模式。
stat_sys_ringer_vibrate 裝置處於「僅震動」模式。
旋轉 stat_sys_rotate_landscape 螢幕處於橫向模式。
stat_sys_rotate_portrait 螢幕處於直向模式。
已關閉感應器 stat_sys_sensors_off
打字機模式 stat_sys_tty_mode
VPN 圖示 stat_sys_vpn_ic 裝置已啟用 VPN，且 VPN 版本有品牌時顯示。
stat_sys_branded_vpn
位置 perm_group_location 當位置要求的目前狀態為有效時，系統就會顯示此值。
位於 platform/frameworks/base/core/res/res/drawable 中。

複合圖示

來電和撥出圖示指標 Wi-Fi 和行動裝置圖示的傳入和傳出活動圖示指標相同，並會與圖示一併顯示。
ic_activity_down 表示入站活動。
ic_activity_up 表示外出活動。
Wi-Fi ic_wifi_signal_0
ic_wifi_signal_1
ic_wifi_signal_2，
ic_wifi_signal_3
ic_wifi_signal_4		 狀態列會顯示 Wi-Fi 圖示。
實際顯示的圖示取決於訊號強度。
ic_wifi_signal_0 最弱，ic_wifi_signal_4最強。
行動裝置 行動裝置圖示的顯示位置會視行動信號類型而定，只會顯示下列其中一個圖示。
stat_sys_airplane_mode 飛航模式圖示
stat_sys_roaming 漫遊模式圖示
ic_lte_mobiledata LTE 圖示
ic_lte_plus_mobiledata LTE Plus 圖示
ic_g_mobiledata GPRS 圖示
ic_e_mobiledata 邊緣圖示
ic_h_mobiledata HSDPA 圖示
ic_h_plus_mobiledata HSDPA Plus 圖示
ic_3g_mobiledata 3G 圖示
ic_4g_mobiledata 4G 圖示
ic_4g_plus_mobiledata 4G Plus 圖示
ic_5g_e_mobiledata 5G Evolution 圖示
ic_5g_mobiledata 5G 圖示
ic_5g_plus_mobiledata 5G Plus 圖示
ic_1x_mobiledata 1X 圖示

特殊圖示

這組設定會決定是否顯示某些圖示：

值 說明
config_showMin3G 設定為 true 時，顯示目前數據連線等級的最低圖示為 3G。否則，例如，可以顯示 1x。
config_alwaysUseCdmaRssi 如果接收訊號強度指標應一律顯示 CDMA 訊號強度 (即使在 Evolution-Data Optimized (EVDO) 上也是如此)，請將其設為 true。
config_hspa_data_distinguishable 如要將 HSPA Data 圖示與通用行動通訊系統 (UMTS) Data 圖示區分開，請將此值設為 true。
config_inflateSignalStrength 將其設為 true，即可人為地將所有訊號強度解讀為比實際值高一格。

電信業者設定服務也會使用其專屬的設定組合，判斷是否要顯示特定圖示。這些值與特定 SIM 卡相關聯，且無法由原始設備製造商 (OEM) 覆寫。例如：

值 說明
KEY_ALWAYS_SHOW_DATA_RAT_ICON_BOOL 一律顯示「資料」圖示。
KEY_SHOW_4G_FOR_LTE_DATA_ICON_BOOL 顯示 LTE 的 4G。
KEY_SHOW_4G_FOR_3G_DATA_ICON_BOOL 將 3G 顯示為 4G。
KEY_HIDE_LTE_PLUS_DATA_ICON_BOOL 不要顯示 LTE Plus。

設定圖示

下列一般設定變數適用於所有狀態列系統圖示：

值 說明
status_bar_system_icon_size 變更系統圖示的大小。
status_bar_system_icon_spacing 決定系統圖示之間的間距。
config_statusBarIconBlacklist 指出哪些系統圖示絕對不應顯示在狀態列中。
config_statusBarIcons 決定屬於某個設定的圖示應顯示的順序。