简体中文
简体中文
English
联系我们
注册
登录

设备报修

更新时间:2021-09-15 01:54:15下载pdf

用户登录后,可在空间中找到需要上报维修的设备,可以通过TuyaLightingRepairManager管理类去创建维修工单、查看维修工单列表,TuyaLightingRepairUploadService来实现设备报修工单图片视频文件上传等。

功能说明

类名 功能接口
TuyaLightingRepairManager 维修工单管理类,创建维修工单、获取维修工单列表、获取维修工单详情、获取设备配置信息
TuyaLightingRepairUploadService 维修工单反馈素材上传类,报修反馈的图片、视频上传

创建维修工单

接口说明

设备详情页故障报修可以创建维修工单来上报云端

- (void)createRepairOrder:(long long)projectId
                    devId:(NSString *)devId
            ticketContent:(nullable NSString *)ticketContent
                ticketPic:(nullable NSString *)ticketPic
    problemClassification:(nullable NSString *)problemClassification
                  success:(nullable TYSuccessID)success
                failure:(nullable TYFailureError)failure;

参数说明

参数 说明
projectId 项目id
devId 设备id
ticketContent 工单描述
ticketPic 工单图片地址(,分割)
problemClassification 问题描述
success 成功回调
failure 失败回调

示例代码

Objc:

    [[TuyaLightingRepairManager new] createRepairOrder:homeId devId:self.devId ticketContent:self.textView.text ticketPic:fileIds problemClassification:self.selectModel.code success:^(id result) {
        NSLog(@"get success");
    } failure:^(NSError *error) {
        NSLog(@"get failure: %@", error);
    }];

查询报修问题类型列表

接口说明

从云端获取维修工单的上报问题类型列表

- (void)getRepairFaultTypeList:(long long)projectId
                       success:(void(^)(NSArray<TuyaLightingRepairFaultTypeModel *> *typeAry))success
                       failure:(TYFailureError)failure;

参数说明

参数 说明
projectId 项目id
success 成功回调
failure 失败回调

示例代码

Objc:

    [[TuyaLightingRepairManager new] getRepairFaultTypeList:self.projectId success:^(id result) {
        NSLog(@"get success");
    } failure:^(NSError *error) {
        NSLog(@"get failure: %@", error);
    }];

查询维修工单列表

接口说明
从云端获取当前用户的维修工单列表,支持翻页。

- (void)getRepairList:(long long)projectId
         ticketStatus:(NSInteger)ticketStatus
                limit:(NSInteger)limit
            offsetKey:(NSString *)offsetKey
              success:(void(^)(NSArray<TuyaLightingRepairOrderModel *> *orderList, NSString * _Nonnull nextOffsetKey, BOOL end))success
              failure:(TYFailureError)failure;

参数说明

参数 说明
projectId 项目id
ticketStatus 工单状态 1未完成 2已完成
limit 每页加载多少条
offsetKey 第几页
success 成功回调
failure 失败回调

示例代码

Objc:

    [[TuyaLightingRepairManager new] getRepairList:self.projectId ticketStatus:self.orderStatus limit:self.limit offsetKey:self.nextOffsetKey success:^(NSArray<TYLampRepairOrderModel *> * _Nonnull orderList, NSString * _Nonnull nextOffsetKey, BOOL end) {
        NSLog(@"get success");
    } failure:^(NSError *error) {
        NSLog(@"get failure: %@", error);
    }];

获取设备配置信息

接口说明

用户在设备详情页通过设备ID从云端获取设备的配置信息。

- (void)getDeviceConfigInfo:(long long)projectId
                      devId:(NSString *)devId
                    success:(void(^)(TuyaLightingRepairDeviceConfigModel *model))success
                    failure:(TYFailureError)failure;

参数说明

参数 说明
projectId 项目id
devId 设备ID
success 成功回调
failure 失败回调

示例代码

Objc:

    [[TuyaLightingRepairManager new] getDeviceConfigInfo:homeId devId:self.devId success:^(TYLampRepairDeviceConfigModel * model) {
        NSLog(@"get success");
    } failure:^(NSError *error) {
        NSLog(@"get failure: %@", error);
    }];

获取维修工单详情

接口说明

用户在工单详情页通过设备ID从云端获取工单详情信息。

- (void)getRepairOrderDetail:(void(^)(TuyaLightingRepairOrderDetailModel *orderDetail))success
                     failure:(TYFailureError)failure;

参数说明

参数 说明
success 成功回调
failure 失败回调

示例代码

Objc:

    [[TuyaLightingRepairManager new] getRepairOrderDetailWithTicketNo:self.ticketNo success:^(TYLampRepairOrderDetailModel * _Nonnull orderDetail) {
        NSLog(@"get success");
    } failure:^(NSError *error) {
        NSLog(@"get failure: %@", error);
    }];

获取项目下指定工单对象

接口说明

通过项目ID创建指定的工单对象

+ (nullable instancetype)createByTicketNum:(NSString *)ticketNum projectId:(long long)projectId;

参数说明

参数 说明
ticketNum 工单ID
projectId 项目ID
success 成功回调
failure 失败回调

示例代码

Objc:

TuyaLightingRepair *manager = [TuyaLightingRepair createByTicketNum:ticketNum projectId:projectId];

提交维修工单结果反馈

接口说明

将维修工单结果反馈提交云端,支持图片、视频和文字等素材上报。

- (void)finishRepairOrder:(NSString *)devId
          feedbackContent:(NSString *)feedbackContent
              feedbackPic:(NSString *)feedbackPic
                  success:(TYSuccessDict)success
                  failure:(TYFailureError)failure;

参数说明

参数 说明
devId 设备id
feedbackContent 反馈内容
feedbackPic 反馈图片
success 成功回调
failure 失败回调

示例代码

Objc:

    [[TuyaLightingRepairManager new] finishRepairOrderWithTicketNo:self.ticketNo devId:devId feedbackContent:content
        NSLog(@"get success");
    } failure:^(NSError *error) {
        NSLog(@"get failure: %@", error);
    }];

上传图片

上传的图片会被压缩成 JPEG 格式。

接口说明

+ (void)uploadImage:(UIImage *)image
            success:(void(^)(TYLampUploadFileModel *))success
            failure:(TYFailureError)failure;

参数说明

参数 说明
image 图片
success 成功回调
failure 失败回调

示例代码

Objc:

    [self uploadImage:obj.displayImage success:^(TYLampUploadFileModel * model) {
        NSLog(@"get success");
    } failure:^(NSError *error) {
        NSLog(@"get failure: %@", error);
    }];

上传视频文件

接口说明

维修工单结果反馈提交云端过程中,图片、视频上传接口,支持多素材异步上传,视频仅支持 MP4 格式。

+ (void)uploadVideoFile:(NSString *)filePath
                success:(void(^)(TYLampUploadFileModel *))success
                failure:(TYFailureError)failure;

参数说明

参数 说明
filePath 文件路径名称
success 成功回调
failure 失败回调

示例代码

Objc:

    [self uploadVideoFile:obj.filePath success:^(TYLampUploadFileModel * model) {
        NSLog(@"get success");
    } failure:^(NSError *error) {
        NSLog(@"get failure: %@", error);
    }];