裁剪屏幕截图

裁剪指定设备的屏幕截图区域，返回裁剪后的图像。

重要提示

此方法只会返回 BMP 图片格式，不支持其他格式。

接口说明

接口类型

cropScreenShot

参数

参数名	类型	必填	说明
deviceId	string	是	设备ID
rect	number[]	是	裁剪区域，格式为 [x1, y1, x2, y2]，单位为像素

返回值

返回裁剪后的图像二进制数据（BMP 格式）：

基本使用

// 裁剪屏幕截图
// rect: [x1, y1, x2, y2] - 左上角坐标和右下角坐标
const croppedImage = await apiInvoke('cropScreenShot', {
    deviceId: 'P72578581E07',
    rect: [100, 100, 300, 400]  // 从 (100, 100) 到 (300, 400) 的区域
});

// 保存为文件（注意：返回的是 BMP 格式）
const fs = require('fs');
fs.writeFileSync('cropped.bmp', croppedImage);

注意事项

1. 格式限制：此方法固定返回 BMP 格式，无法指定其他格式
2. 坐标范围：rect 参数中的坐标和尺寸不能超出屏幕范围
3. 参数格式：rect 必须是一个包含4个数字的数组：[x1, y1, x2, y2]，其中 (x1, y1) 为左上角坐标，(x2, y2) 为右下角坐标