阿里云首页 物联网视频服务

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. 产品详情页,单击功能定义,即可查看设备的物模型,物模型中包括为产品定义的服务。

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

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

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

      方式

      服务

      描述

      手动启停方式

      • 开始PTZ控制

      • 停止PTZ控制

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

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

      说明

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

      步进方式

      PTZ步进控制

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

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

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

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

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

    8. 根据步骤6查看的服务入参信息,调用InvokeThingService接口,使用PTZ控制的相关服务。

      InvokeThingService接口主要请求参数如下表,其余请求参数,请参见InvokeThingService

      参数

      描述

      Identifier

      服务的标识符。设备的服务Identifier,可在控制台中,设备所属的产品的功能定义中查看,或调用QueryThingModel,从返回的物模型信息中查看。

      Args

      步骤6中要启用服务的入参信息,数据格式为JSON String。

      请参考下表的示例,配置各PTZ控制的Identifier和Args请求参数。

      服务

      示例值

      开始PTZ控制

      "identifier":"StartPTZAction",
      "args":{
                 "ActionType":0,
                 "Speed":0
                  }

      停止PTZ控制

      "identifier":"StopPTZAction",
       "args":{
             }

      PTZ步进控制

      "identifier":"PTZActionControl",
      "args":{ 
                 "ActionType":0,
                 "Step":1
                }