SuperAPI AI 工具集

visionos-widgets

通用与其它

查看项目

更新于 10-16 01:14

技能介绍

用途:为 visionOS 构建存在于物理空间中的小组件,覆盖挂载样式、材质、邻近感知细节层级、空间尺寸族与渲染模式。适用于创建或适配 visionOS 小组件、处理 elevated/recessed 挂载、玻璃或纸张材质、邻近感知、.systemExtraLargePortrait,以及把 iOS/iPadOS 小组件移植到 visionOS。

主要能力:挂载样式 .elevated(默认,置于桌面等表面)与 .recessed(嵌入墙面,仅垂直面有效),可用 .supportedMountingStyles([.elevated, .recessed]) 同时支持;材质 .widgetTexture(.glass)(默认,透明融合环境)与 .paper(不透明,适合丰富图像);尺寸族 .systemSmall、.systemMedium、.systemLarge、.systemExtraLarge 及 visionOS 专属 .systemExtraLargePortrait;通过 @Environment(.levelOfDetail) 在 .default 与 .simplified 间自动切换布局;用 .containerBackground(for: .widget) 标记可移除背景以适配强调色渲染模式。

使用方式:在 WidgetConfiguration 上声明 .supportedFamilies 与 .supportedMountingStyles、.widgetTexture;视图中读取 levelOfDetail 与 showsWidgetContainerBackground 分支渲染;多平台目标用 #if os(visionOS) 保护专属尺寸族;用 #Preview(as:) 预览。

限制与注意:.supportedMountingStyles、.widgetTexture、levelOfDetail、.systemExtraLargePortrait 需 visionOS 2.0;水平面始终为 elevated 并带轻微倾斜;小组件为持久房间固定物,用户可缩放 75%–125%,边框宽度五档且边框始终接受用户色调;资源需高分辨率;levelOfDetail 分支应含 @unknown default;避免未标记背景导致强调色模式空白。具体收费与平台支持暂未提供。