材料瑶池

# Weather Live Wallpaper and Widget ## Project Overview This project implements a dynamic wallpaper system based on weather conditions and time of day. Core features include: dynamically adjusting wallpaper colors (sky, mountains, sun/moon) based on time; adding visual effects such as rain, snow, clouds, and lightning based on real-time weather data; supporting local storage and management of weather data; and adaptive brightness adjustment based on time and weather conditions. ## Main Components ### Data Model - **WeatherData.kt**: The data model for storing and transmitting weather information. - **WeatherManager.kt**: The management class responsible for storing, retrieving, and updating weather data. ### Visual Effects - **WeatherEffectRenderer.kt**: The weather effect rendering core, supporting effects such as rain, snow, and clouds. Features include: using VectorChildFinder to load SVG snowflakes (snow_new.xml), achieving a three-layer depth effect (supporting scaling, rotation, and transparency), and providing bitmap and circle drawing fallbacks. - **WallpaperColorHelper.kt**: A utility class that handles wallpaper color conversion and time-related color logic. ### Wallpaper Service and Settings - **LiveWallpaperService.kt**: A live wallpaper service that integrates time and weather effects. - **SettingsScreen.kt**: A wallpaper settings interface that includes functions for retrieving and saving weather data. ### Resource Files Includes graphic resources such as raindrops (raindrop.xml), snowflakes (snowflake.xml, snow_new.xml), and clouds (cloud_1.xml, cloud_2.xml). ### Core Functionality Upgrade ### Celestial System Refactoring (v4.2): A realistic lunar moon phase system #### 24-hour closed-loop celestial cycle - **Solar Cycle**: Motion from 6 AM to 6 PM, gradually disappearing from 6 PM to 6:30 PM, hidden from 6:30 PM to 5:30 AM, and gradually appearing from 5:30 AM to 6 AM. - **Lunar Cycle**: Rise from 7 PM to 12 AM, remains constant from 12 AM to 2 AM, descends from 2 AM to 5 AM, fades from 5 AM to 5:30 AM, and hides from 5:30 AM to 7 PM. #### Sun and Moon Structure - **Three-Layer Sun Design**: Core (80dp, 100% opaque), middle (radius + 18dp, 30% transparent), outer (radius + 18dp again, 10% transparent). Color changes with time of day: sunrise (EC7D8C pink), daytime (FFFFFF white), sunset (EBE600 yellow), and hides at night. - **Three-Layer Moon Design**: Moon Phase Center (eight dynamic phases, 100% transparent), middle circle (white, 40% transparent), outer circle (white, 15% transparent). #### Moon Phase System - **29.5-day true cycle**: Based on the new moon on January 11, 2024, corresponding lunar dates are: New Moon (lunar day 1) → Crescent Moon (3-6) → First Quarter Moon (7-8) → Waxing Gibbous Moon (11-14) → Full Moon (15-16) → Waning Gibbous Moon (18-21) → Last Quarter Moon (22-23) → Waning Moon (25-29). - **SVG Rendering**: Uses eight independent SVG files (e.g., moon_new.xml and moon_full.xml) instead of complex path drawing, improving performance and visual quality. #### Weather Limitations and Technical Implementation - The sun and moon are only displayed in clear weather (WeatherType.CLEAR); they are hidden in other weather conditions. - Based on the CelestialBodyManager architecture, this implements a symmetrical trajectory algorithm (sun in the upper left corner, moon in the upper right corner), unified time units, and accurate dp/px conversion. ### HSL Color System Refactoring (v2.0): Professional Color Management #### Core Improvements - **WeatherColorManager**: An independent color management class that uses HSL (hue, saturation, brightness) triples to uniformly manage colors and implement standard HSL-RGB conversion. - **WeatherColorScheme**: Configures a complete color scheme for each weather type, supporting automatic day/night switching. #### Specialized Weather Coloring - **Snowy Weather**: Uses a light gray-blue hue during the day (background hsl (215, 14%, 79%), front mountain hsl (0, 0%, 94%), etc.), reducing the brightness to a dark gray-blue hue at night, with snowflakes remaining pure white (hsl (0, 0%, 100%)). - **Rainy Weather**: Uses a light gray hue during the day (background hsl (173, 4%, 81%)), and a dark gray-blue hue at night (background hsl (220, 36%, 33%)). The colors of the front and back mountains, as well as the clouds, match the scene. ### Weather Effects Optimization #### Snowflake Rendering (v1.3) - SVG snowflake support: Pre-rendered as a bitmap cache, sized within 4-12dp, divided into three layers (foreground 8-12dp, midground 6-10dp, background 4-8dp), with animation linked to wind speed. - Dedicated color scheme: Switches to a fixed HSL color scheme when snowing, ignoring 24-hour time fluctuations. #### Rain Effects (v2.3) - Optimized raindrop speed (15-35 pixels/frame), distribution (10x8 grid), and continuity (reset interval 10-50 pixels). - Density grading: 60 for light rain, 90 for moderate rain, and 120 for heavy rain. Raindrop length (20-60 pixels), transparency, and width vary with intensity. #### Lightning Effects (v2.5) - SVG Vector Lightning: Load resources such as lightning8.xml, set to pure white using a color filter, and randomly rotate (-180° to +180°). - Flash Effect: Increases full-screen brightness (25% peak) when lightning occurs. Use HSL brightness/saturation adjustments to create a gradient flash, and use a radial aperture to enhance the sense of depth. ### Precipitation Intensity and Debugging #### Precipitation Intensity System (v2.4) - Provides four intensity levels for rain, lightning, and snowfall: light, medium, heavy, and very heavy, reflecting specific precipitation amounts (e.g., light rain 2mm/h, moderate rain 8mm/h). - Live Adjustment in the Floating Window: Intensity options are only displayed during precipitation events and take effect immediately. #### Weather Debug Floating Window - Features: Supports 11 weather types, 4 wind speed levels, real-time adjustment of sunrise/sunset modes, and switching between debugging mode (20-second check interval) and normal mode (30 minutes). - Permission Management: Automatically guides you in granting floating window permissions. The interface uses Material Design 3. ## Extensibility - Adding new weather types requires: adding the type to WeatherType, implementing rendering in WeatherEffectRenderer, adding resource files, and adding options to the floating window. - Reserved AR special effects interface, supports custom effect intensity and color configuration, and is compatible with multiple devices. This system combines astronomical accuracy with visual aesthetics, achieving a harmonious union of science and aesthetics through a 24-hour celestial cycle, a 29.5-day lunar phase cycle, dynamic color matching, and refined special effects.