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

本人對(duì) Scrcpy 項(xiàng)目的開(kāi)發(fā)者表示深深的敬意和感謝。Scrcpy 是一個(gè)強(qiáng)大而高效的開(kāi)源工具，極大地方便了對(duì) 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)目?jī)H實(shí)現(xiàn)了 Scrcpy 的控制協(xié)議。

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

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

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

特性

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

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

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

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

可視化編輯按鍵映射配置

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

更新檢查

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

國(guó)際化

ScreenStream 投屏

手柄按鍵映射

更好的宏

通過(guò) WebSocket 提供外部控制，見(jiàn)外部控制

幫助文檔

基本使用

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

安裝完成

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

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

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

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

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

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

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

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

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

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

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

返回到蒙版界面，開(kāi)始使用吧！

更新日志

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

新增功能

快速重連

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

README 添加教程鏈接

修復(fù)問(wèn)題

web 圖標(biāo)無(wú)效

菜單欄呼出時(shí)出現(xiàn)全局滾動(dòng)條

映射頁(yè)面拖拽時(shí)未考慮存在的頁(yè)面滾動(dòng)偏移

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