全部产品

PTZ控制

视频型实例支持通过调用摄像头的PTZ(Pan/Tilt/Zoom)控制服务,对摄像头进行云台移动及变焦控制。

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

前提条件

已购买视频型实例,且视频设备已经接入物联网平台,详细信息,请参考设备接入

操作步骤

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

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

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

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

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

    视频边缘智能服务提供两种PTZ控制方式,其对应的服务如下表所示。

    方式

    服务

    描述

    手动启停方式

    • 开始PTZ控制

    • 停止PTZ控制

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

    停止PTZ控制:摄像头停止移动或变焦操作。

    说明

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

    步进方式

    PTZ步进控制

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

    添加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
    
                }