一个用纯 Swift + AppKit 封装的哔哩哔哩网页版 macOS 原生客户端。零第三方依赖,无需 Xcode,只要 Command Line Tools 即可构建。
- 完整网页体验:基于 WKWebView,登录状态持久化,窗口标题跟随页面
- 滚轮音量:光标悬停在播放器上时,滚轮直接调节视频音量(非系统音量),其他位置正常滚动页面;首页/推荐位的卡片悬停预览同样保持页面滚动(不调音量);
⌥ + 滚轮调节系统音量。调节幅度偏缓(单次滚动最多 1%),惯性滚动不参与,不会一甩就冲到底;想再改手感见下方「滚轮音量灵敏度」 - 音量 HUD:白色扬声器图标 + 数字,显示在播放器中央,1 秒自动淡出
- 鼠标侧键:前进 / 后退
- 双击真全屏:双击视频 = B 站网页全屏 + 原生窗口全屏(占满整块显示器),再双击或
ESC退出;退出后播放状态不受影响 - 单击暂停/播放:单击视频区域切换播放,双击不会误触
- 窗口记忆:记住窗口大小和位置,下次启动自动恢复
- 快捷键:
⌘R刷新 /⌘⇧R强制刷新 /⌘←⌘→前进后退 /⌃⌘F全屏 - 直播可播放:直播间(含新版播放器 iframe)正常播放,同样支持悬停滚轮调音量
需要 macOS 12+ 和 Xcode Command Line Tools(xcode-select --install)。
./build.sh脚本会自动完成:生成图标 → swiftc 编译 → 组装 App bundle → ad-hoc 签名 → 打包 DMG。产物在 build/ 下:
若项目放在 iCloud/OneDrive 等同步盘里,签名前脚本会先执行
xattr -cr清掉同步盘附带的 Finder 扩展属性,否则codesign会报resource fork, Finder information, or similar detritus not allowed
build/BiliViewer.app— 直接拖入「应用程序」即可使用build/BiliViewer.dmg— 分发用镜像
BiliViewer/
├── Sources/
│ ├── main.swift # 入口:NSApplication 启动 + 菜单栏
│ ├── BrowserWindow.swift # 主窗口:WKWebView、滚轮/侧键/HUD/全屏等全部交互逻辑
│ └── SystemVolume.swift # CoreAudio 系统音量读写
├── scripts/
│ └── make_icon.swift # 用 CoreGraphics 生成应用图标
├── Info.plist
└── build.sh # 一键构建脚本
- UA 注入:默认 UA 会被 B 站判定"浏览器版本过低",注入 Chrome UA 解决
- 播放器悬停检测:注入 JS,用
elementFromPoint+closest()检测光标是否在播放器上,60ms 节流,经WKScriptMessageHandler回传原生 - 悬停预览不算播放器:B 站首页/推荐位的悬停预览同样是
.bpx-player-container+<video>,与主播放器同构,不能只按容器名判断。注入脚本用卡片祖先(如v-inline-player、v-recommend-inline-player、bili-video-card、video-page-card-small)排除预览,并把预览视频排除出mainVideo(),否则滚轮会被预览视频"抢走"变成调音量 - 返回后重置悬停状态:WKWebView 返回上一页时,旧页面的"光标在播放器上"状态会残留,导致返回后滚轮被继续当成调音量吞掉、页面滚不动。注入脚本在
pageshow/pagehide/popstate和新文档启动时上报over:false,原生在didStartProvisionalNavigation/didCommit再兜底清理,返回后立即恢复页面滚动 - 播放器音量:直接修改
video.volume(不走合成事件,B 站会忽略非isTrusted事件) - 全屏播放状态保护:B 站全屏切换会重建播放器(暂停的变播放、播放的变暂停),切换后 2 秒内轮询纠正回原状态
- AppKit 与浏览器滚动方向:NSEvent 的
deltaY(向上滚为正)与浏览器 WheelEvent 相反,转换时需注意;触控板等精确设备要用hasPreciseScrollingDeltas判断 - 直播播放修复:WKWebView 默认不暴露
navigator.mediaDevices,而 B 站直播播放器初始化会无条件调用navigator.mediaDevices.enumerateDevices(),抛TypeError后画面一直黑屏(普通视频页不走这条路径,所以只有直播坏)。修复分两层:Info.plist声明NSMicrophoneUsageDescription/NSCameraUsageDescription(系统据此提供真实 API),同时在页面注入缺失时的空实现兜底 - 直播间播放器在 iframe 里:新版直播间把播放器放进
live.bilibili.com/blanc/<room>同源 iframe,主 frame 拿不到<video>。悬停检测脚本按 frame 注入,原生只往主 frame 发 JS,因此注入脚本里额外提供__biliViewerWheelVolumeGlobal,沿同源 frame 树找到真正持有视频的 frame 调音量;上报的播放器矩形也会逐级换算回顶层坐标,HUD 才能落在播放器中央
默认的调节速度已经降到了旧版的大约 1/3,并且单次滚动事件最多改变 1%(惯性滚动不参与)。觉得还想再调,有两种方式:
- 菜单 BiliViewer → 滚轮音量灵敏度 → 慢 / 标准 / 快,即时生效,重启后保持;
- 命令行微调任意倍率(默认
1.0):
defaults write local.biliviewer PlayerVolumeScrollSensitivity -float 0.6 # 更慢
defaults write local.biliviewer PlayerVolumeScrollSensitivity -float 1.5 # 更快要彻底改基准值,可调 VolumeWebView 里的三个常量:playerVolumeGainPrecise(触控板/Magic Mouse,按滚动位移)、playerVolumeGainWheel(普通滚轮,按行数)、playerVolumeMaxStep(单次事件上限)。
MIT