用途
device-frames 用于创建带设备外框的截图、产品图、视频或实时 UI 模拟,典型场景是把一张图片、一段录屏、一个网页或一个组件放进手机、平板、手表、笔记本或显示器的屏幕中展示。它要求先明确交付物:设备、方向、内容、输出格式、背景和尺寸;缺失的选择若会实质影响结果才询问,否则采用合理默认值。若未提供素材,则使用空白屏幕或简单的原创占位内容。
主要能力
- 支持图片、视频和实时组件三种交付形式:按请求构建实时组件、渲染图片或合成视频。
- 屏幕与硬件分层绘制:用 CSS 和 SVG 或等效矢量工具分别绘制屏幕、外框、边框、玻璃、按键、支架和摄像头,屏幕按显示轮廓裁剪,开孔位于屏幕内容之上。
- 等比缩放与媒体适配:内容按屏幕原生宽高比布局,整个设备统一缩放;媒体不拉伸,用 cover 裁剪或用 contain 保留,并报告裁剪情况。
- 设备几何参考:资料给出 iPhone 17/18 Pro、iPhone 18 Pro Max、iPhone Air、iPhone Duo(闭合与展开)、iPad Pro 11/13 英寸、Apple Watch Series 12(46mm/42mm)、MacBook Pro 14/16 英寸、MacBook Neo 13 英寸、Studio Display 等设备的屏幕点数尺寸、机身毫米尺寸、摄像头位置、圆角轮廓和按键参数。
- 折叠屏处理:iPhone Duo 展开时为一整块连续内屏,不在中间画黑条、缝隙、两个屏幕面板或中央圆角;铰链细节只能放在显示区域之外的薄外壳上;内屏摄像头默认隐藏。
- 横屏处理:硬件与屏幕几何一起旋转,内容保持正向。
- 输出校验:图片按请求像素尺寸渲染并支持透明通道;视频使用与边框相同的屏幕裁剪或遮罩,尽量保留时序和音频,透明输出需选择真正支持 alpha 的编码与容器;实时 UI 在需要时保持可交互,装饰性硬件层不得拦截输入。
使用方式
先检查项目现有工具与约定,不假定已有外框库、脚本、服务器或浏览器;添加依赖或改动无关项目代码前需询问。随后确定交付参数,使用提供的素材或占位内容,按需构建组件、渲染图片或合成视频。设备保持静止,除非要求动画。绘制时用逻辑点布局,输出像素取决于缩放和像素密度,不一定等于物理面板分辨率。资料还给出以毫米为单位的实测硬件数据与坐标换算示例(如闭合 Duo 的 k = 466 / 77.17 ≈ 6.0386 点/毫米),用于提高物理还原度。
适用场景
适合产品展示图、应用商店截图包装、设计稿演示、营销素材中的设备场景,以及需要在网页中嵌入可交互设备预览的场合。
限制
- 资料明确要求用确定性矢量几何构建外框,而非生成式图像合成;若没有矢量或程序化渲染工具,应报告限制,而不是用 AI 生成的设备替代。
- 部分尺寸为推断或近似值,例如 iPhone Duo 展开屏 951 × 669 为近似值,并非经验证的原生点尺寸;笔记本和显示器的正面视图参数为视觉近似,不是实测硬件。
- 闭合与展开的 Duo 外框不模拟折叠过程、分屏、预留区域或 iOS 布局变化。
- 不得添加厂商标志或暗示背书;不得把厂商图纸或营销图片作为外框的一部分交付。
- 屏幕尺寸本身不能证明硬件形状准确,没有合适正面参考时应说明为近似,不能仅凭屏幕分辨率声称像素级精确。
- 交付前需实际检查图像或代表性视频帧;若无法进行视觉检查或播放,应如实说明。
- 资料未提供收费、价格、平台支持范围等信息。