Resource details · 3D建模
model-viewer：把已有拆解动画放进网页
已有合法 GLB 动画时，用一个网页组件提供旋转、播放、暂停和进度控制。
Resource text, examples and licences retain their original language. Code is displayed only; this page does not execute it or call AI.
Resource details
适合已经有自己的产品 GLB 与拆解动画、希望少写代码展示的人。重点是展示已准备好的模型，不是自动建模。
Before you start
- Platforms
- 浏览器 · Windows · macOS · Linux
- Content updated
- 少量 HTML/JavaScript 和能正常访问模型文件的网页环境。
- 准备自己有权使用、已经包含拆解动画的 GLB；播放组件不会替你完成建模与分件。
先按官方动画页显示自己的 GLB，确认可播放，再添加时间轴与装回按钮。
Common pitfalls
- animation-name必须匹配模型真实动画；没有动画时不会凭空产生拆解。
- 官方示例有 NC / NC-SA 资产；本条不收录、不复制，不能将库 Apache-2.0当作模型许可。
Complete resource
【从哪里开始】先准备自己制作或有合法使用权的 GLB，并确认里面确实有拆解动画。若还没有模型，先用自制几何体在建模工具中做好零件与动画，再来学习网页展示。
【基本操作】按官方动画示例加载模型，用 animation-name 选择已有动画；play()/pause() 控制播放，currentTime 对应时间轴，timeScale 调节速度或倒放。加入“拆开”“装回”按钮时，要先确认动画命名和时长，不凭空写死示例名字。
【适用边界】这是高层 Web 组件；材料接口不等于任意节点变形编辑器。若希望实时控制每颗零件的位置、做复杂操作，可转到 Three.js 或 Babylon.js。首次使用先只做浏览器内演示，不把各手机 AR 模式视为相同实现。
【素材特别提醒】官方场景示例页的部分模型另有 CC BY-NC 或 CC BY-NC-SA 限制，例如 Damaged Helmet 和 Horse。本条不收录、不复制、不托管这些模型、贴图或素材；不能把库的 Apache-2.0 许可当成它们允许商用的凭据。使用自制几何产品或单独核对获准的资产。
【来源与许可】Google Inc. 与贡献者（google 官方仓库组织）；许可固定提交 adc877c66f97e1498d8b19a8850976aee3d0197f。Apache-2.0 允许依条款商用、修改和再分发；分发需附完整许可、保留适用声明与 NOTICE，修改文件标示变更。它不授予商标使用权。拆解演示需要独立零件或预先制作好的拆解动画；工具不会自动从一张照片推断真实内部结构。只使用自制几何模型或明确允许相应用途的分件 GLB，不把演示中的虚构结构说成真实产品内部。
【本站核对范围】2026-10-23 阅读官方文档和固定提交完整许可，仅编写原创导览；未安装、运行或实测上游项目，不附上游源码、安装包、演示模型、贴图或其他素材。导览采用 CC BY 4.0，上游软件仍按自己的许可。资料可读不等于安装成功或安全审计；显示效果取决于模型、浏览器和设备。软件开源不代表模型、品牌、声音、字体、依赖或托管服务也采用相同许可。How to use it
如果已有带动画的自有 GLB，先让浏览器播放一遍，再添加最少的按钮。
先核对模型和动画
确认 GLB 是自己制作或有合法使用权，且含拆解动画。只获得一个静态整体模型时，先补分件与动画；不要照搬官方示例中的 NC 模型。
显示并选择动画
按官方动画页加载组件和自己的模型，确认 availableAnimations 列出实际名称，再选择 animation-name；加入播放、暂停与时间轴。
走完拆开与装回
拖动进度确认部件运动连贯，检查加载失败、手机拖动和说明文字；若采用倒放装回，核对 timeScale 与动画起止位置，避免只看见静态第一帧。
Expected output
建议达到：浏览器能旋转查看自有 GLB，指定拆解动画可以播放、暂停、定位并装回；这需要真实带动画模型，不是粘贴一段提示词自动完成。
2026-10-23 按官方文档与固定提交完整许可编写导览；本站未安装、运行或实测上游引擎，也未下载示例模型。下面是建议练习与验收条件，不是已经产出的测试结果。
Suitable uses
- 已有合法拆解动画的模型展示
- 产品页中的简单 3D 浏览与进度控制
Before using it
- 拆解演示需要独立零件或预先制作好的拆解动画；工具不会自动从一张照片推断真实内部结构。只使用自制几何模型或明确允许相应用途的分件 GLB，不把演示中的虚构结构说成真实产品内部。
- 本条不收录或复制官方示例的 CC BY-NC / CC BY-NC-SA 模型与贴图。
- 复杂的逐零件实时操作可选 Three.js 或 Babylon.js；网页 AR、实时展示和 MP4 导出要分别验收。
Authors and sources
- Attribution
- 本站导览
- Upstream author
- Google Inc. 与贡献者（google 官方仓库组织）
- Source repository
- https://github.com/google/model-viewer
- Source revision
adc877c66f97e1498d8b19a8850976aee3d0197f- Licence checked
- 2026-10-23
Complete licence
CC BY 4.0
CC BY 4.0 · Read the complete licence ↗
Upstream licence · Apache-2.0
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Verification scope
资料与许可已核对
只核对项目资料和许可记录；未安装运行上游项目，也未进行安全审计。
2026-10-23