客户端API

编辑文档更新于 2025-09-21 11:59:40

本文将向您介绍BRTC客户端SDK中有关于AI智能体的接口。

手动打断

在与AI智能体的对话过程中，您可以通过两种方式来打断智能体讲话：通过说话来打断智能体，或者在界面上为用户提供一个按钮来手动打断智能体讲话。其中通过说话来打断智能体不需要您进行额外的程序调用。手动打断智能体，只需要您调用BRTC客户端SDK中的一个无参数API即可。例如以Android端举例：

BRTC brtcEngine = BRTC.sharedInstance(getApplicationContext());
brtcEngine.setListener(...);
brtcEngine.enterRoom(...);

// 手动打断智能体
brtcEngine.sendAIInterrupt();

接口定义

向智能体进行文字提问

除了通过说话来和智能体进行对话，您还可以通过文字来向智能体发起提问。例如以iOS端举例：

@property (nonatomic, strong) BRTC *brtc;
self.brtc = [BRTC sharedInstance];
self.brtc.delegate = ...;
[self.brtc enterRoom:...];

// 向智能体发起文字提问
NSString *question = @"文字内容";
[self.brtc sendAIQuestion:question];

接口定义

向智能体请求播报欢迎语

为了保证在创建智能体时设置的欢迎语准确送到客户端来播放，需要您在合适的时机调用接口来播报欢迎语。流程示意图如下：

AI Agent 欢迎语播报流程

接口调用代码，以Web端举例：

let client = BRTC.createClient(...)
// 加房
this.client.join(roomId, userId, token).then(() => {...})
// 监听远程流添加事件
this.client.on('stream-added', (data) => {
    // 判断如果是智能体（agentUserId在创建智能体接口时获取），订阅其音频流
    if (data.stream.getUserId() === this.agentUserId) {
        this.client.subscribe(data.stream, {audio: true, video: false}).then(() => {
            // 向智能体请求播报欢迎语
            this.client.requestAIGreetingMessage()
        })
    }
})