1. 云存储

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

1.1. 流程图

先获取云存储服务状态，如果云存储服务未开通或者已经过期并且云视频已经被全部删除（云存储服务过期后，已经上传的云视频还会保留一段时间，通常是 7 天），就需要先购买云存储服务。如果云存储服务在有效期，先获取有云存储视频的日期，然后获取指定日期的相关数据，包括云存储事件，时间轴数据，鉴权信息等。之后就可以选择一个云存储事件或者一个时间点开始播放云视频了。

1.2. 服务购买

1.2.1. 组件引入

云存储购买需要引入云存储服务购买页面的组件，在 podfile 中增加下面代码

# 涂鸦平台的开放库
source 'https://github.com/TuyaInc/TYPublicSpecs.git'
source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '9.0'
target 'Your_Target' do
  pod 'TYCameraCloudServicePanelSDK'
end

然后在工程主目录下执行pod update。

1.2.2. 使用方法

云存储购买服务 SDK 的初始化需要传入涂鸦平台上注册 App 的渠道标识符。

接口说明

初始化 SDK，需要在 TuyaSmartSDK激活后调用

+ (void)setupWithAppScheme:(NSString *)scheme;

参数说明

示例代码

ObjC

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [[TuyaSmartSDK sharedInstance] startWithAppKey:@"your_appKey" secretKey:@"your_appSecret"];
    [TYCameraCloudServicePanelSDK setupWithAppScheme:@"your_scheme"];
}

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    TuyaSmartSDK.sharedInstance().start(withAppKey: "your_appKey", secretKey: "your_appSecret")
    TYCameraCloudServicePanelSDK.setup(withAppScheme: "your_scheme")
    return true   
}

接口说明

同步用户登陆状态

+ (void)userStateChanged;

云存储服务与账户强关联，务必在在用户登录/登出的时候调用，以同步用户登录状态。

示例代码

ObjC

- (void)login {
    [[TuyaSmartUser sharedInstance] loginByPhone:@"countryCode" phoneNumber:@"phoneNumber" password:@"password" success:^{
                [TYCameraCloudServicePanelSDK userStateChanged];
    } failure:^(NSError *error) {
                // failed
    }];
}

Swift

func login() {
        TuyaSmartUser.sharedInstance().login("countryCode", phoneNumber: "phoneNumber", password: "password", success: {
            TYCameraCloudServicePanelSDK.userStateChanged()
        }) { (error) in
            //failed
        }
    }

1.2.3. 获取云存储购买页面

云存储购买页面是 H5 页面，由于需要从云端请求对应的页面地址，所以获取云存储页面的接口是异步的，并需要传入对应设备的 TuyaSmartDeviceModel对象。

接口说明

获取云存储购买的视图控制器

+ (void)cloudServicePanelWithDevice:(TuyaSmartDeviceModel *)deviceModel
                            success:(void(^)(UIViewController *vc))success
                            failure:(void(^)(NSError *error))failure;

参数说明

接口返回的云存储购买视图控制器是一个 UINavigationController 的子类的对象，所以不能使用 push 的方式将其加入到导航控制器的视图栈中。

示例代码

ObjC

- (void)gotoCloudServicePanelWithDevice:(TuyaSmartDeviceModel *)deviceModel {
    [TYCameraCloudServicePanelSDK cloudServicePanelWithDevice:deviceModel success:^(UIViewController *vc) {
      // 这里返回的 vc 是一个 UINavigationController 的子类
        [self presentViewController:vc animated:YES completion:nil];
    } failure:^(NSError *error) {
        NSLog(@"Error: %@", error);
    }];
}

Swift

TYCameraCloudServicePanelSDK.cloudServicePanel(withDevice: deviceModel, success: { (vc) in
     self.presentViewController(vc, animated: true, completion:nil)
}) { (error) in
            //failed
}

1.3. 云视频

购买过云存储服务后，智能摄像机会把录制的视频上传涂鸦云端。可以通过 SDK 播放已经上传到涂鸦云端的视频录像。云存储相关功能通过 TuyaSmartCameraKit 中的 TuyaSmartCloudManager类操作。

相关类和协议

TuyaSmartCloudManager初始化时，需要传入设备 id 。云存储默认是静音开始播放的，如果需要播放时开启声音，可在初始化时，设置静音状态为 NO。云存储播放时，视频帧数据和帧头信息都将用过代理方法回调。

接口说明

TuyaSmartCloudManager初始化方法

- (instancetype)initWithDeviceId:(NSString *)devId;

参数说明

云存储代理接口为TuyaSmartCloudManagerDelegate，只有一个代理方法，会返回每一帧视频的 YUV 数据和帧信息，如果你想要自己渲染视频，可以将 TuyaSmartCloudManager的autoRender属性设置为NO（默认为YES），并在代理方法中获取视频帧的YUV数据加以渲染。

接口说明

视频帧数据代理回调

- (void)cloudManager:(TuyaSmartCloudManager *)cloudManager didReceivedFrame:(CMSampleBufferRef)frameBuffer videoFrameInfo:(TuyaSmartVideoFrameInfo)frameInfo;

参数说明

1.3.1. 云存储数据

在使用云存储播放功能前，还需要先加载云存储的相关数据，这个接口会返回云存储服务当前的状态，以及加载对应的加密秘钥，鉴权信息等。

接口说明

加载云存储数据

- (void)loadCloudData:(void(^)(TuyaSmartCloudState state))complete

参数说明

TuyaSmartCloudState 枚举

云存储服务过期后，已上传的云存储视频还会预留一段时间（通常是 7 天，具体看云存储服务协议），如果在此期间没有续费，到期后，云存储视频将会删除。

云存储录像日期

在加载云存储数据成功返回后，如果云端有视频回放数据，可以通过cloudDays 属性获取有视频回放数据的日期。

@property (nonatomic, strong, readonly) NSArray<TuyaSmartCloudDayModel *> *cloudDays;

TuyaSmartCloudDayModel 模型

视频片段

在播放云存储视频前，需要获取到当天的视频片段数据。

接口说明

获取某天的视频片段时间数据

- (void)timeLineWithCloudDay:(TuyaSmartCloudDayModel *)cloudDay
                     success:(void(^)(NSArray<TuyaSmartCloudTimePieceModel *> * timePieces))success
                     failure:(void(^)(NSError * error))failure;

参数说明

TuyaSmartCloudTimePieceModel 数据模型

云存储事件

开启云存储服务后，设备通过侦测报警上报的事件，会和云视频关联起来。云存储的报警事件和侦测报警消息略有不同。他们的触发原因可能是一样的，但是侦测报警消息的删除不会影响到云存储事件，也不是所有的侦测报警消息都会触发云视频录制，比如电量警告等。而且云存储事件和云视频相关联，正常情况下，每一个云存储事件都会有一段对应的云视频。

接口说明

获取某天的云存储报警事件

- (void)timeEventsWithCloudDay:(TuyaSmartCloudDayModel *)cloudDay
                        offset:(int)offset
                         limit:(int)limit
                       success:(void(^)(NSArray<TuyaSmartCloudTimeEventModel *> * timeEvents))success
                       failure:(void(^)(NSError * error))failure;

参数说明

TuyaSmartCloudTimeEventModel 数据模型

1.3.2. 云视频播放

播放云存储视频时，需要指定开始播放的时间，结束时间，和是否是播放事件。

接口说明

播放云存储视频

- (void)playCloudVideoWithStartTime:(long)startTime
                            endTime:(long)endTime
                            isEvent:(BOOL)isEvent
                         onResponse:(void(^)(int errCode))responseCallback
                         onFinished:(void(^)(int errCode))finishedCallback;

参数说明

接口说明

暂停播放

- (int)pausePlayCloudVideo;

返回值

接口说明

恢复播放

- (int)resumePlayCloudVideo;

返回值

接口说明

停止播放

- (int)stopPlayCloudVideo;

返回值

接口说明

获取视频渲染视图

- (UIView<TuyaSmartVideoViewType> *)videoView;

返回值

如果是直接播放某个视频片段（TuyaSmartCloudTimePieceModel），开始时间传入介于 TuyaSmartCloudTimePieceModel 中 startTime 和 endTime 之间的一个时间戳， isEvent 传入 NO。如果是想要播放某个事件（TuyaSmartCloudTimeEventModel），开始时间传入 TuyaSmartCloudTimeEventModel 的startTime ，isEvent 传入 YES，结束时间可以传入当天的结束时间，也就是 TuyaSmartCloudDayModel 的 endTime。

TuyaSmartCloudManager会自动渲染视频，通过videoView方法获取视频渲染视图，并添加到屏幕上。

其他功能

云存储视频播放也提供有声音开关，本地视频录制，截图等功能。

接口说明

设置静音状态

- (void)enableMute:(BOOL)mute success:(void(^)(void))success failure:(void (^)(NSError * error))failure;

参数说明

接口说明

获取静音状态

- (BOOL)isMuted;

返回值

接口说明

开始录制视频，视频自动保存到系统相册中

- (void)startRecord;

接口说明

开始录制视频，视频保存到指定文件路径

- (void)startRecordAtPath:(NSString *)filePath;

参数说明

接口说明

停止录制，并保存视频文件

- (int)stopRecord;

返回值

接口说明

视频截图，图片保存在手机系统相册中

- (UIImage *)snapShoot;

返回值

接口说明

视频截图，图片保存到指定文件路径

- (UIImage *)snapShootAtPath:(NSString *)filePath thumbnilPath:(NSString *)thumbnilPath;

参数说明

同样的，如果你只需要获取当前视频截图 UIImage对象，不需要自动保存，可以通过 videoView的 - (UIImage *)screenshot;方法获取截图。

示例代码

ObjC

// self.devId = @"xxxxx";
- (void)viewDidLoad {
    _cloudManager = [[TuyaSmartCloudManager alloc] initWithDeviceId:self.devId];
    [_cloudManager enableMute:NO success:nil failure:nil];
    _cloudManager.delegate = self;
}

- (void)loadData {
    __weak typeof(self) weakSelf = self;
    [self.cloudManager loadCloudData:^(TuyaSmartCloudState state) {
      weak_self.cloudStorageDays = weak_self.cloudManager.cloudDays;
      weak_self.selectedDay = weak_self.cloudManager.cloudDays.lastObject;
      [weakSelf checkCloudState:state];
  }];
}

- (void)requestTimelineData {
    [self.cloudManager timeLineWithCloudDay:self.selectedDay success:^(NSArray<TuyaSmartCloudTimePieceModel *> *timePieces) {
        // success
    } failure:^(NSError *error) {
        // failed
    }];
}

-(void)playVideo:(TuyaSmartCloudTimePieceModel *)timePiece {
    [self.cloudManager playCloudVideoWithStartTime:timePiece.startTime endTime:self.selectedDay.endTime isEvent:NO onResponse:^(int errCode) {
        if (errCode == 0) {
            // success
        }else {
                    // failed
        }
    } onFinished:^(int errCode) {
              // finished
        if (errCode != 0) {
                    // some error
        }
    }];
}

- (void)playEvent:(TuyaSmartCloudTimeEventModel *)event {
    [self.cloudManager playCloudVideoWithStartTime:event.startTime endTime:self.selectedDay.endTime isEvent:YES onResponse:^(int errCode) {
        if (errCode == 0) {
            // success
        }else {
    // failed
        }
    } onFinished:^(int errCode) {
  // finished
        if (errCode != 0) {
    // some error
        }
    }];
}

- (void)pause {
    if ([self.cloudManager pausePlayCloudVideo] != 0) {
        // 暂停失败
    }
}

- (void)resume {
    if ([self.cloudManager resumePlayCloudVideo] != 0) {
        // 恢复播放失败
    }
}

- (void)stop {
        [self.cloudManager stopPlayCloudVideo];
}

- (void)muteAction {
    BOOL isMuted = [self.cloudManger isMuted];
    [self.cloudManager enableMute:!isMuted success:^{
        // success
    } failure:^(NSError *error) {
        // failed
    }];
}

- (void)recordAction {
    if (self.isRecording) {
        if ([self.cloudManager stopRecord] != 0) {
            // 录制失败
        }else {
            // 录制成功，视频已保存到系统相册
        }
          self.isRecording = NO;
    }else {
        [self.cloudManager startRecord];
            self.isRecording = YES;
    }
}

- (void)snapShoot {
    if ([self.cloudManager snapShoot]) {
        // 图片已保存到系统相册
    }else {
        // 截图失败
    }
}

Swift

func viewDidLoad() {
    let cloudManager = TuyaSmartCloudManager(deviceId: devId)
    cloudManager?.enableMute(false, success: nil, failure: nil)
    cloudManager?.delegate = self
}

func loadData() {
    self.cloudManager.loadCloudData { [weak self] (state) in
            self.cloudStorageDays = self.cloudManager.cloudDays
            self.selectedDay =  self.cloudManager.cloudDays.last
            self.checkCloudState(state)            
    }
}

func requestTimelineData() {
        self.cloudManager.timeLine(withCloudDay: self.selectedDay, success: { (timePieces) in
        //success
    }) { (error) in
        //failed
    }
}

func playVideo(_ timePiece: TuyaSmartCloudTimePieceModel) {
    self.cloudManager.playCloudVideo(withStartTime: timePiece.startTime, endTime:self.selectedDay.endTime , isEvent: false, onResponse: { (code) in
        if code == 0 {
            //success
        } else {
            //failed
        }
    }) { (errCode) in
        //finished
        if codeCode != 0 {
            //some error
        }
    }
}

func playEvent(_ event: TuyaSmartCloudTimeEventModel) {
    cloudManager.playCloudVideo(withStartTime: event.startTime, endTime: self.selectedDay.endTime, isEvent: true, onResponse: { (errCode) in
        if code == 0 {
            //success
        } else {
            //failed
        }
    }) { (errCode) in
        //finished
        if errCode != 0 {
            // some error
        }
    }
}

func pause() {
    if self.cloudManager.pausePlayCloudVideo() != 0 {
        //暂停失败
    }
}

func resume() {
    if self.cloudManager.resumePlayCloudVideo() != 0 {
        // 恢复播放失败
    }
}

func stop() {
        self.cloudManager.stopPlayCloudVideo()
}

func muteAction() {
    let isMuted = self.cloudManager.isMuted()
    self.cloudManager.enableMute(!isMuted, success: {
                // success
    }) { (error) in
        // failed
    }
}

func recordAction() {
    if self.isRecording {
        if self.cloudManager.stopRecord() != 0 {
            //录制失败
        } else {
            //录制成功，视频已保存系统相册
        }
        self.isRecording = false
    } else {
        self.cloudManager.startRecord()
        self.isRecording = true
    }
}

func snapShoot() {
    if self.cloudManager.snapShoot() {
        // 图片已保存到系统相册
    } else {
        // 截图失败
    }
}