1// 应用标识 (必填)
2#define APPID "XXXX"
3
4// 访问密钥 (必填)
5#define AK ""
6#define SK ""
7
8// 许可证密钥 (必填)
9#define LICKEY "XXXXX"
10
11// 设备ID (可选，用于license验证)
12#define DEVICE_ID "DEVID-2026-YYYYYY"
13
14// 应用版本
15#define APP_VERSION "V1.0.2"

1// AI Agent服务端地址
2#define AGENT_PLATFROM_ENDPOINT "http://ai.agent.kaywang.cn:8988/kk/v1/aiagent"

1#define ENERGY_THRESHOLD 10000.0f    // 静音检测能量阈值
2#define LOW_ENERGY_FRAMES 10        // 连续静音帧数阈值

1typedef baidurtc::BaiduRtcRoomClient* f_createBaiduRtcRoomClient();
2
3// 使用示例
4void* handle = dlopen("libbaidurtc.so", RTLD_LAZY | RTLD_DEEPBIND);
5f_createBaiduRtcRoomClient* createClient = (f_createBaiduRtcRoomClient*)dlsym(handle, "_ZN8baidurtc24createBaiduRtcRoomClientEv");
6baidurtc::BaiduRtcRoomClient* g_BrtcClient = createClient();

1extern "C" const char* getBaiduRtcSdkVersion();
2
3// 使用示例
4f_getVersion* version = (f_getVersion*)dlsym(handle, "getBaiduRtcSdkVersion");
5printf("BRTC SDK Version is: %s\n", version());

1BAIDU_RTC_EXPORT_API void enableBaiduRtcLog(bool isEnable);
2
3// 使用示例
4f_enable* enableLog = (f_enable*)dlsym(handle, "enableBaiduRtcLog");
5if (enableLog) {
6    enableLog(0); // 0 = 禁用日志，非0 = 启用日志
7}

1virtual void Destory() = 0;
2
3// 使用示例
4g_BrtcClient->Destory();
5g_BrtcClient = nullptr;

1virtual void setAppID(const char *AppID) = 0;
2
3// 参数说明
4// AppID: 百度云RTC申请的AppID
5
6// 使用示例
7g_BrtcClient->setAppID(APPID);
8
9#### 设置SSL证书
10```cpp
11virtual void setCER(const char *cerFile) = 0;
12
13// 参数说明
14// cerFile: SSL证书文件路径 (随SDK提供)
15
16// 使用示例
17g_BrtcClient->setCER("./a.cer");

1virtual void setParamSettings(RtcParameterSettings* paramSettings,
2                               RtcParameterSettings::RtcParamSettingType paramType) = 0;
3
4// RtcParameterSettings 结构说明
5struct RtcParameterSettings {
6    bool HasVideo;              // 是否启用视频
7    bool HasAudio;              // 是否启用音频
8    bool HasData;               // 是否启用数据通道
9    int AudioINChannel;         // 输入音频通道数 (1=单声道, 2=立体声)
10    int AudioINFrequency;       // 输入音频采样率 (如16000, 48000)
11    bool AsPublisher;          // 是否作为发布者
12    bool AsListener;           // 是否作为订阅者
13    bool AutoPublish;          // 是否自动发布
14    // ... 其他音视频参数
15};
16
17// 使用示例
18RtcParameterSettings s;
19s.HasData = true;
20s.HasVideo = false;
21s.HasAudio = true;
22s.AudioINChannel = 1;
23s.AudioINFrequency = 16000;
24s.AsPublisher = true;
25s.AsListener = true;
26s.AutoPublish = true;
27
28g_BrtcClient->setParamSettings(&s, s.RTC_PARAM_SETTINGS_ALL);

1virtual bool loginRoom(const char* roomName, const char* userId,
2                       const char* displayName, const char* token) = 0;
3
4// 参数说明
5// roomName: 房间名 (Agent场景下使用agent ID)
6// userId: 用户ID (64位数字字符串)
7// displayName: 显示名称
8// token: 认证令牌
9
10// 返回值: true=成功, false=失败
11
12// 使用示例
13std::string uid = "202600000" + std::to_string(rand()/100000);
14std::string token = "token";
15g_BrtcClient->loginRoom("2131", uid.c_str(), "BRTC.EAI chat demo", token.c_str());

1virtual bool logoutRoom() = 0;
2
3// 使用示例
4g_BrtcClient->logoutRoom();

1virtual void sendAudio(const char *data, int len) = 0;
2
3// 参数说明
4// data: PCM音频数据地址
5// len: 数据长度 (字节)
6
7// 使用示例 (从ALSA采集音频并发送)
8char buffer[4096];
9// ... 从pcm设备读取音频数据 ...
10g_BrtcClient->sendAudio(buffer, bytes_read);

1virtual void sendImage(const char *data, int len) = 0;
2
3// 参数说明
4// data: 图像数据地址 (支持JPEG, H264, YUV格式)
5// len: 数据长度
6
7// 使用示例
8g_BrtcClient->sendImage(jpeg_data, jpeg_size);

1virtual void sendData(const char *data, int len) = 0;
2
3// 参数说明
4// data: 文本/二进制数据
5// len: 数据长度
6
7// 使用示例 - 发送文本消息
8g_BrtcClient->sendData("Hello", 5);
9
10// 使用示例 - 发送自定义消息
11g_BrtcClient->sendMessageToUser("[T]:Hello.", "0");

1virtual void sendMessageToUser(const char *msg, const char * id) = 0;
2
3// 参数说明
4// msg: 消息内容
5// id: 用户ID ("0"表示广播)
6
7// 使用示例
8g_BrtcClient->sendMessageToUser("[T]:Hello.", "0");  // 广播
9g_BrtcClient->sendMessageToUser("[T]:Hi.", "12345"); // 发送给指定用户

1virtual void startPublish() = 0;

1virtual void stopPublish() = 0;

1virtual void subscribeStreaming(const char * feedId, IAudioFrameObserver *afo,
2                                IVideoFrameObserver *vfo, IDataFrameObserver *dfo) = 0;
3
4// 参数说明
5// feedId: 要订阅的流ID
6// afo: 音频回调 (可为空)
7// vfo: 视频回调 (可为空)
8// dfo: 数据回调 (可为空)

1virtual void stopSubscribeStreaming(const char * feedId) = 0;

1virtual void setUserAttribute(const char * a) = 0;

1virtual void getUserAttribute(const char * id) = 0;

1virtual void shutupUser(const char * userId, bool shutup) = 0;
2// shutup: true=禁言, false=解除禁言

1virtual void kickoutUser(const char * userId) = 0;

1virtual void disbandRoom() = 0;

1virtual void getRoomStates(RtcRoomUserInfo** userInfoList, int& userNumber) = 0;

1virtual ConnectionStats getConnectionStats(ConnectionType connectionType) = 0;

1virtual void setCandidateIP(const char *candidateIP) = 0;

1virtual void setMediaServerIP(const char *mediaserverIP) = 0;

1virtual void setVideoCodec(const char * vc) = 0;
2// 可选值: "h264", "vp8", "vp9", "h263", "av1", "h265", "h266"
3// 默认: "h264"

1virtual void setAudioCodec(const char * ac) = 0;
2// 可选值: "opus", "pcmu", "pcma"
3// 默认: "opus"

1virtual void setAudioOpusCeltOnly(int celtOnly) = 0;  // 只使用CELT编码
2virtual void setAudioOpusPtime(int ptime) = 0;        // 设置包时间大小

1class IRtcMessageListener {
2public:
3    virtual void OnRtcMessage(RtcMessage &msg) = 0;
4};
5
6// RtcMessage 结构
7struct RtcMessage {
8    RtcMessageType msgType;     // 消息类型
9    int64_t feedId;             // 用户ID
10    char extra_info[1024];      // 附加信息
11    // ...
12};
13
14// 注册方式
15g_BrtcClient->registerRtcMessageListener(&myListener);

1class IAudioFrameObserver {
2public:
3    virtual void onAudioData(int64_t feedid, const char *audio, int len,
4                             int samlplerate, int channels) = 0;
5};
6
7// 注册方式
8IAudioFrameObserver* iAfo[1];
9iAfo[0] = &myListener;
10g_BrtcClient->registerAudioFrameObserver(iAfo, 1);

1class IVideoFrameObserver {
2public:
3    virtual void onFrame(int64_t feedid, const char *img, int len,
4                         RtcImageType imgtype, int width, int height) = 0;
5};
6
7// 注册方式
8IVideoFrameObserver* iVfo[1];
9iVfo[0] = &myListener;
10g_BrtcClient->registerVideoFrameObserver(iVfo, 1);

1class IDataFrameObserver {
2public:
3    virtual void onTextData(int64_t feedid, const char *data, int len) = 0;
4};
5
6// 注册方式
7IDataFrameObserver* iDfo[1];
8iDfo[0] = &myListener;
9g_BrtcClient->registerDataFrameObserver(iDfo, 1);

1// 请求: [E]:[LIC]:[MUST]:
2// 响应: [E]:[LIC]:[ACTIVE]:{"devId":"xxx","uId":"xxx","licKey":"xxx"}

1// 消息: [E]:[PLAY_AUDIO]:{URL}

1// 消息: [E]:[ALARM]:{"text":"告警内容"}

1// 消息: [E]:[MEDIA_GENERATE_RESULT]:{"msg":"success","type":"image","data":[...]}

1// TTS开始: [E]:[TTS_BEGIN_SPEAKING]
2// TTS结束: [E]:[TTS_END_SPEAKING]

1// 开始播放: [E]:[REMOTE_PLAYER_BEGIN]
2// 结束播放: [E]:[REMOTE_PLAYER_END]

1// 请求上传: [E]:[UPLOAD_IMAGE]
2// 设备端收到后应拍照并上传

1字节0: 0x18
2后续: [T]=binary;[N]=filename\n
3然后是数据

1字节0: 0x10
2后续是数据

1字节0: 0x14

1#define CHUNK_SIZE 16384 * 4
2
3void sendFile(const char *filename, const char *gImgForMode)
4{
5    FILE *fp = fopen(filename, "rb");
6    // ... 读取文件 ...
7
8    uint8_t chunk[CHUNK_SIZE];
9    size_t offset = 0;
10
11    while (读取数据成功) {
12        char hdr[512];
13        size_t hdr_len = 0;
14
15        if (offset == 0) {
16            // 第一个包 - 带文件头
17            snprintf(hdr, sizeof(hdr),
18                     "\x18[T]=binary;[N]=%s%s\n",
19                     filename, gImgForMode ? gImgForMode : "");
20            hdr_len = strlen(hdr);
21        } else {
22            // 后续包
23            hdr[0] = 0x10;
24            hdr_len = 1;
25        }
26
27        // 发送数据
28        g_BrtcClient->sendData(hdr, hdr_len);
29        g_BrtcClient->sendData(chunk, read_len);
30
31        offset += read_len;
32    }
33
34    // 发送结束标志
35    uint8_t end = 0x14;
36    g_BrtcClient->sendData((const char*)&end, 1);
37}

1make

1cd bin
2LD_LIBRARY_PATH=$LD_LIBRARY_PATH:../lib ./chat

1# 将 bin 和 lib 目录拷贝到设备
2# 修改 chat.cpp 中的配置后重新编译
3cd bin
4LD_LIBRARY_PATH=$LD_LIBRARY_PATH:../lib ./chat