/**
 * @file visual_sender.h
 * @brief 视觉图片分帧发送协议
 *
 * 图片分帧协议：首帧 0x18+元数据+数据，续帧 0x10+数据，
 * 末帧 FA==（0x14）；每帧原始数据上限 1089 字节，
 * 全部以 WS 文本帧（base64）发送。
 */

#ifndef CORE_VISUAL_SENDER_H
#define CORE_VISUAL_SENDER_H

#include <stdint.h>
#include <stddef.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct engine_internal_ctx engine_internal_ctx_t;

/**
 * @brief 将图片数据按分帧协议发送到云端
 *
 * @param ctx  引擎上下文
 * @param data 图片数据（JPEG 或 PNG）
 * @param len  数据长度
 * @return 0 成功，负值失败
 */
int visual_send_image(engine_internal_ctx_t *ctx,
                      const uint8_t *data, size_t len);

#ifdef __cplusplus
}
#endif

#endif /* CORE_VISUAL_SENDER_H */
