video_blur_region

Ecrã, janelas e interface · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Pixeliza/desfoca um ou mais retângulos sobre o vídeo — a ferramenta para ocultar dados pessoais (um painel de e-mail, um nome) antes de publicar uma gravação de tela. Os retângulos estão em pixels de origem, origem no canto superior esquerdo: [{x,y,w,h, start_ms?, end_ms?}] — omita os tempos para cobrir o clipe inteiro. Ótimo com os `bounds` da linha do tempo de marcadores. Retorna o caminho de saída. A primeira chamada mostra uma prévia; confirm: true grava o arquivo.

Entradas obrigatórias

input
regions

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to write the output. Without it the call returns a preview and writes nothing.",
      "type": "boolean"
    },
    "input": {
      "description": "Path to the source video file.",
      "type": "string"
    },
    "output": {
      "description": "Default: <input>_blurred.mov. Missing parent folders are created.",
      "type": "string"
    },
    "overwrite": {
      "description": "Replace an existing file at output. Without it an existing output is refused. The input is never overwritten.",
      "type": "boolean"
    },
    "regions": {
      "description": "[{x,y,w,h, start_ms?, end_ms?}] in source pixels (top-left).",
      "items": {
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "input",
    "regions"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para video_blur_region. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "confirm": false,
  "input": "/Users/demo/Documents/meeting.mov",
  "regions": [
    {
      "end_ms": 5000,
      "h": 180,
      "start_ms": 0,
      "w": 320,
      "x": 0,
      "y": 0
    }
  ]
}

Windows