USDZ 示例文件 — 下载用于 AR 和测试的 USDZ 模型
USDZ — 通用场景描述（压缩包） · .usdz · MIME 类型 model/vnd.usdz+zip
下载 USDZ 示例文件，用来测试 AR 快速查看链接、USD 流程或 USDZ 上传验证。共有三个文件：使用 UsdPreviewSurface 颜色的二进制 USD（usdc）环面结；同一模型并在包内打包了 UV 网格 PNG 贴图；以及图层为文本 USD（usda）的带贴图版本。
USDZ 是一种不压缩的 ZIP，其中每个文件都按 64 字节对齐，设备可以直接从存储中映射读取。三个文件都通过了 usdchecker --arkit（Apple 随 macOS 提供的合规检查），也都能在 three.js r186 的 USDLoader 中加载。usda 版本是为只能解析文本 USD 的旧版或简易读取器准备的——例如 r169 及之前的 three.js USDZLoader 会拒绝二进制图层。
下载 USDZ 示例文件
| 文件 | 详情 | 大小 | 下载 |
|---|---|---|---|
sample-model.usdz | 4,096 个三角形 · 2,193 个顶点 · 法线 · UV · 1 种材质 · 米，Y 轴朝上 | 72 KB | |
sample-model-textured.usdz | 4,096 个三角形 · 2,193 个顶点 · 法线 · UV · 1 种材质 · 米，Y 轴朝上 | 110 KB | |
sample-model-ascii-usda.usdz | 4,096 个三角形 · 2,193 个顶点 · 法线 · UV · 1 种材质 · 米，Y 轴朝上 | 304 KB |
在命令行或 CI 中使用这些文件
每个 URL 都稳定不变并开放 CORS。在测试中固定 SHA-256，一旦测试夹具发生变化，你会立刻知道。
# 下载单个文件 curl -O https://pnb-freetoolsforweb.s3.us-east-2.amazonaws.com/samples/3d/usdz/sample-model.usdz # 校验文件（上方每个文件都列出了 SHA-256） shasum -a 256 sample-model.usdz # 所有示例文件的机器可读索引 curl https://pnb-freetoolsforweb.s3.us-east-2.amazonaws.com/samples/index.json | jq '.files[] | select(.format=="usdz")'
USDZ 格式概览
| 全称 | USDZ — 通用场景描述（压缩包） |
|---|---|
| 扩展名 | .usdz |
| MIME 类型 | model/vnd.usdz+zip |
| 规范 | Pixar OpenUSD，USDZ 包 |
| 容器 | ZIP，仅存储（不压缩），64 字节对齐 |
| 图层 | usdc（二进制 crate）和 usda（文本） |
| 材质 | UsdPreviewSurface、UsdUVTexture |
| 验证 | 通过 usdchecker --arkit |
用 USDZ 示例文件测试什么
- iPhone 和 iPad 上的 AR 快速查看链接
- USDZ 上传与 MIME 验证
- 二进制与文本 USD 图层的处理
- USDZ 内的贴图打包
- USDZ 与 glTF 互转
- ZIP 对齐检查
常见问题
如何查看 USDZ 文件？
在 iPhone、iPad 或 Mac 上点按或打开即可在快速查看中显示（iOS 上还支持 AR）。在网页上，用 rel="ar" 链接到它即可启用 AR 快速查看。在其他平台上，Blender 可原生导入 USD，也可以用 Pixar 的 usdview 或免费的 USD 工具查看。
usda 和 usdc 有什么区别？
两者都是 USD 图层。usda 是人类可读的文本；usdc 是二进制 crate 格式，体积更小、加载更快。Apple 的工具写出的是 usdc，所以大多数 USDZ 文件里都是它；我们额外提供 usda 版本，供只能读取文本的解析器使用。
这些文件使用什么单位和朝上轴？
glTF、GLB、OBJ、PLY、OFF、DAE 和 USDZ 为 Y 轴朝上、单位为米（环面结直径约 1.4 m）。STL 和 3MF 为 Z 轴朝上、单位为毫米，并按切片软件的习惯放置在 z = 0 上。FBX 为 Y 轴朝上、单位为厘米。每个文件的单位和朝上轴都列在其详情中，方便你检查导入器的缩放和旋转是否正确。
这些模型是从哪里来的？
由我们自己生成。脚本先用公式构建几何体（环面结、UV 球、立方体，以及用布尔建模库制作的支架），再按各格式规范逐字节写出文件。没有任何模型是下载、扫描或从他人模型转换而来的，因此可免费用于任何用途（包括商业用途），无需署名。
下载这些 USDZ 文件安全吗？
安全。每个文件都由我们自己的开源脚本从零生成——没有抓取或用户上传的内容——不包含脚本、宏或可执行文件。本页公布了每个文件的 SHA-256，方便你校验收到的文件。
可以将这些 USDZ 示例文件用于商业用途吗？
可以。它们可免费用于任何用途，包括商业产品、测试套件、演示和再分发，无需署名。不需要任何授权，也不必征求任何人的同意。
可以直接外链这些文件或在 CI 中使用吗？
可以。每个链接都是稳定的 HTTPS 直链，带有 Access-Control-Allow-Origin: * 和较长的缓存头，curl、wget、fetch() 和测试运行器都可以直接拉取。每个页面都链接了所有文件的 JSON 索引（见命令行部分）。
相关示例文件
支持 USDZ 的免费工具
发现问题，或者觉得哪里可以更好？每条消息我们都会阅读，并尽快修复。