Skip to main content
GenToonGenToon

嵌入漫画

把 GenToon 漫画放到你的博客或网站上，读者无需离开你的页面，就能在那里滑动看完每个分镜。

效果是这样的

这是真实的嵌入播放器，试着滑动看看吧。

嵌入方法

  1. 在帖子上点击“嵌入”

    就在你想嵌入的漫画帖子下方，分享按钮旁边。

  2. 选择尺寸

    可选择小、标准或大。如果页面的正文栏较窄，请打开“自适应代码”。你的选择会立刻显示在预览中。

    在“阅读方式”中，可选择“左右滑动”（默认）或“向下滚动”。向下滚动时总是从第一个分镜开始。

  3. 点击“复制代码”并粘贴

    粘贴到博客或网站的 HTML 编辑界面就完成了。

在 App 中，点击帖子的分享按钮并选择“嵌入”，就会复制代码。

要粘贴到哪里？

自建的 WordPress
只要粘贴帖子链接，播放器就会自动出现。请使用嵌入窗口中的“复制链接”。
可以放入 HTML 的博客和网站
把用“复制代码”复制的代码粘贴到 HTML 编辑界面。
只能填写网址的地方
如果输入框只接受网址，请填入播放器网址。网址格式如下，末尾的 ID 就是帖子网址的最后一部分。
https://www.gentoon.ai/embed/post/<帖子ID>
点击嵌入窗口中的“复制嵌入网址”，就会复制这个网址。

其他地方则要看网站是否允许外部 HTML 或 iframe。如果不允许，请用“复制链接”分享链接。

小提示

  • 播放器不使用 Cookie，也不会要求任何人登录。
  • 如果作者删除帖子或设为不公开，帖子在所有嵌入的地方都将不再显示。
  • 播放器的按钮文字会跟随每位读者的语言。
  • 作者可以在嵌入窗口的“嵌入效果”中，查看漫画在其他网站被阅读的次数。

给开发者

如果你的服务支持 oEmbed，只需帖子链接就能显示播放器。

oEmbed 端点

用 url 传入帖子网址。格式支持 json 和 xml，指定 maxwidth 和 maxheight 时，会保持比例缩小播放器。帖子页面带有用于 oEmbed 发现的 link 标签。

https://www.gentoon.ai/api/oembed

GET https://www.gentoon.ai/api/oembed?url=https%3A%2F%2Fwww.gentoon.ai%2Fcommunity%2Fposts%2F9fa0016a-1192-4a72-afa8-d0ffad90c315&format=json
GET https://www.gentoon.ai/api/oembed?url=https%3A%2F%2Fwww.gentoon.ai%2Fcommunity%2Fposts%2F9fa0016a-1192-4a72-afa8-d0ffad90c315&format=xml

响应码：200 正常 · 404 帖子不存在，或不是 GenToon 的帖子网址 · 401 帖子存在，但无法嵌入（例如不公开或只能在 App 观看的帖子） · 501 json 和 xml 以外的格式。

<iframe src="https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315" width="400" height="644" title="嵌入漫画 · GenToon" frameborder="0" scrolling="no" loading="lazy" allow="clipboard-write; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen style="border:0;max-width:100%"></iframe>

播放器网址与参数

https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315?hl=en&theme=dark&start=2&layout=scroll
hl
固定显示语言（例如 en 或 ja）。不指定时，将跟随读者的浏览器语言。
theme
设为 dark 时将以深色显示。
start
从第 N 个分镜开始显示（从 1 开始计数）。
layout
设为 scroll 时，可以纵向连续阅读每个分镜。不指定时，读者一次翻一个分镜。oEmbed 的嵌入代码始终一次显示一个分镜。

全屏按钮只在 iframe 带有 allowfullscreen 时才会显示（我们的嵌入代码已包含）。WordPress 会删除这个属性，iPhone 上的 Safari 也不支持全屏，因此在这些地方不会有按钮。字幕（CC）按钮只在读者的语言与对白语言不同时才会显示，点击后会加载一次翻译。

高度通知（postMessage）

播放器高度变化时会通知父窗口。请监听下面的消息并调整 iframe 的高度。

默认格式

{"type":"gentoon:embed:resize","postId":"9fa0016a-1192-4a72-afa8-d0ffad90c315","height":644}

Embedly 和 Iframely 格式

JSON.stringify({"src":"https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315","context":"iframe.resize","height":644,"domains":"all"})

WordPress 格式（网址末尾带有 #?secret= 时）

{"message":"height","value":644,"secret":"<secret>"}

播放器的响应不会设置 Cookie，并标记为 noindex，因此搜索引擎不会将其编入索引。

联系我们

如果嵌入无法正常使用，或想与我们合作，请发邮件至 service@gentoon.ai。

返回帮助中心