Getting Started
Official Site
Getting Started
Official Site
  • Document description
  • Read before you start

  • Light application development guide

  • Mobile application development guide

  • Cloud live development guide

  • Desktop application development guide

  • Third party development guide

  • Message push development guide

  • IoT things data model

  • HTTP interface

    • Development specification
    • API privacy policy
    • Postman interface simulation call
    • accessToken: Get administrator token
    • API request example
    • Account docking
    • Push configuration
    • Cloud storage service
    • Equipment management

    • Device configurat

      • Device wifi configuration
      • Equipment dynamic inspection configuration
      • Device storage configuration
      • Device enable configuration
      • Device collection point configuration
      • Device cruise configuration
      • Device video screen configuration
      • Device recording configuration
      • Device Operation
        • setDeviceSnap:Device snapshot
        • setDeviceSnapEnhanced:Device snapshot
        • controlMovePTZ:PTZ mobile control interface
        • controlLocationPTZ:PTZ positioning interface
        • devicePTZInfo:Get device PTZ control interface
        • restartDevice:Restart the device(Only support device-level restart)
        • calibrationDeviceTime:Calibration equipment UTC time
        • getDeviceTime:Query device UTC time
      • Daylight saving time configuration
    • Video equipment

    • Device message
    • Device live broadcast
    • Device lock access
  • Reference documents

On this page
Function details
Request address
Minimum permissions required for sub-account token request
Incoming parameter description
Sample input
Return data field description
Sample output

controlMovePTZ: PTZ movement control

controlMovePTZ: PTZ movement control

Function details

PTZ movement control interface.

Note: PTZ related functions require the device to have a PT or PTZ PTZ capability set

Request address

https://openapi-[DataCenter].easy4ip.com/openapi/controlMovePTZ

Minimum permissions required for sub-account token request

"Permission":"Ptz" "Resource":"cam:serial number:channel number"

Incoming parameter description

Parameter nameParameter typeRequired or notDefault valueLegal valueParameter description
tokenStringYesAdministrator or sub-account accessToken
deviceIdStringYesDevice serial number
channelIdStringYesChannel ID
operationStringYes0-up, 1-down, 2-left, 3-right, 4-upper left, 5-bottom left, 6-upper right, 7-bottom right, 8-zoom in, 9-zoom, 10 -StopOperation Behavior
durationLongYesMovement duration, in milliseconds

Sample input

{
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign":"74bc756ebd53e9eef2836f8cf1730c10",
        "time":1599031074,
        "nonce":"8ec8a7bd1d1c95420de20d92422d457d"
    },
    "params":{
        "token":"At_00006acr3456d12312d3grf60147de7ec",
        "deviceId":"TESTQWERXXXX",
        "channelId":"0",
        "operation":"1",
        "duration":"1000"
    }
}

Return data field description

No data returned

Sample output

{
  "result":{
    "msg":"The operation was successful.",
    "code":"0"
  },
  "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af"
}
setDeviceSnapEnhanced:Device snapshot
controlLocationPTZ:PTZ positioning interface