壁纸类型
Mirage 通过 project.json 中的 type 字段识别壁纸类型,并交给对应的渲染进程播放。三种主要类型如下。

真实壁纸库会在同一个界面中标明类型、来源并提供筛选。
场景(scene)
Section titled “场景(scene)”场景壁纸是 Wallpaper Engine 的原生格式,通常包含 scene.json 或打包后的 scene.pkg,以及材质、模型、粒子、着色器等资源。
- 渲染器:SceneWallpaper
- 技术栈:C++20、Vulkan(通过 MoltenVK 转译为 Metal)
- 能力:材质、粒子、LUT 调色、文字渲染、用户属性
网页(web)
Section titled “网页(web)”网页壁纸本质上是一个 HTML 页面,可以运行 JavaScript、播放媒体、响应鼠标事件。
- 渲染器:WebWallpaper
- 技术栈:Objective-C++、WKWebView
- 能力:HTML / CSS / JS、媒体播放、鼠标交互、用户属性
由于网页壁纸会执行脚本,应用来源不明的网页壁纸时 Mirage 会弹出安全确认。详见网页壁纸安全。
视频(video)
Section titled “视频(video)”视频壁纸循环播放一段视频,是最轻量、兼容性最好的类型。你可以直接把视频转换成视频壁纸。
- 渲染器:VideoWallpaper
- 技术栈:Objective-C++、AVFoundation
- 能力:循环播放、音量、速度、填充模式
project.json 中还可能出现 application(应用程序)等类型。Mirage 在筛选中提供「应用程序」和「预设」分类,但对无法识别或不受支持的类型不会启动渲染进程。关于创意工坊预设,见预设。
类型与渲染架构
Section titled “类型与渲染架构”每种类型对应一个独立的渲染进程,彼此隔离运行。想了解进程如何通信、崩溃如何隔离,请阅读渲染架构。
