PTZ控制

您需要在物联网平台控制台，为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控制服务。

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 }