Morphe Patches如何集成SponsorBlock跳过广告：赞助分段与类别配置完全解析

Morphe Patches如何集成SponsorBlock跳过广告赞助分段与类别配置完全解析【免费下载链接】morphe-patchesMorphe Patches项目地址: https://gitcode.com/gh_mirrors/mo/morphe-patchesMorphe Patches是一个基于 ReVanced 技术路线的开源补丁集合它的SponsorBlock 补丁可以为 YouTube / YouTube Music 等应用一键接入社区驱动的跳过赞助片段能力——不只是跳过广告还能自动跳过片头、片尾、自推广、无音乐内容等 9 大类无效时间。本文面向新手完整解析它是如何集成的、10 个赞助分段类别各自是什么、5 种行为模式怎么选以及每个配置项的实际效果。一、先搞懂SponsorBlock 在 Morphe 里是怎么插进去的SponsorBlock 本身是一个开源的社区数据库全世界的用户共同标记视频里的赞助内容、片头、推广等时间段任何人拉取接口都能拿到。Morphe 要做的就是把这套数据缝进官方 App 的播放器里。它的集成方式可以拆成 4 步全程无需你手动操作步骤发生了什么对应源码① 打补丁字节码补丁在播放器每秒报告播放时间的位置插入钩子SponsorBlockPatch.kt② 拉数据视频加载后按视频 ID 你启用的类别向 SponsorBlock API 请求分段SBRequester.java③ 实时判断共享播放控制器以约 1 秒一次的频率比对当前时间与分段决定自动跳、弹按钮还是仅高亮SegmentPlaybackController.java④ 呈现进度条上画出彩色分段条播放器上方出现跳过赞助按钮跳过时弹出 Toast 提示YouTubeSponsorBlockConfig.java值得一提的是Morphe 把跳分段的核心逻辑抽成了一个应用无关的共享层SponsorBlockApiYouTube 和 YouTube Music 各自注入一个适配器同一套代码跑在两个宿主 App 上——这正是 SponsorBlockApi.java 中configure(Configuration)两阶段启动设计的意义。二、91 个赞助分段类别每个都在跳什么打开设置里的SponsorBlock面板你会看到一排带彩色圆点的类别开关。这些类别定义在 SegmentCategory.java 中Morphe 的 YouTube 版支持 10 个含 1 个内部类别类别键值含义典型场景 赞助内容sponsor非积分的广告片段UP 主口播/植入广告 非积分自推广selfpromo推广自己的其他频道/周边/播客别忘了订阅我的第二频道 积分自推广interaction求点赞、订阅、开会员等互动引导一键三连⭐ 精彩亮点poi_highlight单点标记不是要跳的而是帮你定位到某时刻高能预警跳转 片头intro频道片头、开场动画30 秒片头曲 片尾outro结束语、求订阅、推荐其他视频结尾下期见 预览/推广preview其他节目/电影/游戏的短预告下集预告 铺垫/引导hook为广告做铺垫的钩子内容广告前的过渡话术 填充内容filler重复内容或跑题闲聊与主题无关的唠嗑 无音乐内容music_offtopic音乐视频中的口播、对话乐评中的广告口播 未提交内部unsubmitted你本地新建、尚未提交到服务器时的分段见下文创建分段类别数量由宿主 App 决定比如音乐场景不需要精彩亮点代码通过activeCategories()按配置动态过滤SegmentCategory.java#L117-L126关闭某类别后请求 API 时也会自动剔除它减少无效数据。三、5 种行为模式自动跳过 / 仅弹按钮 / 只看进度条每个类别点开是一个颜色选择器但同一弹窗里还内置了行为单选组见 SegmentCategoryPreference.java#L145-L189。5 种模式来自 CategoryBehaviour.java⏩ 自动跳过一进分段立刻跳走跳完弹已跳过Toast可手动撤销。 自动跳过一次Morphe 独有同一分段只自动跳一次避免在分段里手动回退后又被迫跳走。 显示跳过按钮不自动跳播放器顶部出现跳过赞助按钮由你手动点。 仅在进度条显示不跳、不弹按钮只在进度条上画色条提醒你分段在哪。 忽略完全不管这一类。 推荐的新手组合sponsor/outro选自动跳过intro选自动跳过一次selfpromo选显示跳过按钮poi_highlight保持自动跳过它会把进度条点亮到精彩位置。四、进度条彩色分段与外观设置每个类别都可以单独选颜色还能拖动透明度滑杆默认 70%见CATEGORY_DEFAULT_OPACITY。进度条上的色条是补丁在原生draw()流程里注入绘制的YouTube 版钩住 Seekbar 的 onDraw在画完原生刻度前调用drawSegmentTimeBars()叠色条SponsorBlockPatch.kt#L285-L298YouTube Music 版钩住迷你播放器时间条的绘制逻辑同样注入色条SponsorBlockPatch.kt#L78-L89。外观相关的其他开关YouTube 版设置面板定义于 SponsorBlockPatch.kt#L74-L105开关作用投票按钮播放器顶部显示 / 按钮可对分段投票紧凑跳过按钮跳过按钮只显示简短文字更省空间自动隐藏跳过按钮按钮停留几秒后自动收起时长可调跳过时提示每次跳过弹 Toast时长可调显示去除分段后的时长播放器左下角时间显示为实际要看的时长方形布局跳过按钮改为方形风格五、YouTube 版进阶配置白名单、创建分段、API 与统计YouTube 版是最完整的配置集SponsorBlockPatch.kt#L106-L1591️⃣ 创建新分段贡献社区开启morphe_sb_create_new_segment后播放器会出现新建分段按钮拖动起止时间、选类别、设最小分段时长提交时由 SBRequester.submitSegments() 上报服务器。提交成功、重复409、限流429、403 等结果都有对应提示。2️⃣ 频道白名单频道白名单入口可把指定频道加入豁免列表——白名单频道的视频不请求、不应用任何分段适配器见 YouTubeSponsorBlockConfig.java#L258-L265还能选择跳过时是否提示该频道已在白名单中。3️⃣ API 地址切换如果默认 API 连接失败会按你的连接错误提示设置弹 Toast可以在morphe_sb_api_url设置里换成可用的镜像端点。4️⃣ 跳过统计与 VIP开启跟踪跳过次数后每次自动跳过会向服务器上报一次已观看sendSegmentSkippedViewedRequest累计数据用于社区统计本地同时记录累计节省的毫秒数和跳过分段数若你有过投票/提交/导入过私有用户 IDApp 会每 3 天后台检测一次 VIP 身份SBRequester.java#L350-L375VIP 可锁定高分段不被覆盖。5️⃣ 导入 / 导出SponsorBlockImportExportPreference支持把类别行为颜色整套导出为 JSON、或从桌面端配置导入换机不丢设置。六、YouTube Music 版轻量但够用的音乐向配置音乐版补丁music/layout/sponsorblock/SponsorBlockPatch.kt只保留最常用的项总开关、跳过 Toast、9 个类别的颜色行为、连接错误提示、API 地址和关于页——没有白名单、创建分段和投票因为音乐场景主要就靠music_offtopic、sponsor、outro三类。其宿主适配见 MusicSponsorBlockConfig.java。七、源码速查想看实现去哪儿找模块路径共享 API 与适配器设计extensions/shared-youtube/library/src/main/java/app/morphe/extension/shared/sponsorblock/分段/类别/行为数据模型objects/API 请求取分段/提交/投票/统计requests/SBRequester.javaYouTube 字节码补丁 设置面板patches/src/main/kotlin/app/morphe/patches/youtube/layout/sponsorblock/SponsorBlockPatch.ktYouTube 设置项与 UI 按钮extensions/youtube/src/main/java/app/morphe/extension/youtube/sponsorblock/YouTube Music 补丁与适配patches/src/main/kotlin/app/morphe/patches/music/layout/sponsorblock/补丁清单说明README.mdSponsorBlock条目八、常见问题排查没有任何色条出现先确认总开关已打开视频 ID 无数据时接口返回 404 属正常若总是连接失败多半是网络/API 地址问题换一个morphe_sb_api_url端点试试。跳过太激进误跳了想看的部分把该类别改为显示跳过按钮或忽略或设置最小分段时长过滤掉过短的脏数据。某 UP 主的内容总被误标把该频道加入 SponsorBlock 白名单一劳永逸。新控件布局下跳过按钮不显示补丁已在新版控件21.36中自动禁用新控件特性以兼容SponsorBlockPatch.kt#L359-L363如仍异常可升级到最新版补丁。✅小结Morphe Patches 的 SponsorBlock 集成的精髓在于共享核心 宿主适配一套跳分段逻辑同时服务 YouTube 与 YouTube Music而 10 个类别 × 5 种行为 × 独立配色的组合加上白名单、投票、创建分段与统计让它成为移动端目前最细粒度的跳过方案之一。花 10 分钟配好类别行为之后的每一期视频都会更直奔主题。【免费下载链接】morphe-patchesMorphe Patches项目地址: https://gitcode.com/gh_mirrors/mo/morphe-patches创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考