chrome.desktopCapture

Descrizione

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

Autorizzazioni

desktopCapture

Tipi

DesktopCaptureSourceType

Enumerazione utilizzata per definire l'insieme di origini multimediali desktop utilizzate in chooseDesktopMedia().

Enum

"screen"

"window"

"tab"

"audio"

SelfCapturePreferenceEnum

Chrome 107+

Specchi SelfCapturePreferenceEnum.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105+

Specchi SystemAudioPreferenceEnum.

Enum

"include"

"exclude"

WindowAudioPreferenceEnum

Chrome 140+

Specchi WindowAudioPreferenceEnum.

Enum

"system"

"window"

"exclude"

Metodi

cancelChooseDesktopMedia()

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

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

Parametri

  • desktopMediaRequestId

    numero

    ID restituito da chooseDesktopMedia()

chooseDesktopMedia()

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

Mostra la UI del selettore media per computer con l'insieme specificato di fonti.

Parametri

  • Il set di fonti da mostrare all'utente. L'ordine delle fonti nel set determina l'ordine delle schede nel selettore.

  • targetTab

    Scheda 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 un flusso multimediale corrispondente all'origine 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 pochi secondi se non viene utilizzato.

    • opzioni

      oggetto

      Chrome 57+

      Contiene le proprietà che descrivono lo stream.

      • canRequestAudioTrack

        booleano

        Vero 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 il flusso audio tramite la chiamata getUserMedia.

Resi

  • numero

    Un ID che può essere passato a cancelChooseDesktopMedia() nel caso in cui la richiesta debba essere annullata.