PTZ控制

视频服务支持通过调用IPC设备的PTZ(Pan/Tilt/Zoom)控制服务,对IPC设备进行云台移动及变焦控制。

您需要在物联网平台控制台,为IPC设备所属的产品,定义PTZ(Pan/Tilt/Zoom)物模型服务,定义后可调用PTZ服务指令,实现IPC设备的PTZ控制。物模型相关说明,请参见什么是物模型

前提条件

  • 已启用智能视频服务,且视频设备已经接入物联网平台,详细信息,请参见设备接入

  • 请确认您的IPC设备支持PTZ控制功能。

背景信息

  • PTZ控制的设备端功能,需要您依照本文下方云端开发中描述的物模型服务实现。

  • PTZ控制的应用端功能,需要您自行实现。实现逻辑为:在应用端发起指令,触发您的云端调用物联网视频服务提供的InvokeThingService接口,对IPC设备进行PTZ控制。

云端开发

  1. 登录物联网平台控制台,在实例概览页,找到已创建的实例,单击实例名称。

  2. 在左侧导航栏,选择设备管理 > 产品,然后单击待配置的视频产品。

  3. 产品详情页,单击功能定义,即可查看设备的物模型,物模型中包括为产品定义的服务。

    物联网视频服务提供两种PTZ控制方式,其对应的服务如下表所示。

    方式

    服务

    描述

    手动启停方式

    • 开始PTZ控制(StartPTZAction)

    • 停止PTZ控制(StopPTZAction)

    • 开始PTZ控制:IPC设备根据设定的速度和动作类型参数,进行移动或变焦操作。

    • 停止PTZ控制:IPC设备停止移动或变焦操作。

    说明

    开始PTZ控制和停止PTZ控制需配套使用。

    步进方式

    PTZ步进控制(PTZActionControl)

    IPC设备根据设定的步进量和动作类型参数,进行移动或变焦操作,到达设定步进量时,自动停止。

  4. 功能定义页面,单击编辑草稿

  5. 编辑草稿页面,单击添加标准功能,开始添加PTZ控制服务。添加PTZ控制服务

  6. 返回编辑草稿页面,找到刚添加的三个PTZ服务,单击其对应操作列的编辑,在编辑标准功能对话框,查看服务详细信息。

    单击输入参数输出参数区域,每一个参数名称后的编辑,可查看参数的详细信息。

    编辑标准功能的详细内容,请参见单个添加物模型编辑标准功能

  7. 编辑草稿页面,单击发布上线,并在对话框内勾选确认已查看当前版本与线上版本的比对结果,然后单击确认提交。

  8. 根据步骤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
              }