Lybic Docs

沙箱桌面截屏与串流

相较于其它的,基于虚拟机 novnc 串流方案,lybic的串流采用了自研的、用于云游戏级别的极低延迟、高灵敏、高性能的屏幕串流,视频图像捕获方案,支持更多编码器,大幅提升了兼容性和用户体验,并可以通过sdk/api将串流画面轻松嵌入你的应用业务。

屏幕截图

在日常工作流中,用户可能需要对当前桌面进行截图保存,lybic 沙箱提供了便捷的截图功能,用户可以通过 API 轻松获取当前桌面的高质量截图。

方式一:使用 Preview 端点直接获取预览

最简单的获取屏幕截图的方式是调用 preview 端点,该端点会返回当前沙箱的屏幕截图和光标位置(仅 Computer 系统会返回)。

curl -X POST https://api.lybic.cn/api/orgs/{orgId}/sandboxes/{sandboxId}/preview \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

响应示例:

{
  "screenShot": "https://sandbox-screenshots.lybic.cn/...",
  "cursorPosition": {
    "x": 512,
    "y": 384,
    "screenWidth": 1920,
    "screenHeight": 1080,
    "screenIndex": 0
  }
}

方式二:执行 Screenshot Action

通过执行一个 screenshot action,可以在执行其他操作的同时获取截图。这种方式更灵活,支持控制是否包含截图。

curl -X POST https://api.lybic.cn/api/orgs/{orgId}/sandboxes/{sandboxId}/actions/execute \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": {
      "type": "screenshot"
    },
    "includeScreenShot": true,
    "includeCursorPosition": true
  }'

响应示例:

{
  "screenShot": "https://sandbox-screenshots.lybic.cn/...",
  "cursorPosition": {
    "x": 512,
    "y": 384,
    "screenWidth": 1920,
    "screenHeight": 1080,
    "screenIndex": 0
  },
  "actionResult": {}
}

桌面串流 

你可以在我们的在线演示 和 控制面板-沙箱-沙箱细节-连接 中体验桌面串流功能,享受极致的流畅体验。

下一步:

使用 UI SDK 将桌面串流功能嵌入你的应用,参考UI SDK 文档

本页内容