chrome.desktopCapture

A API Desktop Capture captura o conteúdo da tela, de janelas ou guias individuais.

desktopCapture

Tipos

Enumeração usada para definir o conjunto de fontes de mídia da área de trabalho usadas em chooseDesktopMedia().

Chrome 107 ou mais recente

Chrome 105 ou mais recente

chrome.desktopCapture.cancelChooseDesktopMedia(
  desktopMediaRequestId: number,
)

Oculta a caixa de diálogo do seletor de mídia para computador mostrada por chooseDesktopMedia().

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

Mostra a interface do seletor de mídia para computador com o conjunto especificado de origens.

origens

DesktopCaptureSourceType[]

Conjunto de origens que precisam ser mostradas ao usuário. A ordem das origens no conjunto decide a ordem da tabulação no seletor.
targetTab

Guia opcional

Guia opcional para a qual o stream é criado. Se não for especificado, o stream resultante só poderá ser usado pela extensão de chamada. O stream só pode ser usado por frames na guia especificada cuja origem de segurança corresponda a tab.url. A origem da guia precisa ser segura, por exemplo, HTTPS.
callback

função

O parâmetro callback tem esta aparência:
```
(streamId: string,options: object)=>void
```
- streamId
  
  string
  
  Uma string opaca que pode ser transmitida à API getUserMedia() para gerar um fluxo de mídia que corresponda à origem selecionada pelo usuário. Se o usuário não selecionou nenhuma origem (ou seja, cancelou a solicitação), o callback será chamado com um streamId vazio. O streamId criado só pode ser usado uma vez e expira após alguns segundos quando não é usado.
- opções
  
  objeto
  
  Chrome 57 ou mais recente
  
  Contém propriedades que descrevem o stream.
  - canRequestAudioTrack
    
    boolean
    
    Verdadeiro se "áudio" estiver incluído nas origens do parâmetro e o usuário final não desmarcar a caixa de seleção "Compartilhar áudio". Caso contrário, é falso, e, neste caso, a solicitação não deve solicitar o fluxo de áudio pela chamada getUserMedia.

number

Um ID que pode ser transmitido para cancelChooseDesktopMedia() caso a solicitação precise ser cancelada.