chrome.desktopCapture

refresh date: 2026-09-25 robots: noindex

Açıklama

Desktop Capture API, ekranın, bağımsız pencerelerin veya bağımsız sekmelerin içeriğini yakalar.

İzinler

desktopCapture

Türler

DesktopCaptureSourceType

chooseDesktopMedia() içinde kullanılan masaüstü medya kaynakları grubunu tanımlamak için kullanılan enum.

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 ve sonraki sürümler

SelfCapturePreferenceEnum'u yansıtır.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105+

SystemAudioPreferenceEnum'u yansıtır.

Enum

"include"

"exclude"

WindowAudioPreferenceEnum

Chrome 140+

WindowAudioPreferenceEnum'u yansıtır.

Enum

"system"

"window"

"exclude"

Yöntemler

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
): void

chooseDesktopMedia() tarafından gösterilen masaüstü medya seçme aracı iletişim kutusunu gizler.

Parametreler

  • desktopMediaRequestId

    sayı

    chooseDesktopMedia() tarafından döndürülen kimlik

chooseDesktopMedia()

chrome.desktopCapture.chooseDesktopMedia(
  sources: DesktopCaptureSourceType[],
  targetTab?: Tab,
  callback: function,
): number

Belirtilen kaynak grubuyla masaüstü medya seçme aracı kullanıcı arayüzünü gösterir.

Parametreler

  • Kullanıcıya gösterilmesi gereken kaynaklar. Kümedeki kaynak sırası, seçicideki sekme sırasını belirler.

  • targetTab

    Sekme isteğe bağlı

    Akışın oluşturulduğu isteğe bağlı sekme. Belirtilmezse sonuç akışı yalnızca çağrı uzantısı tarafından kullanılabilir. Akış yalnızca güvenlik kaynağı tab.url ile eşleşen belirli sekmedeki çerçeveler tarafından kullanılabilir. Sekmenin kaynağı, HTTPS gibi güvenli bir kaynak olmalıdır.

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (streamId: string, options: object) => void

    • streamId

      dize

      Kullanıcı tarafından seçilen kaynağa karşılık gelen medya akışını oluşturmak için getUserMedia() API'ye iletilebilecek opak bir dize. Kullanıcı herhangi bir kaynak seçmediyse (ör. istemi iptal ettiyse) geri çağırma işlevi boş bir streamId ile çağrılır. Oluşturulan streamId yalnızca bir kez kullanılabilir ve kullanılmadığında birkaç saniye sonra geçerliliğini yitirir.

    • seçenekler

      nesne

      Chrome 57 ve sonraki sürümler

      Akışı açıklayan özellikleri içerir.

      • canRequestAudioTrack

        boole

        "Ses" parametre kaynaklarına dahil edilmişse ve son kullanıcı "Sesi paylaş" onay kutusunun işaretini kaldırmadıysa True (Doğru) değerini alır. Aksi takdirde false döndürülür. Bu durumda, getUserMedia çağrısı üzerinden ses akışı istenmemelidir.

İadeler

  • sayı

    İstemin iptal edilmesi gerektiğinde cancelChooseDesktopMedia() yöntemine iletilebilecek bir kimlik.