网格 201 教程第 5 章：获取实时天气数据

项目
08/22/2024

在本章中，我们将转到 Station 4，你将了解如何使用网格云脚本从内部或公共源获取数据，然后在场景中的 3D 上下文中将其可视化。如第 1 章所述，此处的前提是，体验中的与会者可以使用此站了解他们正在考虑建造风电场的三个地点的天气状况。与会者将能够单击交互式地球，并查看来自三个地点的实时天气数据。

车站 4 和 5 位于上一站的 Sphere 露台的另一端。

__________________________________

为此工作站设置

若要完成此工作站，需要将密钥插入到某些代码中，以便访问天气数据 API。现在，让我们获取此密钥，以便以后无需中断工作流。

导航到 weatherapi.com 注册页面。
在该页上，按照说明注册试用计划。

你需要打开他们发送的电子邮件，激活你的帐户，然后在他们的网站上登录。
在 “欢迎返回 ”页上，单击“专业加号计划”。
在本教程中，不需要有付费计划。 单击“免费”下的降级按钮，然后在弹出的对话框中单击“关闭”。
在仪表板下的左侧菜单中，选择 API。
选择 API 密钥字段旁边的“复制”按钮，然后将密钥粘贴到文本编辑器中，然后保存文本文件。

如果复制操作成功，“复制”按钮上的文本将更改为“已复制”。

添加网格云脚本 prefab

打开 StartingPoint 场景。
在层次结构中，右键单击空白区域，然后在上下文菜单中选择“网格工具包>设置云脚本”。

这会添加一个名为 Mesh Cloud Scripting 的 GameObject，该脚本具有附加了同名的组件。

要控制云脚本的任何 GameObject 都必须作为子 级添加到网格云脚本 GameObject。

注意： 网格云脚本 组件包含名为 “启用视觉脚本”的属性。这使网格云脚本能够与视觉脚本进行通信。可以保留此未选中状态。

为工作站 4 添加 prefab

在 Project 文件夹中，导航到 Assets>MeshCloudScripting，然后将 4 - GlobeWithCloudScripting 拖到层次结构，并将其作为子对象放置在网格云脚本中。

此 prefab 提供文本信息框和一个名为地球的嵌套预制表，其中包含地球的模型。
调整视图，使你直接位于车站 4 前面并查看。

插入用于 weatherapi.com 的 API 密钥

在层次结构中，选择网格云脚本 GameObject。
在检查器中，导航到网格云脚本组件，然后单击“打开应用程序”文件夹。

这会打开包含 Windows 文件资源管理器中网格云脚本的文件的文件夹。
打开名为 appsettings 的文件。 在代码编辑器中UnityLocalDev.json。文件中的最后四行代码包含配置设置。

无需为此第一行执行任何操作...

"WEATHER_API_URI": "http://api.weatherapi.com/v1/current.json?key="

...但在下一行中，将“在此处粘贴天气 API 密钥”文本替换为之前复制的 API 密钥。

可以忽略最后两行-我们将在下一章中使用这些行。
保存并关闭 JSON 文件。

更新 csproj 文件

在显示网格云脚本文件的文件资源管理器窗口中，在代码编辑器中打开名为 StartingPoint.csproj 的文件。
复制以下文本：

<ItemGroup> <Folder Include="WeatherAPI\" /> </ItemGroup>

...然后将其粘贴到文件末尾的正上方 </Project> 的文件。

这可确保从本地 WeatherAPI 文件夹中包括一些脚本。
保存并关闭该文件。

添加使全球交互的代码

在显示网格云脚本文件的文件资源管理器窗口中，在代码编辑器中打开名为App.cs的文件。

我们将做的第一件事是确保当与会者单击全球时，刷新天气数据的显示。
在App.cs文件中，找到方法内 StartAsync() 的第一个“在此处粘贴代码”注释。

复制以下代码。

    var refreshButton = _app.Scene.FindFirstChild("Earth", true) as TransformNode;
    var refreshButtonNode = refreshButton?.FindFirstChild<InteractableNode>(true);

    if (refreshButtonNode != null)
    {
        refreshButtonNode.Selected += async (_, _) =>
        {
            await GetCurrentWeather(_latlong);
        };
    }

将刚刚找到的“在此处粘贴代码”注释替换为复制的代码。

该代码执行以下操作：
- 使用场景中的 Earth GameObject 初始化 refreshButton 变量。
- 使用附加到 Earth GameObject 的 InteractableNode 初始化 refreshButtonNode 变量。 （如果场景中的 GameObject 有 附加的网格可交互安装 组件，地球会执行该操作，该组件会添加网格云脚本交互Node。
- 当与会者单击全球时，它会触发 InteractableNode 的 Selected 事件并调用 GetCurrentWeather 方法。这会生成一个 HTTP 请求来获取天气数据。
保存文件。