Func Stateless C# 示例教程

1. 准备工作

本教程将以抽卡 Demo 为例，来展示 UOS Func Stateless C# 的入门操作步骤，完成教程需要下载以下内容。您可以选择以下任意一种 DEMO 进行测试。

「DEMO (STORAGE)」 会将用户数据存储到 「CRUD - Storage」 中开启的 MongoDB 数据库中.

「DEMO (CLOUDSAVE PASSPORT)」 会将用户数据存储到 「CRUD - Save」中，并通过「Passport」实现用户登陆.

开启其他 UOS 服务
在 DEMO (STORAGE) 中，我们是使用了 Mongo 数据库来进行数据持久化。因此，我们建议您在项目中同步启用「CRUD Storage」来完整体验基于 Func Stateless 实现的抽卡演示功能。
您可以参考「CRUD Storage 示例教程」来创建 Mongo 数据库。 Demo 需要您创建的数据库运行。

在 DEMO (CLOUDSAVE PASSPORT) 中, 我们建议您在项目中同步启用「CRUD Save」和「Passport」。
您可以参考「Passport Login 接入指南」来配置是否需要模拟短信验证和模拟实名认证。

2. 创建 Func Stateless 应用

首先需要在 UOS 控制台中启用 Func Stateless，并且选择脚本语言为 「Dotnet」。（如何创建 UOS APP ？）

需要注意的是，在启用 Func Stateless 时需要对云函数运行的环境进行设置。目前暂时不支持在后续使用过程中对云函数的运行环境进行修改。

3. 配置项目工程

首先需要解压下载好的 Unity 工程项目，使用 Unity 编辑器打开。

建议使用 2022 及以上版本 Unity 打开, 注意：Demo 内资源(字体、材质、预制件等)仅用于学习交流，如需使用请自行购买。

打开 「Assets/Scenes/Demo.unity」 场景。

点击 「Import TMP Essentials」 导入资源。

导入完成资源后，点击菜单栏 「UOS -> Open Launcher」。在 UOS 面板中填写 AppID/AppSecret/AppServiceSecret，并点击 「Link App」 与 UOS APP 关联。

注：此处 AppId 、 AppSecret 和 AppServiceSecret，可在 UOS 网站上获取

4. 本地调试

您可以直接在 Unity 编辑中点击运行，进行调试。

在本地调试中，您所有的代码都在本地运行。因此，在此模式下您可以快速地开发、调试和验证您的代码逻辑，无需打包成云函数进行运行。

在本 demo 中不需要通过额外的步骤注册用户名和密码，可以在体验过程中可以使用任意的用户名和密码进行登录。如果登录时数据库中不存在当前用户名相关的记录，那么会自动对该用户名进行注册。

5. 上传云函数

当您验证完成您的代码逻辑或您需要打包项目的时，请先切换成远程模式，上传云函数后再进行验证远程调用或打包项目。

通过点击菜单栏 「UOS -> Func Stateless -> Open Panel」 打开 「Func Stateless Tool」。点击上传「上传云函数」后等待云函数的构建和部署。

当云函数构建完成后，工具会自动将您的云函数部署到 Func Stateless。您可以通过点击工具中的时间戳快速跳转到网页控制台查看函数部署情况。随后，您可以通过模式切换来选择是否调用云函数。

当云函数部署完成后，您可以在工具中切换到 「远程调用」，随后运行项目。您可以在网页控制台上查看云函数的调用日志，验证项目是否成功的调用了云函数。