record_marker

macOS

Finalidade

Coloca um marcador na linha do tempo da gravação ativa. t_ms é o tempo decorrido em ms desde o início da gravação. Informe bounds (pontos globais, canto superior esquerdo) para dar zoom em um elemento, ou omita para o quadro inteiro. note vira a fonte de uma legenda. Retorna no_active_session se nada estiver sendo gravado. A primeira chamada mostra uma prévia; confirm: true coloca o marcador, carimbado no momento dessa chamada.

Entradas obrigatórias

• name

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.

{
  "properties": {
    "bounds": {
      "description": "Optional {x,y,w,h} global points to zoom toward.",
      "type": "object"
    },
    "confirm": {
      "description": "Must be true to drop the marker; it is stamped at that call. Without it the call returns a preview and adds nothing.",
      "type": "boolean"
    },
    "name": {
      "description": "Marker name, e.g. open_tray, act2_calendar_create.",
      "type": "string"
    },
    "note": {
      "description": "Free text → caption source.",
      "type": "string"
    },
    "session_id": {
      "description": "Accepted and IGNORED: v1 records one session at a time, so a marker always lands on the active recording. It is here so echoing back the session_id from screen_record_start is not an error.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para record_marker. 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,
  "name": "Planning meeting"
}