视频服务支持通过调用IPC设备的PTZ(Pan/Tilt/Zoom)控制服务,对IPC设备进行云台移动及变焦控制。
您需要在物联网平台控制台,为IPC设备所属的产品,定义PTZ(Pan/Tilt/Zoom)物模型服务,定义后可调用PTZ服务指令,实现IPC设备的PTZ控制。物模型相关说明,请参见什么是物模型。
前提条件
已启用智能视频服务,且视频设备已经接入物联网平台,详细信息,请参见设备接入。
请确认您的IPC设备支持PTZ控制功能。
背景信息
PTZ控制的设备端功能,需要您依照本文下方云端开发中描述的物模型服务实现。
PTZ控制的应用端功能,需要您自行实现。实现逻辑为:在应用端发起指令,触发您的云端调用物联网视频服务提供的InvokeThingService接口,对IPC设备进行PTZ控制。
云端开发
登录物联网平台控制台,在实例概览页,找到已创建的实例,单击实例名称。
在左侧导航栏,选择设备管理 > 产品,然后单击待配置的视频产品。
在产品详情页,单击功能定义,即可查看设备的物模型,物模型中包括为产品定义的服务。
物联网视频服务提供两种PTZ控制方式,其对应的服务如下表所示。
方式
服务
描述
手动启停方式
开始PTZ控制(StartPTZAction)
停止PTZ控制(StopPTZAction)
开始PTZ控制:IPC设备根据设定的速度和动作类型参数,进行移动或变焦操作。
停止PTZ控制:IPC设备停止移动或变焦操作。
说明开始PTZ控制和停止PTZ控制需配套使用。
步进方式
PTZ步进控制(PTZActionControl)
IPC设备根据设定的步进量和动作类型参数,进行移动或变焦操作,到达设定步进量时,自动停止。
在功能定义页面,单击编辑草稿。
在编辑草稿页面,单击添加标准功能,开始添加PTZ控制服务。
返回编辑草稿页面,找到刚添加的三个PTZ服务,单击其对应操作列的编辑,在编辑标准功能对话框,查看服务详细信息。
单击输入参数和输出参数区域,每一个参数名称后的编辑,可查看参数的详细信息。
编辑标准功能的详细内容,请参见单个添加物模型。
在编辑草稿页面,单击发布上线,并在对话框内勾选确认已查看当前版本与线上版本的比对结果,然后单击确认提交。
根据步骤6查看的服务入参信息,调用InvokeThingService接口,使用PTZ控制的相关服务。
InvokeThingService接口主要请求参数如下表,其余请求参数,请参见InvokeThingService。
参数
描述
Identifier
服务的标识符。设备的服务Identifier,可在控制台中,设备所属的产品的功能定义中查看,或调用QueryThingModel,从返回的物模型信息中查看。
Args
步骤6中要启用服务的入参信息,数据格式为JSON String。
请参考下表的示例,配置各PTZ控制的Identifier和Args请求参数。
服务
示例值
开始PTZ控制(StartPTZAction)
"identifier":"StartPTZAction", "args":{ "ActionType":0, "Speed":0 }
停止PTZ控制(StopPTZAction)
"identifier":"StopPTZAction", "args":{ }
PTZ步进控制(PTZActionControl)
"identifier":"PTZActionControl", "args":{ "ActionType":0, "Step":1 }