What you need to know
Review Axis PTZ Autotracker’s automatic-trigger state separately from its selected target. Distinguish automatic zone entry from a client-selected target before accepting operator behavior.
Potentially affected
Axis products exposing the documented PTZ Autotracker API interface; confirm actual device, hardware and software applicability before applying the proposed checks.
DSE recommendation
DSE recommends recording automatic-trigger mode, selected target and observed camera behavior as distinct client states.
Bottom line: State whether the application should choose a target automatically or await an authorized client selection. Inspect that mode and the target independently before interpreting camera movement or a waiting tracker.
Source fact: documented behavior
Axis’s PTZ Autotracker API defines getAutotrackingState as the state of automatic zone triggering, distinct from getAutotrackingTarget for the tracked object.
The source says automatic mode starts tracking when the first object enters a visible zone; manual mode instead requires a client call to setAutotrackingTarget.
Its target-setting description uses an object identifier to start following and -1 to stop, while the target query uses -1 for no active tracking.
What the source does not establish
Do not infer that manual mode makes all tracking impossible or that an automatic-trigger flag identifies the current object. Confirm the exact application, supported interface and configured zones. This article does not guarantee target selection, detection accuracy, safe camera movement or compatibility with an arbitrary PTZ.
Applicability questions
- Should zone entry or an authorized client choose the target?
- What automatic-trigger state and current target are actually reported?
- Which visible zone and permitted test object are in scope?
- How will the operator stop the approved target and restore normal control?
DSE recommendation: controlled next steps
The following steps are DSE recommendations based on the cited source.
DSE recommends recording automatic-trigger mode, selected target and observed camera behavior as distinct client states.
- Review the actual supported application settings and configured zones with the operator owner. Write the intended manual and automatic behaviors before the pilot. Identify a clear attended movement area and the exact client responsible for any manual target selection, and preserve the approved starting mode.
- In the separately authorized automatic case, observe the configured trigger state and a harmless permitted zone entry. Record the target information and actual camera behavior rather than assuming the enabled flag explains every movement. Keep any target that cannot be reconciled with the observation unresolved.
- For the approved manual case, explicitly select the permitted visible object through the supported client workflow and retain the actual target identifier. Use the documented target-stop operation when the exercise ends, then inspect the resulting state and camera behavior. Restore the approved trigger mode and operator arrangement without treating a missing target as proof that no other control path exists.
Verification and evidence
Retain application/device identity, relevant zones, automatic-trigger state, target queries, sanitized selection/stop outcomes and the observer’s timeline. Require a reviewer to explain the difference between waiting for a manual choice and a failed automatic trigger. Record the actual stop observation independently from the request response.
Use proposed client fixtures where automatic triggering is disabled but a manual target is selected, and where automatic triggering is enabled without a current target. Require distinct displays and investigation paths for those states. These are planning cases; no tracker, camera movement or stop behavior has been tested for this article.
Official references
- PTZ Autotracker API — Axis Communications; official VAPIX documentation.
Source review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.
Review the official source
Axis Communications — PTZ Autotracker API · Verified October 29, 2026
Need help applying this guidance safely?
DSE can help confirm applicability, protect service continuity, and validate the result across physical security and IT systems.
Talk with DSE