更新记录

1.0.0（2026-05-27） 下载此版本

基于 百度 RTC AI Agent Android SDK 封装

平台兼容性

uni-app(5.07)

uts-baidu-rtc-agent

百度 BRTCAgent AI 大模型实时互动 UTS 插件，在 uni-app 中实现 AI 智能体实时语音/文字互动。 基于 百度 RTC AI Agent Android SDK 封装，在 uni-app 中实现 AI 大模型实时语音/文字聊天。

安装

1. 将 uts-baidu-rtc-agent 目录放入 uni-app 项目的 uni_modules/ 下。
2. 在 HBuilderX 中「制作自定义调试基座」（或云打包）。
3. 在页面中通过 ES 模块语法引入：

import * as plugin from "@/uni_modules/uts-baidu-rtc-agent";

注意：UTS 插件不能使用 uni.requireNativePlugin() 加载，必须使用 import 语法。

权限

插件需要麦克风权限，在 AndroidManifest.xml 中需声明：

<uses-permission android:name="android.permission.RECORD_AUDIO" />

首次连接时需在代码中动态申请权限：

plus.android.requestPermissions(
  ['android.permission.RECORD_AUDIO'],
  function(res) {
    if (res.granted.length > 0) {
      // 开始连接
    }
  },
  function() {
    uni.showToast({ title: '请授权麦克风权限', icon: 'none' })
  }
)

快速开始

import * as plugin from "@/uni_modules/uts-baidu-rtc-agent";

export default {
  data() {
    return {
      sdkVersion: ''
    }
  },
  mounted() {
    // 获取 SDK 版本（无需初始化）
    this.sdkVersion = plugin.getSDKVersion()
  },
  methods: {
    // 一键连接 AI 智能体
    connect() {
      // 1. 先注册事件回调
      plugin.setEventCallback((eventName, jsonData) => {
        const data = JSON.parse(jsonData)
        switch (eventName) {
          case 'onCallStateChange':
            // data.state: 1=通话开始, 2=通话结束
            break
          case 'onAIAgentSubtitle':
            // data.text, data.isFinal — AI 流式回复文字
            break
          case 'onError':
            console.error(data.error, data.msg)
            break
        }
      })

      // 2. 一键启动（自动创建 Agent + 初始化 SDK + 发起通话）
      plugin.quickStart(
        'your_app_id',     // appId
        '',                 // userId（可选）
        '',                 // licenseKey（可选）
        JSON.stringify({    // Agent 配置
          lang: 'zh',
          role: '智能助手',
          tts_sayhi: '你好，有什么可以帮你？',
          host: 'https://ai.agent.kaywang.cn'
        })
      )
    },

    // 发送文字
    sendText(text) {
      plugin.sendText(text)
    },

    // 挂断
    hangup() {
      plugin.stopAgent('your_app_id', '', 'https://ai.agent.kaywang.cn', '')
      plugin.hangup()
      plugin.destroy()
    }
  }
}

API 参考

基础 API

交互 API

音频控制 API

高级 API

getSDKVersion()

const ver = plugin.getSDKVersion()  // 如 "3.5.0.4a"

setEventCallback(callback)

注册全局事件回调，必须在调用 initAgent 或 quickStart 之前调用。

plugin.setEventCallback((eventName, jsonData) => {
  const data = JSON.parse(jsonData)
  // 处理各事件
})

回调参数：

• eventName: string — 事件名称
• jsonData: string — JSON 字符串，需 JSON.parse 解析

initAgent(appId, contextJson, userId, licenseKey, verbose)

初始化 Agent SDK。contextJson 需从后端获取。

plugin.initAgent(
  'your_app_id',          // appId
  '{"cid":1,"token":"xxx"}', // contextJson（后端返回）
  'user_001',              // userId（可选，传 ""）
  '',                      // licenseKey（可选，传 ""）
  true                     // verbose 调试日志
)

callAgent(token, instanceId)

发起通话前需先调用 initAgent。

plugin.callAgent('your_token', '1')

quickStart(appId, userId, licenseKey, configJson)

一键启动：自动完成 HTTP 创建 Agent → 初始化 SDK → 发起通话。

plugin.quickStart(
  'your_app_id',
  '',
  '',
  JSON.stringify({
    lang: 'zh',            // 语言
    role: '智能助手',       // 角色描述
    tts_sayhi: '你好！',    // 首次问候语
    sense: '',             // 场景角色（可选）
    llm: '',               // 大模型（可选）
    audiocodec: '',        // 音频编码（可选）
    host: 'https://ai.agent.kaywang.cn'  // 后端地址（可选）
  })
)

configJson 支持的字段：

其他 API

// 发送文字
plugin.sendText('[T]:你好')

// 发送文字并打断当前播报
plugin.sendTextAndInterrupt('停下来')

// 打断 AI 播报
plugin.interrupt()

// 麦克风静音
plugin.muteMic(true)   // 静音
plugin.muteMic(false)  // 取消静音

// 扬声器静音
plugin.mutePlayback(true)
plugin.mutePlayback(false)

// 切换听筒 / 扬声器
plugin.switchToSpeaker(true)  // 扬声器
plugin.switchToSpeaker(false) // 听筒

// 返回 Function Call 结果
plugin.sendFunctionCallResult('call_id', '{"result":"ok"}')

// 发送自定义命令
plugin.sendCommand('[PAUSE]')
plugin.sendCommand('[RESUME]')

// 更新 System Prompt
plugin.updateSystemPrompt(0, '你现在是一个数学老师')

// 上传文件
plugin.uploadFile(0, '/sdcard/photo.jpg', 180)

// HTTP 停止 Agent
plugin.stopAgent('your_app_id', '1', 'https://ai.agent.kaywang.cn', '')

// 释放所有资源
plugin.hangup()
plugin.destroy()

事件回调参考

回调函数会收到两个参数：eventName（事件名）和 jsonData（JSON 字符串）。需要 JSON.parse(jsonData) 后使用。

完整示例

参见 pages/chat/chat.vue。

License

百度 BRTCAgent SDK，需要有效的 License Key。请联系百度获取授权。