
海盗电台核心 - 模组制作者资源
模组制作者资源。将音乐文件夹、YouTube 链接或玩家的 Spotify 应用变成一个实时流,任何 RadioExt 电台都可以调频收听,频道数量不限,并提供一个小型 Lua API。玩家:你需要这个只是因为另一个模组要求它。
查看大图[center][size=6][b]Pirate Radio Core[/b][/size]
[size=4]真正播放音乐的部分[/size][/center]
[line]
[size=5][b]玩家请读这一段,然后离开[/b][/size]
你来到这里,是因为某个其他模组(可能是 [url=https://www.nexusmods.com/cyberpunk2077/mods/37044]Pirate Radio[/url])把它列为前置要求。安装它,忘记它的存在,回去开车撞行人吧。下面所有内容都是给做模组的人看的。
[line]
[size=5][b]这是什么[/b][/size]
这东西最初是 Pirate Radio 的内核。后来我想到,也许有人想做一个电台,但不想像我一样跟 Windows 的音频东西搏斗那么久,所以它有了自己的页面。
RadioExt 已经能给游戏添加电台,而 RadioExt 电台可以从 URL 播放流。Pirate Radio Core 就是那个 URL 另一端的东西。它运行在玩家自己的电脑上,把以下内容之一作为实时 MP3 流播放:
[list]
[]一个音乐文件夹(mp3、flac、ogg、wav、m4a、aac、aiff,包含子文件夹)。在 .asi 内部解码,不需要外部程序。[/]
[]YouTube:视频链接、播放列表、YouTube Music 链接,或者直接输入搜索词。它会在隐藏的 WebView2 窗口中运行真正的 YouTube 网站并截取其音频。[/]
[]Spotify:玩家自己的 Spotify 桌面应用,通过 Windows 的媒体控制进行控制,并用 Windows 的按应用音频捕获进行录制。无需登录、无需 API 密钥、无需账号之类的麻烦事。[/]
[/list]它被划分为多个[b]频道[/b],也就是具名流,每个都有自己的来源、音量和设置。一个模组可以用它运行五个电台,或者两个模组可以各自并排运行自己的频道而互不干扰。
[line]
[size=5][b]做一个电台只需要一个文件[/b][/size]
一个普通的 RadioExt 流电台,指向一个频道。频道名就是你在 URL 里填的内容:
[code]{
"displayName": "101.5 My Station",
"fm": 101.5,
"volume": 1.0,
"icon": "default",
"customIcon": { "inkAtlasPath": "", "inkAtlasPart": "", "useCustom": false },
"streamInfo": {
"streamURL": "http://127.0.0.1:52899/stream/mystation.mp3",
"isStream": true
},
"order": []
}[/code]音频这边真的就这些。Core 会注意到每一个指向其频道的 RadioExt 电台,并把当前歌曲以“Artist - Title”的形式显示在车载收音机上。你不需要为此写任何代码。
几件需要知道的事:
[list]
[]频道名是小写 a-z、0-9、短横线和下划线,最多 32 个字符。其他字符会被丢弃,所以“My Station!”会变成 [font=Courier New]mystation[/font]。[/]
[][font=Courier New]/stream.mp3[/font] 等同于 [font=Courier New]/stream/main.mp3[/font]。[/]
[]频道在电台连接到它或有命令提到它时就会存在。全新的频道从玩家的 Music 文件夹开始。[/]
[]选频率之前先查一下原版频率。我没查,结果硬生生发现 99.9 是 Impulse。[/]
[/list][line]
[size=5][b]用 Lua 控制它[/b][/size]
[code]registerForEvent("onInit", function()
local core = GetMod("PirateRadioCore") -- 在 onInit 里,不要在文件加载时
if not core then return end
local ch = core.channel("mystation")
ch.youtube("synthwave mix") -- 链接、播放列表或搜索词
end)[/code][b]core.channel(name)[/b] 会给你一个句柄,带有这些方法:
[list]
[][font=Courier New]ch.folder(path)[/font]:播放一个音乐文件夹[/]
[][font=Courier New]ch.browse()[/font]:打开 Windows 的文件夹选择器,玩家选择后切换[/]
[][font=Courier New]ch.youtube(text)[/font]:视频或播放列表链接,或者搜索词[/]
[][font=Courier New]ch.spotify(link)[/font]:使用 Spotify 应用。链接是可选的(open.spotify.com/... 或 spotify:...)[/]
[][font=Courier New]ch.source(kind)[/font]:“folder”、“youtube”或“spotify”,并带上该来源上次的内容[/]
[][font=Courier New]ch.play()[/font]、[font=Courier New]ch.pause()[/font]、[font=Courier New]ch.toggle()[/font]、[font=Courier New]ch.next()[/font]、[font=Courier New]ch.prev()[/font][/]
[][font=Courier New]ch.volume(v)[/font]:0 到 2.5,1 为原样[/]
[][font=Courier New]ch.shuffle(on)[/font]:文件夹和 YouTube 播放列表[/]
[][font=Courier New]ch.showYouTube(true)[/font]:在游戏上层显示 YouTube 窗口,以便玩家登录(Premium = 无广告)[/]
[][font=Courier New]ch.status()[/font]:当前情况,见下文[/]
[][font=Courier New]ch.streamUrl()[/font]:此频道的 URL[/]
[/list]以及 [b]core[/b] 本身的:
[list]
[][font=Courier New]core.isRunning()[/font]:.asi 响应后为 true;如果 5 秒内没有响应则为 false(缺少 .asi 或没有 ASI 加载器);还在处理时为 nil[/]
[][font=Courier New]core.status()[/font] 和 [font=Courier New]core.channelStatus(name)[/font][/]
[][font=Courier New]core.bindStation(name, displayName)[/font]:在一个 URL 并非逐字属于我们的电台中显示某频道的歌曲[/]
[][font=Courier New]core.setTitleFormat(fn)[/font]:[font=Courier New]fn(channel, status)[/font] 返回收音机显示的内容,如果你不喜欢“Artist - Title”的风格[/]
[][font=Courier New]core.send(name, op, value)[/font]:低层级,用于上面未涵盖的任何操作[/]
[/list]频道的状态长这样:
[code]{
state = "playing", -- "playing"、"paused"、"loading"、"error" 或 "idle"
title = "...", artist = "...", -- 在 YouTube 广告期间 title 为 "Advertisement"
message = "...", -- "120 songs",或出了什么问题
listeners = 1, -- 当前收听的电台数
listening = true,
settings = { source = "youtube", folder = "...", youtube_url = "...",
spotify_url = "...", volume = 1.0, shuffle = true },
}[/code][line]
[size=5][b]行为方式[/b][/size]
频道只有在有东西收听时才播放。停止收听 1.5 秒后它会暂停。这个延迟是因为 RadioExt 在你于车和 Radioport 之间切换时会重新连接,没有它的话音乐每次都会暂停并重新开始。重新收听它会继续,除非玩家是故意暂停的。
来源是惰性的。在有人收听或命令需要它之前什么都不会启动,无人收听 3 分钟后来源会自行关闭。所以一个从没人收听的频道基本不消耗什么。在游戏进程内测量,空闲时远低于单核的 1%,在播放文件夹或 Spotify 时约为 2% 到 3%。YouTube 的浏览器在游戏之外的独立进程中运行。
当一个频道播放 Spotify 时,Spotify 在 Windows 混音器中的自身音量会被调低,以免玩家听到两遍。当频道停止、CET 关闭时,或者在下次启动时(如果游戏崩溃了),音量会恢复。请一次只让一个频道使用 Spotify,因为只有一个 Spotify 应用。
它监听端口 52899,仅绑定到 127.0.0.1。玩家可以在 [font=Courier New]settings.json[/font] 中更改端口,所以请使用 [font=Courier New]core.streamUrl()[/font] 而不是硬编码。
[line]
[size=5][b]不用 Lua?[/b][/size]
你自己在 Core 的 CET 文件夹里写 [font=Courier New]commands.json[/font]:
[code]{"cmds":[{"id":1762100000123,"ch":"mystation","op":"youtube","value":"lofi"}]}[/code].asi 会执行每一个 id 高于它上次执行过的命令,所以 id 只会递增(Lua 那边使用自 1970 年起的毫秒数)。把最后几条命令保留在列表里,每次重写整个文件。游戏启动时超过 3 秒的 [font=Courier New]commands.json[/font] 会被忽略,这样上次会话的遗留内容不会重放。旁边的 [font=Courier New]status.json[/font] 包含 Lua 状态的所有内容。完整参考在随模组附带的 README 中。
[line]
[size=5][b]要求[/b][/size]
[list]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/107]Cyber Engine Tweaks[/url][/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/4591]RadioExt[/url] 用于电台本身(Core 没有它也能运行,但那样就没有可收听的东西了)[/]
[/list][line]
[size=5][b]在你的模组中使用它[/b][/size]
尽管用,不用问。只需把此页面列为要求,并且请[b]不要在你的压缩包中捆绑 PirateRadioCore.asi[/b]。两份副本会争抢同一个端口,两边都会失败,然后我就会收到 bug 报告。
如果你在它之上构建了什么,请在评论中告诉我,我很想看看。如果 API 缺少你需要的东西,很可能我也想要它。
[line]
[size=5][b]Bug[/b][/size]
这是我写的,所以某处肯定有 bug。[font=Courier New]bin/x64/plugins/cyber_engine_tweaks/mods/PirateRadioCore/PirateRadioCore.log[/font] 会说明 .asi 在做什么。附上它以及你的模组发送的内容,我会深入调查。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。