screenshot_capture

macOS

Amaç

Bir ekranın, pencerenin veya bölgenin tek karesini PNG olarak yakalar. {path, resolution (PIXELS), scale_factor, display_id} döndürür; scale_factor, GERÇEKTEN yakalanan ekranın arka ölçeğidir (yapısı gereği list_displays aracının o display_id için bildirdiği değerle aynıdır: ikisi de tek işlevi okur), dolayısıyla görüntü koordinatını ui_click için dönüştürürken piksel = nokta x scale_factor olur. Ekran belirlenemezse tahmin yerine scale_factor_unknown alırsınız; resolution her zaman bulunur, böylece oranı kendiniz çıkarabilirsiniz. Screen Recording izni gerektirir; izin yoksa boş görüntü yerine açık bir permission_required hatası döndürür.

Zorunlu girdiler

• target

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

• Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.

{
  "properties": {
    "output_path": {
      "description": "Where to write the PNG (default: temp file). Missing parent folders are created.",
      "type": "string"
    },
    "target": {
      "properties": {
        "display_id": {
          "type": "string"
        },
        "kind": {
          "enum": [
            "display",
            "window",
            "region"
          ],
          "type": "string"
        },
        "region": {
          "description": "{x,y,w,h} global points.",
          "type": "object"
        },
        "window_id": {
          "type": "string"
        }
      },
      "required": [
        "kind"
      ],
      "type": "object"
    }
  },
  "required": [
    "target"
  ],
  "type": "object"
}

Belge örneği

screenshot_capture için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{
  "target": {
    "display_id": "1",
    "kind": "display"
  }
}