chrome.desktopCapture

Descrizione

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

Autorizzazioni

desktopCapture

Tipi

DesktopCaptureSourceType

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

Enum

"schermo"

"finestra"

"scheda"

"audio"

SelfCapturePreferenceEnum

Chrome 107 e versioni successive .

Esegue il mirroring di SelfCapturePreferenceEnum.

Enum

"Includi"

"escludi"

SystemAudioPreferenceEnum

Chrome 105 e versioni successive .

Esegue il mirroring di SystemAudioPreferenceEnum.

Enum

"Includi"

"escludi"

Metodi

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

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,
)

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

Parametri

  • Insieme di origini che deve essere mostrato all'utente. L'ordine delle origini nel set determina l'ordine delle schede nel selettore.

  • targetTab

    Scheda facoltativa

    Scheda facoltativa per la quale viene creato lo stream. Se non specificato, lo stream risultante può essere utilizzato solo dall'estensione di chiamata. 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 uno stream multimediale corrispondente all'origine selezionata dall'utente. Se l'utente non ha selezionato alcuna origine (ad esempio ha annullato la richiesta), il callback viene chiamato con un streamId vuoto. L'oggetto streamId creato può essere utilizzato una sola volta e scade dopo qualche secondo se non viene utilizzato.

    • opzioni

      oggetto

      Chrome 57 e versioni successive .

      Contiene le proprietà che descrivono il flusso.

      • canRequestAudioTrack

        booleano

        True se "audio" è incluso nelle origini parametro e l'utente finale non deseleziona l'opzione "Condividi audio" casella di controllo. In caso contrario, è false. In questo caso, non dovresti chiedere 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.