Descrição
A API Desktop Capture captura o conteúdo da tela, de janelas ou guias individuais.
Permissões
desktopCapture
Tipos
DesktopCaptureSourceType
Enumeração usada para definir o conjunto de fontes de mídia da área de trabalho usadas em chooseDesktopMedia().
Tipo enumerado
Tipo enumerado
Tipo enumerado
Métodos
cancelChooseDesktopMedia()
chrome.desktopCapture.cancelChooseDesktopMedia(
desktopMediaRequestId: number,
)
Oculta a caixa de diálogo do seletor de mídia para computador mostrada por chooseDesktopMedia().
Parâmetros
-
desktopMediaRequestId
number
ID retornado por chooseDesktopMedia()
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.
Parâmetros
-
origens
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 umstreamId
vazio. OstreamId
criado só pode ser usado uma vez e expira após alguns segundos quando não é usado. -
opções
objeto
Chrome 57 ou mais recenteConté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.
-
-
Retorna
-
number
Um ID que pode ser transmitido para cancelChooseDesktopMedia() caso a solicitação precise ser cancelada.