1. 老项目里的 ViewFlipper 轮播页怎么接上 AI 能力ViewFlipper 是 Android 里一个挺老但很稳的轮播组件继承自 FrameLayout靠showNext()、showPrevious()在多个子 View 之间切换配合setFlipInterval()和startFlipping()就能自动轮播。很多存量项目里的引导页、公告栏、卡片流还在用它切换逻辑本身没什么问题真正让人头疼的是现在想给这些轮播页加一点 AI 能力比如让某一屏展示的内容由模型动态生成、或者给用户一个「换一批」的智能推荐按钮结果发现 Key 到处散落——这个工具一个 Key那个 SDK 一个 Token配置文件东一份西一份改一次环境要翻五个文件。这篇就聚焦这个场景不改动 ViewFlipper 原有的切换逻辑只在外围加一层统一的 Key 与 API 通道配置让轮播页能发起一次 AI 请求并拿到结果。核心思路是把模型调用收敛到 TaoToken 这一条通道上用一份settings.json和一份config.toml作为配置骨架Android 侧只负责读配置、发请求、把返回文本塞进当前屏的 TextView。适合谁看手里有 ViewFlipper 老代码、想低成本试水 AI 能力、又不想把项目配置搞成一团乱麻的 Android 开发者。我试过在一个三屏轮播的 Demo 上跑通整条链路从拿 Key 到看到模型返回大概十几分钟。下面把每一步拆开讲。2. TaoToken 前置统一 Key 与 API 通道是什么TaoToken 在这里扮演的角色是一个统一的模型调用入口。你不需要为每个模型或每个工具单独维护一套鉴权信息而是拿一个 Key走同一个 API 地址后面想换模型、加模型改配置就行代码基本不动。对 ViewFlipper 这种「只想在某一屏加个 AI 小功能」的场景来说这种收敛特别省事——轮播逻辑照旧AI 调用是旁路。先做两件前置的事。第一拿到 Key。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台里创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建完先复制保存后面配置里要用。第二确认 API 基地址。统一走 https://taotoken.net/api 注意这个地址后面不加任何查询参数请求时路径拼在它后面即可。如果你用的是兼容 OpenAI 风格的调用方式基地址就是它模型名按文档里支持的填。注意Key 属于敏感信息别硬编码进 APK也别提交到 Git。下面配置骨架里我会用占位符你替换成自己的。想先验证 Key 是否可用、模型是否通可以直接用模型对话页试一句https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。如果后面你要做长期的编码或 Agent 类任务可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。3. 可复制配置settings.json 与 config.toml 骨架配置分两份各管一摊。settings.json放在 Android 工程的 assets 目录负责运行时读取的通道参数config.toml放在项目根或构建脚本旁边负责构建期/工具链层面的统一声明。两份都只是骨架字段按需增减。3.1 settings.json运行时读取的通道参数这份文件放app/src/main/assets/settings.jsonApp 启动时读进来解析出 baseUrl、apiKey、model 三个核心字段。轮播页发起请求时直接用这些值不散落在各个 Activity 里。{ ai: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-替换成你的Key, model: 替换成文档里支持的模型名, timeoutMs: 20000, maxTokens: 256 }, flipper: { autoStart: false, flipIntervalMs: 3000 } }字段说明用表格对照一下更清楚字段作用建议值provider标识走哪条通道taotokenbaseUrlAPI 基地址https://taotoken.net/apiapiKey鉴权 Key控制台创建model调用的模型名按文档填timeoutMs请求超时20000maxTokens单次返回上限256 够轮播文案用flipIntervalMs轮播间隔与原有逻辑保持一致flipper这一段是为了让配置集中实际切换逻辑还是走 ViewFlipper 自己的setFlipInterval()这里只是给个默认值来源不改原有行为。3.2 config.toml构建期与工具链的统一声明config.toml放项目根目录给构建脚本、CI 或本地工具读。它不参与 App 运行时但能让「Key 从哪来、地址是什么」在工程层面有唯一出处避免有人手改 assets 里的 json 造成不一致。[ai] provider taotoken base_url https://taotoken.net/api # 不要把真实 Key 写进版本库用环境变量注入 api_key_env TAOTOKEN_API_KEY model 替换成文档里支持的模型名 timeout_ms 20000 max_tokens 256 [flipper] auto_start false flip_interval_ms 3000构建时可以用脚本把api_key_env指向的环境变量写进 assets 的settings.json这样真实 Key 只存在于本地环境或 CI 的 secret 里仓库里永远是占位符。这一步不做也能跑但做了之后配置混乱的问题才算真正解决。3.3 Android 侧读取配置的代码在 Application 或首个 Activity 里读一次缓存成单例。下面是最小实现object AiConfig { var baseUrl: String var apiKey: String var model: String var timeoutMs: Long 20000 fun load(context: Context) { val json context.assets.open(settings.json) .bufferedReader().use { it.readText() } val root JSONObject(json).getJSONObject(ai) baseUrl root.getString(baseUrl) apiKey root.getString(apiKey) model root.getString(model) timeoutMs root.optLong(timeoutMs, 20000) } }这段只做读取不碰 ViewFlipper。轮播页的切换代码一行都不用改。4. 验证请求在轮播页发起一次 AI 调用目标很明确在 ViewFlipper 的某一屏上点一下按钮把当前屏的 TextView 内容换成模型返回的文本。切换逻辑还是原来的showNext()AI 调用是附加动作。4.1 布局里加一个触发按钮在 ViewFlipper 的某一屏里加个按钮id 叫btn_ai旁边放个 TextView 显示结果。其余两屏不动。LinearLayout android:orientationvertical android:layout_widthfill_parent android:layout_heightfill_parent Button android:idid/btn_ai android:textAI 换一批 android:layout_widthfill_parent android:layout_heightwrap_content / TextView android:idid/tv_ai_result android:layout_widthfill_parent android:layout_heightwrap_content android:text等待请求 / /LinearLayout4.2 用 OkHttp 发一次请求请求走baseUrl /v1/chat/completions这种兼容路径具体路径以文档为准。下面用 OkHttp 演示放在按钮点击里private fun requestAi() { val client OkHttpClient.Builder() .connectTimeout(AiConfig.timeoutMs, TimeUnit.MILLISECONDS) .readTimeout(AiConfig.timeoutMs, TimeUnit.MILLISECONDS) .build() val body JSONObject().apply { put(model, AiConfig.model) put(max_tokens, 256) put(messages, JSONArray().apply { put(JSONObject().apply { put(role, user) put(content, 用一句话介绍 Android ViewFlipper 的用途) }) }) } val request Request.Builder() .url(${AiConfig.baseUrl}/v1/chat/completions) .addHeader(Authorization, Bearer ${AiConfig.apiKey}) .addHeader(Content-Type, application/json) .post(body.toString().toRequestBody(application/json.toMediaType())) .build() client.newCall(request).enqueue(object : Callback { override fun onFailure(call: Call, e: IOException) { runOnUiThread { tvAiResult.text 请求失败: ${e.message} } } override fun onResponse(call: Call, response: Response) { val text response.body?.string().orEmpty() runOnUiThread { tvAiResult.text text } } }) }按钮绑定findViewByIdButton(R.id.btn_ai).setOnClickListener { requestAi() }注意这里没有动mViewFlipper的任何一行。轮播该自动播还自动播该手势切还手势切AI 请求是独立的一条线。4.3 成功结果长什么样请求成功后tv_ai_result会显示返回的 JSON里面choices[0].message.content就是模型生成的文本。把它解析出来塞进 TextView用户看到的就是一句关于 ViewFlipper 的介绍。整个过程轮播页的切换动画、间隔、手势都没受影响。如果你在模型对话页先试过同样的 prompt返回风格应该是一致的说明通道是通的。5. 本篇常见错排查接入过程里容易踩的坑集中在配置和请求两块列几个高频的。Key 读不到或为空。最常见的是 assets 里的settings.json没打包进去或者文件名大小写不对。检查app/src/main/assets/下确实有文件且AiConfig.load()在用到之前被调用过。如果 Key 是从环境变量注入的确认构建脚本真的执行了替换。401 或鉴权失败。多半是Authorization头拼错正确格式是Bearer加 Key中间一个空格。也可能是 Key 复制时带了空格或换行。去 API Keys 页面重新复制一次粘贴后检查首尾。请求地址拼错。baseUrl是https://taotoken.net/api后面拼具体路径。别在 baseUrl 末尾多加斜杠也别把/api漏掉。路径以文档为准不同接口路径不同。超时或连接失败。先确认设备网络正常再确认timeoutMs没设得太短。轮播页如果同时开了自动轮播频繁请求可能叠加建议 AI 请求做成手动触发别放进startFlipping()的循环里。返回 JSON 解析崩了。模型返回结构可能和预期不同解析前先判空、判字段存在。上面示例里直接显示原始文本是为了调试正式用要加 try-catch。改了配置但没生效。assets 里的文件在安装后不会自动更新改完要重新构建安装。如果用了缓存单例确认重新加载逻辑。6. 把配置收敛之后轮播页的 AI 能力就好维护了回头看这件事的价值ViewFlipper 的切换逻辑是稳定的、不该动的AI 能力是新增的、可能频繁调整的。把 Key 和 API 通道收敛到settings.json与config.toml两份骨架里等于给「会变的部分」划了一块独立区域轮播代码和模型调用解耦。以后换模型、加超时、调参数改配置就行不用在 Activity 里翻来翻去。如果你只是想让轮播页能调通一次模型按第 3、4 节走完就够了。如果后面要做更重的编码或 Agent 类任务可以看 Coding Plan接入过程中遇到鉴权或路径问题优先查 API Keys 和接入文档。配置骨架先跑通再谈扩展比一上来就堆功能稳得多。