教程:使用 Azure Functions 的 Cloudscript 本地调试

借助 Azure Functions,你现在可以在本地测试和调试你的 CloudScript 代码。完成本教程后,你可以在调试器(例如在 VS Code 或 Visual Studio)下运行你的本地 Azure Functions 应用,设置断点并运行你的游戏客户端。在本教程中,你将学习如何:

[!div class=“checklist”] * 将 ExecuteFunction 的实现添加到你的本地 Azure Functions 应用 * 添加一个设置文件,告知 PlayFab SDK 从你的游戏中调用该本地实现

先决条件

目前以下 SDK 支持本地调试:

添加 ExecuteFunction 的本地实现

对于 C# Azure Functions 应用

若要在你的 C# Azure Functions 应用中设置 ExecuteFunction 的本地实现,请将 ExecuteFunction.cs 文件添加到你的本地 Azure Functions 应用中。

本地 ExecuteFunction 实现所需的环境变量

将以下设置添加到你的 local.settings.json 文件中:

名称	值
PLAYFAB_TITLE_ID	你的游戏 ID(十六进制形式)
PLAYFAB_DEV_SECRET_KEY	你游戏的密钥。你可以在 Game Manager 中通过点击游戏名称右侧的齿轮图标并转到 Title Settings > Secret Keys 来找到密钥。

例如:

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "...",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "PLAYFAB_TITLE_ID": "B55D",
    "PLAYFAB_DEV_SECRET_KEY": "AAAABBBBCCCCDDDDEEEEFFFFGGGGHHHHIIIIJJJJKKKKLLLLMM"
  }
}

配置 PlayFab SDK 以调用本地 ExecuteFunction 实现

若要告知 PlayFab SDK 将 ExecuteFunction API 调用重定向到你的本地实现,请将一个名为 playfab.local.settings.json 的文件添加到以下两个位置之一:

你机器上的临时目录
- 在 Windows 上,这是 TEMP 环境变量
- 在 Linux/Mac 上,这是 TMPDIR 环境变量
你的游戏可执行文件所在的目录

将文件内容设置为如下所示:

{ "LocalApiServer": "http://localhost:<portNumber>/api/<functionName>" }

如果你希望停止本地重定向,让 ExecuteFunction 调用 PlayFab API 服务器,请删除 playfab.local.settings.json 文件。

其他资源

Azure Functions 有一份关于如何在本地测试和调试你的 Functions 的优秀指南。以下是上述文档中的一些要点。

确保你已安装 Azure Functions Core Tools
配置你的本地设置文件。有关更多信息,请参阅使用 Visual Studio Code 开发 Azure Functions
在你的代码中设置断点
选择 F5 开始调试

​教程:使用 Azure Functions 的 Cloudscript 本地调试

​先决条件

​添加 ExecuteFunction 的本地实现

​对于 C# Azure Functions 应用

​本地 ExecuteFunction 实现所需的环境变量

​配置 PlayFab SDK 以调用本地 ExecuteFunction 实现

​其他资源

教程:使用 Azure Functions 的 Cloudscript 本地调试

先决条件

添加 ExecuteFunction 的本地实现

对于 C# Azure Functions 应用

本地 ExecuteFunction 实现所需的环境变量

配置 PlayFab SDK 以调用本地 ExecuteFunction 实现

其他资源