record_marker

macOS

Назначение

Ставит именованный маркер на временную шкалу активной записи. t_ms — прошедшие миллисекунды с начала записи. Передайте bounds (глобальные точки, левый верхний угол), чтобы приблизить к элементу, или опустите для полного кадра. note становится источником подписи. Возвращает no_active_session, если ничего не записывается. Первый вызов показывает предпросмотр; confirm: true ставит маркер с отметкой времени этого вызова.

Обязательные входные данные

• name

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

• Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

{
  "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"
}

Пример для документации

Пример документации для record_marker. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "confirm": false,
  "name": "Planning meeting"
}