- 1
加上嵌入框
把 iframe 指向 Any3D,并在 src 查询参数里写上模型地址。嵌入框里只有画布,右下角带有打开完整查看器的按钮。下面有一段示例。
<iframe src="https://any3d.cc/zh-CN/embed?src=https%3A%2F%2Fcdn.example.com%2Fmodel.glb" title="3D 模型" style="width:100%;height:480px;border:0" loading="lazy" allow="fullscreen" allowfullscreen referrerpolicy="strict-origin-when-cross-origin" ></iframe>提示:你可以直接复制下方的提示词发给 AI 助手(如 Cursor、Claude、ChatGPT 等),让其自动生成嵌入代码并快速接入。AI 接入提示词(点击展开/收起)
请帮我生成一段用于在网页中嵌入 Any3D 3D 查看器的 <iframe> 代码。如果是修改现有页面或组件,请将 <iframe> 放置在需要展示 3D 模型的位置。 嵌入基准地址:https://any3d.cc/zh-CN/embed URL 与参数规则: - 必须参数:src 为模型的 HTTPS 地址,必须做百分号编码(encodeURIComponent),且作为独立查询参数传入(例如 https://any3d.cc/zh-CN/embed?src=...),切勿将原始模型地址直接拼入路径。3D Tiles 格式请传入 tileset.json 的地址。 - 可选参数(不需要则不写): - autorotate=1:让模型自动旋转。不写则保持静止。 - theme=light、theme=dark 或 theme=system:设定页面主题。 - bg=transparent:使用透明背景。 - controls:鼠标操作预设。留空或设为 auto,将按文件类型自动匹配最佳操作方式;也可指定为 standard(轨道)、cad(AutoCAD 手感)、solidworks、blender、splat(高斯泼溅平滑环绕)、custom。 鼠标操作说明: - auto:CAD 文件用 CAD 操作,高斯泼溅用平滑环绕,其它文件用轨道。 - standard:轨道。左键拖拽旋转,右键拖拽平移,滚轮缩放。 - cad:AutoCAD 手感。中键拖拽平移,Shift+中键拖拽环绕,滚轮朝光标缩放,无惯性。左键拖拽也能环绕,右键拖拽平移。 - solidworks:SolidWorks 手感。中键拖拽环绕,Ctrl 或 Command 加中键拖拽平移,Shift+中键拖拽缩放。滚轮向前是缩小,锚在光标处,无惯性。 - blender:Blender 手感。中键拖拽环绕,Shift+中键拖拽平移,Ctrl 或 Command 加中键拖拽缩放。滚轮以视图中心缩放,无惯性。 - splat:适合大型高斯泼溅的平滑环绕。拖拽平滑环绕,双击重设视点。 - custom:与 standard 相同。 iframe 要求与注意事项: - 基础属性:需包含 loading="lazy"、style="width:100%;height:480px;border:0"(可根据容器自适应)。 - 权限与策略:必须包含 allow="fullscreen"、allowfullscreen 与 referrerpolicy="strict-origin-when-cross-origin"。 - 沙箱环境:若外层页面设置了 sandbox,必须额外包含 allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox,右下角按钮才能在新标签页打开完整查看器。 - 资源与跨域:托管模型的网站必须支持跨域读取(CORS 允许 https://any3d.cc)。仅下载单个模型文件(如 GLB、STL、OBJ、FBX、PLY),外置独立贴图若未打包进模型将无法加载。 参考示例: <iframe src="https://any3d.cc/zh-CN/embed?src=https%3A%2F%2Fcdn.example.com%2Fmodel.glb" title="3D 模型" style="width:100%;height:480px;border:0" loading="lazy" allow="fullscreen" allowfullscreen referrerpolicy="strict-origin-when-cross-origin" ></iframe> 注意:示例中的模型地址仅为占位符。生成代码时请将 src 替换为真实编码后的 HTTPS 模型地址。鼠标操作需要按文件自动选择时,请勿添加 controls 参数。 - 2
模型放在哪里
地址必须是 https,托管网站必须允许 https://any3d.cc 读取这个文件。访客的浏览器会下载这一个文件,例如 GLB、STL、OBJ、FBX 或 PLY。3D Tiles 请使用 tileset.json 的地址。Any3D 不会保存一份副本。贴图和数据如果在单独的文件里,除非已经打进模型(GLB 就是这样),否则会缺失。
- 3
页面选项
下面的查询参数都是可选的。打开完整查看器的按钮始终显示。
参数 取值 作用 autorotate1让模型自动旋转。不写则保持静止。 themelight | dark | system设定页面主题。 bgtransparent使用透明背景。 controlsauto | standard | cad | solidworks | blender | splat | custom鼠标操作。留空为 auto,按文件自动选择。 https://any3d.cc/zh-CN/embed ?src=https%3A%2F%2Fcdn.example.com%2Fmodel.glb &autorotate=1 &theme=dark &bg=transparent - 4
打开完整查看器
按钮会在新标签页打开对应的 Any3D 查看器,并带上同一个模型地址。高斯泼溅、3D Tiles,以及 DWG 或 DXF 图纸会进入各自的查看器。其它文件进入 3D 模型查看器。如果外层页面给 iframe 加了 sandbox,需要加上 allow-popups 和 allow-popups-to-escape-sandbox,按钮才能打开新标签页。
嵌入查看器
把 Any3D 查看器放到你自己的页面上。嵌入框从 https 地址加载模型,并提供打开完整查看器的按钮。