Rebocap 終於出 Linux 版了!:用官方版 + WiVRn 在 Linux 上玩 VRChat 全身追蹤

還記得我上一篇那個又臭又長的 Rebocap Linux 文章 嗎?為了讓 Windows 版的 Rebocap 在 Wine 裡跑起來,又是補丁又是 bridge.exe 的,整整踩了七個坑(╯‵□′)╯︵┻━┻

結果文章發出去才九天,Rebocap 官方就直接出了 Linux 版(

明明之前還說不會出的說……hhhh

我昨天裝起來用了一下,跟之前的方案比起來,現在只要開官方的軟體跟 CLI 就好了,Bottles、setupapi 補丁、bridge.exe 這三層全部都不用了,開跟關都簡單超多 ww

不過官方的 Linux 版只附了 SteamVR 的驅動,而我這邊還是用 WiVRn + xrizer 在跑 VRChat 的,根本沒有 SteamVR,所以中間還是要靠 CLI 把追蹤器轉給 WiVRn。如果你本來就是用 SteamVR 的話,那直接裝官方版就好了,這篇可以不用看了(

開玩笑的,還是看一下嘛~

順帶一提,我把 repo 的名字也改了,從 rebocap-linux-vrchat-fbt 改成 TW527E/rebocap-linux-wivrn-fbt,這樣比較看得出來它是給 WiVRn 用的。然後 rebocap-wivrn-bridge、rebocap-wine、rebocap-linux-compat 這幾個 repo 也都補上了簡體、繁體、英文、日文四種語言的 README

就算你沒有 Rebocap 好了,你就只是好奇 Linux 上到底能不能玩 VR 全身追蹤,那也可以來看看我這篇又臭又長的文章唷~www

不過先說好,官方的 Linux 版現在還是 Preview 預覽版,官方自己也說這次主要是拿來觀察程式在 Linux 上穩不穩定的,所以遇到 bug 很正常,有問題可以去官方的 X 貼文或 Discord 回報

好啦,進入正題 w

跟之前的方案差在哪

先看一下資料是怎麼跑的,上面是這次的官方版,下面是之前的 Wine 版:

官方 Linux 版:
Quest 頭顯 → WiVRn → CLI ⇄ Rebocap(Linux 原生,:20480)
Rebocap 追蹤器 → Rebocap → CLI → SolarXR → WiVRn → xrizer → VRChat

之前的 Wine 版:
Quest 頭顯 → WiVRn → CLI ⇄ bridge.exe(Wine,:36850)⇄ Rebocap(Wine)
Rebocap 追蹤器 → Rebocap → bridge.exe → CLI → SolarXR → WiVRn → xrizer → VRChat

之前 Rebocap 跑在 Bottles 的 Wine 裡面,它只會開一條 named pipe,所以要靠 bridge.exe 在 Wine 裡把 pipe 轉成 TCP,Linux 這邊的 CLI 才接得到。而官方的 Linux 版自己就會在 127.0.0.1:20480 監聽,CLI 直接連上去就好了,中間那一大坨 Wine 的東西全部可以拿掉

然後之前接收器要靠 Wine 的 COM 埠加上 setupapi 補丁才認得到,現在官方程式是直接用 USB 去抓接收器的,所以這個也不用管了

剩下的 CLI 還是跟之前一樣,負責在 WiVRn 跟 Rebocap 中間來回轉送:把頭顯的頭部姿勢送給 Rebocap,再把追蹤器的姿勢用 SolarXR 發布給 WiVRn,最後 xrizer 再轉給 VRChat

不過這次我用的是自己 fork 的 TW527E/rebocap-wivrn-bridge,不是原版的 akazdayo/rebocap-wivrn-bridge。我在裡面做了三件事:加上官方 Linux 版的支援(用 --bridge 127.0.0.1:20480 連),然後拿掉追蹤器轉送時兩段 10 ms 的輪詢等待,還有修正用 WayVR 這類工具拖動遊玩區之後,追蹤器會偏離身體的問題

延遲有差嗎

老實說,兩個方案在進 CLI 之前的差別很小。官方版少了 Wine 的 named pipe、bridge.exe 的輪詢跟 Wine 的序列埠模擬,大概只省下 1~3 ms 而已w

真正差比較多的是 CLI 本身。原版 CLI 裡追蹤器的姿勢要在兩個 10 ms 的輪詢迴圈裡排隊,平均會多約 10 ms,最多大概 20 ms,而且更新間隔還會忽長忽短。我的 fork 改成一收到就馬上送給 WiVRn,所以不管你用哪個方案,都建議換成這個 fork 的 CLI

我的環境

系統是 Arch Linux(Omarchy,Hyprland),顯卡是 NVIDIA RTX 3070,頭顯是 Quest 2,用 WiVRn 26.9 加上 xrizer 0.6 在跑 VRChat,WiFi 跟 USB 都可以連

Rebocap 是官方的 Linux Preview 0.1(安裝檔是 rebocap-linux-preview-0.1-1.run),追蹤器韌體是 v17。平常綁 10 點:腰、胸、雙大腿、雙小腿、雙腳、雙上臂

第一步,安裝官方 Linux 版 Rebocap

先到官方文件的 軟體下載安裝 頁面,切到 Linux 分頁,點擊下載 Rebocap Linux Preview 0.1

官方文件下載頁的 Linux 分頁

然後在安裝檔所在的資料夾打開終端機,給它執行權限再跑起來:

chmod +x rebocap-linux-preview-*.run
./rebocap-linux-preview-*.run

照著提示裝完就好,預設會裝在 ~/.local/opt/rebocap。裝好之後從應用程式選單開 Rebocap,或是直接執行 ~/.local/opt/rebocap/rebocap-ui 也可以

安裝程式的畫面-
安裝程式的畫面-2
安裝程式的畫面-3
安裝程式的畫面-4
應用程式選單裡的 Rebocap

第二步,給接收器權限

這步一定要做!官方自己也說沒設好的話接收器會連不上,日誌裡會一直跳 state -3

好在官方有附一個腳本,它會寫一條 udev 規則到 /etc/udev/rules.d/70-rebocap.rules,再把你加進 dialout、uucp、plugdev 其中一個群組(Arch 的話是 uucp):

sudo bash ~/.local/opt/rebocap/linux/install_linux_permissions.sh --install --user "$USER"

跑完之後記得重新登入,再把接收器拔掉重插一次

權限腳本跑完的輸出

第三步,更新韌體

開 Rebocap 之後,如果有跳出要更新追蹤器韌體,就照著更新。Linux Preview 0.1 支援的追蹤器韌體是 V16、V17,接收器是 V6、V7、V8,我的追蹤器本來是 v15,升到 v17 之後感覺有比較穩

Rebocap 的韌體更新視窗

更新的時候不要拔接收器,也不要關程式。官方還特別說了不要同時更新追蹤器跟接收器,一個一個來

然後接收器韌體要特別注意,V8 把傳統的 CDC 序列埠拿掉了,改成 vendor 模式,官方說升上去之後就只有最新版的軟體認得到,要用舊版軟體就只能把韌體降回來。對官方 Linux 版來說 V7、V8 都沒差,但我上一篇的 Wine 方案整條路都是靠 /dev/ttyACM* 這個序列埠在跑的,所以接收器一升到 V8,Wine 方案就接不上了(

我自己的接收器現在還是 V7。如果你想留著 Wine 版當備案,更新的時候先只更新追蹤器就好,韌體更新視窗裡接收器跟追蹤器是分開更新的

第四步,不要裝官方的 SteamVR 驅動

官方版有附一個 SteamVR 驅動(在 data/rebocap_driver),但我們沒有要用 SteamVR,所以不要裝

而且 20480 這個埠同一時間只收一個連線,SteamVR 驅動佔著的話,CLI 就連不上去了

第五步,編譯 CLI

這邊要用我 fork 的版本,原版的不支援官方 Linux 版的 20480:

sudo pacman -S rust openxr pkgconf
git clone https://github.com/TW527E/rebocap-wivrn-bridge ~/Projects/rebocap-wivrn-bridge
cd ~/Projects/rebocap-wivrn-bridge && cargo build --release

那如果你之前照我上一篇裝過,舊的 CLI 應該是在 ~/Downloads/rebocap-wivrn-bridge,而且是 akazdayo 的原版。啟動腳本會優先用跟它自己放在同一層的那份 CLI,所以最簡單的做法就是把舊的刪掉,在同一個位置重新 clone 我的 fork 再編譯一次

第六步,裝啟動腳本

git clone https://github.com/TW527E/rebocap-linux-wivrn-fbt ~/Projects/rebocap-linux-wivrn-fbt
ln -s ~/Projects/rebocap-linux-wivrn-fbt/scripts/rebocap-fbt ~/.local/bin/rebocap-fbt

腳本會自己判斷你用的是哪個方案:20480 有在監聽就當作官方 Linux 版,沒有的話再去找 36850 的 bridge.exe。CLI 也會自動找,順序是 REBOCAP_CLI、PATH、跟這個 repo 放在同一層的 rebocap-wivrn-bridge,再來是 ~/Projects、~/Downloads、~/src、~/ 底下的 rebocap-wivrn-bridge

如果你的路徑或埠號跟我不一樣,可以用 REBOCAP_CLI、REBOCAP_NATIVE_PORT(預設 20480)、REBOCAP_WINE_PORT(預設 36850)這些環境變數蓋掉

之前裝過舊版腳本的人,因為 GitHub 會自動幫改名的 repo 轉址,所以直接在舊的資料夾裡 git pull 就可以更新了,symlink 也不用重做。想把網址也改掉的話,再跑一次:

git remote set-url origin https://github.com/TW527E/rebocap-linux-wivrn-fbt

對了,右搖桿按下也能跳的那個綁定產生器也還在,用法跟上一篇一樣,需要的話去那篇看就好了

第七步,改用 rebocap-launch 開 Rebocap

如果你跟我一樣是用 Omarchy,從應用程式選單(Super+Space)開 Rebocap 的話,它會在視窗出現一秒之後自己關掉(

從終端機開卻又完全正常,搞了半天才找到原因,詳細的放在後面的踩坑那段

所以我在 repo 裡多放了一個 rebocap-launch,用它來開 Rebocap 就不會被關掉了。先把它連到 ~/.local/bin,再把 Rebocap 的 desktop 檔改成用它來開:

ln -s ~/Projects/rebocap-linux-wivrn-fbt/scripts/rebocap-launch ~/.local/bin/rebocap-launch
sed -i "s|^Exec=.*|Exec=$HOME/.local/bin/rebocap-launch|" ~/.local/share/applications/rebocap.desktop

腳本裡會順便設定 REBOCAP_NO_DESKTOP_INTEGRATION=1,因為 Rebocap 每次啟動都會重寫自己的 rebocap.desktop,把 Exec= 改回原本的樣子,不關掉的話你剛改的就白改了ww

Rebocap 不是裝在 ~/.local/opt/rebocap 的話,用 REBOCAP_APP 指定 rebocap-ui 的路徑就好。其他桌面從選單開沒問題的話這步可以跳過,不過裝了也不會怎樣,腳本只有在偵測到限制的時候才會繞路

日常怎麼玩

不玩全追的話就照平常的方式,開 WiVRn → 頭顯連線 → 開 VRChat,Rebocap 跟腳本都不用開

要玩全身追蹤的話,順序很重要!

首先開 WiVRn(wivrn-dashboard),確認伺服器有在跑,這時候頭顯先不要連。然後開官方的 Rebocap,就這樣,不用再先開 Bottles 再開 bridge.exe 了ww

接著在終端機跑腳本:

rebocap-fbt          # 10 點(預設):腰、胸、雙大腿、雙小腿、雙腳、雙上臂
rebocap-fbt 12       # 12 點:10 點再加雙前臂
rebocap-fbt 6        # 6 點
rebocap-fbt 10 --usb # 準備好後自動用 USB 連頭顯
rebocap-fbt --native # 強制用官方 Linux 版(--wine 是強制用 Wine 版)

開頭會印出現在用的是哪個方案,用官方版的話會寫 模式:官方 Linux 版 Rebocap(127.0.0.1:20480)

rebocap-fbt 啟動時印出模式的畫面

等到印出「SolarXR 準備好了」(也會跳桌面通知)之後,再連頭顯。然後在 Rebocap 切到 VR 模式,戴著頭顯校準

Rebocap 切到 VR 模式、校準的位置

最後從 Steam 開 VRChat,在 快捷選單(Quick Menu) 點擊 校準全身追蹤(Calibrate FBT) 就可以了~

腳本跑起來之後一樣會幫你檢查部位:

有資料的部位:0 1 2 3 4 5 6 7 9 10
  ⚠ 已發布但沒有資料:…
  ⚠ 有資料但沒有發布:…

只要出現 ⚠,就代表你給的部位參數跟實際綁的追蹤器對不上,要去改部位參數。部位編號跟 USB 連線的細節跟上一篇一樣,這邊就不重複了

玩完要結束的時候,在腳本的終端機按 Ctrl+C 關掉 CLI,再把 Rebocap 的視窗關掉就好了,WiVRn 照平常的方式處理。之前還要用 bridge.quit 讓 bridge 自己退出、還不能從主機 kill Wine 程序的那些麻煩事,現在全部都沒有了 (❁´◡`❁)

還有一個很重要的跟以前一樣:重啟 CLI 或換了部位之後,頭顯要重新連線,VRChat 也要重開。因為 WiVRn 只有在頭顯連線的那一刻才會讀追蹤器清單

踩過的坑

這次的坑少很多了,畢竟 Wine 那一層整個不見了,上一篇那七個坑基本上都不會再遇到ww

腳本說找不到接收器,但 Rebocap 明明認得到

官方版跑起來的時候,會把接收器從 cdc_acm 卸下來,直接用 USB 去存取,所以 /dev/ttyACM* 跟 /dev/serial/by-id/... 會直接消失。我舊版的腳本就是去找這個檔案的,結果就一直說接收器沒插(

現在腳本已經改成直接找 USB 裝置 248a:8002 了,更新一下就好

從選單開 Rebocap,一秒後就自己關掉

這個是我在 Omarchy 上遇到的,從應用程式選單開 Rebocap,視窗出現大概一秒就自己關掉了,沒有當機紀錄,日誌就停在 [linux-rt] realtime=ok,但從終端機開又完全正常(

原因是 Rebocap 會把接收器的執行緒設成即時排程(SCHED_FIFO,透過 pkexec 呼叫官方的 rebocap-set-rt)。而 Omarchy 的選單是跑在 Quickshell 裡的,Quickshell 的 RLIMIT_RTTIME(即時執行緒能用的 CPU 時間上限)是 0,從選單開的程式全部都會繼承這個值

所以執行緒一變成即時就馬上「超時」,核心送出 SIGXCPU,Rebocap 收到之後就很乖地自己結束了hhhh

而且硬上限是 0 的話,程式自己是調不回來的,所以只能繞開。rebocap-launch 會先檢查這個上限,不是 unlimited 的話,就改用 systemd-run --user 從 systemd 的使用者管理員來開 Rebocap,並把上限設成無限

想看某個程序的上限的話,可以跑:

grep 'realtime timeout' /proc/<PID>/limits

改了 rebocap.desktop,下次又變回去了

Rebocap 每次啟動都會重寫自己的 desktop 檔,用環境變數 REBOCAP_NO_DESKTOP_INTEGRATION=1 就可以關掉,rebocap-launch 已經幫你設好了

CLI 連不上 20480

20480 這個埠同一時間只收一個連線,如果有開著官方的 SteamVR 驅動,或是你不小心開了兩個 CLI,後面那個就連不上去。把 SteamVR 或另一個 CLI 關掉就好

CLI 連上了,但一直沒有資料

檢查一下 Rebocap 是不是還沒切 VR 模式,或是正在更新韌體。更新韌體的時候它是不會送資料的,等更新完、切 VR 模式校準之後就會有了

log 裡一直出現 Wine pipe、bridge.exe

明明用的是官方 Linux 版,CLI 的 log 還是會出現 Wine pipe、bridge.exe 這些字,這只是沿用原版的寫法而已,忽略就好了hhhh

其他跟上一篇一樣的小坑

CLI 噴 Failed to connect to monado service process 的話,是 WiVRn 伺服器沒在跑。dashboard 開著不代表伺服器開著,要在 dashboard 點擊「啟動伺服器」

CLI 顯示 invalid SolarXR frame 加上一堆用法說明的話,檢查一下部位參數裡是不是混了全形標點(例如 12。),只能用半形數字跟逗號

用 WayVR 這類工具拖動遊玩區之後,追蹤器如果偏離身體,先確認你用的是我 fork 的 CLI,再看 log 裡有沒有 libmonado unavailable,有的話就去確認 WiVRn 的 runtime JSON 裡有沒有 MND_libmonado_path

那之前的 Wine 方案呢

還在,沒有刪掉。rebocap-fbt 兩種方案都還是支援的,rebocap-wine 跟 rebocap-linux-compat 也都留著,要是官方版在你的電腦上跑不起來,還是可以照 上一篇 的方法用 Wine 跑

不過除非官方版真的不能用,不然我是不推薦啦。少了 Wine、裝丁跟 bridge.exe 三層,開跟關都簡單太多了,而且韌體也可以直接用官方版更新,不用再擔心在 Wine 裡更新會不會出事了

對了,前面說過的接收器韌體 V8 要注意一下,升上去之後 Wine 方案就接不上了。repo 的 README 裡有寫幾個在 V8 上繼續用 Wine 方案的思路(降回 V7、在 Wine 裡跑支援 V8 的新版 Windows Rebocap、或是自己寫一個 USB 轉序列埠的程式),不過我都還沒做也沒測,有興趣的人可以試試看,修好了歡迎發 PR ~

最後

好啦~以上就是用官方 Linux 版 Rebocap 在 Linux 上玩 VRChat 全身追蹤的整個流程了!現在日常就是開 WiVRn、開 Rebocap、跑一行 rebocap-fbt,然後就可以在 VRChat 裡動腳了ww

說真的,上一篇花了那麼多時間在 Wine 裡面跟 named pipe 搏鬥,結果九天後官方直接出 Linux 版,心情有點複雜(

不過能不用 Wine 終究還是好事啦,感謝 Rebocap 官方~

感謝你把這整篇又臭又長的文章看完~(❁´◡`❁) 如果你也有在 Linux 上用 Rebocap,或是照著這篇接起來了(或是接不起來),快給我在下面留言告訴我啊!!!!

參考資料

CC BY-NC-SA 4.0


MinePage by 誠誠 - ChengCheng is licensed under CC BY-NC-SA 4.0

暫無評論

發怖評論 編輯評論


				
|´・ω・)ノ
ヾ(≧∇≦*)ゝ
(☆ω☆)
(╯‵□′)╯︵┴─┴
 ̄﹃ ̄
(/ω\)
∠( ᐛ 」∠)_
(๑•̀ㅁ•́ฅ)
→_→
୧(๑•̀⌄•́๑)૭
٩(ˊᗜˋ*)و
(ノ°ο°)ノ
(´இ皿இ`)
⌇●﹏●⌇
(ฅ´ω`ฅ)
(╯°A°)╯︵○○○
φ( ̄∇ ̄o)
ヾ(´・ ・`。)ノ"
( ง ᵒ̌皿ᵒ̌)ง⁼³₌₃
(ó﹏ò。)
Σ(っ °Д °;)っ
( ,,´・ω・)ノ"(´っω・`。)
╮(╯▽╰)╭
o(*////▽////*)q
>﹏<
( ๑´•ω•) "(ㆆᴗㆆ)
😂
😀
😅
😊
🙂
🙃
😌
😍
😘
😜
😝
😏
😒
🙄
😳
😡
😔
😫
😱
😭
💩
👻
🙌
🖕
👍
👫
👬
👭
🌚
🌝
🙈
💊
😶
🙏
🍦
🍉
😣
Source: github.com/k4yt3x/flowerhd
颜文字
Emoji
小恐龙
花!
上一篇