云台垂直业务

云台作为网络摄像机（IPC）一个重要的功能点，一直被广泛使用在各类 IPC 设备上。而对于云台业务的接入，一直缺少一个垂直化封装，给开发者对接带来了困难。为了解决这个问题，让开发者更快更方便的接入云台功能，涂鸦对云台相关功能进行了封装。

云台管理类

云台相关功能包括：

• 云台控制
• 焦距调整
• 收藏点
• 巡航
• 移动追踪
• 预设点

如上所有云台相关功能，皆通过 IThingIPCPTZ 云台管理类来管理。同时，因为云台功能涉及到大量DP（即功能点，以下统称DP）操作，所以云台相关DP操作也在 IThingIPCPTZ 类中封装了统一接口。

云台管理类获取

示例代码

IThingIPCPTZ thingIPCPTZ = ThingIPCSdk.getPTZInstance(mDevId)

注册云台监听

接口说明

void addPTZListener(@NonNull IThingIPCPTZListener listener);

参数说明

参数	说明
listener	云台监听者

IThingIPCPTZListener

云台监听者，监听云台相关DP变化，详见下表：

接口名	参数列表	返回值	描述
onPTZDeviceDpUpdate	dpCode	void	当云台相关DP更新时回调，开发者可根据dpCode查询DP当前数据（使用云台 DP 封装中 数据查询 接口）

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.addPTZListener(new IThingIPCPTZListener() {
        @Override
        public void onPTZDeviceDpUpdate(String dpCode) {

        }
    });
}

移除云台监听

移除云台监听。推荐开发者在页面销毁时移除监听，如果监听未移除，将会导致内存泄漏发生。

接口说明

void removePTZListener(@NonNull IThingIPCPTZListener listener);

参数说明

参数	说明
listener	要移除的云台监听者

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.removePTZListener(listener);
}

云台 DP 封装

由于云台功能大量使用 DP（即功能点，功能点概念参考 设备控制），所以，对云台相关的DP，在 设备管理 及 设备控制 的基础上进行了二次封装。

状态查询

通过该方法可以判断设备是否支持该DP，可用于判断对应功能相关UI是否展示。

接口说明

boolean querySupportByDPCode(String dpCode);

参数说明

参数	说明
dpCode	DP标识符

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.querySupportByDPCode("motion_tracking");
}

数据查询

获取DP当前数据信息，直接返回值对象。比如值为布尔类型，tClass参数直接传入Boolean.class，返回值即为Boolean对象类型，其他类型类推。如果不支持该DP，将返回空值。

接口说明

<T> T getCurrentValue(String dpCode, @NonNull Class<T> tClass);

参数说明

参数	说明
dpCode	DP标识符
tClass	DP值类对象，Boolean.class、Integer.class、String.class、JSONBean.class等

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.getCurrentValue("motion_tracking", Boolean.class);
}

从设备查询数据

获取DP当前数据信息，针对不主动发送数据的设备DP。结果将会通过 IThingIPCPTZListener 监听返回。

接口说明

void getCurrentValueFromDevice(String dpCode);

参数说明

参数	说明
dpCode	DP 标识符

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.getCurrentValueFromDevice("cruise_status");
}

功能点属性查询

查询DP属性信息。比如查询枚举型（Enum）DP的功能点属性。如果不支持该DP，将返回空值。

接口说明

<T> T getSchemaProperty(String dpCode, @NonNull Class<T> tClass);

参数说明

参数	说明
dpCode	DP标识符
tClass	DP属性类对象，com.tuya.smart.android.device.bean.EnumSchemaExBean.class、 com.thingclips.smart.android.device.bean.ValueSchemaBean.class、String.class等

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.getSchemaProperty("ptz_control", EnumSchemaBean.class);
}

数据下发

向设备发送DP，改变设备状态或功能，来达到设备控制的目的。

接口说明

void publishDps(@NonNull String dpCode, @NonNull Object value, IResultCallback callback);

参数说明

参数	说明
dpCode	DP标识符
value	DP新的值的对象
callback	结果回调

IResultCallback

接口名	参数列表	返回值	描述
onSuccess	void	void	成功回调
onError	String , String	void	错误码及错误信息

您可以在 onSuccess() 回调中处理下发成功逻辑。比如在回调中通过 数据查询 接口获取 DP 最新数据来更新 UI。

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.publishDps("ptz_stop", true, new IResultCallback() {
        @Override
        public void onError(String code, String error) {

        }

        @Override
        public void onSuccess() {

        }
    });
}

设备 DP 上报

当支持上报的 DP 数据变化时，IThingIPCPTZListener 监听将会通知 DP 发生变化。DP变化的情况包含但不限于以下情况：

1. 别的客户端操作设备
2. 数据下发
3. 从设备查询数据

云台控制

功能点名称	标识符	数据传输类型	数据类型	功能点属性	备注
云台转动	ptz_control	可下发可上报（rw）	枚举型（Enum）	枚举值: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9	direction：方向，共8个;0-上，1-右上，2-右，3-右下，4-下，5-左下，6-左，7-左上，8-已经转到头了，9-云台正在校准中，请稍后。
停止转动	ptz_stop	可下发可上报（rw）	布尔型（Bool）	-	true：停止转动 false：不停止转动

云台控制涉及如上 DP，DP 相关操作参考上文 云台 DP 封装。

焦距控制

功能点名称	标识符	数据传输类型	数据类型	功能点属性	备注
焦距控制	zoom_control	可下发可上报（rw）	枚举型（Enum	枚举值: 0, 1	机械变焦, 0 减焦距 ，1 加焦距
停止变焦	zoom_stop	可下发可上报（rw）	布尔型（Bool）		true：停止变焦

焦距调整涉及如上 DP，DP 相关操作参考上文 云台 DP 封装。

收藏点

功能点名称	标识符	数据传输类型	数据类型
收藏点	memory_point_set	可下发可上报（rw）	字符型（String）

收藏点涉及如上 DP。

获取收藏点列表

接口说明

void requestCollectionPointList(IThingResultCallback<List<CollectionPointBean>> callback);

参数说明

参数	说明
callback	成功返回收藏点列表 失败返回错误码及错误信息

CollectionPointBean

参数	描述
id	收藏点 ID
devId	设备 ID
pos	预设点位置信息
name	预设点名字
pic	图的地址
mpId	设备内唯一 ID，设备生成
encryption	图片解密 Key 的存放 Map，为一个 JSON String。

收藏点加密图片展示请参考 DecryptImageView。

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.requestCollectionPointList(new IThingResultCallback<List<CollectionPointBean>>() {
        @Override
        public void onSuccess(List<CollectionPointBean> result) {

        }

        @Override
        public void onError(String errorCode, String errorMessage) {

        }
    });
}

添加收藏点

全景巡航、收藏点巡航中不能添加收藏点，否则 callback 失败回调将会返回错误码 -2001。

接口说明

void addCollectionPoint(@NonNull String name, IResultCallback callback);

参数说明

参数	说明
name	自定义的收藏点名字
callback	结果回调

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.addCollectionPoint("name", new IResultCallback() {
        @Override
        public void onError(String code, String error) {

        }

        @Override
        public void onSuccess() {

        }
    });
}

修改收藏点名称

接口说明

void modifyCollectionPoint(@NonNull CollectionPointBean pointBean, @NonNull String name, IResultCallback callback);

参数说明

参数	说明
pointBean	要修改名字的收藏点Bean
name	新名称
callback	结果回调

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.modifyCollectionPoint(collectionPointBean, "NewTitle", new IResultCallback() {
        @Override
        public void onError(String code, String error) {
        }

        @Override
        public void onSuccess() {
        }
    });
}

删除收藏点

接口说明

void deleteCollectionPoints(@NonNull List<CollectionPointBean> points, IResultCallback callback);

参数说明

参数	说明
points	需要删除的收藏点集合
callback	结果回调

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.deleteCollectionPoints(points, new IResultCallback() {
        @Override
        public void onError(String code, String error) {

        }

        @Override
        public void onSuccess() {

        }
    });
}

预览收藏点

接口说明

void viewCollectionPoint(@NonNull CollectionPointBean collectionPointBean, IResultCallback callback);

参数说明

参数	说明
collectionPointBean	需要预览的收藏点
callback	结果回调

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.viewCollectionPoint(collectionPointBean, new IResultCallback() {
        @Override
        public void onError(String code, String error) {

        }

        @Override
        public void onSuccess() {

        }
    });
}

巡航模式

功能点名称	标识符	数据传输类型	数据类型	功能点属性	备注
巡航开关	cruise_switch	可下发可上报（rw）	布尔型（Bool）	-	-
巡航模式	cruise_mode	可下发可上报（rw）	枚举型（Enum）	枚举值: 0, 1	0 ：全景巡航 1：收藏点巡航
巡航状态	cruise_status	可下发可上报（rw）	枚举型（Enum）	枚举值: 0, 1, 2	0：全景巡航中 1：收藏点巡航 2：非巡航模式
巡航时间模式	cruise_time_mode	可下发可上报（rw）	枚举型（Enum）	枚举值: 0, 1	0：全天巡航 1：自定义巡航
巡航时间	cruise_time	可下发可上报（rw）	字符型（String）		数据格式： t_start：开始时间 t_end：结束时间 多个时间由 ; 分隔

巡航涉及如上DP，设置巡航模式及设置定时巡航操作有单独接口封装，其他DP相关操作参考上文 云台 DP 封装。

设置巡航模式

设置巡航模式，对应 DP cruise_mode。如果设置收藏点巡航，当收藏点个数小于 2 时，将返回错误码 -2002。

接口说明

void setCruiseMode(String mode, IResultCallback callback);

参数说明

参数	说明
mode	只支持两个值： 0：全景巡航 1：收藏点巡航
callback	结果回调

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.setCruiseMode("0", new IResultCallback() {
        @Override
        public void onError(String code, String error) {
        }

        @Override
        public void onSuccess() {

        }
    });
}

设置定时巡航

设置定时巡航。对应 DP cruise_time_mode 及 cruise_time。此接口会先设置 cruise_time_mode 值为定时巡航，再设置 cruise_time 的巡航时间。

接口说明

void setCruiseTiming(@NonNull String startTime, @NonNull String endTime, IResultCallback callback);

参数说明

参数	说明
startTime	开始时间，格式：00:00
endTime	结束时间，格式：00:00
callback	结果回调

示例代码

if (thingIPCPTZ != null) {
    thingIPCPTZ.setCruiseTiming("08:00", "10:00", new IResultCallback() {
        @Override
        public void onError(String code, String error) {

        }

        @Override
        public void onSuccess() {

        }
    });
}

移动追踪

功能点名称	标识符	数据传输类型	数据类型
移动追踪开关	motion_tracking	可下发可上报（rw）	布尔型 （Bool）

移动追踪涉及如上 DP，DP 相关操作参考上文 云台 DP 封装。

预设点

功能点名称	标识符	数据传输类型	数据类型	功能点属性	备注
预设点设置	ipc_preset_set	可下发可上报（rw）	枚举型（Enum）	枚举值: 1, 2, 3, 4	预设点 1、2、3、4

预设点涉及如上 DP，DP 相关操作参考上文 云台 DP 封装。

错误码

云台相关错误码

错误码	说明
-1431	全景巡航、收藏点巡航中不能添加收藏点
-1432	收藏点小于 2 个，无法开启收藏点巡航