鴻蒙遠(yuǎn)程真機(jī)工具 HOScrcpy三步跑通投屏在家遙控辦公室的設(shè)備【免費下載鏈接】鴻蒙遠(yuǎn)程真機(jī)工具該工具主要提供鴻蒙系統(tǒng)下基于視頻流的投屏功能幀率基本持平真機(jī)幀率達(dá)到遠(yuǎn)程真機(jī)的效果。項目地址: https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy人在家里真機(jī)躺在辦公室的桌子上線上會突然要演示一個鴻蒙應(yīng)用的 bug怎么辦把設(shè)備寄回來等兩三天顯然不現(xiàn)實。HOScrcpy 就是為此準(zhǔn)備的鴻蒙遠(yuǎn)程真機(jī)工具它把設(shè)備畫面以視頻流的形式實時推到你的電腦幀率基本持平真機(jī)你還能反過來在設(shè)備上點按、打字一次投屏就同時解決看和控兩件事 ?快速上手三步跑起第一次鴻蒙投屏先把環(huán)境說清楚你的電腦需要 JDK 8 以上并且配好JAVA_HOME環(huán)境變量注意路徑里不要帶bin目錄帶了對不起就是不起。git clone https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy上面這條命令把源碼拉到本地。接下來在 IDEA 里打開工程按 README 里的步驟新建工件、勾選模塊、構(gòu)建產(chǎn)物會落在out/HOScrcpy_jar目錄那一堆 jar 就是運(yùn)行時要用的全部家當(dāng)拿到 jar 后在它的存放目錄執(zhí)行下面這行命令投屏工具就起來了java -jar HOScrcpy.jar -cp Main窗口打開后設(shè)備列表旁邊點「刷新設(shè)備」選中你的設(shè)備再點「進(jìn)入投屏」稍等片刻畫面就出來了。mac 用戶編譯時記得把pom.xml里 ffmpeg 依賴的 classifier 從windows-x86_64改成macosx-x86_64其余步驟和 Windows 完全一致。遠(yuǎn)程操控真機(jī)幀率、分辨率、碼率怎么取舍連上設(shè)備后鼠標(biāo)在畫面里的操作就是真實設(shè)備的觸摸右邊還有一排電源鍵、音量加減、返回鍵等于把實體機(jī)搬到了屏幕上。真正決定順不流暢的是三個參數(shù)用 SDK 的HosRemoteConfig就能調(diào)參數(shù)默認(rèn)值拉滿的代價幀率setFrameRate120 FPS幀率越高CPU 和網(wǎng)絡(luò)負(fù)擔(dān)越大碼率setBitRate30 Mbps碼率越高畫質(zhì)越細(xì)帶寬吃緊時先崩的就是它分辨率縮放setScale原分辨率傳 2 表示分辨率減半最大可設(shè) 5如果你的網(wǎng)絡(luò)環(huán)境一般一個比較穩(wěn)的組合是HosRemoteConfig config new HosRemoteConfig(設(shè)備SN); config.setScale(2); // 分辨率減半先保住流暢度 config.setFrameRate(60); // 從 120 降到 60 config.setBitRate(10 * 1024 * 1024); // 碼率壓到 10 Mbps這段配置解決的是高配設(shè)備 普通寬帶時畫面卡頓的問題先降分辨率比降幀率更劃算因為畫面細(xì)節(jié)的損失遠(yuǎn)小于動態(tài)流暢度的損失。另外setIFrameInterval控制 I 幀間隔I 幀就是能單獨解碼的完整關(guān)鍵幀默認(rèn) 2000ms網(wǎng)絡(luò)波動大時把間隔調(diào)短畫面恢復(fù)得更快。觸摸與輸入桌面操作怎么變成設(shè)備上的手指工具內(nèi)部做了一層坐標(biāo)映射把你鼠標(biāo)在投屏窗口里的位置換算成設(shè)備上的觸摸坐標(biāo)所以窗口縮放后點擊依然對得準(zhǔn)。SDK 提供的注入方法可以歸納成三組觸摸按下、抬起、移動三種手勢做自動化腳本時最常用鼠標(biāo)左鍵、中鍵、右鍵的按下/抬起/移動外加滾輪上滑、下滑和停止移動事件傳null就是普通懸停移動鍵盤按鍵按下與抬起、粘貼、中文字符直接輸入打字場景不用靠英文鍵盤拼官方給出的響應(yīng)時延指標(biāo)是 100ms 以內(nèi)日常點按、滑動基本感覺不到隔了一層。這些方法的完整清單在 hoscrcpy API介紹.md 里有逐條說明。布局抓取用 dumpLayout 寫自動化測試投屏窗口上方有個「控件查看」開關(guān)打開后右側(cè)會列出現(xiàn)頁面的控件樹支持搜索和高亮定位。它的數(shù)據(jù)來源是設(shè)備上的uitest dumpLayout命令uitest 是鴻蒙自帶的 UI 測試工具執(zhí)行后返回整頁 UI 結(jié)構(gòu)的 JSON包含每個控件的類型、文本、位置屬性。這份數(shù)據(jù)能直接干三件事控件定位寫自動化測試時按文本或?qū)傩哉夷繕?biāo)控件再結(jié)合前面的觸摸注入完成點擊一條打開應(yīng)用→點擊設(shè)置→驗證標(biāo)題的用例就能串起來界面對比工具支持 Layout 導(dǎo)入/導(dǎo)出兩個版本的界面各抓一份 JSONdiff 一下就知道改了哪些控件回歸驗證CI 里定期抓取布局存檔界面被誤改時第一時間能發(fā)現(xiàn)抓取邏輯本身很薄核心就一行 shell 命令加文件回拉實現(xiàn)在 src/main/java/utils/entity/Device.java 的getLayout里想自己接一套測試框架可以直接參考。瀏覽器端投屏免裝客戶端打開網(wǎng)頁就能看如果對方只是看看就行比如遠(yuǎn)程排查時說一句你把畫面發(fā)我不必讓他裝任何軟件。項目里的 web_demo/ 是一個 Maven 小工程思路是本地起一個 WebSocket 服務(wù)端WebSocket 就是瀏覽器和服務(wù)器之間的一條雙向通道類似對講機(jī)雙方隨時能說話跑投屏視頻幀通過它推到瀏覽器頁面用 jmuxer.js一個專門在網(wǎng)頁里解 H.264 流的 JS 庫解碼渲染到 Canvas 上你的鼠標(biāo)操作再順著同一條通道回傳。使用就三步運(yùn)行MyWebSocket的 main 方法起服務(wù)把resources/html/h264.html第 31 行改成自己的設(shè)備 SN瀏覽器打開這個 html 文件即可。多人圍觀一個 bug 現(xiàn)場時這個方案比遠(yuǎn)程桌面友好得多 ?? 有一個已知的小脾氣畫面靜止時視頻流不產(chǎn)新幀頁面不會自動刷新動一下手機(jī)屏幕畫面就跟上了。踩坑與實用建議JAVA_HOME 必須包含正確路徑且不帶bin這是啟動失敗最常見的原因配錯時命令直接報不是內(nèi)部或外部命令投屏黑著不動先晃一下手機(jī)靜止畫面下視頻流不出新幀這不是卡死是編碼器的正常行為SDK 的onReady回調(diào)就是專門通知你流已就緒畫面需要動一下默認(rèn) 30Mbps 碼率不是給所有網(wǎng)絡(luò)準(zhǔn)備的公司內(nèi)網(wǎng)隨便跑走遠(yuǎn)程網(wǎng)絡(luò)建議先壓到 10Mbps 再試端口被占就換視頻流轉(zhuǎn)發(fā)默認(rèn)走設(shè)備側(cè) 5000 端口同機(jī)同時投多臺設(shè)備時用setPort錯開mac 編譯只改一處ffmpeg 依賴的 classifier 換成macosx-x86_64或macosx-arm64Apple Silicon其他照抄FAQQ設(shè)備列表里刷不出設(shè)備先單獨跑一次hdc list targetsHDC 是鴻蒙的設(shè)備連接工具作用類似安卓的 adb命令行都列不出來說明是 hdc 環(huán)境或授權(quán)問題和工具無關(guān)命令行能列出而界面沒有點刷新重試一次。Q120FPS 跑不動畫面很卡把setScale設(shè)為 2、幀率降到 60體驗改善通常立竿見影再不行就降碼率。順序記住分辨率 → 幀率 → 碼率。Q投的是視頻流點擊會不會對不準(zhǔn)會做坐標(biāo)映射窗口拉伸后點擊依然對齊但注意鼠標(biāo)模式開關(guān)完整鼠標(biāo)事件需要設(shè)備側(cè)支持界面里有對應(yīng)按鈕可切換。QSDK 支持老版本系統(tǒng)嗎hosscrcpy-1.0.0-beta對應(yīng)老系統(tǒng)1.0.1-beta起對應(yīng)新系統(tǒng)版本1.0.4-beta 還修了 5.0.0.71 機(jī)型無法投屏的問題選型時對照 hoscrcpy API介紹.md 頂部的版本表即可。總結(jié)HOScrcpy 用視頻流投屏 事件反控 布局抓取三件套把鴻蒙遠(yuǎn)程調(diào)試從把設(shè)備寄過來變成了打開一個窗口。它的 SDK 接口足夠薄往 Web 平臺、遠(yuǎn)程真機(jī)池方向擴(kuò)展也只是換傳輸和調(diào)度層的事。后續(xù)如果朝云端化部署和自動化測試深度集成走這套看、控、查的能力基本可以直接復(fù)用。【免費下載鏈接】鴻蒙遠(yuǎn)程真機(jī)工具該工具主要提供鴻蒙系統(tǒng)下基于視頻流的投屏功能幀率基本持平真機(jī)幀率達(dá)到遠(yuǎn)程真機(jī)的效果。項目地址: https://gitcode.com/OpenHarmonyToolkitsPlaza/HOScrcpy創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考