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

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

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

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

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

除此之外，為了更好的支持 Scrcpy Mask 與安卓設備交互，本人對 scrcpy-server 進行了一些修改，在此擴展出了一個分支項目 scrcpy-mask-server

特性

有線、無線連接安卓設備

啟動并連接 Scrcpy 服務端

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

鼠標和鍵盤按鍵映射

可視化編輯按鍵映射配置

按鍵映射配置的導入與導出

更新檢查

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

國際化

ScreenStream 投屏

手柄按鍵映射

更好的宏

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

幫助文檔

基本使用

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

安裝完成

確認你的安卓設備類型對于手機或平板電腦等物理設備

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

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

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

啟動軟件并導航到設備頁面。

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

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

再次右擊設備并選擇“控制此設備”。

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

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

導航到鍵映射頁面，切換或編輯鍵映射配置。

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