Skip to main content
GenToonGenToon

Nhúng webtoon

Khi bạn đặt webtoon GenToon lên blog hoặc trang web, người đọc có thể vuốt xem hết các khung ngay tại đó mà không phải rời khỏi trang của bạn.

Trông sẽ như thế này

Đây là trình phát nhúng thật. Hãy thử vuốt xem.

Cách nhúng

  1. Nhấn “Nhúng” trên bài viết

    Nút này nằm bên dưới bài viết webtoon, ngay cạnh nút chia sẻ.

  2. Chọn kích thước

    Chọn Nhỏ, Mặc định hoặc Lớn. Nếu cột nội dung của trang hẹp, hãy bật “Mã thích ứng”. Bản xem trước sẽ hiển thị ngay lựa chọn của bạn.

    Ở mục “Cách đọc”, bạn có thể chọn “Lướt từng khung” (mặc định) hoặc “Cuộn xuống”. Khi cuộn xuống, truyện luôn bắt đầu từ khung đầu tiên.

  3. Nhấn “Sao chép mã” rồi dán vào

    Dán vào trình soạn thảo HTML của blog hoặc trang web là xong.

Trong ứng dụng, nhấn nút chia sẻ của bài viết rồi chọn “Nhúng” để sao chép mã.

Dán ở đâu?

WordPress tự lưu trữ
Chỉ cần dán liên kết bài viết là trình phát tự hiện ra. Hãy dùng “Sao chép liên kết” trong cửa sổ nhúng.
Blog và trang web cho phép chèn HTML
Dán mã đã sao chép bằng “Sao chép mã” vào trình soạn thảo HTML.
Nơi chỉ có ô để nhập địa chỉ
Nếu ô chỉ nhận địa chỉ, hãy dùng địa chỉ trình phát. Địa chỉ có dạng như dòng bên dưới, và ID ở cuối chính là phần cuối của địa chỉ bài viết.
https://www.gentoon.ai/embed/post/<id-bài-viết>
Nhấn “Sao chép địa chỉ nhúng” trong cửa sổ nhúng để sao chép địa chỉ này.

Ở những nơi khác, việc này tùy vào trang web có cho phép HTML bên ngoài hoặc iframe hay không. Nếu không, hãy chia sẻ liên kết bằng “Sao chép liên kết”.

Điều cần biết

  • Trình phát không dùng cookie và không bao giờ yêu cầu ai đăng nhập.
  • Nếu tác giả xóa bài viết hoặc chuyển bài sang riêng tư, bài sẽ không còn hiển thị ở bất kỳ nơi nào đã nhúng.
  • Chữ trên các nút của trình phát sẽ theo ngôn ngữ của từng người đọc.
  • Tác giả có thể xem webtoon của mình được đọc bao nhiêu lần trên các trang khác trong mục “Kết quả nhúng” của cửa sổ nhúng.

Dành cho nhà phát triển

Nếu dịch vụ của bạn hỗ trợ oEmbed, chỉ cần liên kết bài viết là có thể hiển thị trình phát.

Endpoint oEmbed

Truyền địa chỉ bài viết vào url. Định dạng là json và xml, còn maxwidth và maxheight sẽ thu nhỏ trình phát mà vẫn giữ nguyên tỉ lệ. Trang bài viết có thẻ link để khám phá 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

Mã phản hồi: 200 thành công · 404 bài viết không tồn tại hoặc đây không phải địa chỉ bài viết GenToon · 401 bài viết tồn tại nhưng không thể nhúng (ví dụ bài viết riêng tư hoặc chỉ xem được trong ứng dụng) · 501 định dạng khác json và xml.

<iframe src="https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315" width="400" height="644" title="Nhúng webtoon · 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>

Địa chỉ trình phát và tham số

https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315?hl=en&theme=dark&start=2&layout=scroll
hl
Cố định ngôn ngữ (ví dụ en hoặc ja). Nếu không có, trình phát sẽ theo ngôn ngữ trình duyệt của người đọc.
theme
Dùng dark để trình phát có giao diện tối.
start
Bắt đầu từ khung thứ N (đếm từ 1).
layout
Dùng scroll để đọc các khung nối tiếp nhau theo chiều dọc. Nếu không có, người đọc sẽ lật từng khung một. Mã nhúng oEmbed luôn hiển thị từng khung một.

Nút toàn màn hình chỉ hiện khi iframe có allowfullscreen (mã nhúng của chúng tôi đã có sẵn). WordPress xóa thuộc tính này và Safari trên iPhone không hỗ trợ toàn màn hình, nên ở đó sẽ không có nút. Nút phụ đề (CC) chỉ hiện khi ngôn ngữ của người đọc khác với ngôn ngữ của lời thoại, và khi nhấn sẽ tải bản dịch một lần.

Thông báo chiều cao (postMessage)

Trình phát sẽ báo cho cửa sổ cha khi chiều cao thay đổi. Hãy lắng nghe các thông điệp bên dưới và chỉnh kích thước iframe.

Định dạng mặc định

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

Định dạng Embedly và Iframely

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

Định dạng WordPress (khi địa chỉ kết thúc bằng #?secret=)

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

Phản hồi của trình phát không đặt cookie và được đánh dấu noindex, nên công cụ tìm kiếm sẽ không lập chỉ mục.

Liên hệ

Nếu không nhúng được hoặc bạn muốn hợp tác với chúng tôi, hãy gửi email đến service@gentoon.ai.

Quay lại Trợ giúp