list_windows
Ekran, pencereler ve arayüz · macOS · Windows
Etki: okuma. Durum: koşullu kullanılabilir.
“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.
macOS
Amaç
Herhangi bir uygulamanın ekrandaki pencerelerini window_id, sahibi uygulamanın paket kimliği ve adı, başlık, sınırlar (genel koordinat uzayı, sol üst başlangıç noktası, punto), display_id (CGDirectDisplayID; list_displays ile eşleşir ve pencerenin hangi ekranda olduğunu bulmanızı sağlar) ve is_focused bilgileriyle listeler. Pencere BAŞLIKLARI Screen Recording izni gerektirir; izin yoksa başlıksız sonuç yerine açık bir permission_required hatası döner. İsteğe bağlı app_bundle_id filtresi vardır; Electron türü uygulamaların pencereleri çoğu zaman farklı paket kimliğine sahip bir HELPER işlemi tarafından sahiplenildiğinden, uygulama ekranda açıkça görünürken filtre boş dönebilir. on_screen_only VARSAYILAN OLARAK TRUE'dur ve küçültülmüş, gizli veya başka Space'teki pencereleri dışlar; bunları görmek için false iletin. Sonuç boş olduğunda araç hangi filtrenin sonucu boşalttığını ve yerine ne iletilmesi gerektiğini açıklayan bir `note` döndürür; uygulamanın penceresi olmadığı sonucuna varmadan bunu okuyun. window_id oturum boyunca sonraki hedeflemeler için sabittir.
Zorunlu girdiler
Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.
İ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.
İngilizce kanonik teknik şema — macOS
{
"properties": {
"app_bundle_id": {
"description": "Only return windows owned by this app bundle id.",
"type": "string"
},
"on_screen_only": {
"description": "Only on-screen windows (default true).",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Belge örneği
list_windows 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.
{}Windows
Amaç
Bu makinedeki açık pencereleri listeler: pencere kimliği, sahibi uygulama (exe adı), pid, başlık, {x,y,w,h} sınırları ve ekran kimliği. Yalnızca Windows'ta çalışır (Win32 pencere API'sini kullanır). Uygulamaya göre filtrelemek için app_bundle_id kullanın; Windows'ta exe adı alt dizesiyle eşleşir.
Zorunlu girdiler
Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.
İ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.
İngilizce kanonik teknik şema — Windows
{
"properties": {
"app_bundle_id": {
"description": "Filter to windows owned by this app. On Windows, a case-insensitive substring of the exe name (e.g. 'chrome').",
"type": "string"
},
"on_screen_only": {
"description": "Only return visible, non-empty-title windows (default true).",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Belge örneği
list_windows 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.
{}