文档

支持

Cloud Code

Open Unity Dashboard

Cloud Code

Cloud Code JavaScript 脚本

Write server-side JavaScript code and call these scripts from games built with Unity or any other client.
阅读时间4 分钟最后更新于 1 个月前
Cloud Code 脚本使用 JavaScript。您可以从使用 Unity 构建的游戏或任何其他客户端或服务器调用这些脚本。

创作方法

描述

Unity Cloud Dashboard使用 Unity Cloud Dashboard 创建和测试脚本。您可以从同一位置访问其他 Unity Gaming Services（Unity 游戏服务）服务，例如 Remote Config。
Unity 编辑器使用 Unity 编辑器编写、测试和捆绑脚本。您可以集成 Deployment（部署）窗口，自动执行工作流程，以及将 Cloud Code 与其他 Unity 服务一起部署。
Unity Gaming Services（Unity 游戏服务）CLI使用 CLI 从命令行部署和管理脚本。一次部署多个 Unity 服务配置，并与 CI/CD 集成。

典型工作流程

以下过程详细介绍了一个典型的开发周期：
  1. 创建脚本。通过 Unity Cloud Dashboard 创建 Cloud Code 脚本并添加自定义参数。
  2. 编写代码。基于示例脚本进行构建或从头开始构建。使用 Cloud Code JavaScript SDK 可与其他 Unity Gaming Services（Unity 游戏服务）服务轻松集成。
  3. 测试和调试。在后台上选择 Run（运行） 并测试函数的结果。使用提供的测试玩家来验证与其他服务的交互情况，或添加日志记录语句来调试问题。如需了解更多信息，请参阅关于如何测试运行脚本的页面。
  4. 发布该脚本。选择 Publish（发布） 以使脚本可供游戏客户端使用。这是添加脚本实时更新的主要机制，这些更新会立即显示在游戏中。
  5. 将脚本与您的项目集成。将 Cloud Code SDK 导入到游戏中，然后从 Unity Runtime 调用脚本。您可以使用 REST API 运行脚本，也可以从 Multiplay 服务器运行脚本。

使用示例

您可以使用 Cloud Code 编写大量游戏逻辑。例如，可以从脚本中连接到不同的服务。要了解如何连接到服务以及游戏机制的工作方式，您可以查看用例。例如，服务器时间反作弊机制、游戏内优惠券和每日奖励。 如需了解更高级的用法，请下载 Unity Gaming Services（Unity 游戏服务）示例项目以了解如何使用 Cloud Code 克服常见的游戏开发挑战，并阅读高级用例。

基本概念

了解 Cloud Code 脚本的基本概念：

主题

描述

创建脚本了解如何创建脚本。
脚本结构了解脚本的结构。
编写脚本了解如何使用 Unity Cloud Dashboard、UGS CLI、REST API 或 Unity 编辑器编写脚本。
运行脚本了解如何从 Unity Runtime、使用 REST API 或从 Multiplay 服务器运行脚本。
测试运行脚本了解如何测试脚本。
错误处理了解如何处理脚本中的错误。
Logging了解如何使用日志记录来调试脚本。

改善工作流程

为了简化脚本的开发和部署，您可以自动执行该过程。

主题

描述

与 CI/CD 集成将脚本的部署与 CI/CD 管线集成。
与 Unity 编辑器集成了解如何在 Unity 编辑器中编写、测试和捆绑脚本。

进一步集成

您可以将模块与其他 Unity Gaming Services（Unity 游戏服务）服务和任何外部服务集成，并访问跨玩家数据。 要与其他服务集成，您可以安装 Cloud Code JavaScript 库或使用 HTTP 客户端。

主题

描述

身份验证了解如何使用 Cloud Code 对游戏客户端进行身份验证。
服务令牌和访问令牌支持了解如何使用服务令牌和访问令牌对脚本进行身份验证。
可用库查找 Cloud Code 脚本适用的 UGS SDK。
访问控制了解如何控制访问并防止不必要的使用。
与 Unity 服务集成了解如何将 Cloud Code 连接到其他 Unity 服务。
与外部服务集成了解如何与外部服务集成。
处理跨玩家数据了解如何访问和更新其他玩家的数据。
Triggers了解如何使用触发器来自动执行服务器端操作。