文档

嵌入网页(Beta)

把交互模型放进网页,并了解当前嵌入方式的边界。

普通文章和课件优先使用导出的 SVG:文件小、打印清楚,也不会依赖 JavaScript。只有读者需要播放动画时,才需要嵌入交互模型。

从 Studio 复制嵌入代码

在 Studio 的“分享”菜单中选择“复制嵌入代码”,会得到一段 iframe

<iframe
  src="https://physloom.com/zh-CN/embed/#phys=..."
  title="交互式物理图"
  loading="lazy"
  width="100%"
  height="720"
  style="border:0"
></iframe>

可以按页面版式修改 height。不要修改 src 中的模型数据。

它如何工作

嵌入页面在浏览器中读取并编译 .phys 源码。源码经过压缩后保存在 URL 中,没有上传到 PhysLoom 账户,也没有单独的云端副本。

因此,任何拿到完整 URL 的人都能读取模型。不要在源码中放入个人信息、秘密或未公开试题。

当前限制

这项能力目前是 Beta:

  • 模型为只读展示;修改时需要回到 Studio。
  • 复杂模型可能超过浏览器可接受的 URL 长度,此时应改用 SVG 或 .phys 文件。
  • 页面必须允许加载来自 physloom.com 的 iframe 和 JavaScript。
  • 外层页面需要自行处理宽度、高度、懒加载和小屏幕布局。
  • PhysLoom SDK 尚未公开发布;现在提供的是 iframe 嵌入,不是可安装的软件包。

重要页面应同时保留一张 SVG 作为封面或后备内容。