自訂狀態列系統圖標

狀態列是 Android 系統 UI 的一個元件,持續向使用者顯示重要資訊。本頁介紹如何自訂狀態列系統圖示。要了解有關疊加資源的更多信息,請參閱自訂系統 UI

狀態列

圖 1.狀態列。

特定圖示的疊加

狀態列中顯示的項目的大多數資源都在以下目錄中提供:

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

單一圖示

用法資源意義
警報stat_sys_alarm設定了鬧鐘。
stat_sys_alarm_dim設備處於禪宗模式。
投擲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表示出站活動。
無線上網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 加圖示
ic_g_mobiledata GPRS 圖標
ic_e_mobiledata邊緣圖示
ic_h_mobiledata HSDPA 圖標
ic_h_plus_mobiledata HSDPA 加號圖標
ic_3g_mobiledata 3G圖標
ic_4g_mobiledata 4G圖示
ic_4g_plus_mobiledata 4G 加號圖標
ic_5g_e_mobiledata 5G演進圖標
ic_5g_mobiledata 5G圖標
ic_5g_plus_mobiledata 5G 加圖標
ic_1x_mobiledata 1X 圖示

特殊圖示

這組配置決定是否顯示某些圖示(或不顯示):

價值描述
config_showMin3G當設定為true時,顯示目前資料連線等級的最低圖示是 3G。否則,作為範例,可以顯示 1x。
config_alwaysUseCdmaRssi如果接收訊號強度指示器應始終顯示 CDMA 訊號強度(即使在演進資料最佳化 (EVDO) 上),則設為true
config_hspa_data_distinguishable當 HSPA 資料圖示與通用行動電信系統 (UMTS) 資料圖示區分開時,設定為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顯示4G為3G。
KEY_HIDE_LTE_PLUS_DATA_ICON_BOOL不顯示 LTE Plus。

配置圖示

以下常規配置變數適用於所有狀態列系統圖示:

價值描述
status_bar_system_icon_size更改系統圖示的大小。
status_bar_system_icon_spacing確定係統圖示之間的間距。
config_statusBarIconBlacklist確定哪些系統圖示不應出現在狀態列中。
config_statusBarIcons決定屬於某個配置的圖示的顯示順序。