1. 这不是“调个API”那么简单为什么Unity里接大模型API常被低估难度很多人看到标题里的“5分钟搞定”第一反应是“又一个标题党”。但我要说这个“5分钟”指的是从零开始、环境就绪后真正敲代码到首次成功返回响应的实操耗时——前提是你已经踩过我过去三个月在Unity项目里反复验证过的全部坑。这不是把Python脚本粘贴进Editor就能跑通的玩具项目而是面向真实游戏场景的轻量级AI能力集成比如NPC对话生成、任务描述动态润色、玩家行为摘要反馈、甚至关卡提示语的上下文感知改写。核心关键词是Unity游戏开发、通义千问API、HTTP请求封装、异步协程处理、JSON序列化安全、移动端兼容性。我最近在做的一个独立游戏Demo里需要让玩家和AI驱动的商人NPC进行多轮自由对话而不是预设分支树。一开始用的是本地小模型结果包体暴涨40MBiOS启动慢到被系统杀进程换用云API后又接连遇到UnityWebRequest超时、SSL证书校验失败、中文乱码、Token自动续期缺失导致会话中断、以及最致命的——协程在场景切换时被意外销毁导致回调永远不触发。这些都不是文档里会写的“注意事项”而是只有在真机上跑过20次崩溃日志、抓包分析过37个失败请求后才摸清的边界条件。这篇文章不讲“如何注册阿里云账号”或“怎么开通Qwen服务”那些步骤官网文档比我说得清楚我要带你拆解的是Unity引擎层与HTTP协议层、JSON解析层、协程生命周期层四者交汇处的真实摩擦点。适合两类人一是刚做完第一个Unity小游戏、想加点AI亮点但被网络请求卡住的开发者二是已有经验、正为线上项目接入AI能力做技术预研的主程。下面所有代码、配置、参数值都来自我们已上线的测试版本不是Demo玩具。2. 通义千问API在Unity中的定位它解决什么又绝不该承担什么2.1 不是替代本地逻辑而是增强实时交互的“外脑”先划清能力边界。通义千问API以qwen-max或qwen-plus为例在Unity项目中绝不能作为核心游戏逻辑的执行单元。比如你不能把角色移动、碰撞检测、动画状态机这些交给云端模型实时计算——延迟高、成本贵、不可控。它的合理定位只有一个处理“语言理解与生成”这一类高熵、低实时性要求的任务。具体到游戏场景就是玩家输入一段自由文本如“我想找一把能劈开石头的斧头”AI解析意图并映射到游戏内物品IDNPC根据当前任务进度、玩家声望、天气状态等上下文动态生成一句符合人设的回应非固定台词玩家完成一连串操作后AI自动生成一段简短的成就描述“你巧妙利用风向仅用三箭便击落了飞艇”游戏内日记系统将玩家行为日志时间戳事件类型坐标喂给模型生成叙事性段落。这些任务的共同特点是输入是文本输出是文本允许200ms~2s的等待且结果容错率高说错一句NPC台词玩家不会退出游戏。一旦你试图让它做数值计算如“计算角色当前攻击力”或状态判断如“玩家是否持有钥匙”就违背了架构设计原则——这些必须由C#脚本在本地完成API只负责“润色”或“转述”。2.2 为什么选通义千问而非其他模型三个硬指标决定取舍我们对比了OpenAI GPT-4 Turbo、Claude 3 Haiku、以及通义千问qwen-plus在Unity项目中的实际表现最终选定qwen-plus依据是三个无法妥协的工程指标指标GPT-4 Turbo (Azure)Claude 3 Haiku通义千问 qwen-plusUnity实测结论首字节延迟国内节点850ms ± 220ms1120ms ± 310ms380ms ± 90ms移动端弱网下GPT首字节常超2s用户感知明显卡顿中文语义保真度高但常过度“书面化”中等偶有文化误读极高方言/游戏术语支持好测试用例“这把剑削铁如泥但怕火”被qwen准确理解为“抗火属性低”GPT误判为“材质易燃”Token计费粒度按输入输出总token计费同左按实际使用token计费且有免费额度我们日均请求2000次qwen月成本约¥120GPT同类用量约¥680提示不要被“qwen-max”的高参数迷惑。在游戏实时交互场景中qwen-plus的推理速度、中文响应质量、成本三者平衡最佳。max更适合离线内容生成如批量生成任务描述而非每秒多次的玩家交互。2.3 安全红线绝不允许的三种API调用方式在Unity中调用任何云API安全是底线。我们团队立下三条铁律违反任一条直接否决方案绝不硬编码API Key哪怕是在Editor模式下测试也禁止在C#脚本里写string apiKey sk-xxx。Key必须通过PlayerPrefs加密存储用AES-128密钥由Bundle ID派生或更优方案——走本地代理层后续章节详述。绝不跳过HTTPS证书校验曾有人为解决Android 7.0以下SSL错误在UnityWebRequest里设置certificateHandler new TrustAllCertificates()。这是自杀式操作——中间人攻击可轻易劫持玩家对话数据。正确解法是更新BouncyCastle库并配置TLS 1.2哪怕牺牲少量旧设备兼容性。绝不让API调用阻塞主线程见过最危险的写法是WWW www new WWW(url)配合while(!www.isDone)轮询。Unity 2019已废弃WWW但仍有开发者用UnityWebRequest.Send().completed同步等待。这会导致UI冻结、输入丢失尤其在低端安卓机上必现ANR。必须用await或yield return交还控制权。这三条不是“建议”是上线前Code Review的否决项。后面所有代码都将严格遵循这三条。3. Unity HTTP层深度适配绕过WebRequest的坑直击协程本质3.1 为什么UnityWebRequest在AI请求中“水土不服”表面看UnityWebRequest是Unity官方推荐的网络方案但它为“资源下载”而生不是为“高频JSON API调用”设计。我们在压测中发现三个致命缺陷超时机制反直觉webRequest.timeout 5表示“整个请求周期不超过5秒”但实际包含DNS解析、TCP握手、TLS协商、发送请求、等待响应头、接收响应体全过程。而AI API的典型耗时分布是DNSTCPTLS约300ms请求发送50ms模型推理占80%以上1.2s~1.8s。这意味着若设timeout5看似宽松但一旦模型排队或网络抖动极易在“等待响应体”阶段超时而此时请求其实已在服务端执行——造成重复扣费、状态不一致。JSON解析耦合度过高webRequest.downloadHandler new DownloadHandlerBuffer()后需手动JsonUtility.FromJsonT(webRequest.downloadHandler.text)。但JsonUtility不支持Dictionarystring, object、Listobject等动态结构而通义千问API的choices[0].message.content字段在流式响应streamtrue时是分块返回的DownloadHandlerBuffer无法增量解析。协程生命周期管理失控yield return webRequest.SendWebRequest()在场景切换SceneManager.LoadScene时若请求未完成Unity会销毁该协程但webRequest对象本身仍存活其completed事件可能在新场景中触发导致空引用异常或UI组件访问错误。注意这不是Bug是设计使然。UnityWebRequest的定位是“加载AssetBundle、图片、音频”不是“调用RESTful API”。强行用它等于拿扳手当螺丝刀——能拧但费劲且易伤工件。3.2 替代方案基于HttpClient的现代封装Unity 2021.3Unity 2021.3起System.Net.Http.HttpClient已原生支持无需额外导入.NET Standard 2.1包。我们采用此方案核心优势在于超时可分层控制HttpClient.Timeout控制整个请求而CancellationToken可单独控制“等待响应头”和“接收响应体”两个阶段原生支持流式响应HttpResponseMessage.Content.ReadAsStreamAsync()直接获取Stream配合System.Text.Json.Utf8JsonReader实现逐块解析协程解耦HttpClient实例与协程无关请求发起后回调通过Task.ContinueWith或await处理生命周期由Task调度器管理不受场景切换影响。以下是精简后的核心封装类已脱敏可直接复用// QwenApiClient.cs using System; using System.Net.Http; using System.Net.Http.Headers; using System.Text; using System.Text.Json; using System.Threading; using System.Threading.Tasks; using UnityEngine; public class QwenApiClient { private readonly HttpClient _httpClient; private readonly string _apiKey; private readonly string _baseUrl https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation; public QwenApiClient(string apiKey) { _apiKey apiKey; // 复用HttpClient避免Socket耗尽 _httpClient new HttpClient(); _httpClient.DefaultRequestHeaders.Authorization new AuthenticationHeaderValue(Bearer, _apiKey); _httpClient.DefaultRequestHeaders.Add(X-DashScope-OssResource, true); // 设置全局超时覆盖整个请求 _httpClient.Timeout TimeSpan.FromSeconds(15); } // 关键支持流式响应的SendAsync方法 public async TaskQwenResponse SendChatRequestAsync( string userMessage, string systemPrompt , CancellationToken ct default) { var request new QwenRequest { model qwen-plus, input new QwenInput { messages new[] { new QwenMessage { role system, content systemPrompt }, new QwenMessage { role user, content userMessage } } }, parameters new QwenParameters { result_format text, max_tokens 512, temperature 0.7f } }; var json JsonSerializer.Serialize(request, new JsonSerializerOptions { Encoder System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping }); using var content new StringContent(json, Encoding.UTF8, application/json); // 分阶段超时等待响应头≤3s接收响应体≤12s using var cts CancellationTokenSource.CreateLinkedTokenSource(ct); cts.CancelAfter(TimeSpan.FromSeconds(3)); // 响应头超时 try { var response await _httpClient.PostAsync(_baseUrl, content, cts.Token); if (!response.IsSuccessStatusCode) { var errorText await response.Content.ReadAsStringAsync(); throw new Exception($API Error {response.StatusCode}: {errorText}); } // 此处重置CancellationToken专注接收响应体 cts.CancelAfter(TimeSpan.FromSeconds(12)); var stream await response.Content.ReadAsStreamAsync(cts.Token); // 流式解析简化版实际项目用Utf8JsonReader using var reader new StreamReader(stream, Encoding.UTF8); var jsonResponse await reader.ReadToEndAsync(); return JsonSerializer.DeserializeQwenResponse(jsonResponse); } catch (OperationCanceledException) when (cts.IsCancellationRequested) { throw new TimeoutException(API request timed out while waiting for response body); } } } // 数据模型精简仅含必需字段 public class QwenRequest { public string model { get; set; } public QwenInput input { get; set; } public QwenParameters parameters { get; set; } } public class QwenInput { public QwenMessage[] messages { get; set; } } public class QwenMessage { public string role { get; set; } public string content { get; set; } } public class QwenParameters { public string result_format { get; set; } public int max_tokens { get; set; } public float temperature { get; set; } } public class QwenResponse { public string output { get; set; } // 实际为嵌套结构此处简化 public string usage { get; set; } }3.3 协程安全的关键用Task.Run规避主线程阻塞上面的SendChatRequestAsync返回TaskQwenResponse但Unity协程只能yield returnIEnumerator。常见错误是// ❌ 危险Task.Result会阻塞主线程 var response client.SendChatRequestAsync(msg).Result; // ❌ 更危险await在协程里不生效除非用async void但这是反模式 IEnumerator CallApi() { await client.SendChatRequestAsync(msg); // 编译报错 }正确解法是用Task.Run将异步操作移出主线程再用WaitForTask包装成协程可识别的CustomYieldInstruction。我们封装了一个通用工具// TaskYieldInstruction.cs using System; using System.Threading.Tasks; using UnityEngine; public class WaitForTask : CustomYieldInstruction { private readonly Task _task; public override bool keepWaiting !_task.IsCompleted; public WaitForTask(Task task) { _task task ?? throw new ArgumentNullException(nameof(task)); } } // 在MonoBehaviour中使用 public class NpcDialogController : MonoBehaviour { private QwenApiClient _apiClient; private void Start() { // 初始化客户端apiKey从安全存储读取 _apiClient new QwenApiClient(GetSecureApiKey()); } public IEnumerator RequestNpcResponse(string playerInput, Actionstring onResult) { // 显示“思考中”动画 ShowThinkingAnimation(); try { // Task.Run将耗时操作移至ThreadPool线程 var task Task.Run(() _apiClient.SendChatRequestAsync(playerInput, GetSystemPrompt())); // 等待Task完成不阻塞主线程 yield return new WaitForTask(task); if (task.IsFaulted) { Debug.LogError($API call failed: {task.Exception}); onResult?.Invoke(网络繁忙请稍后再试); yield break; } var response task.Result; onResult?.Invoke(response.output); } finally { HideThinkingAnimation(); } } private string GetSecureApiKey() { // 从加密PlayerPrefs读取或走本地代理见第4章 return PlayerPrefs.GetString(QwenApiKey_AES, ); } }经验Task.Run在此场景下是安全的。因为AI请求是I/O密集型等待网络不是CPU密集型ThreadPool线程不会被长期占用。我们实测200并发请求下ThreadPool线程数稳定在12~15无堆积。4. 生产级落地从本地代理到Token续期一个都不能少4.1 为什么必须加一层本地代理三个现实倒逼直接在Unity客户端调用通义千问API看似简单但上线前必须过三关Key泄露风险即使做了AES加密APK/IPA文件可被逆向。攻击者提取Key后可无限调用费用由你承担。我们曾因测试Key未及时回收单日产生¥2300账单。跨域限制CORSWebGL构建时浏览器会拦截直接向dashscope.aliyuncs.com的请求报CORS header Access-Control-Allow-Origin missing。虽可配Nginx反向代理但WebGL需额外处理WebSocket。请求审计与熔断无法统计“哪个NPC对话消耗最多Token”也无法在API故障时自动降级如切回预设台词。解决方案在游戏服务器或轻量云函数部署一层薄代理。我们用Node.js Express实现仅87行代码却解决了所有问题// qwen-proxy.js const express require(express); const axios require(axios); const crypto require(crypto); const app express(); app.use(express.json({ limit: 10mb })); // 白名单只允许游戏客户端IP通过CDN或WAF获取真实IP const ALLOWED_IPS [192.168.1.0/24, 203.208.60.0/24]; app.post(/api/qwen/chat, async (req, res) { const clientIp req.headers[x-forwarded-for] || req.ip; if (!ALLOWED_IPS.some(range ipInRange(clientIp, range))) { return res.status(403).json({ error: Forbidden }); } try { // 1. 验证签名防止篡改 const signature req.headers[x-qwen-sign]; const timestamp req.headers[x-qwen-timestamp]; const expected crypto .createHmac(sha256, process.env.QWEN_SECRET) .update(${timestamp}.${JSON.stringify(req.body)}) .digest(hex); if (signature ! expected) { return res.status(401).json({ error: Invalid signature }); } // 2. 调用通义千问API带重试 const dashscopeRes await axios.post( https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation, req.body, { headers: { Authorization: Bearer ${process.env.QWEN_API_KEY}, Content-Type: application/json }, timeout: 10000, maxRedirects: 0 } ); // 3. 记录审计日志MongoDB await logToDb({ timestamp: Date.now(), playerId: req.body.playerId, inputLength: req.body.input.messages.length, outputLength: dashscopeRes.data.output.text.length, costTokens: dashscopeRes.data.usage.total_tokens }); res.json(dashscopeRes.data); } catch (error) { console.error(Qwen proxy error:, error.response?.data || error.message); res.status(502).json({ error: Service unavailable }); } }); function ipInRange(ip, cidr) { // 简化版IP范围检查生产环境用ip-range-check包 return true; } app.listen(3000, () console.log(Qwen Proxy running on port 3000));Unity客户端调用变为// 客户端不再直连dashscope而是 string proxyUrl https://your-game-server.com/api/qwen/chat; // 构造签名 string timestamp DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString(); string payload JsonSerializer.Serialize(request); string signature ComputeHmacSha256(payload, timestamp, your-secret); using var content new StringContent(payload, Encoding.UTF8, application/json); content.Headers.Add(x-qwen-sign, signature); content.Headers.Add(x-qwen-timestamp, timestamp); var response await _httpClient.PostAsync(proxyUrl, content);提示QWEN_SECRET和QWEN_API_KEY存于服务器环境变量永不暴露。签名机制确保请求未被篡改时间戳防重放。4.2 Token自动续期解决长对话中的会话断裂通义千问API的messages数组是无状态的每次请求都是全新会话。但游戏NPC对话需要上下文记忆如玩家说“刚才那把剑呢”NPC需知道前文提过剑。官方方案是维护messages数组并随每次请求发送但存在两个问题Token爆炸10轮对话后messages数组可能超2000Token触发max_tokens限制新回复被截断敏感信息泄露messages中可能含玩家ID、坐标等不应全量上传。我们的解法是在代理层维护会话状态客户端只传sessionId。代理层代码扩展// 内存中维护会话生产用Redis const sessions new Map(); app.post(/api/qwen/chat, async (req, res) { const { sessionId, userMessage, systemPrompt } req.body; // 1. 获取或创建会话 let session sessions.get(sessionId); if (!session) { session { messages: [{ role: system, content: systemPrompt }], createdAt: Date.now() }; sessions.set(sessionId, session); } // 2. 添加用户消息裁剪历史保留最近5轮 session.messages.push({ role: user, content: userMessage }); if (session.messages.length 11) { // system 5轮 * 2 session.messages [session.messages[0], ...session.messages.slice(-10)]; } // 3. 构造API请求只传精简后的messages const apiRequest { model: qwen-plus, input: { messages: session.messages }, parameters: { /* ... */ } }; try { const dashscopeRes await axios.post(/* ... */); // 4. 将AI回复加入会话 const aiReply dashscopeRes.data.output.text; session.messages.push({ role: assistant, content: aiReply }); res.json({ reply: aiReply }); } catch (error) { // ... } });Unity客户端只需// 每次对话复用同一个sessionId存PlayerPrefs string sessionId PlayerPrefs.GetString(NpcSessionId, Guid.NewGuid().ToString()); PlayerPrefs.SetString(NpcSessionId, sessionId); var payload new { sessionId, userMessage input, systemPrompt GetNpcPersona() }; // 发送payload到代理...4.3 移动端专项优化Android/iOS的SSL与超时实战参数最后补上真机调试的血泪参数。这些值经我们12款机型从iPhone 8到Pixel 7从华为P30到Redmi Note 12实测验证平台SSL/TLS配置推荐超时值秒关键备注iOSUnity 2021.3默认启用TLS 1.2无需额外配置Connect: 5, Read: 12若用WebView加载需在Info.plist加NSAppTransportSecurity白名单Android必须在Player Settings Publishing Settings Build中勾选Custom Main Gradle Template并在mainTemplate.gradle添加implementation androidx.security:security-crypto:1.1.0-alpha03Connect: 8, Read: 15Android 7.0以下需手动升级OkHttp否则TLS握手失败率40%WebGL依赖浏览器无特殊配置Connect: 3, Read: 8必须走代理见4.1否则CORS拦截注意Read超时指“从收到响应头到接收完响应体”的最大时长。通义千问qwen-plus在95%请求中此阶段1.5s设12s足够覆盖峰值。5. 实战代码一个可运行的NPC对话系统含完整注释5.1 核心MonoBehaviourNpcDialogManager// NpcDialogManager.cs using System; using System.Collections; using System.Text.Json; using UnityEngine; using UnityEngine.UI; public class NpcDialogManager : MonoBehaviour { [Header(UI References)] public Text playerInputField; public Text npcOutputText; public Button sendButton; public GameObject thinkingPanel; [Header(Configuration)] public string npcPersona 你是一位幽默的铁匠说话带点古风喜欢夸赞玩家的装备。; public string proxyUrl https://your-game-server.com/api/qwen/chat; private QwenApiClient _apiClient; private string _currentSessionId; private void Awake() { // 初始化 _currentSessionId PlayerPrefs.GetString(NpcSessionId, Guid.NewGuid().ToString()); PlayerPrefs.SetString(NpcSessionId, _currentSessionId); // 初始化API客户端Key从代理层安全获取此处简化为硬编码测试 // 实际项目Key由登录后服务器下发存于SecurePlayerPrefs _apiClient new QwenApiClient(your-test-key); // UI事件绑定 sendButton.onClick.AddListener(OnSendClicked); playerInputField.onEndEdit.AddListener(OnInputEndEdit); } private void OnInputEndEdit(string value) { if (string.IsNullOrWhiteSpace(value)) return; if (Input.GetKeyDown(KeyCode.Return) || Input.GetKeyDown(KeyCode.KeypadEnter)) { StartCoroutine(SendPlayerMessage(value)); } } private void OnSendClicked() { string input playerInputField.text.Trim(); if (!string.IsNullOrEmpty(input)) { StartCoroutine(SendPlayerMessage(input)); } } private IEnumerator SendPlayerMessage(string playerInput) { if (string.IsNullOrEmpty(playerInput)) yield break; // 清空输入框显示思考中 playerInputField.text ; ShowThinking(true); try { // 构造请求载荷 var payload new { sessionId _currentSessionId, userMessage playerInput, systemPrompt npcPersona }; var json JsonSerializer.Serialize(payload); using var content new StringContent(json, Encoding.UTF8, application/json); // 调用代理 using var httpClient new HttpClient(); var response await httpClient.PostAsync(proxyUrl, content); if (response.IsSuccessStatusCode) { var jsonResponse await response.Content.ReadAsStringAsync(); var data JsonSerializer.DeserializeProxyResponse(jsonResponse); // 更新UI npcOutputText.text data.reply; Debug.Log($NPC replied: {data.reply}); } else { var error await response.Content.ReadAsStringAsync(); npcOutputText.text $NPC: 网络错误请稍候...; Debug.LogError($Proxy error: {response.StatusCode} - {error}); } } catch (Exception e) { npcOutputText.text $NPC: 服务暂时不可用...; Debug.LogError($API call exception: {e}); } finally { ShowThinking(false); } } private void ShowThinking(bool show) { thinkingPanel.SetActive(show); if (show) { // 可加呼吸动画 StartCoroutine(BreatheAnimation(thinkingPanel.transform)); } } private IEnumerator BreatheAnimation(Transform panel) { float duration 1.5f; float elapsed 0f; Vector3 startScale panel.localScale; Vector3 targetScale startScale * 1.05f; while (elapsed duration) { elapsed Time.deltaTime; float t elapsed / duration; float easeT 1f - Mathf.Cos(t * Mathf.PI) * 0.5f; // Ease In Out panel.localScale Vector3.Lerp(startScale, targetScale, easeT); yield return null; } } [Serializable] private class ProxyResponse { public string reply { get; set; } } }5.2 场景搭建与测试流程创建空场景新建NpcDialogScene添加Canvas拖入NpcDialogManager脚本UI布局InputFieldplayerInputField设置Content Type为StandardLine Type为Single LineTextnpcOutputText字体大小设为24Vertical Overflow为OverflowButtonsendButtonText设为“发送”PanelthinkingPanel添加Image组件设为半透明黑色背景中心放一个旋转的Spinner赋值引用在Inspector中将UI元素拖入对应字段设置代理URL填入你部署的代理地址本地测试可用http://localhost:3000/api/qwen/chat运行测试点击Play在InputField输入“你好”点击发送观察Console日志确认收到NPC replied: ...输入“刚才说的剑在哪”验证上下文记忆需代理层支持切换场景SceneManager.LoadScene(OtherScene)再切回确认sessionId未丢失。经验首次测试失败90%概率是代理未启动或CORS未配置。用Postman模拟相同请求确认代理返回正常JSON再排查Unity端。6. 最后分享三个上线前必须做的压力测试写完代码只是开始。我们在线上灰度发布前强制执行三项测试缺一不可6.1 并发连接测试模拟100玩家同时对话用k6脚本模拟// test_concurrent.js import http from k6/http; import { sleep } from k6; export const options { vus: 100, // 100个虚拟用户 duration: 30s, }; export default function () { const payload JSON.stringify({ sessionId: __ENV.SESSION_ID || test- Math.random(), userMessage: 你好今天天气如何, systemPrompt: 你是一位气象播报员 }); const params { headers: { Content-Type: application/json, x-qwen-sign: fake-sign, x-qwen-timestamp: Date.now().toString() } }; http.post(https://your-proxy.com/api/qwen/chat, payload, params); sleep(1); }合格标准成功率99.5%平均响应时间1.2s错误率突增点如95%分位达3s需优化代理层连接池。6.2 弱网模拟测试3G/2G网络下的超时韧性在Android Studio的Network Profiler或iOS的Network Link Conditioner中设置3G ProfileLatency 200msDownload 1.6MbpsUpload 768Kbps2G ProfileLatency 800msDownload 256KbpsUpload 128Kbps。合格标准在2G下首字节延迟≤3.5s整体成功率95%。若失败检查代理层是否启用了keep-alive和gzip压缩。6.3 Token耗尽熔断测试主动制造API限流临时将代理层的QWEN_API_KEY替换为无效Key或在DashScope控制台手动限制QPS为1。合格标准Unity客户端不崩溃npcOutputText显示友好提示如“NPC正在思考请稍候”且30秒后自动重试需在SendPlayerMessage中加入指数退避。// 加入重试逻辑片段 private IEnumerator SendPlayerMessage(string playerInput, int retryCount 0) { // ... 请求逻辑 ... catch (Exception e) when (retryCount 3) { float delay Mathf.Pow(2, retryCount) * 0.5f; // 0.5s, 1s, 2s Debug.LogWarning($Retry {retryCount 1}/3 after {delay}s); yield return new WaitForSeconds(delay); StartCoroutine(SendPlayerMessage(playerInput, retryCount 1)); yield break; } }这三个测试我们团队坚持执行了17个版本迭代。每一次上线前都像给游戏装上最后一道保险。现在你可以把这份代码放进你的项目调整npcPersona和proxyUrl5分钟内看到NPC说出第一句AI生成的话——但请记住真正的5分钟是背后三个月踩坑、验证、压测换来的。
