自訂狀態列系統圖示

狀態列是 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 表示出城活動。
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「進化」圖示
ic_5g_mobiledata 5G 圖示
ic_5g_plus_mobiledata 5G Plus 圖示
ic_1x_mobiledata 1X 圖示

特殊圖示

這組設定會決定部分圖示是否顯示 (或不會顯示):

說明
config_showMin3G 設為 true 時,最低圖示會顯示目前數據連線等級 3G 網路。否則,可以顯示 1 倍。
config_alwaysUseCdmaRssi 如果收到的訊號強度指標應一律顯示 CDMA,則設為 true 信號強度,甚至是「進化資料最佳化」(EVDO)
config_hspa_data_distinguishable 設為true的時機 HSPA 資料圖示與通用行動通訊系統 (UMTS) 有所區別 資料圖示。
config_inflateSignalStrength 設為 true 到 人為把所有訊號強度解讀為比實際高 1 高的指標。

電信業者設定服務也會以自家設定組合來判斷 特定圖示的畫面這些值與特定 SIM 卡相關聯,無法設定 已由原始設備製造商覆寫例如:

說明
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 決定屬於設定的圖示顯示順序。