Get started
  • English
  • 简体中文
Official Site
Get started
  • English
  • 简体中文
Official Site
  • Get started
  • Concepts
  • Guides
  • Device capabilities & events
    • Browse by device type
    • Device capabilities
      • Common methods
      • Detection and alarms
      • Image
      • PTZ
        • PTZ movement
          • ptz.aim.speed (Read PTZ speed)
          • ptz.aim.speed (Set PTZ speed)
          • ptz.aim.scanDistance (Read wide-angle scan distance)
          • ptz.aim.relative (Move by speed)
          • ptz.aim.step (Move by step)
          • ptz.aim.reset (Reset PTZ)
        • Cruise
        • Gun-ball linkage
        • Presets
        • Zoom
      • Light
      • Recording
      • Audio
      • Media
      • Network
      • Power
      • Privacy
      • Call
      • Storage
      • System
      • Algorithm
      • Maintenance
      • Control
    • Events overview
    • Permission codes
    • Capability error codes
    • Alarm and capability messages
    • Capability FAQ
    • Legacy ability and push types
  • API reference
  • SDK and tools
  • Solutions
  • Platform and support
On this page
Scope
Reader notes
Index in this folder

PTZ

PTZ

Scope

This domain covers presets, cruise, PTZ movement, and related capabilities. Before calling APIs, use device.capability.list to confirm the device supports each capability.

PTZ movement and gun-ball linkage: a sub-account needs Ptz; a shared device needs PTZ permission. Presets, cruise, and zoom: a sub-account needs Ptz; a shared device needs the basic configuration permission. Gun-ball linkage is device scope—do not send channelId. Everything else is channel scope; omitting channelId returns DV2007.

Reader notes

Start with Using capabilities. Call device.capability.list before you use IDs on this page. See Permission codes and Capability errors.

Index in this folder

CapabilityDescription
PTZ movementSpeed, reset
CruiseSmart cruise, cruise info
Gun-ball linkageSwitch, manual
PresetsFavorites (same preset group)
ZoomAuto, level