首次运行客户端
更新时间：2024-09-25
首次运行客户端Unity工程，所需要的配置流程
1.元宇宙能力底座客户端工程介绍
下面介绍如何在项目工程中运行就绪的场景，首先我们先了解下整个元宇宙应用构成分为MetaStack客户端和Metastack副本工程两个工程构成 MetaStack客户端（以下简称Client）：由业务组件（例如 社交 互动 主ui等 对应的功能模块），客户端内核(引擎内核 通讯机制 资源加载机制 原生库管控) Metastack副本工程（以下简称World）：Client启动运行的世界（这里可以理解为用户的主世界），而主世界的地图场景又对应了各自独立的副本场景 Instance（副本）：副本是针对世界各地标的延伸，可以由开发者自行设计地标对应的展馆内风格和功能，同样也是通过Client加载跳转 所有World本身也是一个Instance，元宇宙应用的开发者构建World，同时也可以吸引更多生态开发者构建Instance
2.下一步我们来通过Client启动World
2.1工程运行逻辑
应用的初始化逻辑：Start
- 初始化
- 启动Wecome场景
- 启动Initialize场景 1> 服务协议弹 2> 客户端SDK启动 3> 版本更新 4> 热更新
- 加载主版本数资hotfix
- 加载副本资源
- 场景显示
3. 启动准备
3.1 运行依赖
运行前准备，将zip解压后的文件放入StreamingAssets下。（运行依赖）
3.2 入口类与核心类
主场景Main，通过Main场景加载所有业务逻辑，ClientManager为入口脚本，挂载所有所需运行的初始业务逻辑。
3.3 Client本地调试模式
本地项目运行前需要做的准备工作，首先找到main场景了解ClientManager的相关配置
3.4配置参数调整
| 名称 | 类型 | 参数 | 说明 | 备注 |
|---|---|---|---|---|
| Enviroment | enum | TEST_ENVIROMENT （多租户联调环境）ONLINE_ENVIROMENT(正式环境) | 项目运行的后端环境，多租户联调环境用于开发者第一次熟悉整个底座开发流程的研发联调环境。正式环境为线上环境。 | |
| Version | enum | NORMAL（online阶段）DEVELOPVERSION(dev阶段) | 项目运行后端环境的不同阶段，每个环境都有3个阶段构成，dev（开发阶段）->aduit(审核阶段)->online(线上阶段) | 阶段的变化与MetaStack运营管理系统挂钩。开放平台-发布测试版： 空间id添加到dev阶段。运营后台-审核：空间id添加到aduit阶段。运营后台-上线：空间id添加到online阶段 |
| debugautologin | bool | 默认在Unity Editor环境下是自动登录（调试游客模式取消勾选） | ||
| debugSkipVersionUpdate | bool | 用于Unity Editor环境下调试跳过版本升级 | ||
| debugSkipHotfixUpdate | bool | 用于Unity Editor环境下调试跳过资源热更新 | ||
| debugSkipChooseEnvironment | bool | 用于Unity Editor环境下调试跳过环境选择 | ||
| debugNewAccount | bool | 用于在Unity Editor环境下模拟新用户（必须为Normal方式登录） | ||
| baiduUseLocal | bool | 主版本数资使用本地/远程。本地数资直接使用工程内的数资，无需编译Addressable，改动即时生效。远程数资依赖需要取消勾选。debugSkipHotfixUpdate ，客户端会先下载远程数资到persistentdatapath目录再加载。改动依赖打Addressable包并发布。 | ||
| ThirdPartyLocal | bool | 副本数资使用本地/远程。主工程中默认不勾选 | ||
| debugBDUSS | sting | //用于在Unity Editor环境下调试Passport登录 | BDUSS可以从登入百度账号的网页Cookie中获取，网络 -HTML-cookie-BDUSS，BDUSS会定时刷新，所以最好24小时检查一下BDUSS是否发生变更。 |
4. 运行场景
第一次进入需要创建账号，后续等待资源加载完成即可，演示的场景为希壤大世界，开发者则可自建对应场景
