附录 A · 术语表
术语按主题分类,每条给出定义、适用条件和正文回链。接口行为与版本限制以相应官方文档为准。
VRChat
社交 VR 平台,用户上传虚拟世界和化身后供他人加入。客户端跑在 PC(Windows)、Meta Quest,以及移动端 iOS / Android。
首次出现:第 2 章 · VRChat 这家公司和这个引擎。
VRChat Inc.
平台开发公司,2014 年由 Graham Gaylor 和 Jesse Joudrey 创立,2017 年 Steam Early Access 上线。
首次出现:第 2 章 · Unity 与 VRChat 的分工。
Worlds(世界)
能站进去的虚拟空间。Unity 项目通过 Worlds SDK 打包成 .vrcw 文件后上传。本书全程讲 Worlds。
首次出现:第 2 章 · Worlds 与 Avatars。
Avatars(化身)
玩家套在身上的形象。通过 Avatars SDK 打包成 .vrca。本书不讲 Avatars。
首次出现:第 2 章。
Worlds SDK / Avatars SDK
两套独立 SDK,对应两类项目。一个 Unity 项目里二选一。
首次出现:第 2 章 · Worlds 与 Avatars。
com.vrchat.base / com.vrchat.worlds
Worlds 项目使用的官方包。base 提供共用工具,worlds 提供世界组件、Udon、UdonSharp 与 ClientSim。SDK 3.10.5 的 ClientSim 位于 Worlds 包内部,旧独立包名不代表还需额外安装。
首次出现:第 2 章。
SDK1 / SDK2 / SDK3
SDK 的三代。SDK1(2017–2019)依赖 Animator 状态机;SDK2(2018–2020)用 VRC_Trigger 可视化触发器;SDK3(2020 至今)引入 Udon。新世界只能用 SDK3,老教程出现 VRC_Trigger 字样基本是 SDK2 的。
首次出现:第 2 章。
Booth / Gumroad
第三方数字商品销售平台。购买前分别检查商品内容、版本、许可、交付与退款条件。
首次出现:第 2 章 · 社区资源的作用。适用 SDK3.x。
Udon 与脚本运行时
Section titled “Udon 与脚本运行时”.NET
包含运行时、类库、编译器与开发工具的软件开发平台。C# 是编程语言,运行时负责执行与内存管理,类库提供字符串、集合等现成功能;Unity 2022.3 使用自身集成的 Mono / IL2CPP 后端与 API 配置,并不等同于安装最新版 .NET。UdonSharp 又把受支持的 C# 转成 Udon 程序,不能据此调用全部 .NET 类库。
参考:第 2 章、Microsoft .NET、Unity 中的 .NET。
Mono
.NET 生态的一种实现,也是 Unity 2022.3 的脚本后端之一;与 IL2CPP 的编译方式不同。用户世界里的 UdonSharp 程序仍走 Udon 编译与运行流程。
参考:Unity 脚本后端。
Udon
VRChat 世界的脚本系统,包含虚拟机、事件与可调用 API。用户编写的 UdonSharp 程序转换成 Udon 程序后执行;这不表示客户端内部和所有 SDK 组件都由 Udon 实现。
首次出现:第 2 章 · UdonSharp 写法与 Udon 执行环境。
UdonSharp
将受支持的 C# 语法转换为 Udon Assembly 的编译器。本书自定义世界脚本采用它;可用语法和 API 受编译器与 Udon 暴露范围限制。
首次出现:第 2 章。
Udon Graph
Udon 的可视化连线编辑器,编译产物和 UdonSharp 相同。本书不用。
首次出现:第 2 章。
Udon Assembly
Udon 程序的文本汇编表示,经组装后由 Udon 虚拟机执行;它不是普通 .NET 程序的 IL。
首次出现:第 2 章。
字节码(Bytecode)
供虚拟机执行的指令表示,区别于人编写的源代码和 CPU 原生机器指令。Udon Assembly 是汇编文本,生成的 Udon 程序由 Udon VM 执行。
首次出现:第 2 章 · UdonSharp 写法与 Udon 执行环境。
虚拟机(VM, Virtual Machine)
执行特定指令集的程序。Udon VM 执行 Udon 程序;Unity 的 Mono / IL2CPP 脚本后端和普通 .NET 运行时是不同层面的执行机制。
首次出现:第 2 章。
沙箱(Sandbox)
限制程序可调用的 API、文件和网络访问范围的执行环境。Udon 只暴露获准使用的能力;Class Exposure Tree 是查看 API 暴露情况的工具,并非单独执行安全隔离的组件。
首次出现:第 2 章 · Unity 与 VRChat 的分工。
Class Exposure Tree
Udon 允许调用的 .NET / Unity API 白名单。不在白名单上的 API(System.IO.File.Delete、System.Net.HttpClient、反射、LINQ 等)调用会被编译器拦下。async / await、自定义泛型类这类属于 UdonSharp 编译器限制,查附录 D。
首次出现:第 2 章。详细限制见附录 D · UdonSharp 限制。
UdonSharpBehaviour
用 UdonSharp 编写世界运行时逻辑时继承的基类。移植普通 Unity 脚本不仅需改基类,还需检查 API、语法、序列化与事件是否受支持。
首次出现:第 11 章 · C# 刚好够用。
MonoBehaviour
Unity 脚本组件的基类。普通 Unity 脚本不能因此直接作为用户上传的 VRChat 世界代码运行;UdonSharp 自定义世界逻辑使用 UdonSharpBehaviour。
首次出现:第 11 章 · C# 刚好够用。
编程基础与 C# 语法(第 10–11 章)
Section titled “编程基础与 C# 语法(第 10–11 章)”变量(Variable)
保存带类型数据的命名位置。例如 int score = 0; 声明整数变量 score,初值为 0。
首次出现:第 10 章 · 把动作写成明确步骤。
条件判断 if / else
根据布尔条件选择执行分支,例如按 player.isLocal 判断事件涉及的是否为本地玩家。
首次出现:第 10 章、第 11 章 · 控制流:if / else / for / while。
循环 for / while / foreach
把一段事重复做。for 适合「重复固定次数」,while 适合「直到某条件不成立才停」。UdonSharp 官方文档列出支持 foreach,本书示例在需要索引时使用 for。
首次出现:第 10 章、第 11 章。
函数 / 方法(Function / Method)
把一组操作定义为可调用的程序单元,可包含参数和返回值。脚本中的 Start、Interact 都是方法。
首次出现:第 10 章 · 方法组织一组动作、第 11 章 · 方法、参数和返回值。
类(Class)
把相关的字段和方法装在一起的容器。一个 .cs 文件通常就是一个类,VRChat 世界脚本里这个类继承自 UdonSharpBehaviour。
首次出现:第 10 章 · 类归拢字段与方法、第 11 章 · 一段完整的灯光开关脚本。
字段(Field)
类里直接写出来的变量,访问范围由修饰符决定。可序列化的 public 字段或带 SerializeField 的私有字段可在 Inspector 配置。
首次出现:第 11 章 · 字段、访问范围与序列化。
局部变量(Local Variable)
方法内部 { ... } 里临时声明的变量,方法跑完就消失。生命周期短、不出现在 Inspector。
首次出现:第 11 章。
int / float / bool / string
C# 基础类型。int 整数,float 带小数点的浮点数(写值要加 f,例如 1.5f),bool 真假,string 文字。
首次出现:第 11 章 · 变量和类型。
Vector3
表示 3D 空间里一个位置或方向的结构体,含 x / y / z 三个 float。transform.position、Networking.LocalPlayer.GetPosition() 都是 Vector3。
首次出现:第 11 章。
null
”什么都不指向”的特殊值。Inspector 引用槽空着、GameObject.Find 没找到时都会得到 null,再去 .something 就会抛 NullReferenceException。
首次出现:第 11 章 · 引用其他物体。
public / private / [SerializeField]
public 与 private 是访问修饰符;SerializeField 是序列化特性。可序列化的 public 字段或带 SerializeField 的 private 字段可在 Inspector 配置,私有字段仍限制其他类直接访问。
首次出现:第 11 章 · 字段、访问范围与序列化。
using 指令
例如 using UnityEngine; 允许代码省略相应命名空间前缀。出现类型名无法解析时,检查命名空间、程序集引用和类型拼写。
首次出现:第 11 章 · 一段完整的灯光开关脚本。
Start() / Update()
Unity 生命周期方法。Start 在物体启用后第一帧调一次,常用来初始化引用;Update 在启用期间逐帧调用,频繁操作需测量成本。
首次出现:第 11 章。
大驼峰 / 小驼峰(PascalCase / camelCase)
C# 命名约定:类名、方法名、public 字段用大驼峰(GameManager、Interact、PlayerCount);局部变量、private 字段用小驼峰(playerCount、localScore)。
首次出现:第 11 章 · 语句、代码块和注释。
Time.deltaTime
上一帧到这一帧之间过了多少秒。脚本里要做”每秒移动 N 米”这类与时间挂钩的运算就乘以它,否则会被高帧率显卡跑得过快。
首次出现:第 11 章。
Mathf
Unity 的数学工具静态类,提供 Mathf.Clamp、Mathf.Lerp、Mathf.Sin 等常用函数。在 Udon 白名单内,可以直接用。
首次出现:第 11 章。
GameObject.Find
按名字在场景里搜物体的方法。性能差且容易因改名失效,VRChat 项目里通常改用 [SerializeField] 在 Inspector 拖引用。
首次出现:第 11 章 · 引用其他物体。
[Tooltip]
字段上方加的 attribute,会让 Inspector 鼠标悬浮时显示一行说明文字。给协作者或几个月后的自己留提示用。
首次出现:第 11 章 · 字段、访问范围与序列化。
UdonSharp 限制与替代写法(第 12 章)
Section titled “UdonSharp 限制与替代写法(第 12 章)”SendCustomEventDelayedSeconds
UdonSharpBehaviour 自带的延时事件方法。传入方法名和延迟秒数后,Udon 虚拟机在那么多秒后调用那个方法。async / await 和协程在 UdonSharp 不可用,“过 N 秒之后做某事”统一写它。
首次出现:第 12 章 · 语言特性需要逐项核对。
Coroutine / yield return
普通 Unity 项目里写「等一段时间再继续做」的协程机制,依赖 IEnumerator 和 yield return new WaitForSeconds(...)。UdonSharp 不支持 yield,看到这种写法要翻译成 SendCustomEventDelayedSeconds。
首次出现:第 12 章。
DataList / DataDictionary(VRC.SDK3.Data)
VRChat SDK 提供的动态列表和键值字典,能装混合类型数据,是 UdonSharp 里 List<T> / Dictionary<TKey, TValue> 的替代品。当前 UdonSharp 集合只支持数组 T[],需要动态长度时用它。
首次出现:第 12 章 · 用合适的数据结构保存多项数据。
DataToken
DataList / DataDictionary 里每个元素的盒子。取值时用 .Int、.String、.Boolean 等属性把原始类型解出来。
首次出现:第 12 章。
Plugins/ 目录
Unity 的特殊资源目录,其脚本编译规则还受程序集定义影响。把 C# 文件移入 Plugins 不会绕过 Udon API 或语法限制;当前 UdonSharp 支持的静态方法无需靠该目录解锁。
首次出现:第 12 章 · 源码与程序资产的关联。
UdonSharpProgramAsset
关联 UdonSharp 源脚本与编译后 Udon 程序的编辑期资产。出现资产与脚本类型不匹配的错误时,应核对关联,而非把所有工具类搬入 Plugins。
首次出现:第 12 章。
Player Persistence API
VRChat SDK 3.7.4 起提供的玩家数据持久化通道,让世界保存少量玩家相关字段并跨实例读取。沙箱不让脚本读写本地文件,需要持久化时走它。
首次出现:第 12 章 · API 开放范围。
VRCUrl / VRCStringDownloader
VRChat 提供的受限 URL 类型与字符串下载工具。世界要从外部地址读文本只能走这套通道,普通 System.Net.* 调不到。官方 String Loading 文档列出一组可信域名;不在列表里的地址,需要玩家在设置中允许不受信任 URL 才会下载。
首次出现:第 12 章。
工具链与项目
Section titled “工具链与项目”VCC(VRChat Creator Companion)
VRChat 官方项目管理工具,可创建项目、管理 VRChat SDK / VPM 包并配置 Unity 安装。
首次出现:第 4 章 · 装好工具,准备出发。
Unity Hub
Unity 自家的版本管理器,管理本机已安装的多个 Unity 编辑器版本。配合 VCC 使用。
首次出现:第 4 章 · 工具的分工。
Unity Editor
编辑场景、资源和组件并调用 SDK 构建的工具。本书按 VRChat 官方支持的 Unity 版本配置。
首次出现:第 4 章。
Unity 支持版本
VRChat 指定内容构建所用的 Unity 版本,以官方 Current Unity Version 页面与 VCC 检查结果为准。客户端内部版本、兼容政策与构建要求不能只用“版本字符串必须完全相等”概括。
首次出现:第 4 章 · 第二步:安装支持的 Unity 版本。理由见 理解章 A · 那 Unity 编辑器版本为什么要钉死。
LTS(Long Term Support,长期维护版本)
Unity 的长期支持版本系列。支持周期与更新政策以 Unity 对该系列的说明为准;VRChat 内容构建另受官方指定版本要求约束。
首次出现:第 2 章 · 版本与平台。
ClientSim
随 Worlds SDK 提供的编辑器模拟工具,可在 Unity Play Mode 检查部分玩家行为。它不能替代 VRChat 客户端、多客户端网络与目标设备测试。
首次出现:第 2 章。详细用法见第 41 章 · 测试你的世界。
Library/PackageCache
Unity 项目下的本地缓存目录,Unity 编译时会高频读写。不要进 git,不要被网盘同步。
首次出现:第 4 章 · 第三步:创建 World 项目。
MAX_PATH 限制
部分传统 Win32 文件 API 使用 260 字符路径上限;应用是否支持长路径还取决于系统与程序设置。缩短项目路径可降低缓存路径超限风险,中文字符本身不等于 .NET 不支持。
首次出现:第 4 章。
构建与发布管线
Section titled “构建与发布管线”YAML
一种纯文本的结构化格式,主打人类可读,用缩进表示层级。Unity 的 .unity 场景文件、.prefab 文件、.meta 文件都是 YAML 写的,因此可以用文本编辑器打开看,也能在 git 里做有意义的 diff。
首次出现:理解章 A · Unity 场景,本质是一份引用清单。
BuildPipeline
Unity 的构建系统。VRChat SDK 调用它把场景及依赖打成 AssetBundle。
首次出现:理解章 A · 打包:Unity AssetBundle。
AssetBundle
Unity 自有的二进制资源打包格式。VRChat 世界文件 .vrcw 内层就是它,外层套 VRChat 元信息。
首次出现:理解章 A。
IL2CPP
Unity 的脚本后端之一:将托管程序集的中间语言转换为 C++,再提前编译为平台原生代码。它不负责把用户 UdonSharp 世界脚本转换成 Udon 程序。
首次出现:理解章 A · 那 Unity 编辑器版本为什么要钉死。
图形 API(Graphics API)
GPU 听得懂的指令规范,由操作系统/硬件厂商定义,让上层引擎用同一套语义控制不同显卡。常见的有 Direct3D(D3D11 / D3D12,Windows)、Vulkan(跨平台)、OpenGL ES(移动端,Quest 用)、Metal(macOS / iOS)。Shader 在打包时会被编译成这些 API 各自的字节码。
首次出现:理解章 A · 打包:Unity AssetBundle。
.vrcw
World 包文件后缀。AssetBundle + VRChat 元信息(世界名、容量、PC/Quest 标记)。下载到玩家本地后被 Unity Runtime 解包加载。
首次出现:理解章 A。
.vrca
Avatar 包文件后缀。本书不深入。
首次出现:第 2 章。
Build & Test
SDK 控制面板按钮:本地打包 + 唤起本机 VRChat 客户端读取本地文件,整条路不出本机。日常迭代主流程。
首次出现:第 5 章 · 第五步:Build & Test。
Build & Publish
SDK 的世界构建与上传流程。新世界创建对应 World ID;更新时使用已有 Blueprint ID 关联同一世界。场景包和世界名称、描述等元数据分别由 SDK 上传处理。
首次出现:理解章 A · 正式上传:到 VRChat 云。
Token
一段临时的登录凭证。SDK 在登录账号时拿到 token,之后调用 VRChat 后端接口(上传 .vrcw、写元信息)都凭这段 token 证明「这是这个账号在操作」。token 有有效期,过期后需要重新登录。
首次出现:理解章 A · 正式上传:到 VRChat 云。
Build Target
Unity 当前编译的目标平台(Windows / Android / iOS 等)。同一个世界要给不同平台分别切换 Build Target 各打一次包。
首次出现:理解章 A · 跨平台:PC、Android(含 Quest)、iOS 各一份。
世界 ID(wrld_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
VRChat 后端给每个发布过的世界分配的全局唯一 ID。Build & Publish 后第一次产生。
首次出现:理解章 A · 正式上传:到 VRChat 云。
对象存储
云端保存文件数据的服务,负责存放 .vrcw 这种世界包文件。VRChat 使用的具体云服务商 / CDN 没有公开声明,社区抓包观察到 files.vrchat.cloud 域名走第三方 CDN 分发。
首次出现:第 2 章 · Unity 与 VRChat 的分工。
CDN(Content Delivery Network,内容分发网络)
通过分布式节点向客户端交付资源的网络服务。玩家加入世界时,不是从作者电脑下载,而是从 CDN 拉取 .vrcw;世界越大,第一次加载越慢。
首次出现:理解章 A · 正式上传:到 VRChat 云。
Cloudflare R2
Cloudflare 的对象存储服务。社区里有时看到这个名字出现在 VRChat 相关讨论中,用作 CDN / 对象存储的一类典型选项理解;VRChat 没有公开声明具体后端。
首次出现:理解章 A。
Instance(实例)
一群人此刻一起跑某个世界的一次具体聚会。同一世界可以同时存在很多个实例,互相隔离。
首次出现:理解章 A · 世界与实例。
Master(实例主)
实例中的一个客户端角色,初始通常为首位加入者,离开时由 VRChat 重新选择。Master 与单个网络对象的 Owner 不同,不能把 Master 当成权限或可信身份。
首次出现:理解章 A。
Late Joiner
在实例创建后加入的玩家。已同步字段可提供当前状态;此前的一次性网络事件不会自动补发。
首次出现:理解章 A · 一张可以反复回看的全景图。详细见第 29 章 · 后来的人怎么办。
VRC Scene Descriptor
告诉 SDK「这个 Unity 场景是 VRChat 世界」的描述组件,登记出生点、参考摄像机等。世界必装。
首次出现:第 5 章 · 第四步:添加场景描述组件。组件字段见附录 C。
Spawn(出生点)
玩家进世界时落点和朝向的标记。VRC Scene Descriptor 的 Spawns 数组里登记一个或多个空物体,按策略选其中之一。
首次出现:第 5 章 · 第三步:标记出生位置。
Unity 编辑器与场景
Section titled “Unity 编辑器与场景”Scene(场景)
后缀 .unity 的文件,存这个空间里的所有物体、灯光、引用关系。
首次出现:第 5 章 · 第一步:新建并保存场景、第 6 章。
GameObject(游戏物体)
Unity 中所有场景物体的容器。本身没有任何能力,能力来自挂在它身上的 Component。
首次出现:第 6 章 · GameObject 与组件。
Empty GameObject(空物体)
不挂渲染组件,画面里看不见。常用作组的父级容器、旋转轴心、纯逻辑挂载点。Spawn 就是空物体。
首次出现:第 6 章 · GameObject 与组件。
Hierarchy(层级面板)
当前场景里所有 GameObject 的目录清单。父子关系在这里调整。
首次出现:第 6 章 · 场景与面板。
Inspector(检视面板)
选中某物体后展示它身上所有组件和参数的面板。
首次出现:第 6 章。
Project 面板
项目的所有文件夹与资源。材质、模型、脚本、声音、Prefab 都在这里。
首次出现:第 4 章 · Unity 面板。
Scene 视图 / Game 视图
Scene 视图是搭世界的画布,Game 视图是模拟玩家视角。
首次出现:第 4 章。
Console(面板)
显示编译错误、运行日志和警告的编辑器面板。可按消息内容、对象和堆栈定位问题。
首次出现:第 4 章。
Transform
每个 GameObject 自带、删不掉的组件。管 Position、Rotation、Scale 三件事。
首次出现:第 6 章 · Transform 与坐标。
Position / Rotation / Scale
Transform 的三个字段:在哪、朝哪、多大。
首次出现:第 5 章、第 6 章。
父子层级
在 Hierarchy 里把一个 GameObject 拖到另一个下面,子物体的 Transform 变为相对父物体。父物体一移动,子物体跟着走。
首次出现:第 6 章 · 父子层级。
Component(组件)
挂在 GameObject 上的能力单元。每个组件只管一件事,按需组合。
首次出现:第 6 章 · GameObject 与组件、第 7 章。
Add Component
Inspector 底部按钮,给当前物体加新组件。
首次出现:第 7 章 · 添加组件。
Play Mode
Unity 顶部三角形按钮启动的运行时预览模式。对场景对象运行时状态的改动通常在退出时还原;直接修改资产文件或编辑器工具写入的内容可能保留。
首次出现:第 7 章 · Play Mode 修改的保存条件。
Playmode tint
Edit → Preferences → Colors 里的设置,给 Play Mode 下的编辑器界面染色,避免误以为还在编辑模式而白调一通参数。
首次出现:第 7 章 · Play Mode 修改的保存条件。
引用槽(None (Object))
组件参数中可以把其他物体或资产拖进来的字段。如果组件「莫名其妙不工作」,先查引用槽是不是 None。
首次出现:第 7 章 · 引用槽连接具体对象。
图形与物理基础
Section titled “图形与物理基础”GPU(Graphics Processing Unit,图形处理器)
执行图形渲染和并行计算的处理器。PC 与独立头显的性能、内存和功耗约束不同,不能用一个固定倍数概括全部设备。
首次出现:第 2 章 · Unity 与 VRChat 的分工。
显存(VRAM, Video RAM)
GPU 自己使用的高速内存,专门给画面渲染用。.vrcw 加载时,mesh、material、shader、texture 会从硬盘读出后装进显存。资源占用超出设备预算可能造成性能或加载问题;移动设备也可能采用 CPU/GPU 共享内存,需按目标设备测量。
首次出现:理解章 A · 别人加入:从 CDN 拉,再装进 Unity Runtime。
渲染管线(Rendering Pipeline)
GPU 把场景画成一帧画面的流水线,依次做几何变换、光栅化、片元着色等步骤。Unity 提供多套渲染管线(Built-in / URP / HDRP),VRChat 当前主用 Built-in。Shader 必须按管线编写,跨管线一般需要重写。
首次出现:第 2 章 · Unity 与 VRChat 的分工。
物理引擎(Physics Engine)
模拟物体下落、碰撞、反弹、摩擦等物理行为的子系统。Unity 用的是 PhysX。VRChat 不重做这一层,但 Udon 调用物理 API 受 Class Exposure Tree 限制;Pickup、Rigidbody 这些组件最终都依赖物理引擎运行。
首次出现:第 2 章 · Unity 与 VRChat 的分工。
Mesh(网格)
模型的几何数据,由顶点和三角形组成。形状由它定义。
首次出现:第 9 章 · 材质与光共同决定表面外观。
Mesh Filter
存 Mesh 数据的组件,给 Mesh Renderer 提供形状。
首次出现:第 6 章 · GameObject 与组件。
Mesh Renderer
负责把 Mesh 画出来的组件。关掉它,物体隐形,但 Collider 还在。
首次出现:第 6 章 · 对照渲染与碰撞。
Cube / Plane
Unity 内置基础形状。Cube 是封闭六面体,Plane 是细分平面。本书最小场景用压扁的 Cube 配 Box Collider;Plane 也可作为地板,需分别检查 Collider 与材质背面显示。模型形状本身不能保证或排除碰撞穿透。
首次出现:第 5 章 · 第二步:创建地板。
Box Collider / Sphere Collider / Mesh Collider
三种常用碰撞体。Box 是盒子(默认 Cube 自带),Sphere 是球,Mesh 按网格逐三角形碰撞(默认 Plane 自带)。能用 Box 不用 Mesh,便宜得多。
首次出现:第 5 章、第 6 章。
Backface Culling(背面剔除)
渲染优化:默认情况下从背面看一个三角形会直接消失。Plane 单面 + 背面剔除导致从底面看不见。
首次出现:第 5 章。
Rigidbody(刚体)
让物体获得重力、能被物理引擎模拟。VRChat 中谨慎用,物理交互成本高。
首次出现:第 7 章 · 添加组件。
VRChat SDK 组件
Section titled “VRChat SDK 组件”VRC Scene Descriptor :见上方”构建与发布管线”。
VRC Pickup
让玩家能把物体拿起来。默认本地行为;要让别人也看见拿起,需要配 VRC Object Sync。
首次出现:第 7 章 · VRChat 组件的职责。详细见第 15 章 · 三个组件分别负责什么。
VRC Object Sync
同步物体位置、旋转以及重力和运动学状态;Pickup 需要共享移动结果时可配合使用。
首次出现:第 7 章。详细见第 15 章。
VRC Spatial Audio Source
为 Unity Audio Source 配置 VRChat 的空间化、增益与衰减;它不替代 Audio Source,也不自动把声音限制在某个房间。
首次出现:第 7 章。详细见第 33 章 · 声音和氛围。
VRC Mirror Reflection
生成镜面反射并增加渲染工作,可通过开关、分辨率和反射层控制成本。
首次出现:第 7 章。详细见第 16 章 · 第二节:做一面可开关的镜子。
VRC Station
让物体能被坐下(椅子、沙发、驾驶座)。会接管玩家移动控制。
首次出现:第 7 章。详细见第 16 章 · 第一节:用 VRCStation 做座椅。
Udon Behaviour
承载 Udon 程序并接收相应事件的组件。程序可由 UdonSharp 或 Udon Graph 生成;SDK 原生组件不都属于 Udon 脚本。
首次出现:第 7 章。详细见第三部(第 12 章 · UdonSharp 的支持范围与使用条件起)和第四部(第 13 章 · 可以按的东西起)。
Unity 内置组件
Section titled “Unity 内置组件”Light
通用光源组件。Type 字段决定它是什么光(Directional / Point / Spot / Area)。
首次出现:第 7 章、第 9 章 · 光源类型。
Directional Light(方向光)
模拟太阳/月亮,光线平行,位置无关,只看 Rotation。每个场景默认一盏。
首次出现:第 9 章 · 配置方向光。
Point Light(点光源)
从一个点向四周发光,超过 Range 不再照亮。常做暖色局部光源。
首次出现:第 8 章、第 9 章 · 配置局部点光源。
Spot Light(聚光灯)
朝一个方向打锥形光束,像手电筒或舞台灯。
首次出现:第 9 章 · 光源类型。
Area Light(面光源)
从一个面发出的光;Unity Built-in 中的 Area Light 用于烘焙照明。
首次出现:第 9 章。详细见第 36 章 · 光与影。
Audio Source
Unity 音频播放组件,配置 AudioClip、音量、循环、播放时机与 2D/3D 混合。VRC Spatial Audio Source 在它的基础上补充空间化设置。
首次出现:第 7 章。
Animator
状态机驱动的动画组件,用于平滑运动(开关门、电梯、风扇)。
首次出现:第 7 章。详细见第 17 章 · 门、机关和状态。
资产复用:Prefab 一族
Section titled “资产复用:Prefab 一族”Prefab(预制体)
保存 GameObject 层级、组件和默认参数的资产。场景实例引用该资产,同时可保存自己的覆盖项。
首次出现:第 8 章 · 创建 Prefab 资源。
Prefab Instance(预制体实例)
场景里从 Prefab 拖出来的具体物体,名字在 Hierarchy 里显示成蓝色。
首次出现:第 8 章。
Override(覆盖)
某个 Prefab Instance 上某个字段相对模具被改过。Inspector 里那个字段旁边有一条蓝色小标记。
首次出现:第 8 章 · Override:实例覆盖。
Apply / Revert
Override 的两种处理:Apply 把 Override 写回 Prefab 模具,Revert 把这个字段拉回模具值。
首次出现:第 8 章。
Prefab Variant(预制体变体)
基于一个已有 Prefab 派生出的”子模具”。继承基础 Prefab 的配置并保存自身覆盖项;公共配置变更和个别覆盖分别管理。
首次出现:第 8 章 · Override:实例覆盖。
Unpack Prefab
把一个 Instance 与模具断开。之后改模具不再影响它。引入第三方 Prefab 想拆开研究时常用,自家项目里慎用。
首次出现:第 8 章 · Unpack 的作用。
渲染:材质与 Shader
Section titled “渲染:材质与 Shader”Material(材质)
引用 Shader 并保存颜色、贴图、金属度等参数的资产,决定 Renderer 的表面绘制方式。
首次出现:第 9 章 · 材质与光共同决定表面外观。
Shader(着色器)
一套渲染规则,告诉 GPU”这种表面怎么被画”。Material 是 Shader 的一份具体参数。
首次出现:第 9 章 · Material、Shader、Texture。
Texture(贴图)
图片资源(木纹、砖缝、划痕、发光图案),被 Material 引用,最终铺到模型表面。
首次出现:第 9 章。
Albedo / Base Color / Base Map
材质的底色字段,不同 Shader 名字略有差异,作用接近。
首次出现:第 9 章 · 材质与光共同决定表面外观。
Metallic
金属感字段。0 是非金属(木头、布料、墙面),1 接近纯金属。
首次出现:第 9 章 · 四个材质参数。
Smoothness
光滑度字段。低值像水泥,高值像抛光金属或塑料。
首次出现:第 9 章。
Emission
材质的自发光参数。字牌自身亮而墙未被照亮时,可能只有表面自亮;实时照明可使用 Light,满足材质 GI、静态对象和烘焙设置时,Emission 也能贡献烘焙间接光。
首次出现:第 9 章 · 给灯球设置 Emission。
PBR(Physically Based Rendering,基于物理的渲染)
一套基于物理参数(金属度、光滑度等)描述表面的渲染范式。Unity Standard Shader 走的就是 PBR。
首次出现:第 9 章。
Standard Shader
Unity Built-in 管线的 PBR 材质 Shader;本书基础材质示例使用它。
首次出现:第 9 章 · 修改没有生效时。详细见第 37 章 · 表面和材质。
「材质突然变粉色」
Shader 丢了 / 不兼容 / 渲染管线对不上的视觉表现。处理:先把 Material 的 Shader 切回稳定可用的标准 Shader。
首次出现:第 9 章。详细排查见附录 F · 报错排查。
渲染:光照(基础)
Section titled “渲染:光照(基础)”Lightmap(烘焙光贴图)
事先把光照算好烤成贴图,运行时不再实时计算。代价是贴图占内存、不能动。
首次出现:第 9 章 · 光源类型。详细见第 36 章 · 光与影。
Light Probe
散布在场景里的探针,存间接光信息,让动态物体(玩家、Pickup)也能受静态烘焙光影响。
首次出现:第 9 章 · 控制实时光照开销。详细见第 36 章 · 光与影。
Shadow Map
实时阴影的内部表示。Unity 每帧重算,灯多 + 投影开 = 帧率掉。
首次出现:第 9 章 · 阴影的条件和成本。
PC / Windows
VRChat 主力平台,SteamVR / Oculus 头显或纯 Desktop 模式都能玩。
首次出现:第 2 章 · 版本与平台。
Meta Quest
运行 Android 的独立 VR 头显。世界需提供兼容的 Android 构建,并在目标设备上验证资源占用和性能。
首次出现:第 2 章。详细见第 39 章 · PC 和 Quest。
iOS / Android(VRChat 移动端)
VRChat 的移动端客户端,2025 年 10 月正式登陆 App Store 和 Google Play。触屏、无 VR,以 2D 平面模式进入世界。
首次出现:第 2 章。
Steam Early Access
VRChat 2017 年 2 月在 Steam 上线时使用的发布模式。
首次出现:第 2 章。
交互事件与玩家 API(第 4 部第 13–14 章)
Section titled “交互事件与玩家 API(第 4 部第 13–14 章)”Interact
VRChat 对可交互对象发起交互时调用的本地事件,UdonSharp 签名为 public override void Interact()。键位取决于输入设备与绑定;拿起 Pickup 和持握后的 Use 有各自事件。
首次出现:第 13 章 · 按一下,灯亮了。
Interaction Text
组件的自定义交互提示。中文文本不会自动转换为玩家的语言;可填写双语短句,或由作者提供多语言文本及本地切换逻辑。Pickup 字段留空时官方规定显示默认标签。
首次出现:第 13 章 · 第四步:配置 Collider 和交互提示。
Proximity
交互或拾取的距离参数,单位米。VR 射线从手柄计算,非 VR 射线还包含额外可及距离补偿,所以不能直接当作玩家根节点到物体的严格球形半径。
首次出现:第 13 章。
override(C# 关键字)
C# 中重写基类虚方法的关键字。UdonSharp 的 Interact、OnPlayerJoined 等事件使用 public override;Start、Update 等 Unity 消息按对应签名定义。
首次出现:第 13 章 · 第二步:创建灯光开关脚本。
enabled(组件字段)
Behaviour 类组件(Light、MeshRenderer、AudioSource、UdonSharpBehaviour 等)共有的字段,控制这个组件是不是处于工作状态。light.enabled = false 让灯不发光,但物体本身、其他组件不受影响。
首次出现:第 13 章 · 第二步:创建灯光开关脚本。
Is Trigger(Collider 字段)
Collider 的检测模式。启用后不作为实体阻挡体;玩家进入或离开相应检测体可触发 OnPlayerTriggerEnter / Exit,脚本、对象与碰撞配置仍需有效。
首次出现:第 14 章 · Trigger 的作用和事件条件。
OnPlayerTriggerEnter / OnPlayerTriggerExit
VRChat 的玩家区域进出事件,参数指出被检测到的玩家。各客户端可以检测本地或远端玩家,不能把它理解为一次可靠的网络广播;只影响本地音频时按 player.isLocal 过滤。
首次出现:第 14 章 · 第三步:连接进入与离开事件。
OnPlayerTriggerStay
玩家停留在 Trigger 内时每帧调用一次。开销显著高于 Enter / Exit,能用进出事件解决就别用它。
首次出现:第 14 章 · 相关事件的区别。
OnPlayerCollisionEnter / OnPlayerCollisionExit / OnPlayerCollisionStay
玩家撞上 / 离开 / 持续接触一个普通(非 Trigger)Collider 时的事件。和 Trigger 系列对应,区别在 Collider 是不是 Is Trigger。
首次出现:第 14 章。
OnTriggerEnter / OnTriggerExit
Unity 标准的 Trigger 事件,处理普通物体(不是玩家)穿过 Trigger 的情况,比如「球进了得分框」。和 OnPlayerTrigger* 区别在前缀有没有 Player。
首次出现:第 14 章。
VRCPlayerApi
VRChat SDK 表示一个玩家的对象类型。OnPlayerJoined、OnPlayerTriggerEnter 等事件的形参就是它。常用属性 isLocal、displayName、playerId。命名空间在 VRC.SDKBase。
首次出现:第 14 章 · 第三步:连接进入与离开事件。
isLocal
VRCPlayerApi 的属性,判断这个玩家是不是当前客户端的本地玩家。多人事件里用 if (!player.isLocal) return; 把「别人的事件」过滤掉是 VRChat 世界的高频写法。
首次出现:第 14 章 · 为什么过滤本地玩家。
Networking.LocalPlayer
VRChat 静态 API,返回当前客户端那个 VRCPlayerApi。常用 Networking.LocalPlayer.TeleportTo(...) 把本地玩家瞬移到某个 Transform。
首次出现:第 14 章 · 把区域事件用于其他动作。详细见第 16 章 · 第三节:区域传送。
Spatial Blend(AudioSource 字段)
Audio Source 的 2D/3D 混合参数:0 不按声源位置做 3D 处理,1 使用完整 3D 设置。它不决定何时播放;跨区域边界才播放的本地 BGM 可以保持 2D,由 Trigger 控制 Play/Stop。
首次出现:第 14 章 · 第二步:配置 2D 音乐。
Play On Awake(AudioSource 字段)
Audio Source 启用加载时是否自动播放。全局 BGM 可启用;需要由区域进入或按钮决定开始时,关闭它并显式调用 Play。
首次出现:第 14 章。
Loop(AudioSource 字段)
勾选后音频播完会从头再播。需要连续循环的音轨勾选;一次性播放的音效保持关闭。
首次出现:第 14 章。
音乐播放范围速查
Section titled “音乐播放范围速查”| 需求 | 开始与停止 | 空间化 |
|---|---|---|
| 进入世界就播放的全局 BGM | 启用 Play On Awake;按需循环 | 2D,关闭空间化 |
| 跨咖啡厅边界播放的本地 BGM | 本地玩家 Trigger Enter 调 Play,Exit 调 Stop | 2D,关闭空间化;本书区域示例采用此方案 |
| 室内固定音箱持续播放 | 音箱独立播放,不依赖门口 Trigger | 3D;方向与距离随玩家相对位置变化,室外也可能听到 |
Trigger 决定播放时机,Spatial Blend 与空间化组件决定声音如何随位置变化。3D 声源的衰减范围不等于房间边界,也不提供自动墙体隔音。配置见区域触发与音频组件。
拿取、座椅、镜子、Animator(第 15–17 章)
Section titled “拿取、座椅、镜子、Animator(第 15–17 章)”OnPickup / OnDrop
玩家把 VRC Pickup 物体拿起 / 放下时被 VRChat 调用的事件,写在挂着同一个 UdonSharpBehaviour 的脚本上。完全本地:只有抓的人会跑这段代码。
首次出现:第 15 章 · 第四步:添加灯光反馈。
OnPickupUseDown / OnPickupUseUp
拿着 Pickup 时按下 / 松开 Use(使用键,Settings → Controls)的事件。可以用来做「按住喷射、松手停」这类交互。
首次出现:第 15 章。
Pickupable(VRC Pickup 字段)
是否当前可被拿起。脚本里设 pickup.pickupable = false 可以临时禁止抓取,常用于”游戏中锁定道具”。
首次出现:第 15 章。
Auto Hold / Orientation(VRC Pickup 字段)
Auto Hold 控制结束 Grab 后是否继续持握:组件 1.1 为复选框,1.0 为 Yes/No/Sometimes/Auto Detect。Orientation 独立控制 Any/Grip/Gun 握持姿态,Any 不是 Auto Hold 的取值。
首次出现:第 15 章 · 第二步:添加刚体和 Pickup。
Disallow Theft
VRC Pickup 上的勾选项。打勾后别人不能从你手里抢走这个物体。多人世界里默认推荐勾上,避免误抢。
首次出现:第 15 章。
VRCStation
让玩家能”坐”上的 SDK 组件(Add Component 搜索框里显示为 VRC Station)。坐下后玩家移动控制被它接管,常用于椅子、驾驶座、过山车。简介见上方“VRChat SDK 组件”。
首次出现:第 16 章 · 第一节:用 VRCStation 做座椅。
Player Mobility(VRCStation 字段)
坐下后玩家的活动范围:Mobile(可移动,比如开船)、ImmobilizeForVehicle(锁住但允许 vehicle station chaining)、Immobilize(完全锁住,普通椅子用它)。
首次出现:第 16 章。
Station Enter Player Location / Station Exit Player Location
两个 Transform 引用槽,分别决定坐下时玩家被吸到哪、起身时被弹到哪。Enter 槽通常拖一个椅面上方的子空物体;Exit 槽拖椅子前方一点。
首次出现:第 16 章。
Seated(VRCStation 字段)
是否走”坐姿”模式。Seated 打勾后 VR 玩家自动以坐姿校准,第一人称高度变化。普通椅子勾上,过山车 / 驾驶座按需。
首次出现:第 16 章。
Disable Station Exit
打勾后玩家不能自己按按钮起身,必须脚本调用 station.ExitStation(player) 才能弹下来。做小游戏锁人时用。
首次出现:第 16 章。
OnStationEntered / OnStationExited
玩家坐上 / 离开 VRCStation 时被调用的事件。形参 VRCPlayerApi player 是发生进出的玩家,所有客户端都会收到这次事件。
首次出现:第 16 章。
VRCMirrorReflection
VRChat 镜面反射组件,会增加反射视角的渲染工作。可通过默认关闭、反射层和分辨率控制开销;实际成本需测量。
首次出现:第 16 章 · 第二节:做一面可开关的镜子。
m_ReflectLayers(VRCMirrorReflection 字段)
指定镜子渲染哪些 Layer。只需玩家头像时包含 Player 与 MirrorReflection;后者用于镜中的本地玩家。其余层按反射用途配置并测试,依据 官方 Layers。
首次出现:第 16 章。
TeleportTo
VRCPlayerApi 上的方法:把这个玩家瞬移到指定 Vector3 位置和 Quaternion 朝向。完全本地:只有调用方所在客户端的玩家会被移动。
首次出现:第 16 章 · 第三节:区域传送。
Animator Controller
后缀 .controller 的资产文件。里面是一张状态图:每个节点是一个 Animator State,节点之间是 Transition。动画该播哪段、怎么切换都写在它里面。Animator 组件本身的简介见上方“Unity 内置组件”。
首次出现:第 17 章 · 第三步:配置 Animator Controller。
Animator State
状态图里的一个节点,对应一段具体动画(一个 AnimationClip)。门”关着”是一个 State,“开着”是另一个。
首次出现:第 17 章。
Animator Parameter
Animator Controller 上声明的参数(Bool / Int / Float / Trigger),脚本通过它驱动状态切换。比如声明一个 IsOpen 的 Bool,从脚本调 animator.SetBool("IsOpen", true) 让门切到”开”状态。
首次出现:第 17 章 · 第四步:写门的状态脚本。
Animator.SetBool / SetInt / SetFloat / SetTrigger
脚本写参数的四个方法。前三个对应同名类型;SetTrigger 触发一次性事件(被读后自动清回)。键名是字符串,必须和 Animator Controller 里的参数名一字不差。
首次出现:第 17 章。
Has Exit Time(Transition 字段)
两个状态间的过渡是否要等动画播完一个比例后才能切。门、按钮这类瞬时切换通常 关掉它,否则会”按一下要等几秒才动”。
首次出现:第 17 章。
nameof()
C# 运算符,返回标识符名称的字符串。用于方法名可减少手写字符串错误;它不会验证 Animator Controller 资产里是否有同名参数。
首次出现:第 17 章 · 第四步:写门的状态脚本。
交互与多人同步(第 5–6 部)
Section titled “交互与多人同步(第 5–6 部)”状态机(State Machine)
用「当前处于哪个状态、满足什么条件跳到下一个状态」来描述系统的写法。门的开 / 关、回合的等待 / 游戏中 / 结算都适合用状态机。
首次出现:第 17 章 · 门、机关和状态。
序列化(Serialization)
把脚本字段打包成网络能发送的数据。VRChat 里 Owner 改完 [UdonSynced] 字段后,调 RequestSerialization() 请求打包发送。
首次出现:第 28 章 · 告诉别人发生了什么。
反序列化(Deserialization)
把收到的网络数据解包,还原成本机脚本里的字段值。VRChat 解包完成后会调用 OnDeserialization()。
首次出现:第 28 章。
插值(Interpolation)
让数值在两次同步之间平滑过渡,避免远端物体或颜色突然跳变。UdonSyncMode.Linear 就是线性插值。
首次出现:第 28 章。
快照(Snapshot)
某一时刻所有同步字段当前值打包成的一份初始状态。Late Joiner 加入实例时会收到当前同步字段的快照。
首次出现:第 29 章 · 后来的人怎么办。
多人同步:所有权、网络事件、Manager 模式(第 26–30 章)
Section titled “多人同步:所有权、网络事件、Manager 模式(第 26–30 章)”OnPlayerJoined / OnPlayerLeft
玩家加入 / 离开实例时被调用的事件,形参 VRCPlayerApi player 是当事人。所有客户端都会收到一次,常用来播提示音、刷新玩家名单。
首次出现:第 26 章 · 客户端与脚本实例。
OnPlayerRestored
Player Persistence API 的回调事件:对应玩家的持久化数据恢复完成时触发,参数用于识别该玩家。读 PlayerData 字段、应用到世界状态(比如恢复”上次坐过哪把椅子”)应该在这个事件里做,不能仅凭 OnPlayerJoined 或 Start 已执行就假定数据恢复完成。
首次出现:第 24 章 · Tool World、持久化范围见创作者经济中的持久化说明。
Networking(静态类)
VRChat SDK 全局工具类,命名空间 VRC.SDKBase。所有「玩家是不是 Owner」「拿当前玩家」「拿服务器时间」「转移所有权」类操作都从它出发:Networking.LocalPlayer、Networking.IsOwner(...)、Networking.SetOwner(...)、Networking.GetServerTimeInSeconds()。
首次出现:第 27 章 · Owner 的范围。
Owner(所有权概念)
对每一个挂着 UdonBehaviour 的 GameObject,VRChat 服务器都登记了”现在哪个玩家说了算”,那个玩家就是 Owner。[UdonSynced] 字段以 Owner 的值为准;RequestSerialization 只有 Owner 调用才有效;某些事件只在 Owner 上跑。Owner 离线时所有权会自动迁移。
首次出现:第 27 章。
Networking.IsOwner / GetOwner / SetOwner
所有权三件套:IsOwner(this.gameObject) 判断本机玩家是不是这个对象的 Owner;GetOwner(this.gameObject) 拿到当前 Owner 的 VRCPlayerApi;SetOwner(player, this.gameObject) 把所有权转移给某个玩家。
首次出现:第 27 章 · 交互时请求所有权。
OnOwnershipRequest
所有权请求的验证回调,可在发起方和当前 Owner 上执行;返回值与双方判断影响是否允许转移。判断逻辑应保持一致,转移结果用 OnOwnershipTransferred 核对。
首次出现:第 27 章 · 拒绝请求与转移回调。
OnOwnershipTransferred
所有权转移完成后,所有客户端都会被通知一次的事件。形参是新 Owner 的 VRCPlayerApi。常用来在新 Owner 上立即抓一次最新状态、或者全员刷新 UI。
首次出现:第 27 章 · 拒绝请求与转移回调。
[UdonSynced]
标记需要网络同步的字段。Manual 模式由 Owner 修改后请求序列化,Continuous 模式按网络调度自动同步;接收方在 OnDeserialization 中更新本地显示。
首次出现:第 28 章 · 告诉别人发生了什么。
RequestSerialization()
UdonSharpBehaviour 上的方法,Owner 调用才有效。请求把所有 [UdonSynced] 字段打包发给其他客户端。一次调用通常对应一次状态变化(按钮被按、回合切换)。
首次出现:第 28 章。
OnDeserialization()
非 Owner 客户端收到同步包并解开后被调用的事件。在这里读 [UdonSynced] 字段当前值,然后刷新本地表现(灯亮、UI 更新)。
首次出现:第 28 章。
OnPostSerialization
Owner 调完 RequestSerialization 并完成打包后被调用的回调,形参 SerializationResult 里能查 success 和 byteCount。用来确认这次同步是否真的发出去了。
首次出现:第 28 章。
[UdonBehaviourSyncMode]
指定 UdonSharpBehaviour 的同步模式:Continuous 自动调度连续同步,Manual 显式请求序列化;NoVariableSync 不同步变量但允许网络事件,None 关闭该 Behaviour 的网络功能。Continuous 不保证每帧发包。
首次出现:第 28 章、第 30 章 · 结构与规则。
SendCustomNetworkEvent
向目标客户端发送 Udon 事件调用,事件不向后来加入者重放。当前 SDK 支持带参数调用,接收方法按官方规则声明 NetworkCallable;本书基础示例也包含无参数形式。
首次出现:第 28 章。
NetworkEventTarget(枚举)
SendCustomNetworkEvent 的目标参数:All 发给所有人(包括自己)、Owner 只发给当前 Owner。需要”只让 Owner 改字段”时,先 SendCustomNetworkEvent(NetworkEventTarget.Owner, nameof(...)) 让 Owner 跑那段代码,再 RequestSerialization。
首次出现:第 28 章。
Networking.GetServerTimeInSeconds()
所有客户端共享的 VRChat 服务器时间(double,秒)。做倒计时、回合时长、动画同步起点时用它,因为各个客户端的 Time.time 互不一致。
首次出现:第 30 章 · GameManager。
VRCPlayerApi.GetPlayerById
通过 playerId(int)反查 VRCPlayerApi 的方法。同步玩家间状态(“现在轮到哪号玩家”)时通常存 id 而不是引用。
首次出现:第 30 章。
playerId / displayName
VRCPlayerApi 的两个常用属性。playerId 是 int,进入实例时分配,可同步;displayName 是字符串昵称,调试和展示用。
首次出现:第 30 章。
Manager 模式
把相关共享状态集中到一个控制脚本的组织方式。按钮、检测区域和显示脚本通过引用调用它,便于统一状态更新;这是一种设计选择,不是 VRChat 的强制架构。
首次出现:第 30 章 · 结构与规则。
VR 舒适与音频(第 7 部)
Section titled “VR 舒适与音频(第 7 部)”晕动症(Motion Sickness)
可能表现为头晕、恶心等不适。VR 中视觉运动与身体感受不一致可能诱发症状,程度因人和使用条件而异。
首次出现:第 32 章 · 空间、比例和舒适。
前庭系统(Vestibular System)
参与感知头部运动与保持平衡的感觉系统。视觉与前庭信息不一致可能与 VR 不适有关,不能由单个设置保证所有人的舒适度。
首次出现:第 32 章。
VRC Spatializer / 空间化(Spatialization)
VRChat 的空间音频算法,按声源相对玩家的 3D 位置计算左右耳音量、方向和衰减,让声音听起来来自某个方向。
首次出现:第 33 章 · 声音和氛围。
dB(Decibel,分贝)
音量的对数刻度,不是普通线性百分比。音频里常用 -12 dB、+10 dB 这类值描述响度变化。
首次出现:第 33 章。
增益(Gain)
在原始音量之上额外加或减多少 dB。VRChat 世界 Audio Source 默认有 +10 dB 增益,所以素材本身太响时要降。
首次出现:第 33 章。
Audio Listener
Unity 接收音频的”耳朵”组件。Unity 默认场景里 Main Camera 自带一个;VRChat 世界里不要自己再挂——VRChat 客户端会在玩家头部放置 Listener,世界里多挂一个会冲突或被忽略。
首次出现:第 33 章。
玩家落地、世界 UI、跨世界传送门(第 31 / 34 / 35 章)
Section titled “玩家落地、世界 UI、跨世界传送门(第 31 / 34 / 35 章)”Spawns 数组(VRC Scene Descriptor 字段)
登记一个或多个空物体作为出生点,玩家进入实例时按 Spawn Order 选其中之一。要让两个人不出生在同一格上,需要至少两个分散的 Spawn。
首次出现:第 31 章 · 配置 Spawn 的位置与朝向。
Spawn Order(First / Random / Sequential / Demo)
VRC Scene Descriptor 上决定从 Spawns 数组里挑哪个的策略。First 一直用第一个;Random 随机;Sequential 按列表顺序轮;Demo 把 Spawn 当作 VR 房间尺度的中心点来对齐。
首次出现:第 31 章 · 多个出生点。
Spawn Orientation(AlignPlayerWithSpawnPoint / AlignRoomWithSpawnPoint)
出生点的朝向语义。AlignPlayerWithSpawnPoint 让玩家本人面向 Spawn 物体的 forward;AlignRoomWithSpawnPoint 让 VR 玩家的房间坐标系跟 Spawn 对齐,常用于客厅型 VR 体验。
首次出现:第 31 章 · 让行走路线可辨认。
Object Behaviour at Respawn / Player Object Behaviour at Respawn
Scene Descriptor 官方说明中的 Object Behaviour At Respawn 决定 Pickup 掉到 Respawn Height 以下时销毁或回到初始位置;不要把它理解成玩家点击重生时重置所有物体。额外字段按所用 SDK 的实际说明核对。
首次出现:第 31 章。
Canvas(Unity UI)
Unity UI 系统的根容器。所有 UI 元素都要挂在某个 Canvas 下面才能被画出来。
首次出现:第 34 章 · World Space Canvas 的搭法。
Render Mode(Canvas 字段)
决定 UI 怎么画:Screen Space - Overlay(贴屏幕,VRChat 世界用不到)、Screen Space - Camera(贴某摄像机近平面)、World Space(作为 3D 物体放进场景)。VRChat 世界 UI 用 World Space。
首次出现:第 34 章。
World Space Canvas
Render Mode = World Space 的 Canvas。它就是一块挂在世界里的 3D 平面,玩家可以走到它前面看,可以围着它转。VRChat 可用于立牌、屏幕与得分板;这些对象也可采用其他渲染实现。
首次出现:第 34 章。
VRC_UIShape
VRChat SDK 的 World Space Canvas 必装组件,告诉 VRChat「这个 Canvas 上的按钮、Slider 应该响应玩家激光指针」。漏装的 Canvas 上按钮按不动。
首次出现:第 34 章 · World Space Canvas 的搭法。
TextMeshPro / TMP
Unity 的文字组件,支持 SDF 字体与文本排版。本书文字示例使用它;清晰度仍取决于字体资产、材质和显示条件。
首次出现:第 34 章 · TextMeshPro 与中文字体。
SDF(Signed Distance Field,有向距离场)
用到字形边界的距离信息表示字符的技术,可用于缩放、描边等效果;并不保证任意大小与距离下都清晰。
首次出现:第 34 章。
TMP Font Asset / Font Asset Creator
TextMeshPro 用的字体资产(.asset)和生成它的窗口(Window → TextMeshPro → Font Asset Creator)。中文世界里要先把 .ttf 通过 Font Asset Creator 烤一份只含必要汉字的 TMP Font Asset,否则中文会显示为方框。
首次出现:第 34 章 · TextMeshPro 与中文字体。
MaterialPropertyBlock
Unity 的材质参数覆盖工具。可以在不复制材质的前提下、单独让某一个 Renderer 显示成不同颜色。VRChat 里给一组按钮做”按下变红”反馈又不想为每个按钮做单独材质时用它。
首次出现:第 34 章 · 操作反馈。
AudioSource.PlayOneShot
在某个 AudioSource 上”插播”一段 AudioClip,不打断当前正在播的内容。按钮”啪”一声、命中”叮”一声常用它,因为可以让多次按动重叠播放。
首次出现:第 34 章 · 操作反馈。
VRC Portal Marker
VRChat SDK 的传送门组件。挂在一个空物体上、设上目标世界(World ID 或 Home / Hub),运行时 VRChat 会在这里自动生成一个站着进就走的传送门。
首次出现:第 35 章 · 创建传送门。
Custom Portal Name
VRC Portal Marker 的字段,传送门正面浮出来的世界名字。空着会显示目标世界自己的真实名称。
首次出现:第 35 章。
World 字段(None / Home / Hub)
VRC Portal Marker 的目标选择枚举。None 表示用下面那个 Room ID(即 wrld_xxx);Home 把玩家送回他自己设置的 Home 世界;Hub 送到 VRChat 当前的官方 Hub。
首次出现:第 35 章 · Home 与 Hub。
Hub 世界
VRChat 设置的官方公共大厅世界。新玩家、断网回归玩家会被推到这里,是 VRChat 的”游戏主菜单”。
首次出现:第 35 章 · Home 与 Hub。
VRCWorld_PortalMarker Prefab
SDK 自带的传送门模板(Packages/com.vrchat.worlds/Runtime/...)。直接拖进场景就是一个完整可工作的传送门,比手搓一个空物体加组件省事。
首次出现:第 35 章 · 创建传送门。
渲染:光照(进阶)
Section titled “渲染:光照(进阶)”Reflection Probe
在某个位置捕捉四周环境的一张 Cube Map,让附近金属、玻璃等高反射材质反射房间本身,而不是默认天空。
首次出现:第 18 章 · Chill World,先让人想留下。详细见 第 36 章 · 光。
全局光照(Global Illumination / GI)
把直接光和间接光一起算进去的总光照系统。烘焙光照主要就是把 GI 预先算好存起来。
首次出现:第 36 章 · 光。
直接光 / 间接光(Direct / Indirect Light)
直接光是从光源直射到表面的光;间接光是光打到别的表面后反弹过来的光。间接光影响未被直接照射表面的亮度与颜色。
首次出现:第 36 章。
UV
把 3D 模型表面摊平成 2D 贴图坐标的展开方式。贴图、Lightmap、法线贴图都靠 UV 知道该贴到模型哪里。
首次出现:第 36 章。
Lightmap UV
专门给烘焙光贴图使用的 UV。模型 Lightmap UV 没展开好,会出现亮线、黑线、漏光等烘焙问题。
首次出现:第 36 章。
Shadowmask
Mixed Lighting 的一种模式:静态物体的阴影烘焙进贴图,动态物体仍能接收实时阴影。是否适用取决于所需静态/动态阴影组合、质量设置与目标平台支持。
首次出现:第 36 章。
Subtractive
Mixed Lighting 的一种省性能模式:大部分光照都烘焙,动态物体只保留粗略实时影子。适用于需要这种光照组合且目标平台支持的场景。
首次出现:第 36 章。
渲染:材质与贴图(进阶)
Section titled “渲染:材质与贴图(进阶)”Normal Map(法线贴图)
记录表面每一点朝向的贴图,让平面在光照下看起来有凹凸;模型几何本身并没有真的变形。
首次出现:第 37 章 · 表面和材质。
Occlusion / AO(Ambient Occlusion,环境光遮蔽)
让模型缝隙、凹陷和接触处自动变暗的贴图或效果。没有 AO 的材质容易显得平。
首次出现:第 37 章。
Detail Map
叠在主贴图上的高频细节贴图,常用来让墙、地板在贴脸观看时不糊。
首次出现:第 37 章。
sRGB
按人眼感知校正过的颜色存储空间,适合 Albedo / Base Color 这类「颜色图」。
首次出现:第 37 章。
Linear / 线性空间
按物理量线性存储的颜色空间,适合 Metallic、Smoothness、Normal、AO 这类「不是颜色」的贴图。
首次出现:第 37 章。
ORM
把 Occlusion、Roughness、Metallic 三张灰度图分别塞进 RGB 三个通道的一张打包贴图。Unity Standard Shader 不直接支持,需要拆通道或换支持它的 Shader。
首次出现:第 37 章。
Mip Maps
同一张贴图的多级缩小副本。物体离远时自动使用小图,减少闪烁和采样开销,代价是多占一点内存。
首次出现:第 37 章。
渲染:性能(第 38 章)
Section titled “渲染:性能(第 38 章)”FPS(Frames Per Second)
每秒渲染帧数。目标值取决于设备、刷新率与运行模式;帧时间不稳定可能增加不适。应记录测试场景与目标设备,并结合帧时间比较。
首次出现:第 38 章 · 性能与测量。
Stats 窗口
Unity Game 视图右上角的快速性能读数窗口,能看到 FPS、Batches、Tris、SetPass calls 等粗略指标。
首次出现:第 38 章。
Profiler
Unity 的逐帧性能分析器,用来查看 CPU、GPU、内存、脚本、物理等系统每帧花了多少时间。
首次出现:第 38 章。
Draw Call
CPU 命令 GPU 画一批物体的一次绘制请求。Draw Call 越多,CPU 准备渲染数据的开销越大。
首次出现:第 38 章。
Batches
Stats 里显示的绘制批次数,通常可以理解成当前帧实际发出的 Draw Call 数。材质和批处理会影响它。
首次出现:第 38 章。
SetPass call
切换 Shader / 材质渲染状态的次数。SetPass call 高通常意味着材质种类太多或 Shader 切换太频繁。
首次出现:第 38 章。
Static Batching / Dynamic Batching
Unity 把多个物体合成更少 Draw Call 的两类批处理。Static Batching 适合不会动的物体,Dynamic Batching 适合少量小动态物体。
首次出现:第 38 章。
GPU Instancing
同一份 Mesh + 同一份 Material 出现很多次时,用更少 Draw Call 批量绘制。树、石头、栏杆等重复物体可作为测试对象;实际合批还受 Shader 和渲染设置影响。
首次出现:第 38 章。
Occlusion Culling
预计算「玩家站在某个区域时哪些物体被墙挡住」,运行时挡住的物体不画。可在存在有效遮挡的场景中评估;实际收益需在目标设备上比较开启前后的帧时间。
首次出现:第 38 章。
Overdraw / Fillrate
Overdraw 是同一个像素被多个透明物体反复画;Fillrate 是 GPU 每秒能填多少像素。透明烟雾、玻璃叠多了会把 Fillrate 吃满。
首次出现:第 38 章。
GC(Garbage Collection,垃圾回收)
运行时清理临时对象的机制。脚本每帧制造太多临时对象时,GC 会突然卡一下。
首次出现:第 38 章。
Quest 与跨平台(第 39 章)
Section titled “Quest 与跨平台(第 39 章)”APK(Android Package)
Android 应用安装包格式。VRChat 客户端可作为 Android 应用安装;世界上传的是平台对应的场景资源包,不是供玩家单独安装的 APK。
首次出现:第 39 章 · PC 和 Quest。
Post Processing(后处理)
一帧画面渲染完之后再叠的屏幕效果,如 Bloom、Color Grading、Vignette。VRChat 官方 Android 文档写明 Post Processing 在 Android 上会被禁用,Quest / Android 版本按 0 处理。
首次出现:第 39 章。
Cloth
Unity 的布料模拟组件,让布按物理规则飘动或下垂。官方 Android / Quest 平台规则禁用此组件,需采用受支持的替代方式。
首次出现:第 39 章。
ASTC
Android / Quest 常用的现代纹理压缩格式。Unity 在 Android 标签下常用 ASTC 6x6 作为贴图压缩起点。
首次出现:第 39 章。
调试与测试(第 8 部)
Section titled “调试与测试(第 8 部)”NullReferenceException / NRE(空引用异常)
脚本试图使用一个值为 null 的引用时抛出的异常。VRChat / UdonSharp 世界里常见原因是 Inspector 字段没拖引用,或 GetComponent<T>() 没找到组件。
首次出现:第 40 章 · 坏了怎么办,调试的思路。
调用栈(Call Stack)
错误发生时的一串调用记录,显示代码从哪个方法一路调用到出错位置。Console 里的 (at Assets/xxx.cs:18) 就是定位入口。
首次出现:第 40 章。
Debug.Log
Unity 的日志输出方法,用来把脚本执行到哪、变量当前是什么写进 Console 或客户端日志。发布前要清掉高频日志,避免额外开销。
首次出现:第 40 章。
halted
UdonBehaviour 未捕获异常后被 Udon 虚拟机停掉的状态。出现 this UdonBehaviour will be halted 后,这个对象上的事件通常不会继续触发,直到玩家重新进入世界。
首次出现:第 40 章。
EXTERN
Udon 字节码里调用外部 API 的指令名。错误日志里看到 EXTERN 时,通常要结合上下文找到是哪一行 C# 调用了对应 API。
首次出现:第 40 章。
SDK Validation
SDK 在构建或上传前的检查结果。需区分阻止构建的错误、可构建的警告与性能建议;世界和头像的限制范围也不同。
首次出现:第 41 章 · 测试你的世界。
版本管理与许可(第 8 部)
Section titled “版本管理与许可(第 8 部)”.gitignore
Git 的忽略清单,告诉 Git 哪些文件和目录不要进入版本控制。Unity 项目里常用它排除 Library/、Temp/、Builds/ 等自动生成目录。
首次出现:第 42 章 · 版本管理和备份。
Git LFS(Large File Storage)
Git 的大文件扩展。仓库里只保留指针,实际的大模型、PSD、HDR、视频等文件放到 LFS 存储里,避免普通 Git 历史迅速膨胀。
首次出现:第 42 章。
Smart Merge / UnityYAMLMerge
Unity 自带的智能合并工具,能按 GameObject / Component 等对象结构合并 .unity、.prefab 这类 YAML 文件。它比普通文本行合并更适合 Unity 场景冲突。
首次出现:第 42 章。
Force Text(资产序列化模式)
Unity 项目设置 Edit → Project Settings → Editor → Asset Serialization → Mode 的一个选项。改成 Force Text 后,.unity / .prefab / .asset 等文件以 YAML 文本写入,能 diff、能合并。VRChat 模板默认是 Force Text,但合作开发时拉别人项目要确认一遍。
首次出现:第 42 章 · 第一节:Unity 的序列化与 .meta。
Visible Meta Files(meta 文件可见模式)
Unity 项目设置 Edit → Project Settings → Editor → Version Control → Mode 的默认选项。资源旁边的 .meta 保存 GUID 和导入设置,应与资源一起提交;丢失后重新生成 GUID 可能破坏已有引用。
首次出现:第 42 章 · 第一节:Unity 的序列化与 .meta。
EULA(End User License Agreement,最终用户许可协议)
规定用户买到或下载到一份素材后能做什么、不能做什么。Unity Asset Store 素材统一受 Asset Store EULA 约束。
首次出现:第 43 章 · 素材、插件和版权。
Creative Commons / CC(知识共享)
一组常见内容许可证家族,用 BY、NC、ND、SA 等条件组合说明署名、商用、修改和相同方式共享要求。Sketchfab、Polyhaven、Freesound 等素材站经常使用。
首次出现:第 43 章。
DMCA
美国版权投诉与下架流程。版权方投诉后,平台可以按 DMCA 流程下架世界、头像或其他用户上传内容。
首次出现:第 43 章。
IP(Intellectual Property,知识产权)
版权、商标、角色形象、品牌标识等权利的统称。VRChat 世界里使用动漫角色、游戏音乐、品牌 logo 等内容时,通常都涉及 IP 授权问题。
首次出现:第 43 章。
发布、商业化与运营(第 9 部)
Section titled “发布、商业化与运营(第 9 部)”Community Labs
VRChat 新公开世界的预审池。世界先给主动开启 Labs 的玩家看到,经过一段时间和数据观察后再自动晋升为 Public。
首次出现:第 44 章 · 发布你的世界。
Opt-in
主动开启某个功能或入口。Community Labs 的 opt-in 用户指在 VRChat 设置里主动勾选 Show Community Labs 的玩家。
首次出现:第九部总览。
元数据(Metadata)
描述内容本身的数据。VRChat 世界的元数据包括名称、描述、缩略图、标签、容量、可见性等,不等同于 Unity 场景内容。
首次出现:第 44 章。
SEO(Search Engine Optimization,搜索优化)
让内容更容易被搜索和推荐系统识别的写法或配置。VRChat 标签能帮助分类和搜索,但滥用标签会被处罚。
首次出现:第 44 章。
TOS(Terms of Service,服务条款)
平台对用户行为、上传内容和账号责任的规则。世界发布后,内容不仅要符合素材许可证,也要符合 VRChat TOS 和社区准则。
首次出现:第 44 章。
Creator Economy
VRChat 官方创作者经济系统。玩家用 VRChat Credits 购买世界内商品或订阅,创作者通过 Tilia 提现。
首次出现:第 45 章 · 赞助、商品和创作者经济。
VRChat Credits
VRChat 平台内的商品交易代币。玩家购买 Credits,再用它购买 Listing 或 Subscription;创作者达到门槛后按规则提现。
首次出现:第 45 章。
Tilia
VRChat 用于 Creator Economy 的第三方支付服务商,负责身份验证、资金流转和提现流程。
首次出现:第 45 章。
Authorized Seller(授权卖家)
通过 VRChat 审核、允许在 Creator Economy 里创建和销售商品的创作者账号状态。申请时会审核账号、世界质量、社群活跃度和支付资料。
首次出现:第 45 章。
Products / Listings / Subscriptions / Stores
Creator Economy 的四件套:Products 是买家最终拥有的内容,Listings 是一次性商品,Subscriptions 是周期性订阅,Stores 是购买入口。
首次出现:第 45 章。
Dark Patterns(暗黑模式)
诱导用户做出不利选择的界面或流程设计,如隐藏取消按钮、虚假倒计时、强制订阅等。VRChat Creator Economy 明确禁止这类做法。
首次出现:第 45 章。
Recommended Capacity / Capacity (Hard Cap)
SDK 世界构建面板中的两档实例容量字段。Recommended Capacity 是软上限,达到后实例在公开浏览中曝光下降;Capacity 是硬上限(Hard Cap),达到后新玩家不能再加入(少数 Group / 创建者例外)。容量应结合实测人数、世界用途和平台要求设置。
首次出现:第 23 章 · Event World、应用在第 44 章发布元数据。
外部网址与远程内容
Udon 的 VRCUrl 与下载接口用于受限的远程内容加载,不等同于让浏览器打开商店。需要展示外部入口时提供清楚的网址或二维码;只使用当前 SDK 实际暴露并有官方说明的接口。
参考:External URLs。
backlog
待处理清单。维护世界时常用它收集反馈和想法,再按必修、应修、看情况等优先级排队。
首次出现:第 46 章 · 维护一个世界。
Feature Creep(功能膨胀)
产品或世界在持续迭代中不断加功能,最终偏离核心定位、维护成本变高的状态。可通过记录功能目标、维护成本和变更范围评估新增需求。
首次出现:第 46 章。
IntelliSense
IDE 的自动补全、签名和类型提示功能。检查 API 时还需确认该接口在当前 SDK 中存在,并已向 Udon 暴露。
首次出现:第 47 章 · 继续学习。
Mod
非官方客户端改件。本书只在解释「本地篡改不能作为可信来源」时提到它;VRChat 平台规则通常不允许修改客户端。
首次出现:第 45 章。
接口与限制按所用 Unity / SDK 版本核对;正文回链用于查操作上下文,不能替代官方 API 定义。