类型定义

typedef struct {
    char track_id[64];
    char uid[64];
    char desc[64];
    int kind;
    int codec;
    int width;
    int height;
    int fps;
    int angle;
    int bitrate;
    int sample_rate;
    int channel_count;
    const char* props;
} rtc_track_info_t;

typedef struct {
    char uid[64];
    char name[128];
    char device_id[128];
    char version[64];
    char channel[128];
    char sid[128];
    const char* props;
    int device_type;
    int is_audience;
    int64_t join_at;
    int64_t leave_at;
    int64_t updated_at;
    rtc_track_info_t* stream_tracks;
    int stream_track_count;
} rtc_user_info_t;

typedef struct {
    char app_id[64];
    char channel[128];
    const char* props;
    int64_t created_at;
    int64_t updated_at;
} rtc_channel_info_t;

typedef struct {
    char desc[64];         // 轨道描述（必填，不能为空串）
    int width;             // 视频宽度（视频必填）
    int height;            // 视频高度（视频必填）
    int fps;               // 帧率（视频必填）
    int sample_rate;       // 采样率（音频必填）
    int channel_count;     // 声道数（音频必填）
    int angle;             // 视频角度（可选）
    int bitrate;           // 码率 bps（可选）
    const char* props;     // 自定义属性，JSON 字符串（可选）
} rtc_publish_options_t;

#define RTC_CODEC_H264  0x1b        // H264 视频
#define RTC_CODEC_H265  0x24        // H265 视频
#define RTC_CODEC_VP8   0x38        // VP8 视频
#define RTC_CODEC_VP9   0x39        // VP9 视频
#define RTC_CODEC_AV1   0x3a        // AV1 视频
#define RTC_CODEC_AAC   0x0f        // AAC 音频
#define RTC_CODEC_OPUS  0x5355504f  // OPUS 音频

static inline const char* rtc_codec_to_string(int codec);
// 未知取值返回 "UNKNOWN"

#define RTC_LOG_DEBUG  0
#define RTC_LOG_INFO   1
#define RTC_LOG_WARN   2
#define RTC_LOG_ERROR  3

#define RTC_MCU_PUBLISHER_UID "__mcu__"   // 合成流发布者 uid
#define RTC_TRACK_AMCU_ID     "__amcu__"  // 音频合成流 trackId
#define RTC_TRACK_MCU_ID      "__mcu__"   // 视频合成流 trackId

typedef void (*rtc_connection_callback)(void* context, int state);

typedef void (*rtc_user_event_callback)(void* context, const char* uid, int event_type);

typedef void (*rtc_track_event_callback)(void* context, const char* uid,
                                         rtc_track_info_t* track_info, int event_type);

typedef void (*rtc_track_sample_callback)(void* context,
                                          rtc_user_info_t* user_info,
                                          rtc_track_info_t* track_info,
                                          uint8_t* data, int len,
                                          int64_t timestamp, int64_t duration);

typedef void (*rtc_layer_switched_callback)(void* context, const rtc_layer_switched_t* data);

typedef void (*rtc_connection_quality_callback)(void* context, const rtc_connection_quality_t* q);

typedef void (*rtc_active_speakers_callback)(void* context, int64_t ts,
                                             const rtc_active_speaker_t* speakers,
                                             int speakers_count);

typedef void (*rtc_custom_msg_callback)(void* context, const rtc_custom_msg_t* msg);

typedef void (*rtc_keyframe_request_callback)(void* context, const char* track_id);

typedef void (*rtc_disconnected_callback)(void* context, int reason, int code, const char* msg);