Melhor compartilhamento de tela com o Foco condicional

François Beaufort

Elad Alon

A API Screen Capture permite que o usuário selecione uma guia, janela ou tela para capturar como um fluxo de mídia. Essa transmissão pode ser gravada ou compartilhada com outras pessoas pela rede. Esta documentação apresenta o foco condicional, um mecanismo para apps da Web controlarem se a guia ou janela capturada será focada quando a captura começar ou se a página de captura vai permanecer em foco.

Suporte ao navegador

O foco condicional está disponível a partir do Chrome 109.

Contexto

Quando um web app começa a capturar uma guia ou uma janela, o navegador precisa tomar uma decisão: a superfície capturada deve ser colocada em primeiro plano ou a página de captura deve permanecer em foco? A resposta depende do motivo da ligação getDisplayMedia() e da plataforma que o usuário seleciona.

Considere um web app de videoconferência hipotético. Ao ler track.getSettings().displaySurface e possivelmente examinar o Capture Handle, o web app de videoconferência pode entender o que o usuário escolheu compartilhar. Em seguida:

• Se a guia ou janela capturada puder ser controlada remotamente, mantenha a videoconferência em foco.
• Caso contrário, foque na guia ou janela capturada.

No exemplo acima, o web app de videoconferência manteria o foco se um conjunto de slides fosse compartilhado, permitindo que o usuário passasse os slides remotamente. No entanto, se o usuário escolhesse compartilhar um editor de texto, o web app de videoconferência mudaria imediatamente o foco para a guia ou janela capturada.

Como usar a API Conditional Focus

Instancie um CaptureController e transmita-o para getDisplayMedia(). Ao chamar setFocusBehavior() imediatamente após a resolução da promessa retornada por getDiplayMedia(), você pode controlar se a guia ou janela capturada será focada ou não. Isso só pode ser feito se o usuário tiver compartilhado uma guia ou uma janela.

const controller = new CaptureController();

// Prompt the user to share a tab, a window or a screen.
const stream =
    await navigator.mediaDevices.getDisplayMedia({ controller });

const [track] = stream.getVideoTracks();
const displaySurface = track.getSettings().displaySurface;
if (displaySurface == "browser") {
  // Focus the captured tab.
  controller.setFocusBehavior("focus-captured-surface");
} else if (displaySurface == "window") {
  // Do not move focus to the captured window.
  // Keep the capturing page focused.
  controller.setFocusBehavior("focus-capturing-application");
}

Ao decidir se vai focar, é possível considerar o Capture Handle.

// Retain focus if capturing a tab dialed to example.com.
// Focus anything else.
const origin = track.getCaptureHandle().origin;
if (displaySurface == "browser" && origin == "https://example.com") {
  controller.setFocusBehavior("focus-capturing-application");
} else if (displaySurface != "monitor") {
  controller.setFocusBehavior("focus-captured-surface");
}

É possível até decidir se você quer focar antes de chamar getDisplayMedia().

// Focus the captured tab or window when capture starts.
const controller = new CaptureController();
controller.setFocusBehavior("focus-captured-surface");

// Prompt the user to share their screen.
const stream =
    await navigator.mediaDevices.getDisplayMedia({ controller });

Você pode chamar setFocusBehavior() várias vezes antes da resolução da promessa ou, no máximo, uma vez imediatamente após a resolução. A última invocação substitui todas as anteriores.

Mais precisamente: - A promessa retornada getDisplayMedia() é resolvida em uma microtarefa. Chamar setFocusBehavior() depois que essa microtarefa for concluída vai gerar um erro. - Chamar setFocusBehavior() mais de um segundo após o início da captura não faz nada.

Ou seja, os dois snippets a seguir vão falhar:

// Prompt the user to share their screen.
const stream =
    await navigator.mediaDevices.getDisplayMedia({ controller });

// Too late, because it follows the completion of the task
// on which the getDisplayMedia() promise resolved.
// This will throw.
setTimeout(() => {
  controller.setFocusBehavior("focus-captured-surface");
});

// Prompt the user to share their screen.
const stream =
    await navigator.mediaDevices.getDisplayMedia({ controller });

const start = new Date();
while (new Date() - start <= 1000) {
  // Idle for ≈1s.
}

// Because too much time has elapsed, the browser will have
// already decided whether to focus.
// This fails silently.
controller.setFocusBehavior("focus-captured-surface");

A chamada de setFocusBehavior() também gera exceções nos seguintes casos:

• a faixa de vídeo da transmissão retornada por getDisplayMedia() não é "live".
• depois que a promessa retornada de getDisplayMedia() for resolvida, se o usuário tiver compartilhado uma tela (não uma guia ou janela).

Exemplo

Para testar o foco condicional, execute a demonstração.

Detecção de recursos

Para verificar se CaptureController.setFocusBehavior() é compatível, use:

if (
  "CaptureController" in window &&
  "setFocusBehavior" in CaptureController.prototype
) {
  // CaptureController.setFocusBehavior() is supported.
}

Feedback

A equipe do Chrome e a comunidade de padrões da Web querem saber sobre suas experiências com o foco condicional.

Fale sobre o design

Há algo sobre o foco condicional que não funciona como esperado? Ou há métodos ou propriedades ausentes que você precisa implementar sua ideia? Tem uma dúvida ou um comentário sobre o modelo de segurança?

• Registre um problema de especificação no repositório do GitHub ou adicione suas ideias a um problema existente.

Problemas com a implementação?

Você encontrou um bug na implementação do Chrome? Ou a implementação é diferente da especificação?

• Registre um bug em https://new.crbug.com. Inclua o máximo de detalhes possível e instruções simples para reproduzir o problema.

Mostrar apoio

Você planeja usar o foco condicional? Seu apoio público ajuda a equipe do Chrome a priorizar recursos e mostra a outros fornecedores de navegadores a importância de oferecer suporte a eles.

Envie um tweet para @ChromiumDev e informe onde e como você está usando.

Links úteis

• Especificação
• Explicação
• Revisão da TAG

Agradecimentos

Imagem principal de Elena Taranenko.

Agradecemos a Rachel Andrew por revisar este artigo.