1. 老項(xiàng)目里的 ViewFlipper 輪播頁(yè)怎么接上 AI 能力ViewFlipper 是 Android 里一個(gè)挺老但很穩(wěn)的輪播組件繼承自 FrameLayout靠showNext()、showPrevious()在多個(gè)子 View 之間切換配合setFlipInterval()和startFlipping()就能自動(dòng)輪播。很多存量項(xiàng)目里的引導(dǎo)頁(yè)、公告欄、卡片流還在用它切換邏輯本身沒(méi)什么問(wèn)題真正讓人頭疼的是現(xiàn)在想給這些輪播頁(yè)加一點(diǎn) AI 能力比如讓某一屏展示的內(nèi)容由模型動(dòng)態(tài)生成、或者給用戶一個(gè)「換一批」的智能推薦按鈕結(jié)果發(fā)現(xiàn) Key 到處散落——這個(gè)工具一個(gè) Key那個(gè) SDK 一個(gè) Token配置文件東一份西一份改一次環(huán)境要翻五個(gè)文件。這篇就聚焦這個(gè)場(chǎng)景不改動(dòng) ViewFlipper 原有的切換邏輯只在外圍加一層統(tǒng)一的 Key 與 API 通道配置讓輪播頁(yè)能發(fā)起一次 AI 請(qǐng)求并拿到結(jié)果。核心思路是把模型調(diào)用收斂到 TaoToken 這一條通道上用一份settings.json和一份config.toml作為配置骨架Android 側(cè)只負(fù)責(zé)讀配置、發(fā)請(qǐng)求、把返回文本塞進(jìn)當(dāng)前屏的 TextView。適合誰(shuí)看手里有 ViewFlipper 老代碼、想低成本試水 AI 能力、又不想把項(xiàng)目配置搞成一團(tuán)亂麻的 Android 開(kāi)發(fā)者。我試過(guò)在一個(gè)三屏輪播的 Demo 上跑通整條鏈路從拿 Key 到看到模型返回大概十幾分鐘。下面把每一步拆開(kāi)講。2. TaoToken 前置統(tǒng)一 Key 與 API 通道是什么TaoToken 在這里扮演的角色是一個(gè)統(tǒng)一的模型調(diào)用入口。你不需要為每個(gè)模型或每個(gè)工具單獨(dú)維護(hù)一套鑒權(quán)信息而是拿一個(gè) Key走同一個(gè) API 地址后面想換模型、加模型改配置就行代碼基本不動(dòng)。對(duì) ViewFlipper 這種「只想在某一屏加個(gè) AI 小功能」的場(chǎng)景來(lái)說(shuō)這種收斂特別省事——輪播邏輯照舊AI 調(diào)用是旁路。先做兩件前置的事。第一拿到 Key。打開(kāi)官網(wǎng) https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注冊(cè)后在控制臺(tái)里創(chuàng)建 API Key。控制臺(tái)地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理頁(yè)在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。創(chuàng)建完先復(fù)制保存后面配置里要用。第二確認(rèn) API 基地址。統(tǒng)一走 https://taotoken.net/api 注意這個(gè)地址后面不加任何查詢(xún)參數(shù)請(qǐng)求時(shí)路徑拼在它后面即可。如果你用的是兼容 OpenAI 風(fēng)格的調(diào)用方式基地址就是它模型名按文檔里支持的填。注意Key 屬于敏感信息別硬編碼進(jìn) APK也別提交到 Git。下面配置骨架里我會(huì)用占位符你替換成自己的。想先驗(yàn)證 Key 是否可用、模型是否通可以直接用模型對(duì)話頁(yè)試一句https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。如果后面你要做長(zhǎng)期的編碼或 Agent 類(lèi)任務(wù)可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入細(xì)節(jié)看文檔https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。3. 可復(fù)制配置settings.json 與 config.toml 骨架配置分兩份各管一攤。settings.json放在 Android 工程的 assets 目錄負(fù)責(zé)運(yùn)行時(shí)讀取的通道參數(shù)config.toml放在項(xiàng)目根或構(gòu)建腳本旁邊負(fù)責(zé)構(gòu)建期/工具鏈層面的統(tǒng)一聲明。兩份都只是骨架字段按需增減。3.1 settings.json運(yùn)行時(shí)讀取的通道參數(shù)這份文件放app/src/main/assets/settings.jsonApp 啟動(dòng)時(shí)讀進(jìn)來(lái)解析出 baseUrl、apiKey、model 三個(gè)核心字段。輪播頁(yè)發(fā)起請(qǐng)求時(shí)直接用這些值不散落在各個(gè) Activity 里。{ ai: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-替換成你的Key, model: 替換成文檔里支持的模型名, timeoutMs: 20000, maxTokens: 256 }, flipper: { autoStart: false, flipIntervalMs: 3000 } }字段說(shuō)明用表格對(duì)照一下更清楚字段作用建議值provider標(biāo)識(shí)走哪條通道taotokenbaseUrlAPI 基地址https://taotoken.net/apiapiKey鑒權(quán) Key控制臺(tái)創(chuàng)建model調(diào)用的模型名按文檔填timeoutMs請(qǐng)求超時(shí)20000maxTokens單次返回上限256 夠輪播文案用flipIntervalMs輪播間隔與原有邏輯保持一致flipper這一段是為了讓配置集中實(shí)際切換邏輯還是走 ViewFlipper 自己的setFlipInterval()這里只是給個(gè)默認(rèn)值來(lái)源不改原有行為。3.2 config.toml構(gòu)建期與工具鏈的統(tǒng)一聲明config.toml放項(xiàng)目根目錄給構(gòu)建腳本、CI 或本地工具讀。它不參與 App 運(yùn)行時(shí)但能讓「Key 從哪來(lái)、地址是什么」在工程層面有唯一出處避免有人手改 assets 里的 json 造成不一致。[ai] provider taotoken base_url https://taotoken.net/api # 不要把真實(shí) Key 寫(xiě)進(jìn)版本庫(kù)用環(huán)境變量注入 api_key_env TAOTOKEN_API_KEY model 替換成文檔里支持的模型名 timeout_ms 20000 max_tokens 256 [flipper] auto_start false flip_interval_ms 3000構(gòu)建時(shí)可以用腳本把a(bǔ)pi_key_env指向的環(huán)境變量寫(xiě)進(jìn) assets 的settings.json這樣真實(shí) Key 只存在于本地環(huán)境或 CI 的 secret 里倉(cāng)庫(kù)里永遠(yuǎn)是占位符。這一步不做也能跑但做了之后配置混亂的問(wèn)題才算真正解決。3.3 Android 側(cè)讀取配置的代碼在 Application 或首個(gè) Activity 里讀一次緩存成單例。下面是最小實(shí)現(xiàn)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。輪播頁(yè)的切換代碼一行都不用改。4. 驗(yàn)證請(qǐng)求在輪播頁(yè)發(fā)起一次 AI 調(diào)用目標(biāo)很明確在 ViewFlipper 的某一屏上點(diǎn)一下按鈕把當(dāng)前屏的 TextView 內(nèi)容換成模型返回的文本。切換邏輯還是原來(lái)的showNext()AI 調(diào)用是附加動(dòng)作。4.1 布局里加一個(gè)觸發(fā)按鈕在 ViewFlipper 的某一屏里加個(gè)按鈕id 叫btn_ai旁邊放個(gè) TextView 顯示結(jié)果。其余兩屏不動(dòng)。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等待請(qǐng)求 / /LinearLayout4.2 用 OkHttp 發(fā)一次請(qǐng)求請(qǐng)求走baseUrl /v1/chat/completions這種兼容路徑具體路徑以文檔為準(zhǔn)。下面用 OkHttp 演示放在按鈕點(diǎn)擊里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 請(qǐng)求失敗: ${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() }注意這里沒(méi)有動(dòng)mViewFlipper的任何一行。輪播該自動(dòng)播還自動(dòng)播該手勢(shì)切還手勢(shì)切AI 請(qǐng)求是獨(dú)立的一條線。4.3 成功結(jié)果長(zhǎng)什么樣請(qǐng)求成功后tv_ai_result會(huì)顯示返回的 JSON里面choices[0].message.content就是模型生成的文本。把它解析出來(lái)塞進(jìn) TextView用戶看到的就是一句關(guān)于 ViewFlipper 的介紹。整個(gè)過(guò)程輪播頁(yè)的切換動(dòng)畫(huà)、間隔、手勢(shì)都沒(méi)受影響。如果你在模型對(duì)話頁(yè)先試過(guò)同樣的 prompt返回風(fēng)格應(yīng)該是一致的說(shuō)明通道是通的。5. 本篇常見(jiàn)錯(cuò)排查接入過(guò)程里容易踩的坑集中在配置和請(qǐng)求兩塊列幾個(gè)高頻的。Key 讀不到或?yàn)榭铡Ｗ畛Ｒ?jiàn)的是 assets 里的settings.json沒(méi)打包進(jìn)去或者文件名大小寫(xiě)不對(duì)。檢查app/src/main/assets/下確實(shí)有文件且AiConfig.load()在用到之前被調(diào)用過(guò)。如果 Key 是從環(huán)境變量注入的確認(rèn)構(gòu)建腳本真的執(zhí)行了替換。401 或鑒權(quán)失敗。多半是Authorization頭拼錯(cuò)正確格式是Bearer加 Key中間一個(gè)空格。也可能是 Key 復(fù)制時(shí)帶了空格或換行。去 API Keys 頁(yè)面重新復(fù)制一次粘貼后檢查首尾。請(qǐng)求地址拼錯(cuò)。baseUrl是https://taotoken.net/api后面拼具體路徑。別在 baseUrl 末尾多加斜杠也別把/api漏掉。路徑以文檔為準(zhǔn)不同接口路徑不同。超時(shí)或連接失敗。先確認(rèn)設(shè)備網(wǎng)絡(luò)正常再確認(rèn)timeoutMs沒(méi)設(shè)得太短。輪播頁(yè)如果同時(shí)開(kāi)了自動(dòng)輪播頻繁請(qǐng)求可能疊加建議 AI 請(qǐng)求做成手動(dòng)觸發(fā)別放進(jìn)startFlipping()的循環(huán)里。返回 JSON 解析崩了。模型返回結(jié)構(gòu)可能和預(yù)期不同解析前先判空、判字段存在。上面示例里直接顯示原始文本是為了調(diào)試正式用要加 try-catch。改了配置但沒(méi)生效。assets 里的文件在安裝后不會(huì)自動(dòng)更新改完要重新構(gòu)建安裝。如果用了緩存單例確認(rèn)重新加載邏輯。6. 把配置收斂之后輪播頁(yè)的 AI 能力就好維護(hù)了回頭看這件事的價(jià)值ViewFlipper 的切換邏輯是穩(wěn)定的、不該動(dòng)的AI 能力是新增的、可能頻繁調(diào)整的。把 Key 和 API 通道收斂到settings.json與config.toml兩份骨架里等于給「會(huì)變的部分」劃了一塊獨(dú)立區(qū)域輪播代碼和模型調(diào)用解耦。以后換模型、加超時(shí)、調(diào)參數(shù)改配置就行不用在 Activity 里翻來(lái)翻去。如果你只是想讓輪播頁(yè)能調(diào)通一次模型按第 3、4 節(jié)走完就夠了。如果后面要做更重的編碼或 Agent 類(lèi)任務(wù)可以看 Coding Plan接入過(guò)程中遇到鑒權(quán)或路徑問(wèn)題優(yōu)先查 API Keys 和接入文檔。配置骨架先跑通再談擴(kuò)展比一上來(lái)就堆功能穩(wěn)得多。