chrome.desktopCapture

Descrizione

L'API Desktop Capture acquisisce i contenuti della schermata, 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

Specchi SelfCapturePreferenceEnum.

Enum

"include"

"exclude"

SystemAudioPreferenceEnum

Chrome 105 e versioni successive

Riflette SystemAudioPreferenceEnum.

Enum

"include"

"exclude"

Metodi

cancelChooseDesktopMedia()

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

Nasconde la finestra di dialogo del selettore di contenuti multimediali del computer 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

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

  • targetTab

    Tab facoltativo

    Scheda facoltativa per la quale 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 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 se non viene utilizzato.

    • opzioni

      oggetto

      Chrome 57 e versioni successive

      Contiene 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, è falso 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 sia necessario annullare la richiesta.