Scrcpy Mask為了實(shí)現(xiàn)電腦控制安卓設(shè)備，本人使用 Tarui + Vue 3 + Rust 開發(fā)了一款跨平臺桌面客戶端。該客戶端能夠提供可視化的鼠標(biāo)和鍵盤按鍵映射配置。通過按鍵映射實(shí)現(xiàn)了實(shí)現(xiàn)類似安卓模擬器的多點(diǎn)觸控操作，具有毫秒級響應(yīng)速度。該工具可廣泛用于電腦控制安卓設(shè)備玩手游等等，提供流暢的觸控體驗(yàn)。

本人對 Scrcpy 項(xiàng)目的開發(fā)者表示深深的敬意和感謝。Scrcpy 是一個強(qiáng)大而高效的開源工具，極大地方便了對 Android 設(shè)備的控制。本項(xiàng)目的實(shí)現(xiàn)基于 Scrcpy 的優(yōu)秀架構(gòu)，進(jìn)行了鼠標(biāo)鍵盤控制的優(yōu)化和調(diào)整。

本項(xiàng)目不提供 Scrcpy 的投屏功能！本項(xiàng)目僅實(shí)現(xiàn)了 Scrcpy 的控制協(xié)議。

原因是投屏?xí)嬖谘舆t和模糊問題，本項(xiàng)目另辟蹊徑，直接放棄投屏，而使用透明的蒙版顯示窗口背后的內(nèi)容（可以使用電腦安卓模擬器 、手機(jī)廠商提供的低延遲投屏等），從根本上杜絕了 Scrcpy 的投屏體驗(yàn)差的問題。

如果您確實(shí)需要一個開箱即用的投屏功能，并且不在意延遲和性能問題，可以使用安卓應(yīng)用 ScreenStream 在局域網(wǎng)內(nèi)投屏。本項(xiàng)目已適配 ScreenStream 投屏（自 v0.5.0 版本起），雖然它的性能可能不太理想，但開箱即用。

除此之外，為了更好的支持 Scrcpy Mask 與安卓設(shè)備交互，本人對 scrcpy-server 進(jìn)行了一些修改，在此擴(kuò)展出了一個分支項(xiàng)目 scrcpy-mask-server

特性

有線、無線連接安卓設(shè)備

啟動并連接 Scrcpy 服務(wù)端

實(shí)現(xiàn) Scrcpy 控制協(xié)議

鼠標(biāo)和鍵盤按鍵映射

可視化編輯按鍵映射配置

按鍵映射配置的導(dǎo)入與導(dǎo)出

更新檢查

在按鍵映射和按鍵輸入之間切換

國際化

ScreenStream 投屏

手柄按鍵映射

更好的宏

通過 WebSocket 提供外部控制，見外部控制

幫助文檔

基本使用

在本站下載軟件安裝，根據(jù)提示安裝

安裝完成

確認(rèn)你的安卓設(shè)備類型對于手機(jī)或平板電腦等物理設(shè)備

你需要自己解決投屏的問題。推薦使用設(shè)備品牌的官方投屏方式，這樣一般延遲最小。

通過USB或無線方式在設(shè)備上啟用ADB調(diào)試，然后將其連接到電腦。

對于模擬器，不僅不需要投屏，而且模擬器通常默認(rèn)啟用ADB有線調(diào)試。所以幾乎不用操作就能獲得最好的體驗(yàn)。

啟動軟件并導(dǎo)航到設(shè)備頁面。

在可用的設(shè)備中查找你的設(shè)備(如果未找到，請自行搜索如何為安裝設(shè)備啟用ADB調(diào)試)。

右擊你的設(shè)備并選擇“獲取屏幕大小”。根據(jù)獲得的屏幕尺寸為參考，正確輸入設(shè)備的寬度和高度。注意：如果寬度或高度不正確 (例如，在縱向和橫向模式下這兩個參數(shù)是顛倒的)，所有觸摸操作將被忽略，但是不會有任何錯誤消息。

再次右擊設(shè)備并選擇“控制此設(shè)備”。

導(dǎo)航到設(shè)置頁面->蒙版設(shè)置，將蒙版的寬度和高度設(shè)置為設(shè)備大小的一定倍數(shù)，以確保蒙版大小合適。

導(dǎo)航到蒙版頁面，你可以在其中看到一個完全透明的蒙版區(qū)域。接下來，調(diào)整并移動模擬器窗口或投屏窗口，讓其內(nèi)容區(qū)域與透明蒙版區(qū)域完全對齊。

導(dǎo)航到鍵映射頁面，切換或編輯鍵映射配置。

返回到蒙版界面，開始使用吧！

更新日志

修復(fù)缺陷，完善功能

新增功能

快速重連

為不同功能按鈕添加圖標(biāo)

README 添加教程鏈接

修復(fù)問題

web 圖標(biāo)無效

菜單欄呼出時出現(xiàn)全局滾動條

映射頁面拖拽時未考慮存在的頁面滾動偏移

多屏幕設(shè)備截圖失敗