整体方案说明

用户登录

允许已授权的用户通过此接口更新自己的信息。

• URL：POST:/v1.0/openapi/visual/d/user/login

• Method：POST

• 需要登录：是

• 需要鉴权：是

请求参数

请求示例

{
    "userName": "userName",		// 开发者账户名
    "password": "password",		// 开发者密码
    "deviceList": [				// 需要授权的设备列表
        {
            "productKey": "wkNCAsnnlsYSnI6n",	// 设备产品Key
            "deviceName": "2ac4d7cffa"			// 设备名称
        }
    ]
}

成功响应

响应示例

{
    "success": true,
    "msg": null,
    "t": 1737621418759,
    "data": {
        "deviceVisualTokenList": [
            {
                "productKey": "wkNCAsnnlsYSnI6n",	// 设备产品Key
                "deviceName": "2ac4d7cffa",			// 设备名称
                "visualToken": "eyJhbGciNiJ9.xxx.5f5Nd5JNaP-O2LBmYJZO0_9thFU",
            	  "expire": 3600						// 过期时间，单位秒。
            }
        ]
    }
}

注意事项

发起连接

接口说明：发起p2p连接

/// connect
- (void)connect;

示例代码：

ThingSmartCameraDevice *device = [[ThingSmartCameraDevice alloc] createCameraWithProductKey:@"your productId" deviceSecret:@"your device secret" deviceName:@"you device name"];

[device connect];

连接成功回调：

发起connect后，如果连接成功，会回调下面这个方法

连接成功回调：

/// Them camera did connected
/// @param camera camera
- (void)cameraDidConnected:(id<ThingSmartCameraTypeProtocol>)camera;

连接失败回调：

type 对应 ThingSmartCameraVisualTypeConnect

/// The operate did occurred error
/// @param camera camera
/// @param errCode error code
/// @param type opera type
- (void)camera:(id<ThingSmartCameraTypeProtocol>)camera didOccurredError:(NSInteger)errCode type:(ThingSmartCameraVisualType)type;

云存储业务

• 云存储开始上传

/**
 * @brief    report an event, cloud storage will start
 *
 * @return OPRT_OK on success. Others on error, please refer to tuya_error_code.h
 */
OPERATE_RET tuya_imm_cloud_storage_event_start(VOID);

• 云存储结束上传

/**
 * @brief    report the end of event, synchronous api
 *
 * @return OPRT_OK on success. Others on error, please refer to tuya_error_code.h
 */
OPERATE_RET tuya_imm_cloud_storage_event_stop(VOID);

获取录像片段

获取云存储播放片段信息

/// load cloud datas
/// - Parameters:
///   - params: params
///   - success: success callback
///   - fail: fail callback
- (void)loadCloudData:(ThingSmarCameraLiteCloudParamas *)params success:(ThingSmartCameraCloudDataHandler)success fail:(ThingSmartCameraCloudDataFailHandler)fail;

ThingSmarCameraLiteCloudParamas 参数说明

示例代码

ThingSmarCameraLiteCloudParamas *params = [[ThingSmarCameraLiteCloudParamas alloc] init];
params.startTime = 12345;
params.endTime = 67890;
params.pageIndex = 0;
params.pageSize = 20;
[self.cloudManager loadCloudData:params success:^(NSString * _Nonnull jsonData) {
        
} fail:^(NSError * _Nonnull error) {
        
}];