Android Device Screen Streaming · Appium 官方文檔

## 使用Appium的Android設備屏幕流 Appium從1.16開始，可以將被測設備的屏幕流式傳輸到一個或多個遠程客戶端。當前顯示的內容通過http協議作為可配置的[MJPEG](https://en.wikipedia.org/wiki/Motion_JPEG)流廣播。這樣可以觀察自動化測試在運行時的執行情況，并盡早發現可能的問題。單個MJPEG服務器支持多個并發客戶端，這些客戶端可以同時接收屏幕更新。那里的幀速率取決于服務器和設備的性能，但是接近實時速率，可以達到每秒60幀，尤其是在適當調整比特率和/或縮放屏幕尺寸的情況下。 ### mobile: startScreenStreaming 開始流式傳輸設備的屏幕。僅在滿足所有要求的情況下才能開始流傳輸： - [GStreamer](https://gstreamer.freedesktop.org/)二進制文件已安裝在服務器計算機上。例如，可以使用以下命令在Mac OS上安裝它：`brew install gstreamer gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav` - 被測設備有`screenrecord`程序，并且該程序支持`--output-format=h264`參數選項。模擬器僅從API 27開始有此程序。 - `adb_screen_streaming` [服務器功能](https://github.com/appium/appium/blob/master../../writing-running-appium/security.md)被啟用。該命令使用adb初始化低級流，將其通過管道傳輸到GStreamer管道，該管道將h264編碼的幀轉換為JPEG圖像并將其發送到TCP套接字。在此序列的末尾有Node.js http服務，該服務將TCP流包裝為HTTP協議，因此可以使用常規瀏覽器觀看視頻。如果流媒體已在運行，則命令僅靜默返回。不支持同時在多個端口/不同的配置的設備進行流傳輸。在開始新的流之前，必須先停止當前流。 #### 支持的參數 - *width*：生成的圖像所需的寬度。如果該參數未設置，則默認設置為設備屏幕的實際寬度。如果該`width`值小于原始值，則將縮放輸出流。建議在設置自定義寬度/高度時保留原始比例。 - *height*：生成的圖像所需的高度。如果該參數未設置，則默認設置為設備屏幕的實際高度。如果該`height`值小于原始值，則將縮放輸出流。建議在設置自定義寬度/高度時保留原始比例。 - *bitRate*：原始的h264編碼的視頻流的比特率。默認情況下，它等于4000000 bit / s。如果在生成的MJPEG視頻中發現嚴重的幀丟失，建議將其設置為較低的值。 - *host*：用于啟動HTTP MJPEG服務的IP地址/主機名。您可以將其設置為`0.0.0.0`,觸發所有可用網絡接口上的廣播。默認情況下為`127.0.0.1`。 - *port*：用于啟動HTTP MJPEG服務器的端口號。默認情況下為`8093`。 - *pathname*：MJPEG服務可用的HTTP請求路徑。如果該參數未設置，則給定`host`/`port`組合上的任何路徑名都可以使用。請注意，該值應始終以單個斜杠開頭：`/` - *tcpPort*：用于啟動內部TCP MJPEG廣播的端口號。此類廣播始終在環回接口（`127.0.0.1`）上開始。默認情況下為`8094`。 - *quality*：流式JPEG圖像的質量值。此數字應在[1，100]范圍內，其中100是最佳質量。默認情況下為`70`。 - *thinkRotation*：如果設置為，`true`則GStreamer管道將增加生成的圖像的尺寸，以使圖像橫向和縱向都正確適合。`true`如果在廣播會話期間設備旋轉不會相同，請將其設置為。`false`默認情況下。 - *logPipelineDetails*：是否將GStreamer管道事件記錄到標準日志輸出中。用于調試作用較大。默認情況下為`false`。 #### 用法示例 ```java // Java Map<String, Object> args = new HashMap<>(); args.put("width", 1080); args.put("height", 1920); args.put("considerRotation", true); args.put("quality", 45); args.put("bitRate", 500000); driver.executeScript("mobile: startScreenStreaming", args); ``` ```python # Python driver.execute_script('mobile: shell', { 'width': 1080, 'height': 1920, 'considerRotation': True, 'quality': 45, 'bitRate': 500000, }) ``` ### mobile: stopScreenStreaming 停止正在運行的屏幕流session。如果之前沒開始任何session，則不執行任何操作。請注意，一旦終止容器driver的session，屏幕流session會自動停止。 #### 用法示例 ```java // Java driver.executeScript("mobile: stopScreenStreaming"); ``` ```python # Python driver.execute_script('mobile: stopScreenStreaming') ```