
# Baidu AI Agent SDK集成说明

    -  用于进行BRTC SDK开发的demo程序。  
       百度智能云实时音视频RTC：https://cloud.baidu.com/doc/RTC/index.html  
       关于语音互动各文件说明：  
        ./doc                               //RTOS SDK接口文档以及服务端创建智能体的流程文档
        ./include/                          //BaiduRTC SDK的头文件。
        ./libs/libbrtc.a                    //BaiduRTC SDK的库文件。 
        ./platform/os_ac79_audio           //提供了AC79平台系统录制/播放的调用流程接口
        ./platform/os_ac79_video           //提供了AC79平台系统视频采集/显示的调用流程接口
        ./src/app_demo/wifi_camera          //智能体多模态互动的demo程序代码，可以正常运行
        ./src/sdk_wrapper/brtc_wrapper.c   //AI Agent 调用流程代码
        ./README.md                        //集成说明文档

       ./src/sdk_wrapper/brtc_wrapper.c中主要函数说明如下：

        1. baidu_create_chat_agent_engine 创建智能体引擎

        2. baidu_chat_agent_engine_init 初始化参数和设置事件回调
            1). 设置事件回调。  
            2). 设置登录BRTC 房间需要的参数BDCloudDefaultRTCAppID。//需要客户申请 https://cloud.baidu.com/doc/RTC/index.html
            3). 需要设置params->license_key，需要向百度购买license获取。

        3. baidu_chat_agent_engine_call 开启智能体对话 

        4. baidu_chat_agent_engine_destroy 结束智能体对话和销毁 

######版本更新须知#######
时间：20260119
版本：BRTC.RTOS.SDK.AC79.V3.0.9B06.20260119
功能：
1. 增加了音频高保真功能，可减少卡顿延迟。
2. 增加了闹钟信息上报业务层的功能。
3. 增加了美国域名节点，后续可以访问美国服务。

时间：20251208
版本：BRTC.RTOS.SDK.AC79.V3.0.9B05.tmp20251208
功能：
1. 增加了图片理解功能
2. 增加了文生图功能


###客户搭建服务的流程###
1.客户需要搭建自己的服务，可以在本地或者服务器上运行我们的服务端demo参考示例，具体详情请参考《BRTC实时交互智能体接入指引文档V1.4》中的rtos sdk章节

https://cloud.baidu.com/doc/RTC/s/wm8y592lc 下载服务端Demo示例代码userserver-and-web-demo.zip
服务端示例代码可以运行在本地或者服务器上（windows/mac/linux），只需要安装jdk17即可
linux/mac环境下执行步骤：
BCE_APP_AK=xxxx\
BCE_APP_SK=xxxx\
java -jar rtc-aiagent-userserver-1.0-SNAPSHOT.jar\
windows环境下执行步骤：
set BCE_APP_AK=xxxx
set BCE_APP_SK=xxxx
java -jar rtc-aiagent-userserver-1.0-SNAPSHOT.jar


## 注意事项

    -  下面是在集成中需要注意的点：  
       1. ./platform/os_ac79_video/video_photo.c 我们基于这代码增加拍照数据回调接口，请合入相关修改到客户自己的video_photo.c中。
	   2. ./platform/os_ac79_video/app_config.h 中增加了打开音频回声等相关配置，请将差异话的修改合入到客户指定的app_config.h
       3. ./platform/os_ac79_audio/key_voice.c中我们拍照声音采样率改成了16k，与AI Agent TTS声音一致，请将按键采样率改成16k
	   4. ./src/app_demo/wifi_camera demo例程是基于fw-AC792_SDK_V2.2.2基线开发的。
	   5. ./src/app_demo/wifi_camera/app_main.c 中设置了wifi密码和用户名，wifi_enter_sta_mode("BD", "Abcde168");
	   6. ./src/app_demo/wifi_camera/wifi/wifi_app_task.c中wifi_event_callback函数网络连接上了就启动了brtc_ai_agent_task_open，客户根据实际需要调用该接口启动SDK流程。