chrome.desktopCapture

refresh date: 2026-09-25 robots: noindex

Descrizione

L'API Desktop Capture acquisisce i contenuti dello schermo, di singole finestre o di singole schede.

Autorizzazioni

desktopCapture

Tipi

DesktopCaptureSourceType

Enum utilizzato per definire l'insieme di origini multimediali desktop utilizzate in chooseDesktopMedia().

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107 e versioni successive

Rispecchia SelfCapturePreferenceEnum.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105 e versioni successive

Rispecchia SystemAudioPreferenceEnum.

Enum

"include"

"exclude"

WindowAudioPreferenceEnum

Chrome 140+

Rispecchia WindowAudioPreferenceEnum.

Enum

"system"

"window"

"exclude"

Metodi

cancelChooseDesktopMedia()

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

Nasconde la finestra di dialogo del selettore media desktop mostrata da chooseDesktopMedia().

Parametri

  • desktopMediaRequestId

    numero

    ID restituito da chooseDesktopMedia()

chooseDesktopMedia()

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

Mostra l'interfaccia utente del selettore di contenuti multimediali per computer con l'insieme di origini specificato.

Parametri

  • Insieme di fonti che devono essere mostrate all'utente. L'ordine delle origini nel set determina l'ordine delle schede nel selettore.

  • targetTab

    Tab facoltativo

    Scheda facoltativa per cui viene creato lo stream. Se non specificato, lo stream risultante può essere utilizzato solo dall'estensione chiamante. Lo stream può essere utilizzato solo dai frame nella scheda specificata la cui origine di sicurezza corrisponde a tab.url. L'origine della scheda deve essere un'origine sicura, ad esempio HTTPS.

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • streamId

      stringa

      Una stringa opaca che può essere passata all'API getUserMedia() per generare lo stream multimediale corrispondente alla sorgente selezionata dall'utente. Se l'utente non ha selezionato alcuna origine (ovvero ha annullato la richiesta), il callback viene chiamato con un streamId vuoto. Il streamId creato può essere utilizzato una sola volta e scade dopo alcuni secondi se non viene utilizzato.

    • opzioni

      oggetto

      Chrome 57 e versioni successive

      Contiene le proprietà che descrivono lo stream.

      • canRequestAudioTrack

        booleano

        True se "audio" è incluso nelle origini dei parametri e l'utente finale non deseleziona la casella di controllo "Condividi audio". In caso contrario, il valore è false e in questo caso non è necessario richiedere lo stream audio tramite la chiamata getUserMedia.

Resi

  • numero

    Un ID che può essere passato a cancelChooseDesktopMedia() nel caso in cui il prompt debba essere annullato.