用户脚本¶
录播姬的高级设置里可以写 javascript 脚本,实现一些比较特殊的功能。录播姬桌面版的高级设置打开方法是鼠标右键点击两次界面左下角的设置齿轮按钮。
在 BililiveRecorder/recorder-scripting-template 里提供了 d.ts 类型文件,推荐 clone 这个仓库后用 VSCode 打开,新建一个 js 文件编写。VSCode 会提供基本的类型提醒以及错误检查。
这个仓库里也提供了能运行的脚本例子,可以参考。
录播姬事件¶
录播姬会在特定事件发生时调用脚本。
事件 handler 是定义在 recorderEvents
上的函数,比如在按下测试按钮时录播姬会调用 recorderEvents.onTest()
。
目前提供了以下几个事件:
onTest¶
测试
当按下软件界面上的测试按钮时触发。
onDanmaku¶
过滤弹幕消息
弹幕和礼物等信息写入 XML 文件之前时会调用这个事件,如果返回 false
就不会写入 XML 文件。
onFetchStreamUrl¶
获取直播流地址
可以使用这个事件来替录播姬获取直播流地址,录播姬会优先使用脚本给的地址。
如果脚本返回了 null
则会使用录播姬自己默认的逻辑。
onTransformStreamUrl¶
修改直播流地址
在获取到直播流地址后,向该地址发送请求之前会调用这个事件,脚本可以修改请求的地址,还可以指定连接的服务器 IP。
如果直播服务器返回了 HTTP 302 等状态码跳转到了另一个地址,每次请求跳转的目标地址之前也会调用一次此事件。
JS 语言功能¶
录播姬使用的运行环境不是 node (甚至不是 V8),有一些语言功能是不支持的,在编写脚本时需要注意避开不支持的功能。
一般来说建议直接编写最终在录播姬里运行的脚本而不是使用 Babel 等工具进行编译。因为运行时是支持大多数 JS 语言功能的,并且一般来说脚本逻辑也足够简单。
语言支持情况
录播姬使用的 JS 引擎是 Jint
ECMAScript 5.1 (ES5)
- 完全支持
ECMAScript 2015 (ES6)
- ArrayBuffer
- Arrow function expression
- Binary and octal literals
- Class support
- DataView
- Destructuring
- Default, rest and spread
- Enhanced object literals
-
for...of
- Generators
- Template strings
- Lexical scoping of variables (let and const)
- Map and Set
- Modules and module loaders
- Promises (Experimental, API is unstable)
- Reflect
- Proxies
- Symbols
- Tail calls
- Typed arrays
- Unicode
- Weakmap and Weakset
ECMAScript 2016
-
Array.prototype.includes
-
await
,async
- Block-scoping of variables and functions
- Exponentiation operator
**
- Destructuring patterns (of variables)
ECMAScript 2017
-
Object.values
,Object.entries
andObject.getOwnPropertyDescriptors
ECMAScript 2018
-
Promise.prototype.finally
- Rest/spread operators for object literals (
...identifier
),
ECMAScript 2019
-
Array.prototype.flat
,Array.prototype.flatMap
-
String.prototype.trimStart
,String.prototype.trimEnd
-
Object.fromEntries
-
Symbol.description
- Optional catch binding
ECMAScript 2020
-
BigInt
-
export * as ns from
-
for-in
enhancements -
globalThis
object -
import
-
import.meta
- Nullish coalescing operator (
??
) - Optional chaining
-
Promise.allSettled
-
String.prototype.matchAll
ECMAScript 2021
- Logical Assignment Operators (
&&=
||=
??=
) - Numeric Separators (
1_000
) -
Promise.any
andAggregateError
-
String.prototype.replaceAll
-
WeakRef
andFinalizationRegistry
ECMAScript 2022
- Class Fields
- RegExp Match Indices
- Top-level await
- Ergonomic brand checks for Private Fields
-
.at()
- Accessible
Object.prototype.hasOwnProperty
(Object.hasOwn
) - Class Static Block
- Error Cause
运行时 API¶
录播姬的 js 运行环境不是 node, 因此也没有 node 或浏览器里的 fetch
, URL
, require
等 API。
录播姬提供的运行时 API 请参考这个 d.ts 文件中的定义。
总的来说录播姬提供了以下这些 API
console¶
类似 node 和 浏览器 中的 console
,不过少了一点功能。
sharedStorage¶
一个 Storage
,和浏览器里的 localStorage
sessionStorage
类似,除了这里以外其他所有的变量在多次运行之间都不会保留。
需要注意如果只在里面添加数据但不删除的话会导致内存占用增加。
fetchSync¶
参考标准的 fetch
实现的一个 HTTP 请求接口,是同步而不是异步的。
dns¶
dns.lookup
会返回一个含有解析到的 IP 的文本数组。
dotnet¶
dotnet
里提供了一些 .NET API 的 binding。
比如可以使用下面的代码
const builder = new dotnet.UriBuilder('https://example.com/path');
builder.path = '/newpath';
console.log(builder.uri.toString());
// https://example.com/newpath
来使用 .NET 的 UriBuilder
对链接进行修改。
具体提供了哪些类型请参考 d.ts 文件中的定义。 如果需要使用其他类可以联系我添加。