1. 为什么要在 HoloLens 工程里统一管理 AI Key做 HoloLens MRTK 项目的人大概率都遇到过这种局面场景里挂了一堆脚本有的负责语音指令转文字有的负责把识别结果丢给大模型做意图理解还有的负责把模型返回的文本渲染到空间面板上。每个脚本各自持有一份 API Key散落在 Inspector 面板、ScriptableObject、甚至硬编码在 C# 里。项目一旦换人接手或者需要把 Key 从测试环境切到正式环境就得满工程翻找改漏一处就报 401。更麻烦的是 HoloLens 2 的部署方式。它跑的是 UWP应用打包成 AppX 后运行时的工作目录和编辑器里完全不一样。你在 Unity Editor 里用Application.dataPath拼出来的路径到了设备上直接失效。所以配置文件放哪儿、怎么读本身就是个需要提前想清楚的问题。这篇笔记聚焦一个具体环节在 MRTK 工程里用一份settings.json作为统一 Key 通道把 AI 工具凭据集中管理起来并演示一次从 Unity 发出的验证请求确认 Key 生效、通道可用。适合已经在做 HoloLens 开发、手里有 MRTK 工程、需要接入大模型能力的开发者。读完你能拿到一份可直接复制的配置骨架以及一套在 Editor 和 HoloLens 设备上都能跑通的读取逻辑。TaoToken 在这里扮演的角色是统一入口你不需要在工程里维护多个厂商的 Key而是通过一个兼容 OpenAI 风格的基础地址把对话、编码等能力收敛到同一套凭据体系下。官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。2. TaoToken 前置准备Key 与通道地址在动 Unity 工程之前先把通道侧的事情办完。这一步不涉及 HoloLens纯浏览器操作。打开 https://taotoken.net/api-keys 登录后创建一个 API Key。建议按项目命名比如hololens-mrtk-demo方便后面在settings.json里对应。创建完立刻复制页面刷新后就看不到了。通道地址固定为https://taotoken.net/api这是 OpenAI 兼容风格的基础地址。也就是说你在 Unity 里发请求时拼接的完整 URL 是https://taotoken.net/api/v1/chat/completions。注意/api后面接/v1不要写成/api/v1/v1。如果你还想在浏览器里先确认模型能正常对话可以打开 https://taotoken.net/model-conversation 试一句确认账号状态没问题。这一步不是必须的但能帮你排除「Key 本身有问题」和「Unity 代码有问题」这两类故障。注意Key 只显示一次建议创建后立刻写入你的密码管理器或本地临时文件不要直接贴进聊天窗口或截图。3. settings.json 骨架与字段说明现在进入工程侧。在 Unity 项目的Assets/StreamingAssets/目录下新建一个settings.json。选 StreamingAssets 的原因是它在 Editor 和 HoloLens 设备上都能通过Application.streamingAssetsPath访问UWP 打包后这个目录会随应用一起进包读取方式统一。骨架如下{ ai: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: gpt-4o-mini, timeoutSeconds: 30, maxRetries: 2 }, app: { environment: development, logLevel: info } }字段逐个说清楚provider是标识字段方便你以后扩展多个通道时做分支判断当前固定写taotoken。baseUrl是通道基础地址写https://taotoken.net/api不要带末尾斜杠。代码里拼接路径时统一用baseUrl /v1/chat/completions。apiKey就是第 2 步拿到的 Key。这里有个安全习惯不要把真实 Key 提交到 Git。可以在.gitignore里排除settings.json然后提交一份settings.example.json作为模板。model是默认模型名。不同模型名对应不同能力具体可用列表以通道文档为准。写一个你确认可用的即可。timeoutSeconds是 UnityWebRequest 的超时时间。HoloLens 上网络抖动比 PC 明显建议不低于 30 秒。maxRetries是重试次数。网络类错误重试有意义鉴权类错误重试没意义代码里要区分。app.environment和app.logLevel是应用侧字段和 AI 无关但放在同一份文件里能减少配置文件数量。对应的 C# 数据类[Serializable] public class AiSettings { public string provider; public string baseUrl; public string apiKey; public string model; public int timeoutSeconds; public int maxRetries; } [Serializable] public class AppSettings { public string environment; public string logLevel; } [Serializable] public class RootSettings { public AiSettings ai; public AppSettings app; }读取逻辑放在一个静态类里Editor 和设备共用using System.IO; using UnityEngine; public static class SettingsLoader { public static RootSettings Load() { string path Path.Combine(Application.streamingAssetsPath, settings.json); if (!File.Exists(path)) { Debug.LogError($settings.json not found at {path}); return null; } string json File.ReadAllText(path); return JsonUtility.FromJsonRootSettings(json); } }这里有个坑要提前说在 HoloLens 的 UWP 环境下File.ReadAllText对 StreamingAssets 的读取在部分 Unity 版本上会失败因为 StreamingAssets 在 UWP 里可能不是普通文件系统路径。稳妥做法是用UnityWebRequest读using System.Collections; using UnityEngine; using UnityEngine.Networking; public static class SettingsLoader { public static IEnumerator LoadAsync(System.ActionRootSettings onDone) { string path Path.Combine(Application.streamingAssetsPath, settings.json); using (UnityWebRequest req UnityWebRequest.Get(path)) { yield return req.SendWebRequest(); if (req.result ! UnityWebRequest.Result.Success) { Debug.LogError($load settings failed: {req.error}); onDone?.Invoke(null); yield break; } var settings JsonUtility.FromJsonRootSettings(req.downloadHandler.text); onDone?.Invoke(settings); } } }Editor 下UnityWebRequest.Get对本地文件路径也支持所以这一套代码两边都能跑不用写条件编译。4. 发起一次验证请求确认 Key 生效配置读到了接下来验证通道。写一个最小请求脚本挂在场景里任意 GameObject 上运行后看 Console。using System.Collections; using System.Text; using UnityEngine; using UnityEngine.Networking; public class TaoTokenProbe : MonoBehaviour { private RootSettings _settings; private IEnumerator Start() { yield return SettingsLoader.LoadAsync(s _settings s); if (_settings null || _settings.ai null) { Debug.LogError(settings load failed); yield break; } yield return SendProbe(); } private IEnumerator SendProbe() { string url _settings.ai.baseUrl.TrimEnd(/) /v1/chat/completions; var body new { model _settings.ai.model, messages new[] { new { role user, content reply with the single word: ok } }, max_tokens 8 }; string json JsonUtility.ToJson(new Wrapper { model body.model, messages new[] { new Msg { role user, content reply with the single word: ok } }, max_tokens body.max_tokens }); using (UnityWebRequest req new UnityWebRequest(url, POST)) { byte[] payload Encoding.UTF8.GetBytes(json); req.uploadHandler new UploadHandlerRaw(payload); req.downloadHandler new DownloadHandlerBuffer(); req.SetRequestHeader(Content-Type, application/json); req.SetRequestHeader(Authorization, Bearer _settings.ai.apiKey); req.timeout _settings.ai.timeoutSeconds; yield return req.SendWebRequest(); if (req.result ! UnityWebRequest.Result.Success) { Debug.LogError($probe failed: {req.responseCode} {req.error}\n{req.downloadHandler.text}); yield break; } Debug.Log($probe ok: {req.downloadHandler.text}); } } [System.Serializable] private class Msg { public string role; public string content; } [System.Serializable] private class Wrapper { public string model; public Msg[] messages; public int max_tokens; } }运行后Console 里应该出现类似这样的返回{ id: chatcmpl-xxx, object: chat.completion, choices: [ { index: 0, message: { role: assistant, content: ok }, finish_reason: stop } ] }看到content里有ok说明三件事同时成立settings.json被正确读取、Key 通过鉴权、通道地址可达。如果这一步在 Editor 里过了再打包到 HoloLens 上跑一次确认设备侧网络和路径也没问题。提示HoloLens 设备需要联网。首次部署时建议先用 USB 连接确认网络配置再走无线部署。5. 本篇常见错排查报 401 Unauthorized九成是 Key 问题。检查settings.json里的apiKey有没有多余空格检查请求头是不是Bearer加 Key注意Bearer后面有一个空格。另外确认 Key 没有在别处被删除或重置。报 404 Not FoundURL 拼错了。常见错误是baseUrl末尾带了斜杠代码里又拼了一个变成//v1/chat/completions或者把/api和/v1的顺序写反。正确形式是https://taotoken.net/api/v1/chat/completions。Editor 里能跑HoloLens 上报文件找不到说明用了File.ReadAllText而不是UnityWebRequest。UWP 下 StreamingAssets 的访问方式不同统一用第 3 节的异步读取方案。请求一直挂起直到超时HoloLens 网络环境问题或者timeoutSeconds设得太短。先在设备浏览器里访问一个普通网页确认网络通再排查代码。JsonUtility 解析返回为空JsonUtility对嵌套结构和数组的支持有限返回体里的choices数组如果字段名和你的类对不上就会解析成默认值。建议先用Debug.Log(req.downloadHandler.text)把原始文本打出来确认字段名后再写对应的数据类。Key 泄露风险如果settings.json已经提交到 Git立刻在控制台重置 Key然后把文件加入.gitignore改用settings.example.json模板加本地覆盖的方式。6. 后续接入与凭据管理建议settings.json这套骨架跑通之后工程里所有需要 AI 能力的模块都可以从同一个RootSettings实例取配置不再各自维护 Key。语音转文字、意图理解、空间面板文本生成共用一份baseUrl和apiKey换环境时只改一个文件。如果你后续要在工程里做更长期的编码类任务比如让 Agent 持续调用模型完成多步操作可以了解 Coding Plan 相关的通道配置地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 里面有各语言的最小请求示例和本篇的 Unity 版本可以对照看。凭据管理上我的习惯是settings.json只放本地仓库里放settings.example.jsonKey 按项目隔离一个 HoloLens 工程一个 Key方便单独吊销控制台地址 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 里可以随时查看和重置。这样即使某台设备上的包被反编译损失也能控制在单个 Key 范围内。