cube_unite_iot_sdk.h

浏览该文件的文档.

#ifndef CUBE_UNITE_SDK_CUBE_UNITE_IOT_SDK_H
#define CUBE_UNITE_SDK_CUBE_UNITE_IOT_SDK_H
 
#include <stdbool.h>
#include <stdint.h>
#include <time.h>
 
#define CU_IOT_AUDIO_FRAME_MAX_SIZE (640)
 
 
typedef enum cu_iot_err_code_e {
    CU_IOT_ERR_OK=0,        
    // 1-100, reserved
    // 101-200, network related error
    CU_IOT_ERR_SERVER_NOT_AVAILABLE=0,        
    // 201-300, API error
    CU_IOT_ERR_ARGUMENT_INVALID=200,        
    // 301-400, application level error
    CU_IOT_ERR_DEVICE_INVALID=301,      
    CU_IOT_ERR_LICENSE_INVALID=65535,     
} cu_iot_err_code_t;
 
typedef struct cu_iot_video_meta_s {
    uint32_t image_width;   
    uint32_t image_height;  
    char format[64];
    char rotation[16];
} cu_iot_video_meta_t;
 
typedef struct cu_iot_audio_meta_s {
    char codec[32];
} cu_iot_audio_meta_t;
 
typedef struct cu_iot_device_event_s {
    char name[32];        
    uint8_t user_type;      
    uint16_t user_id;       
    uint8_t event_info;     
    char* extra_meta;       
} cu_iot_device_event_t;
 
typedef enum cu_iot_sdk_event_e {
    CU_IOT_SDK_EVENT_UNDEFINED=-1,
    CU_IOT_SDK_EVENT_REMOTE_UNLOCK,     
    CU_IOT_SDK_EVENT_REMOTE_TRIGGER_WAKEUP,     
    CU_IOT_SDK_EVENT_REMOTE_TRIGGER_SLEEP,     
    CU_IOT_SDK_EVENT_REMOTE_ENABLE_KEEP_ALIVE,      
    CU_IOT_SDK_EVENT_REMOTE_DISABLE_KEEP_ALIVE,     
    // RTC related
    CU_IOT_SDK_EVENT_REMOTE_RTC_STARTED,     
    CU_IOT_SDK_EVENT_REMOTE_RTC_END,     
} cu_iot_sdk_event_t;
 
typedef struct cu_iot_audio_frame_s {
    uint32_t data_bytes;        
    uint8_t data[CU_IOT_AUDIO_FRAME_MAX_SIZE];                 
} cu_iot_audio_frame_t;
 
typedef struct cu_iot_video_frame_s {
    uint32_t data_bytes;        
    uint8_t *data;                 
} cu_iot_video_frame_t;
 
typedef void (*cu_iot_sdk_event_handler_t)(cu_iot_sdk_event_t *event, void *event_meta);
 
typedef void (*cu_iot_rtc_on_audio_frame_received_t)(cu_iot_audio_frame_t *audio_frame, uint64_t sent_ts);
 
 
cu_iot_err_code_t cu_iot_init(char* license, char *vendor_name, char* vendor_token);
 
cu_iot_err_code_t cu_iot_deinit();
 
cu_iot_err_code_t cu_iot_ping_server();
 
 
cu_iot_err_code_t cu_iot_device_create(
        char* device_creation_code,
        char* device_mac_addr,
        cu_iot_video_meta_t *video_meta,
        cu_iot_audio_meta_t *audio_meta,
        uint8_t *device_meta_out_buf
        );
 
cu_iot_err_code_t cu_iot_device_delete(uint8_t *device_meta);
 
cu_iot_err_code_t cu_iot_device_init(uint8_t *device_meta);
 
 
cu_iot_err_code_t cu_iot_device_deinit();
 
 
// event related
cu_iot_err_code_t cu_iot_device_event_create(cu_iot_device_event_t *event);
 
cu_iot_err_code_t cu_iot_device_snapshot_upload(cu_iot_video_frame_t *snapshot);
 
cu_iot_err_code_t cu_iot_device_register_callback(cu_iot_sdk_event_handler_t handler);
 
// time sync
cu_iot_err_code_t cu_iot_device_get_remote_time(time_t *server_time_ts);
 
// RTC related
cu_iot_err_code_t cu_iot_device_rtc_start();
 
cu_iot_err_code_t cu_iot_device_rtc_end();
 
cu_iot_err_code_t cu_iot_device_rtc_register_audio_frame_receive_callback(cu_iot_rtc_on_audio_frame_received_t on_audio_frame_received);
 
cu_iot_err_code_t cu_iot_device_video_send_frame(cu_iot_video_frame_t *video_frame);
 
cu_iot_err_code_t cu_iot_device_audio_send_frame(cu_iot_audio_frame_t *audio_frame);
 
 
#endif //CUBE_UNITE_SDK_CUBE_UNITE_IOT_SDK_H