GitHub – google/model-viewer：在网络和 AR 中轻松显示交互式 3D 模型！
| Name | ||
|---|---|---|
|
AE9BA60 · 2 months ago
|
||
|
6 months ago
|
||
|
2 months ago
|
||
|
2 years ago
|
||
|
5 years ago
|
||
|
2 years ago
|
||
|
5 years ago
|
||
|
3 years ago
|
||
|
2 years ago
|
||
|
6 years ago
|
||
|
5 years ago
|
||
|
5 years ago
|
||
|
last year
|
||
|
6 months ago
|
||
|
6 months ago
|
||
存储库文件导航
项目<model-viewer>
这是 Web 组件的主要 GitHub 存储库，并且 其所有相关项目。<model-viewer>
开始？查看<模型查看器>项目！
存储库被组织成包含各种项目的子目录。 查看特定项目的 README.md 文件以获取更多详细信息：
👩 🚀 <model-viewer> • Web 组件（可能是您要查找的）<model-viewer>
✨ <model-viewer-effects> • 用于<model-viewer>
🌐 modelviewer.dev • 文档网站的来源<model-viewer>
🖼 render-fidelity-tools • 用于测试模型渲染效果的工具<model-viewer>
🎨 shared-assets • 在许多子项目之间共享的 3D 模型、环境地图和其他资产
🚀 space-opera • 编辑器的源代码<model-viewer>
当跨此存储库中的所有项目进行开发时，首先安装 git， Node.js 和 npm。
然后，执行以下步骤以设置开发：
git clone --depth=1 git@github.com:google/model-viewer.git
cd model-viewer
npm install
注意：depth=1 会阻止您下载我们 ~3Gb 的历史记录，该历史记录由我们的黄金渲染保真度图像的所有版本主导。
以下全局命令可用：
| 命令 | 描述 |
|---|---|
npm ci |
安装依赖项和交叉链接子项目 |
npm run build |
为所有子项目运行构建步骤 |
npm run serve |
运行 Web 服务器并打开指向 modelviewer.dev 本地副本的新浏览器选项卡（不要忘记构建！ |
npm run test |
在具有测试的所有子项目中运行测试 |
npm run clean |
从所有子项目中删除已构建的工件 |
您现在应该准备好从事任何项目了！<model-viewer>
由于 Windows 10 上的依赖关系问题，建议从 WSL2 环境运行安装程序。<model-viewer>
并通过 NVM 安装 Node.js 和 npm
应从 WSL 内部克隆模型查看器，而不是从 Windows 内部克隆模型查看器。否则，您可能会遇到行尾和符号链接问题。
若要在 WSL 中通过 HTTPS 克隆（WSL 中的 SSH 密钥存在已知的文件权限问题）：
git clone --depth=1 https://github.com/google/model-viewer.git
cd model-viewer
npm install
若要在 WSL 中运行测试，需要绑定：CHROME_BIN
export CHROME_BIN="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
npm run test
请注意，您应该能够使用该设置运行 和 测试，但运行保真度测试需要 GUI 支持，该支持仅在 Windows 11 上的 WSL 中可用。packages/model-viewerpackages/model-viewer-effects
其他 WSL 故障排除 – 仅供参考
当你执行上述 WSL 设置步骤（通过 HTTPS 克隆、从 WSL 内部克隆、绑定CHROME_BIN）时，不应发生这些问题。如果尝试从 Windows （不是 WSL） 内部开发模型查看器，则此处的注释可能会有所帮助 （不建议） 。
运行需要 WSL 上的环境变量指向 。 您可以通过此命令进行设置（这是默认的 Chrome 安装目录，可能位于您计算机上的其他地方）npm run testCHROME_BIN
export CHROME_BIN="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
npm run test
测试现在应该正常运行;保真度测试可能仍会失败（请参阅下面的错误和潜在的解决方法）。packages/model-viewerpackages/model-viewer-effects
症状例如，运行.sh脚本会抛出错误消息fetch-khronos-gltf-samples.sh/bin/bash^M: bad interpreter: No such file or directory
替代错误：
! was unexpected at this time.
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! @google/model-viewer@1.10.1 prepare: `if [ ! -L './shared-assets' ]; then ln -s ../shared-assets ./shared-assets; fi && ../shared-assets/scripts/fetch-khronos-gltf-samples.sh`
溶液这是由于某些.sh文件中的行尾不正确造成的，因为 git 在 Windows 上签出时更改了这些行尾（而不是在 WSL 中）。建议从 WSL 会话克隆模型查看器存储库。
作为一种解决方法，您可以使用以下命令重写行尾：
sed -i -e 's/r$//' ../shared-assets/scripts/fetch-khronos-gltf-samples.sh
症状尝试时，错误的记录类似于：npm run test
❌Fail to analyze scenario :khronos-IridescentDishWithOlives! Error message: ❌ Failed to capture model-viewer's screenshot
[836:836:0301/095227.204808:ERROR:browser_main_loop.cc(1409)] Unable to open X display.
Pupeteer 测试需要显示输出;这意味着需要对 WSL 的 GUI 支持，这似乎只能在 Windows 11 上（轻松）使用，而不是在 Windows 10 上使用。
https://docs.microsoft.com/de-de/windows/wsl/tutorials/gui-apps#install-support-for-linux-gui-apps
因此，解决方法似乎正在运行 Windows 11（但尚未测试）。
症状在 Windows 上运行会抛出错误 。npm run devpackages/model-viewerERROR: Task not found: "'watch:tsc"
Solution (if you have one please make a PR!)
2. 分享目的仅供大家学习和交流，请不要用于商业用途!
3. 如果你也有好源码或者教程，可以到用户中心发布，分享有积分奖励和额外收入！
4. 本站提供的源码、模板、插件等等其他资源，都不包含技术服务请大家谅解！
5. 如有链接无法下载、失效或广告，请联系管理员处理！
6. 本站资源售价只是赞助，收取费用仅维持本站的日常运营所需！
7. 如遇到加密压缩包，默认解压密码为"gltf",如遇到无法解压的请联系管理员！
8. 因为资源和程序源码均为可复制品，所以不支持任何理由的退款兑现，请斟酌后支付下载
声明：如果标题没有注明"已测试"或者"测试可用"等字样的资源源码均未经过站长测试.特别注意没有标注的源码不保证任何可用性
GLB下载网 - GLB/GLTF模型与格式资源免费下载，支持在线浏览与转换 » 在网络和 AR 中轻松显示交互式 3D 模型！
常见问题FAQ
- 免费下载或者VIP会员专享资源能否直接商用？
- 本站所有资源版权均属于原作者所有，这里所提供资源均只能用于参考学习用，请勿直接商用。若由于商用引起版权纠纷，一切责任均由使用者承担。更多说明请参考 VIP介绍。
- 提示下载要提取码
- 分享过期和重复下载怎么办
- 模型和平台不兼容怎么办
