bangumi 扩展类型：视频与动画源

bangumi 是什么

bangumi 类型（中文语境常指动画剧集，但 Miru 里实际覆盖更广）的扩展负责接入任何以视频形式消费的媒体源。它是目前官方仓库里收录最多的扩展类型，也是用户最常接触的。

它输出什么

一个 bangumi 扩展的 watch() 方法返回：

// 视频源扩展 watch() 返回值
{
  type: "hls" | "mp4",   // 流式协议类型
  url: "https://example.com/stream.m3u8"  // 视频地址
}

type: "hls" — HLS 流媒体（.m3u8 格式），目前绝大多数在线视频源都用这个协议；
type: "mp4" — 直接的 MP4 文件链接，比较少见。

Miru 拿到这两个字段后就会把 URL 丢给内置视频播放器，按 type 选择对应的解码方式。

搜索与列表的返回格式

bangumi 扩展的 search() 和 latest() 返回一组 ListItem：

{
  title: "进击的巨人 第四季",
  url: "https://example.com/detail/12345",
  cover: "https://example.com/cover.jpg",
  update: "2026-08-25"   // 可选，最近更新时间或集数
}

其中 url 是详情页的唯一标识，后续 detail() 和 watch() 都靠这个 URL 定位到具体内容。

详情页的返回格式

detail(url) 返回：

{
  title: "进击的巨人 第四季",
  cover: "https://example.com/cover.jpg",
  desc: "人类与巨人的最终决战...",
  metadata: {
    "作者": "谏山创",
    "年份": "2023",
    // 其他元数据...
  },
  episodes: [
    {
      title: "第 1 集",
      urls: [
        { name: "超清", url: "/play/12345/1" },
        { name: "高清", url: "/play/12345/1-hd" }
      ]
    },
    // ...更多集
  ]
}

episodes 是选集列表，每集可以有多条线路（不同清晰度）。Mirv 会自动把这些线路渲染成可点击的切换按钮。

安装与启用

在仓库管理区浏览 bangumi 类型的扩展；
挑一个点击"安装"；
左侧切换到"视频"标签，中间区域就是这个扩展的 latest() 返回的列表；
点击卡片进入详情，再点击集数进入播放界面。

bangumi 扩展的安装门槛最低——官方仓库里有大量现成可用的视频源，启用后开箱即用，不需要写任何代码。