Cloud Storage Recording

Smart cameras support the cloud storage service that allows users to save video footage on the camera to the cloud.

How it works

1. Determine whether a device supports cloud storage. If this service is supported, proceed with the process.

2. Get the cloud storage service status.

3. Perform steps based on the service status.

   • If the cloud storage service is inactive or has expired, this service must be purchased to enable cloud storage.

     After the cloud storage service expires, the existing cloud-stored video files will be retained for a period, seven days in most cases. At the end of this period, all cloud-stored video files will be deleted.

   • If the cloud storage service is within the validity period:

     1. Get the date on which the cloud-stored video files were created.
     2. Get the data of the specified date, including cloud storage events, timeline data, and authentication information.
     3. Select a cloud storage event or a time point to start cloud-stored video playback.
     

Core methods

Important notes

To enable subscription to the cloud storage service, the Cloud Storage UI BizBundle must be integrated. This component provides the H5 pages and order display features for the subscription.

Core code

Query cloud storage status

- (void)loadCloudData:(void(^)(ThingSmartCloudState state))complete;

Query video clips within a specified period

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

Start playing cloud-stored clips

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

Stop playing cloud-stored clips

- (int)stopPlayCloudVideo;

Example

// Initialize cloud storage management class
- (void)cloudstorageManagerInit {
    // Check if cloud storage is supported.
    BOOL isSupportCloudStorage = [ThingSmartCloudManager isSupportCloudStorage:self.devId];

    // Create a cloud storage management class
    _cloudManager = [[ThingSmartCloudManager alloc] initWithDeviceId:self.devId];
    [_cloudManager enableMute:NO success:nil failure:nil];
    _cloudManager.delegate = self;
}

// Check cloud storage activation status
- (void)queryCloudstroageState {
    __weak typeof(self) weakSelf = self;
    [self.cloudManager loadCloudData:^(ThingSmartCloudState state) {
        if (state == ThingSmartCloudStateValidData || state == ThingSmartCloudStateExpiredData) {
            weak_self.cloudStorageDays = weak_self.cloudManager.cloudDays;
            weak_self.selectedDay = weak_self.cloudManager.cloudDays.lastObject;
            if (state == ThingSmartCloudStateExpiredData) {
                // The cloud storage has expired. Prompt the user to subscribe.
            }
        } else {
            // Prompt the user to subscribe to cloud storage.
        }
  }];
}

// Get video clips
- (void)queryTimePieces {
    [self.cloudManager timeLineWithCloudDay:self.selectedDay success:^(NSArray<ThingSmartCloudTimePieceModel *> *timePieces) {
        // Succeeded
    } failure:^(NSError *error) {
        // Failed
    }];
}

// Play video clips
-(void)playVideoWithTimePiece:(ThingSmartCloudTimePieceModel *)timePiece {
    [self.cloudManager playCloudVideoWithStartTime:timePiece.startTime endTime:self.selectedDay.endTime isEvent:NO onResponse:^(int errCode) {
        if (errCode == 0) {
            // Succeeded
        }else {
            // Failed
        }
    } onFinished:^(int errCode) {
        // finished
        if (errCode != 0) {
            // Error
        }
    }];
}

// Play cloud storage event
- (void)playVideoEvent:(ThingSmartCloudTimeEventModel *)event {
    [self.cloudManager playCloudVideoWithStartTime:event.startTime endTime:self.selectedDay.endTime isEvent:YES onResponse:^(int errCode) {
        if (errCode == 0) {
            // Succeeded
        }else {
            // Failed
        }
    } onFinished:^(int errCode) {
        // finished
        if (errCode != 0) {
            // Error
        }
    }];
}

// Stop playing
- (void)stopPlayCloudVideo {
    [self.cloudManager stopPlayCloudVideo];
}

// Destroy
- (void)destroy {
    [self.cloudManage destroy];
}