跳转到内容

装填配置

装填配置是插件的核心配置,用于指定插件在哪些网页上生效,以及如何将弹幕装填到视频上。

同一网址最多只能有一个装填配置生效,如果有多个装填配置匹配到同一个网址,插件会选择第一个匹配到的装填配置。

装填配置需要以下信息:

名称

就是一个名字,方便识别。

视频元素

视频元素的选择器,用于指定视频元素。插件会将弹幕覆盖到这个元素上并与其同步。

适配

用于关联适配配置

网址(URL模式)

相当于一个白名单,只有在这些网址上插件才会生效。

准确地说,装填配置对应的网址不是单一的地址,而是一个模式,这个模式可以匹配多个网址。

拿B站为例,如果希望插件在B站上生效,可以使用 https://www.bilibili.com/* 这个模式,这个模式可以匹配所有的B站视频网址。

如果填写 https://www.bilibili.com/,那么插件只会在B站首页生效。

如果填写 https://www.bilibili.com/video/*,那么插件只会在视频播放页生效。

如果填写 https://*.bilibili.com/*,那么插件会在所有的B站子域名下生效,包括动态、空间、直播等。

其他例子:

  • ip地址:http://10.0.0.1/*
    • 含端口:http://10.0.0.1:8080/*
    • 任意端口:http://10.0.0.1:*/*
  • 本地服务器:http://localhost/*
  • 本地mp4文件(注意三斜杠):file:///*.mp4
  • 任意HTTPS地址:https://*/*

一般来说,如果希望匹配的网页是 https://www.example.com,那么模式填写 https://www.example.com/* 或者 https://*.example.com/* 就可以满足需求。如果有特殊情况请按照实际情况填写。

单个装填配置可以填写多个模式。

iframe

有一个特殊情况是视频元素在 iframe 中,这种情况下需要填写 iframe 的地址,而不是网页本身的地址。

iframe 的地址可以通过使用浏览器的开发者工具查看 iframe 元素的 src 属性获得。

原因见工作原理