安装
onvif
用python安装有源码安装和pip安装两种方式
- pip 安装
python 2.x
:
pip install onvif
python 3
:
pip install --upgrade onvif_zeep
- Github源码安装
python2.x
:
https://github.com/quatanium/python-onvif.git
cd python-onvif && python setup.py install
python 3
:
https://github.com/FalkTannhaeuser/python-onvif-zeep.git
cd python-onvif-zeep && python setup.py install
ONVIF控制
使用规则
-
python API:https://pypi.org/project/onvif/
-
wsdl文档:http://www.onvif.org/onvif/ver20/util/operationIndex.html
-
函数使用流程:
- 创建对象:ptz, imaging, media
- 调用对象方法,详见wsdl文档
- 设置参数:
- 字典形式,无需初始化
- 属性形式,部分需要初始化
- 使用函数
示例
from onvif import ONVIFCamera
class myONVIF():
def __init__(self, ip, usr, pwd):
self.usr = usr
self.pwd = pwd
self.cam = ONVIFCamera(ip, 80, usr, pwd)
self.ptz = self.cam.create_ptz_service()
self.media = self.cam.create_media_service()
self.imaging = self.cam.create_imaging_service()
self.profile = self.cam.media.GetProfiles()[0]
def get_ptz_status(self):
# 获取PTZ状态
request = self.cam.ptz.create_type('GetStatus')
request.ProfileToken = self.profile.token
status = self.cam.ptz.GetStatus(request)
return {'pan': status.Position.PanTilt.x, 'tilt': status.Position.PanTilt.y, 'zoom': status.Position.Zoom.x}
def set_home(self):
# 设置归位点
request = self.cam.ptz.create_type('SetHomePosition') # 设置当前位置为原点位置
request.ProfileToken = self.profile.token
self.cam.ptz.SetHomePosition(request)
def move_home(self):
# 归位
request = self.cam.ptz.create_type('GotoHomePosition') # 回到原点位置
request.ProfileToken = self.profile.token
if request.Speed is None: # 设置归位的速度
request.Speed = self.cam.ptz.GetStatus({'ProfileToken': self.profile.token}).Position
self.cam.ptz.GotoHomePosition(request)
def abs_move(self, pan, tilt, zoom):
# 绝对移动
request = self.ptz.create_type('AbsoluteMove')
request.ProfileToken = self.profile.token
request.Position = {'PanTilt':{'x':pan, 'y':tilt}, 'Zoom':zoom}
request.Speed = {'PanTilt':{'x':1, 'y':1}, 'Zoom':1} # default speed
self.ptz.AbsoluteMove(request)
def continue_move(self, speed_pan, speed_tilt, speed_zoom):
# 持续移动
request = self.ptz.create_type("ContinuousMove")
request.ProfileToken = self.profile.token
request.Velocity = {'PanTilt':{'x':speed_pan, 'y':speed_tilt}, 'Zoom':speed_zoom}
self.ptz.ContinuousMove(request)
def relative_move(self, pan, tilt, zoom):
# 相对移动
request = self.cam.ptz.create_type('RelativeMove')
request.ProfileToken = self.profile.token
request.Translation = {'PanTilt':{'x':pan, 'y':tilt}, 'Zoom':zoom}
request.Speed = {'PanTilt':{'x':1, 'y':1}, 'Zoom':1}
self.ptz.RelativeMove(request)
def stop_move(self):
# 停止
self.ptz.Stop({'ProfileToken': self.profile.token})
def snap_image(self, path):
# 抓拍图像
import requests, os
res = self.media.GetSnapshotUri({'ProfileToken': self.profile.token})
auth = requests.auth.HTTPDigestAuth(self.usr, self.pwd)
response = requests.get(url=res.Uri, auth=auth)
path_out = os.path.join(path, 'tmp.jpg')
with open(path_out, 'wb') as fp:
fp.write(response.content)
def get_rtsp(self):
# 获取rtsp
obj = self.media.create_type('GetStreamUri')
obj.StreamSetup = {'Stream': 'RTP-Unicast', 'Transport': {'Protocol': 'RTSP'}}
obj.ProfileToken = self.profile.token
res_uri = self.media.GetStreamUri(obj)['Uri']
return res_uri
def get_image_status(self):
# 获取焦距不起作用???
request = self.imaging.create_type('GetStatus')
request.VideoSourceToken = self.profile.VideoSourceConfiguration.SourceToken
return self.imaging.GetStatus(request)
def abs_move_image(self, pos, speed=1):
# 焦距绝对移动
request = self.imaging.create_type('Move')
request.VideoSourceToken = self.profile.VideoSourceConfiguration.SourceToken
request.Focus = {'Absolute': {'Position': pos, 'Speed': speed}}
self.imaging.Move(request)
def continue_move_image(self, speed=1):
# 焦距持续移动
request = self.imaging.create_type('Move')
request.VideoSourceToken = self.profile.VideoSourceConfiguration.SourceToken
request.Focus = {'Continuous':{'Speed':0.5}}
self.imaging.Move(request)
def relative_move_image(self, dist, speed=1):
# 焦距相对移动
request = self.imaging.create_type('Move')
request.VideoSourceToken = self.profile.VideoSourceConfiguration.SourceToken
request.Focus = {'Relative': {'Distance':dist, 'Speed':speed}}
self.imaging.Move(request)
def stop_move_image(self):
# 焦距停止移动
self.imaging.Stop({'VideoSourceToken': self.profile.VideoSourceConfiguration.token})
if __name__ == "__main__":
pass