云存储

涂鸦为智能摄像机 (IPC) 提供云存储服务，可以将 IPC 录制的视频上传到云端。

流程说明

1. 判断设备是否有支持云存储能力，支持则继续。
2. 查询云存储服务的开通状态。
3. 根据开通状态判断后续逻辑：
   • 如果云存储服务未开通或者已经过期，就需要先购买云存储服务。
     云存储服务过期后，已经上传的云视频还会保留一段时间，通常是 7 天。之后，云视频会被全部删除。

   • 如果云存储服务在有效期：

     1. 获取有云存储视频的日期。

     2. 获取指定日期的相关数据，包括云存储事件、时间轴数据、鉴权信息等。

     3. 选择一个云存储事件或者一个时间点，开始播放云视频。

        

支持云存储

IThingIPCCloud 是云存储的 API 集合，所以提供了设备是否支持云存储能力的方法。

接口说明

boolean isSupportCloudStorage(String devId);

参数说明

参数	说明
devId	设备 ID

示例代码

IThingIPCCloud cloud = ThingIPCSdk.getCloud();
    if (cloud != null) {
    isSupportCloudStorage = cloud.isSupportCloudStorage(devId);
    }

开通服务

开通云存储服务请使用 云存储服务 UI 业务包，该组件提供了云存储服务开通的 H5 页面和订单展示功能。

云存储对象

IThingCloudCamera 提供了云视频存储相关的接口。

接口说明

创建云存储的实例对象。

IThingCloudCamera createCloudCamera();

示例代码

private IThingCloudCamera cloudCamera;

        IThingIPCCloud cloud = ThingIPCSdk.getCloud();
        if (cloud != null) {
        cloudCamera = cloud.createCloudCamera();
        }

普通云存储

查询云存储的开通状态

接口说明

void queryCloudServiceStatus(String devId, IThingResultCallback<CloudStatusBean> callback);

参数说明

参数	说明
devId	设备 ID
callback	回调方法

示例代码

cloudCamera.queryCloudServiceStatus(devId, new IThingResultCallback<CloudStatusBean>() {
@Override
public void onSuccess(CloudStatusBean result) {
        //Get cloud storage status
        }

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

        }
        });

CloudStatusBean 数据模型

参数	说明
status	状态码： 10001：未购买云存储服务 10010：已开通云存储服务 10011：云存储服务已过期

获取有云存储数据的日期

接口说明

void getCloudDays(String devId, String timezoneId, IThingResultCallback<List<CloudDayBean>> callback);

参数说明

参数	说明
devId	设备 ID
timezoneId	时区 ID

示例代码

cloudCamera.getCloudDays(devId, TimeZone.getDefault().getID(), new IThingResultCallback<List<CloudDayBean>>() {
@Override
public void onSuccess(List<CloudDayBean> result) {

        }

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

        }
        });

CloudDayBean 数据模型

参数	说明
uploadDay	日期
currentDayStart	对应日期的开始时间，用于获取指定时间内的视频片段
currentDayEnd	对应日期的结束时间，用于获取指定时间内的视频片段

获取指定时间内的视频片段

接口说明

void getTimeLineInfo(String devId, long timeGT, long timeLT, IThingResultCallback<List<TimePieceBean>> callback);

参数说明

参数	说明
devId	设备 ID
timeGT	10 位时间戳格式的开始时间
timeLT	10 位时间戳格式的结束时间
callback	回调方法

示例代码

CloudDayBean dayBean = dayBeanList.get(0);
        cloudCamera.getTimeLineInfo(devId, dayBean.getCurrentStartDayTime(), dayBean.getCurrentDayEndTime(), new IThingResultCallback<List<TimePieceBean>>() {
@Override
public void onSuccess(List<TimePieceBean> result) {

        }

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

        }
        });

AITimePieceBean 数据模型

参数	说明
startTime	视频开始时间 Unix 时间戳
endTime	视频结束时间 Unix 时间戳
aiCode	AI 事件片段 ID

获取指定时间内的移动侦测数据

接口说明

void getMotionDetectionInfo(String devId, long timeGT, long timeLT, int offset, int limit, IThingResultCallback<List<TimeRangeBean>> callback);

参数说明

参数	说明
devId	设备 ID
timeGT	10 位时间戳格式的开始时间
timeLT	10 位时间戳格式的结束时间
offset	第几页，默认为 0
limit	每次拉取条数，默认为 -1，表示所有数据
callback	回调方法

TimeRangeBean 数据模型

参数	说明
describe	移动侦测信息描述
startTime	移动侦测事件开始时间
endTime	移动侦测事件结束时间
snapshotUrl	移动侦测事件图片
v	版本，2 表示图片已加密

示例代码

CloudDayBean dayBean = dayBeanList.get(0);
        cloudCamera.getMotionDetectionInfo(devId, dayBean.getCurrentStartDayTime(), dayBean.getCurrentDayEndTime(), offset, limit, new IThingResultCallback<List<TimeRangeBean>>() {
@Override
public void onSuccess(List<TimeRangeBean> result) {

        }

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

        }
        });

获取云存储密钥信息

接口说明

 void getCloudSecret(String devId, ResultListener<JSONObject> callback)

参数说明

参数	说明
devId	设备 ID
Business.ResultListener	回调方法

示例代码

CloudBusiness cloudBusiness =new CloudBusiness();
    cloudBusiness.getCloudSecret(devId, new Business.ResultListener<JSONObject>() {
            @Override
            public void onFailure(BusinessResponse bizResponse, JSONObject bizResult, String apiName) {

            }

            @Override
            public void onSuccess(BusinessResponse bizResponse, JSONObject bizResult, String apiName) {
                    mEncryptKey = bizResult.getString("encryptKey");
            }
        });

错误码

错误码	说明
-2000	保存云存储片段文件信息失败
-2001	云存储鉴权认证信息为空
-2002	云存储获取播放 URL 解析失败

AI 云存储

查询设备 AI 云存储设置信息

设备是否开启 AI 检测能力

接口说明

void queryAIDetectConfig(String devId, IThingResultCallback<AIDetectConfigBean> callback);

AIDetectConfigBean 数据模型

参数	说明
switchState	设备 AI 检测能力是否开启 1 表示开启 0 表示关闭
isAiDevice	设备是否有 AI 检测能力
aiItemList	支持检测的 AI 物种数据信息

AIDetectEventBean 数据模型

参数	说明
aiCode	AI 标识符
aiCodeIcon	AI 模型图标
aiCodeDesc	AI 描述信息
configState	当前模型是否开启 1 表示开启 0 表示关闭
orderValue	当前模型排序值

示例代码

cloudCamera.queryAIDetectConfig(getDevId(), new IThingResultCallback<AIDetectConfigBean>() {
            @Override
            public void onSuccess(AIDetectConfigBean result) {
            }

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

更新 AI 检测开关状态

开启、关闭设备 AI 检测功能。

接口说明

void enableAIDetect(String devId, boolean enable, IThingResultCallback<Boolean> callback);

参数说明

参数	说明
devId	设备 ID
enable	是否开启 AI 检测功能

示例代码

cloudCamera.enableAIDetect(getDevId(), enable, new IThingResultCallback<AIDetectConfigBean>() {
            @Override
            public void onSuccess(Boolean result) {
            }

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

更新 AI 检测事件类型

接口说明

void enableAIDetectEventType(String devId, String aiCode, int enableState, IThingResultCallback<Boolean> callback);

参数说明

参数	说明
devId	设备 ID
aiCode	AI 事件 标识 ID
enableState	是否可用 0：不可用 1：可用

示例代码

cloudCamera.enableAIDetectEventType(getDevId(), aiCode, enableState, new IThingResultCallback<AIDetectConfigBean>() {
            @Override
            public void onSuccess(Boolean result) {
            }

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

查询 AI 云存储事件

开启 AI 云存储服务后，设备通过侦测报警上报的事件，AI 算法能够精准识别到上报事件中是否包含用户设置的物种，目前支持设置的物种有人形、宠物、车辆、包裹。

接口说明

void getMotionDetectionInfo(String devId, String aiCodes, long timeGT, long timeLT, int offset, int limit, IThingResultCallback<List<TimeRangeBean>> callback);

参数说明

参数	说明
devId	设备 ID
aiCodes	AI 事件 ID，例如 ai_package,ai_human
timeGT	10 位时间戳格式的开始时间
timeLT	10 位时间戳格式的结束时间
offset	第几页，默认为 0
limit	每次拉取条数，默认为 -1，表示所有数据
callback	回调方法

云存储管理

初始化

创建设备对象。

接口说明

void createCloudDevice(String cachePath, String devId)

参数说明

参数	说明
cachePath	缓存路径
devId	设备 ID

示例代码

cloudCamera.createCloudDevice(cachePath, devId);

反初始化

接口说明

void deinitCloudCamera();

示例代码

cloudCamera.deinitCloudCamera();

销毁

接口说明

public void destroy();

示例代码

cloudCamera.destroy();

注册云存储监听

向 IThingCloudCamera 注册监听器，否则无法正常显示画面。

接口说明

void registorOnP2PCameraListener(OnP2PCameraListener listener);

参数说明

参数	说明
listener	P2P 回调

示例代码

cloudCamera.registorOnP2PCameraListener(new AbsP2pCameraListener() {
@Override
public void onSessionStatusChanged(Object camera, int sessionId, int sessionStatus) {
        super.onSessionStatusChanged(camera, sessionId, sessionStatus);
        }
        });

注销云存储监听

接口说明

void removeOnP2PCameraListener();

示例代码

cloudCamera.removeOnP2PCameraListener();

绑定播放组件 view

接口说明

void generateCloudCameraView(IRegistorIOTCListener view);

参数说明

参数	说明
view	播放器组件

示例代码

cloudCamera.generateCloudCameraView(mVideoView);

云存储使用

开始播放视频

接口说明

void playCloudDataWithStartTime(long mStartTime, long mEndTime, boolean isEvent, OperationCallBack callback, OperationCallBack playFinishedCallBack);

参数说明

参数	说明
mStartTime	10 位时间戳格式的开始时间
mEndTime	结束时间，一般是这一天的结束时间
isEvent	是否是侦测事件，默认为 false
callBack	播放回调
playFinishedCallBack	播放结束回调

示例代码

cloudCamera.playCloudDataWithStartTime(startTime, endTime, isEvent,
        new OperationCallBack() {
@Override
public void onSuccess(int sessionId, int requestId, String data, Object camera) {
        // 播放中的回调, playing
        }

@Override
public void onFailure(int sessionId, int requestId, int errCode, Object camera) {

        }
        }, new OperationCallBack() {
@Override
public void onSuccess(int sessionId, int requestId, String data, Object camera) {
        //播放完成的回调, playCompleted
        }

@Override
public void onFailure(int sessionId, int requestId, int errCode, Object camera) {
        }
        });

暂停播放视频

接口说明

int pausePlayCloudVideo(OperationDelegateCallBack callBack);

参数说明

参数	说明
callBack	操作回调

示例代码

cloudCamera.pausePlayCloudVideo(new OperationDelegateCallBack() {
@Override
public void onSuccess(int sessionId, int requestId, String data) {
        }

@Override
public void onFailure(int sessionId, int requestId, int errCode) {

        }
        });

继续播放视频

接口说明

int resumePlayCloudVideo(OperationDelegateCallBack callBack);

参数说明

参数	说明
callBack	操作回调

示例代码

cloudCamera.resumePlayCloudVideo(new OperationDelegateCallBack() {
@Override
public void onSuccess(int sessionId, int requestId, String data) {
        }

@Override
public void onFailure(int sessionId, int requestId, int errCode) {

        }
        });

停止播放视频

接口说明

int stopPlayCloudVideo(OperationDelegateCallBack callBack);

参数说明

参数	说明
callBack	操作回调

示例代码

cloudCamera.stopPlayCloudVideo(new OperationDelegateCallBack() {
@Override
public void onSuccess(int sessionId, int requestId, String data) {
        }

@Override
public void onFailure(int sessionId, int requestId, int errCode) {

        }
        });

下载云存储视频

接口说明

void startCloudDataDownload(long startTime, long stopTime, String folderPath, String mp4FileName,
        OperationCallBack callback, ProgressCallBack progressCallBack, OperationCallBack finishedCallBack);

参数说明

参数	说明
startTime	需要下载的视频片段的开始时间，10 位时间戳
stopTime	需要下载的视频片段的结束时间，10 位时间戳
folderPath	存储路径
mp4FileName	文件名
callback	操作回调
progressCallBack	下载进度回调
finishedCallBack	下载完成回调

停止下载视频

接口说明

void stopCloudDataDownload(OperationCallBack callBack);

参数说明

参数	说明
callBack	操作回调

删除云存储视频

接口说明

void deleteCloudVideo(String devId, long timeGT, long timeLT, boolean isAllDay, String timeZone, IThingResultCallback<String> listener);

参数说明

参数	说明
devId	设备 ID
timeGT	10 位时间戳格式的开始时间
timeLT	结束时间
isAllDay	是否是删除整天
timeZone	时区
listener	回调方法

视频录制

开始录制

接口说明

int startRecordLocalMp4(String folderPath, String fileName, OperationDelegateCallBack callBack);

参数说明

参数	说明
folderPath	文件夹路径
fileName	文件名称
callBack	操作回调

示例代码

cloudCamera.startRecordLocalMp4(IPCCameraUtils.recordPath(devId), String.valueOf(System.currentTimeMillis()), new OperationDelegateCallBack() {
@Override
public void onSuccess(int sessionId, int requestId, String data) {
        Toast.makeText(CameraCloudStorageActivity.this, "record start success", Toast.LENGTH_SHORT).show();
        }

@Override
public void onFailure(int sessionId, int requestId, int errCode) {
        }
        });

结束录制

接口说明

int stopRecordLocalMp4(OperationDelegateCallBack callBack);

参数说明

参数	说明
callBack	操作回调

示例代码

cloudCamera.stopRecordLocalMp4(new OperationDelegateCallBack() {
@Override
public void onSuccess(int sessionId, int requestId, String data) {
        Toast.makeText(CameraCloudStorageActivity.this, "record end success", Toast.LENGTH_SHORT).show();
        }

@Override
public void onFailure(int sessionId, int requestId, int errCode) {
        }
        });

其他功能

云存储视频播放也提供有声音开关、截图等功能。

获取静音状态

接口说明

int getCloudMute();

示例代码

cloudCamera.getCloudMute()

设置静音状态

接口说明

void setCloudMute(final int mute, OperationDelegateCallBack callBack);

参数说明

参数	说明
mute	是否静音： 1：关闭声音 0：打开声音
callBack	操作回调

示例代码

cloudCamera.setCloudMute(mute, new OperationDelegateCallBack() {
@Override
public void onSuccess(int sessionId, int requestId, String data) {
        soundState = Integer.valueOf(data);
        }

@Override
public void onFailure(int sessionId, int requestId, int errCode) {
        }
        });

视频截图

接口说明

int snapshot(String absoluteFilePath, OperationDelegateCallBack callBack);

参数说明

参数	说明
absoluteFilePath	文件地址
callBack	操作回调

示例代码

cloudCamera.snapshot(IPCCameraUtils.recordSnapshotPath(devId), new OperationDelegateCallBack() {
@Override
public void onSuccess(int sessionId, int requestId, String data) {
        Toast.makeText(CameraCloudStorageActivity.this, "snapshot success", Toast.LENGTH_SHORT).show();
        }

@Override
public void onFailure(int sessionId, int requestId, int errCode) {
        }
        });

倍速播放

在开始播放调用成功后设置倍速播放，音频不支持倍速状态。

接口说明

void setPlayCloudDataSpeed(int speed, OperationCallBack operationCallBack);

参数说明

参数	说明
speed	播放倍速，支持 1、2、4 倍速，枚举值 CloudPlaySpeed
operationCallBack	操作回调

CloudPlaySpeed 枚举值

        CloudPlaySpeed.MULTIPLE_1,               // 1.0 倍速
        CloudPlaySpeed.MULTIPLE_2,               // 2.0 倍速
        CloudPlaySpeed.MULTIPLE_4,               // 4.0 倍速

示例代码

 mCloudCamera.setPlayCloudDataSpeed(speed, new OperationCallBack() {
@Override
public void onSuccess(int sessionId, int requestId, String data, Object camera) {
        // TODO " setPlayCloudDataSpeed onSuccess"
        }

@Override
public void onFailure(int sessionId, int requestId, int errCode, Object camera) {
        }
        });