开发者文档中心

OpenAPI进入控制台

Android · 2026-10-31

Android:快速接入

WebView 源码示例,需加入自己的宿主工程编译。

下载接入包

开始前准备

  1. 在“渠道 → 自建渠道 → 服务入口”创建专用 Web 入口,启用入口并绑定已发布智能体。需要渠道管理权限;没有入口时请企业管理员协助。
  2. 将 Kotlin 文件加入最低 API 23 的现有 Android 工程,修改包名并合并 Manifest 片段。使用更新版支持 WebRTC/AudioWorklet 的 System WebView;不是已发行 AAR 或 Maven 依赖。

从哪里取得入口参数

参数填写内容获取位置
origin部署客服的公网 HTTPS 主机,不带 /support、路径或查询参数从“服务入口 → 皮肤与代码”的入口链接提取协议和主机
key / publicKey同一入口的公开 UUID key从该入口生成的链接或代码复制 key;Android 字段名为 publicKey
entryId同一入口的 ID从该入口生成的链接或代码复制 entryId,不填写智能体 ID

客户端只填公开参数

管理 API Key、AppSecret 和登录 token 不得放入 App 源码或入口链接。公开 key 不是管理授权;本地会话编号也不代表可信会员身份。

安装与配置

  1. 下载本页客户端接入包,将 android/YunfuSupportActivity.kt 及准备要求中的配套文件合并到宿主工程,不覆盖原有业务配置。
  2. 替换 origin、publicKey、entryId;合并 INTERNET、RECORD_AUDIO、MODIFY_AUDIO_SETTINGS 和 exported=false 的 Activity。只在用户点击后启动,保留 HTTPS 与 SSL 默认拒绝行为。

宿主接入示例

运行前

android/usage.kt · 宿主调用文件 · 接入包 0.3.15

  • 修改示例 Activity 的公开参数,合并 Manifest,并将 package 改为宿主实际包名。
完整代码 · 13 行
android/usage.ktKotlin
package your.app.support

import android.app.Activity
import android.content.Intent
import android.os.Build

// Configure the three public entry constants in YunfuSupportActivity and merge the Manifest.
fun openYunfuSupport(host: Activity) {
    require(Build.VERSION.SDK_INT >= Build.VERSION_CODES.M)
    host.startActivity(Intent(host, YunfuSupportActivity::class.java))
}
// Call from a support button, never from Application startup.
// The account-switch flow must close all hosted support Activities before replacing the account.
聊天交互预览 · 本地示意

通用聊天交互示意,回复为固定演示内容;不执行此源码、不连接当前渠道或调用模型。

客户服务助手欢迎咨询

您好,我是您的服务助手。有什么可以帮您?

对应源码:android/usage.kt。实际效果请在自己的宿主中按下方验收项核对。

预期结果:按钮进入可信客服页;开始语音才申请录音。账号切换须关闭旧 Activity,仍需 Android 工程编译。

实际接待范围

容器承载现有 /support 页面:当前读取最近 100 条消息,尚未接线显式转人工按钮与更早历史翻页。人工接待沿服务端路由进入。页面能打开不代表宿主、文件与真实接待已验收。

本平台能力边界

开始语音时申请系统录音权限,仅向当前可信来源授予 AUDIO_CAPTURE,拒绝摄像头和未知资源。使用渠道 Web 语音,需同步更新 /support。无后台通话、ConnectionService、厂商推送或附件原生保存桥。

怎样确认接入成功

  1. 从自己的 App 入口发送一条带唯一标记的测试问题,确认收到回复,并在接待台找到同一企业、入口和会话。仅页面打开或编译成功不能代替这一步。
  2. 真机验收允许/拒绝录音、授权中退出、AI 出声与打断、挂断释放、前后台/锁屏/电话中断、耳机、弱网、旋转和账号切换。
  3. 退出 A 账号后用 B 账号重新进入,确认 B 看不到 A 的内容;挂断或离开页面后确认录音指示消失。

没有成功时先检查

现象下一步
页面打不开 / 连接被拒绝先核对 HTTPS 证书、origin 与同一入口的 key / entryId,再检查入口是否启用及来源限制;不要关闭安全校验绕过问题。
页面打开但没有回复检查入口接待方案是否绑定已发布智能体、模型是否可用;在接待台按测试标记查找会话,确认是否已转人工。
文字可用,但无法语音检查企业和入口是否开启语音、系统录音权限与网页授权是否都满足;由用户主动点击开始,分别确认实际收音、AI 出声和挂断释放。

继续接入与配置

官方原始接入文档

先按云蝠指南完成入口、智能体和服务配置,再按下列官方原文配置宿主权限或供应商资源。外部文档说明对应平台能力,不代表云蝠已开放其中全部接口;腾讯 SecretKey、签名密钥和管理 API Key 仅放服务端。参数、地域、类目和资费以官方当前页面及账号实际开通结果为准。

实现依据 · 仓库内路径
  • sdk/client-kit/android/YunfuSupportActivity.kt
  • sdk/client-kit/README.md

文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。