wangzuyao / onvif-camera-api

API to control cameras

onvif-camera-api

This is an API to control IP cameras using the ONVIF specification. The API server code passes parameters to onvif.jar to select and control a camera.

Tested on: Python 2.7.6, Flask 0.10.1, Java 1.7.0_25

onvif library based on: https://github.com/milg0/onvif-java-lib

Camera Control Options:

• Pan
• Tilt
• Zoom

Example calls:

View All Presets:

method: GET

url/v1/camera/ptz/preset

curl -H "Content-Type: application/json" -X GET http://127.0.0.1:8888/v1/camera/ptz/preset

View a Selected Preset via ID:

method: GET

url/v1/camera/ptz/preset/preset_id

curl -H "Content-Type: application/json" -X GET http://127.0.0.1:8888/v1/camera/ptz/preset/1

Move Selected Camera via Preset ID:

method: POST

url/v1/camera/ptz/preset/preset_id

curl -H "Content-Type: application/json" -X POST -d '{"username":"myUsername","password":"myPwd"}' http://127.0.0.1:8888/v1/camera/ptz/preset/4

Move Selected Camera:

method: POST

url/v1/camera/ptz/

curl -H "Content-Type: application/json" -X POST -d '{"url":"0.0.0.0","username":"myUsername","password":"myPwd","pan":"-1.0","tilt":"-1.0","zoom":"2.0"}' http://127.0.0.1:8888/v1/camera/ptz

Create Preset:

method: POST

url/v1/camera/ptz/preset/create

curl -H "Content-Type: application/json" -X POST -d '{"url":"0.0.0.0","pan":"-1.0","tilt":"1.0","zoom":"2.0"}' http://127.0.0.1:8888/v1/camera/ptz/preset/create

Example JSON Output:

Moving Camera:

{
  "status_code": "ok",
  "status_message": [
    "x -1.0  y -1.0  zoom 2.0",
    "Move completed."
  ]
}

Viewing All Presets:

{
  "settings": [
    {
      "id": 1,
      "pan": "0.0",
      "tilt": "0.0",
      "url": "0.0.0.0",
      "zoom": "0.0"
    },
    {
      "id": 2,
      "pan": "0.0",
      "tilt": "0.0",
      "url": "10.10.10.10",
      "zoom": "0.0"
    },
    {
      "id": 3,
      "pan": "0.0",
      "tilt": "0.0",
      "url": "192.168.1.1",
      "zoom": "0.0"
    }
  ],
  "status_code": "ok"
}

Selecting/Viewing a Single Preset:

{
  "settings": {
    "id": 1,
    "pan": "0.0",
    "tilt": "0.0",
    "url": "0.0.0.0",
    "zoom": "0.0"
  },
  "status_code": "ok"
}