ฝังเว็บตูน

สำหรับนักพัฒนา

ถ้าบริการของคุณรองรับ oEmbed แค่ลิงก์โพสต์ก็แสดงเพลเยอร์ได้แล้ว

เอนด์พอยต์ oEmbed

ส่งที่อยู่โพสต์เป็น url รูปแบบที่รองรับคือ json และ xml ส่วน maxwidth และ maxheight จะย่อเพลเยอร์โดยคงสัดส่วนเดิมไว้ หน้าโพสต์มีแท็ก link สำหรับให้ค้นพบ oEmbed อยู่แล้ว

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 มีโพสต์นี้อยู่ แต่ฝังไม่ได้ (เช่น โพสต์ส่วนตัวหรือโพสต์ที่ดูได้เฉพาะในแอป) · 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 จะลบแอตทริบิวต์นี้ และ Safari บน iPhone ไม่รองรับโหมดเต็มจอ จึงไม่มีปุ่มนี้ในที่เหล่านั้น ปุ่มคำบรรยาย (CC) จะแสดงเฉพาะเมื่อภาษาของผู้อ่านต่างจากภาษาของบทพูด และเมื่อกดจะโหลดคำแปลหนึ่งครั้ง

การแจ้งความสูง (postMessage)

เพลเยอร์จะแจ้งหน้าต่างหลักเมื่อความสูงเปลี่ยน ให้รับข้อความด้านล่างแล้วปรับความสูงของ iframe

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

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

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

การตอบกลับของเพลเยอร์ไม่ตั้งค่าคุกกี้ และติด noindex ไว้ เครื่องมือค้นหาจึงไม่จัดทำดัชนี