47 lines
1.6 KiB
C
47 lines
1.6 KiB
C
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#include "esp_err.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* 仅描述 WebSocket 传输事件，不携带 domain 层的业务会话语义。 */
|
|
typedef enum {
|
|
MULTIMODAL_WS_EVENT_CONNECTED = 0,
|
|
MULTIMODAL_WS_EVENT_DISCONNECTED,
|
|
MULTIMODAL_WS_EVENT_ERROR,
|
|
MULTIMODAL_WS_EVENT_TEXT_MESSAGE,
|
|
MULTIMODAL_WS_EVENT_BINARY_MESSAGE,
|
|
} multimodal_ws_event_type_t;
|
|
|
|
/* data 指针只在事件回调期间有效，需要异步处理时必须复制。 */
|
|
typedef struct {
|
|
multimodal_ws_event_type_t type;
|
|
const uint8_t *data;
|
|
size_t data_len;
|
|
} multimodal_ws_event_t;
|
|
|
|
typedef void (*multimodal_ws_event_callback_t)(const multimodal_ws_event_t *event,
|
|
void *user_data);
|
|
|
|
/* start 复制鉴权信息和回调；stop 负责回收 client、队列及全部工作任务。 */
|
|
esp_err_t multimodal_ws_start(const char *bearer_token,
|
|
const char *workspace_id,
|
|
multimodal_ws_event_callback_t cb,
|
|
void *user_data);
|
|
esp_err_t multimodal_ws_stop(int timeout_ms);
|
|
bool multimodal_ws_is_connected(void);
|
|
|
|
/* 普通文本允许内部重试；realtime 接口使用更短锁等待和发送超时以保护实时性。 */
|
|
esp_err_t multimodal_ws_send_text(const char *label, const char *text);
|
|
esp_err_t multimodal_ws_send_text_realtime(const char *label, const char *text);
|
|
esp_err_t multimodal_ws_send_binary_realtime(const uint8_t *data, size_t len);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|