chrome.desktopCapture

Açıklama

Masaüstü Yakalama API'sı ekranın, bağımsız pencerelerin veya tek tek sekmelerin içeriğini yakalar.

İzinler

desktopCapture

Türler

DesktopCaptureSourceType

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

Enum

"window"

"audio"

SelfCapturePreferenceEnum

Chrome 107 ve sonraki sürümler

SelfCapturePreferenceEnum öğesini yansıtır.

Enum

SystemAudioPreferenceEnum

Chrome 105 ve sonraki sürümler

SystemAudioPreferenceEnum'u yansıtır.

Enum

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ı

    selectDesktopMedia() 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. Gruptaki kaynaklar 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 elde edilen akış yalnızca arama uzantısı tarafından kullanılabilir. Akış yalnızca belirtilen sekmedeki güvenlik kaynağı tab.url ile eşleşen kareler 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'sine geçirilebilen opak bir dize. Kullanıcı herhangi bir kaynak seçmediyse (ör. istemi iptal ettiyse) 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 süresi dolar.

    • seçenekler

      nesne

      Chrome 57 ve sonraki sürümler

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

      • canRequestAudioTrack

        boolean

        Parametre kaynaklarında "audio" varsa ve son kullanıcı "Ses paylaş" onay kutusunun işaretini kaldırmazsa doğru değerini alır. Aksi takdirde false (yanlış) olarak ayarlanır ve bu örnekte getUserMedia çağrısı ile ses akışı istenmemelidir.

İlerlemeler

  • sayı

    İstemin iptal edilmesi gerekirse cancelChooseDesktopMedia() işlevine iletilebilecek bir kimlik.