chrome.desktopCapture

refresh date: 2026-09-25 robots: noindex

Açıklama

Masaüstü Görüntüsü Yakalama API'si, ekranın, pencerelerin veya sekmelerin içeriğini yakalar.

İzinler

desktopCapture

Türler

DesktopCaptureSourceType

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

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 ve sonraki sürümler

Aynalar SelfCapturePreferenceEnum.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105 veya daha yeni bir sürüm

Aynalar SystemAudioPreferenceEnum.

Enum

"include"

"exclude"

WindowAudioPreferenceEnum

Chrome 140 veya daha yeni bir sürüm

Aynalar WindowAudioPreferenceEnum.

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 grubu. Ayarlanan kaynakların 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çta elde edilen akış yalnızca çağıran uzantı tarafından kullanılabilir. Akış yalnızca güvenlik kaynağı tab.url ile eşleşen, belirtilen sekmedeki çerçeveler tarafından kullanılabilir. Sekmenin kaynağı güvenli bir kaynak olmalıdır (ör. HTTPS).

  • 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ışı oluşturmak için getUserMedia() API'ye iletilebilen opak bir dize. Kullanıcı herhangi bir kaynak seçmezse (ör. istemi iptal ederse) geri arama 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

        Parametre kaynaklarına "audio" dahil edilmişse ve son kullanıcı "Sesi paylaş" onay kutusunun işaretini kaldırmamışsa true. Aksi takdirde yanlış olur ve bu durumda, getUserMedia çağrısı aracılığıyla ses akışı istenmemelidir.

İadeler

  • sayı

    İstem iptal edilmesi gerektiğinde cancelChooseDesktopMedia() işlevine iletilebilecek bir kimlik.