chrome.desktopCapture

Açıklama

Masaüstü Yakalama API'si, 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ı 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

SystemAudioPreferenceEnum'u yansıtır.

Enum

"include"

"exclude"

WindowAudioPreferenceEnum

Chrome 140 veya daha yeni bir sürüm

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 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ı

    Yayın oluşturulan isteğe bağlı sekme. Belirtilmezse sonuçta elde edilen akış yalnızca arayan 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çmediyse (ör. istemi iptal ettiyse) geri çağırma 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 veya sonraki bir sürüm

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

      • canRequestAudioTrack

        boolean

        Parametre kaynaklarına "ses" dahil edilmişse ve son kullanıcı "Sesi paylaş" onay kutusunun işaretini kaldırmamışsa doğru. 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 iletilebilen bir kimlik.