chrome.desktopCapture

Açıklama

Desktop Capture API, ekranın içeriğini, tek tek pencereleri veya sekmeleri yakalar.

İzinler

desktopCapture

Türler

DesktopCaptureSourceType

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

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 ve sonraki sürümler

SelfCapturePreferenceEnum değerini yansıtır.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105 ve üzeri sürümler

SystemAudioPreferenceEnum değerini yansıtır.

Enum

"include"

"exclude"

Yöntemler

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

chooseDesktopMedia() tarafından gösterilen masaüstü medya seçici 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,
)

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

Parametreler

  • Kullanıcıya gösterilmesi gereken kaynak grubu. Seçimdeki kaynaklar sıralaması, seçicideki sekme sırasına karar verir.

  • targetTab

    Sekme isteğe bağlı

    Yayının oluşturulduğu isteğe bağlı sekme. Belirtilmemişse ortaya çıkan akış yalnızca arayan uzantısı tarafından kullanılabilir. Akış yalnızca belirli sekmedeki güvenlik kaynağı tab.url ile eşleşen çerçeveler tarafından kullanılabilir. Sekmenin kaynağı güvenli bir kaynak (ör. HTTPS) olmalıdır.

  • geri çağırma

    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 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 süresi dolar.

    • seçenekler

      nesne

      Chrome 57 ve sonraki sürümler

      Aktarımı açıklayan özellikleri içerir.

      • canRequestAudioTrack

        boolean

        Parametre kaynaklarına "audio" dahil edilmişse ve son kullanıcı "Sesi paylaş" onay kutusunun işaretini kaldırmazsa doğru değerini döndürür. Aksi takdirde yanlış olur ve bu durumda getUserMedia çağrısı üzerinden ses akışı istenmemelidir.

İadeler

  • sayı

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