chrome.desktopCapture

Descrizione

L'API Desktop Capture acquisisce il contenuto 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

"audio"

SelfCapturePreferenceEnum

Chrome 107 e versioni successive

Mirroring di SelfCapturePreferenceEnum.

Enum

SystemAudioPreferenceEnum

Chrome 105 e versioni successive

Rispecchia SystemAudioPreferenceEnum.

Enum

Metodi

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

Nasconde la finestra di dialogo del selettore media per 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 media 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 cui è stato creato lo stream. Se non specificata, lo stream risultante può essere utilizzato solo dall'estensione di chiamata. Il flusso 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 (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 quando non viene usato.

    • opzioni

      oggetto

      Chrome 57 e versioni successive

      Contiene le proprietà che descrivono lo stream.

      • canRequestAudioTrack

        boolean

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

Ritorni

  • numero

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