Miru 中文文档 下载 App

manga 扩展类型:漫画图源

manga 是什么

manga 类型的扩展负责接入漫画 / 条漫 / 绘本等以图片序列消费的媒体源。和 bangumi 输出视频 URL 不同,manga 扩展直接输出一组图片地址。

watch() 返回值

// 漫画图源扩展 watch() 返回值
{
  urls: [
    "https://example.com/chapter/01.jpg",
    "https://example.com/chapter/02.jpg",
    "https://example.com/chapter/03.jpg",
    // ...该章节的所有图片,按顺序排列
  ]
}

Miru 拿到这组 URL 后,漫画阅读器会按顺序预加载图片并渲染成可翻页的视图。

manga 和 bangumi 在详情页的差异

detail() 返回的数据结构和 bangumi 类似,关键区别在 episodes 字段——在 manga 语境下它通常叫"章节"而不是"集数",但数据结构相同:

{
  episodes: [
    { title: "第 1 话", urls: [...] },
    { title: "第 2 话", urls: [...] },
    // ...
  ]
}

开发者写 manga 扩展时可以沿用这个结构,只是把章节内容填进去即可。Miru 会根据扩展的 @type 自动用漫画阅读器消费,而不是视频播放器。

图片加载的注意点

漫画图源扩展有一些特殊的挑战:

manga 扩展从哪来

官方仓库里的 manga 类型扩展比 bangumi 少很多,大部分漫画图源扩展来自第三方仓库或社区分享。找漫画源的常见路径:

安装方式和 bangumi 完全相同:添加仓库 → 启用 → 浏览 → 安装 → 左侧切换到"漫画"标签就能看到内容了。