record_marker

macOS

Doel

Plaatst een benoemde markering in de tijdlijn van de actieve opname. t_ms is de verstreken ms sinds het begin van de opname. Geef bounds (globale punten, linksboven) mee om naar een element in te zoomen, of laat weg voor het volledige beeld. note wordt een bron voor ondertitels. Geeft no_active_session terug als er niets wordt opgenomen. De eerste aanroep toont een voorbeeld; confirm: true plaatst de markering, met het tijdstip van die aanroep.

Vereiste invoer

• name

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

• Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

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

Documentatievoorbeeld

Documentatievoorbeeld voor record_marker. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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