《虚拟现实脚本与策划》教案-四-2-知识点1：网络传输开发

任务2AI数字人功能开发任务描述适配岗位与职责本任务围绕AI数字人功能开发展开，学习网络传输与API使用，实现语音输入、语音转文字、文字聊天、文字转语音等功能，最终完成AI对话模块的搭建。岗位：VR开发工程师职责：VR项目开发学习目标知识目标：掌握网络传输开发与API

Key

的基础使用方法。了解麦克风语音输入、语音转文字、文字转语音的

API

调用逻辑。熟悉AI

对话模块的整体架构与实现流程。能力目标：能独立完成API

Key

配置与基础网络请求开发。具备AI

对话模块的搭建、调试与优化能力。可实现语音输入、文字交互、语音输出的完整功能链路。素质目标：养成规范的API

调用与数据安全意识。培养模块化开发、分步调试的工程思维。学习重难点重点：API

Key

配置与语音转文字、文字转语音的接口调用。AI

对话模块的功能整合与交互流程实现。难点：多

API

模块联动的逻辑串联与异常情况处理。操作步骤职业知识网络传输开发常见概念API（接口）API：不同系统之间“对话”的标准化通道。大模型（如豆包、GPT）部署在厂商服务器上，程序不能直接拿到模型，只能通过HTTP/HTTPS

请求调用它的能力：发一段文本→

服务器返回一段回答。对Unity

来说，就是用WebRequest

/

HTTP

Client

发JSON

请求到厂商给定的URL。APIKey（接口密钥/访问密钥）API

Key：一串随机字符串（类似sk-xxx

/

ARK-xxx），是调用大模型的身份证+

钥匙。作用：1.身份认证：证明你是平台注册用户；2.权限控制：能调用哪些模型、是否能用语音/

图文；3.计费&

用量统计：按这个Key

统计使用了多少Token。类似：银行卡密码，不能公开。Token（词元）Token：大模型处理文本的最小单位（可以是字、词、子词）。鉴权火山方舟/豆包：请求头里带Authorization:Bearer{APIKey}火山引擎；有的平台用签名、时间戳；原因是每次请求必须带上合法凭证，否则返回401/403

拒绝服务。效果预览步骤1：界面效果预览UI面板关键交互组件集成用户输入框、一键发送按钮、自动滚动的对话视图，以及支持动态加载的聊天气泡预制体，打造流畅的即时通讯体验WebRequest方法介绍WebRequest是.NET框架（C#）中用于发起HTTP/HTTPS/文件/FTP网络请求的抽象基类，属于System.Net命名空间，是.NET早期标准网络请求工具，用来代替底层Socket，简化网页、接口数据获取。APIKey变量介绍APIKey是调用接口的专属密钥，用作身份验证，控制接口访问权限。设为变量是为了统一管理、方便更换、避免密钥硬编码泄露，一般通过请求头或URL参数传入接口请求。ModelId介绍ModelId是大模型服务商给每一个AI模型分配的唯一标识字符串。调用API时通过该变量指定要使用哪一款模型（如gpt-3.5-turbo、glm-4等），搭配APIKey一同发起请求，切换模型只需修改此ID变量。步骤2：鉴权和环境变量打开脚本，找到网络请求部分找到100行左右WebRequest核心作用：Unity引擎中用于发起HTTP/HTTPS网络请求的基础类，支持GET、POST等协议，是实现客户端与后端服务数据交互的底层入口。鉴权配置逻辑：在协程`StreamDouBaoChat`中，通过`SetRequestHeader`方法为请求添加身份凭证，这是通过服务端安全校验的必要步骤。环境变量APIKey与核心参数配置在ds.cs脚本头部可配置关键变量，是实现AI对话的基础：ChatApiKey：你的专属API身份密钥，用于接口鉴权ChatModelId：指定要调用的AI模型版本或标识ChatUrl：AI服务的接口请求地址，指向后端服务步骤3：对话预览打开DSScene，找到LLM3，运行场景输入框输入文字即可提问核心交互体验：支持自然语言即时提问，AI以流式打字机效果动态返回结果，对话气泡左右分区布局，清晰区分用户与AI角色提升交互清晰感与便捷性。查看返回内容可视化实时预览AI返回文本展示效果拖动聊天框查看历史记录实时查看流式输出的回答与历史对话记录面板组件变量脚本内通过公开变量统一管理AI接口、UI组件、过滤关键词三类配置，在Unity检视面板可视化赋值，无需修改代码即可完成项目配置。网络传输原理步骤1：发送文字Input点击发送时间调用OnSendText方法点击发送按钮触发OnSendText方法，完整执行用户消息预处理、界面渲染、网络请求三步流程：发送消息方法SendChatMessageSendChatMessage是对话请求中转方法，负责初始化状态并启动协程执行流式网络请求对话请求方法StreamDoubaoChat协程方法，完整封装流式POST网络请求全流程：步骤2：更新UIUpdateChatUI该方法负责实时刷新AI回复对话界面，搭配内容过滤方法完成流式文本渲染请求的数据结构核心：结构化的请求实体为实现与API的精准通信，需严格定义数据载体类：1.DouBaoRequest：顶层请求类，封装模型ID、对话上下文列表及关键配置；2.DouBaoMessage：单轮消息类，明确角色与具体文本内容，确保请求结构与方舟API文档完全匹配。工作任务验收步骤1：检查是否理解AI数字人对话模块中的逻辑原理，理解数据发送，接收的过程。步骤2：检查是否了解该