教程：云变量使用

云变量快速入门教程

由于“云变量 (Cloud Variables)”主页面信息量非常大，本教程旨在作为一个快速指南，教你创建、写入和读取这些变量，并设计为分步流程，让你能立即上手。相比主页面，这应该更容易理解。

所需准备

• 预期先决条件（拥有 Resonite 账号并登录，网络连接通畅等）
• 可用的云变量存储空间（每个人都有 256 个可用名额，如果你拥有群组则更多）

设置

用户端需要进行少量的设置工作。但一旦设置完成，在进入 ProtoFlux 部分之前就不需要再操心了。

Resonite Bot (机器人)

我们需要使用 Resonite Bot 来操作云变量指令。虽然有完整的指令列表和各种可替换参数，为了方便设置，我们这里直接使用完整版本的指令。如需查看完整指令集，请查阅 云变量指令列表。

我们将使用以下格式：
/createUserVar <路径> <类型> <默认值> <读取权限> <写入权限> <列出权限>

作为一个示例，假设我们需要一个 String (字符串) 类型来存储信息，并且允许我们的任何好友访问这个信息表。下面的指令是我们发送给 Resonite Bot 的内容，你可以根据喜好随意修改（例如更改 支持的数据类型 或 用户定义权限）。

• /createUserVar MyVariable string:8192 <defaultval> variable_owner_unsafe variable_owner_unsafe anyone

有时我们需要删除不再需要的变量，或者想通过删除并重建来清空数据表。例如要删除我们要刚刚创建的变量：

• /deleteUserVar MyVariable

ProtoFlux

既然变量已经创建好了，让我们立即使用它。

写入 (Write)

要写入云变量，请设置并生成 ProtoFlux 节点 Write Cloud Variable。（连接方式请参考图片）。

• Path (路径) 应该是变量名加上用户 ID 前缀：U-AmasterAmaster.MyVariable
• VariableOwnerId (变量所有者 ID) 应该是变量所有者的用户 ID，基本上就是希望在云端使用此数据表的任何人：U-AmasterAmaster。这不一定非要是你自己，可以是任何人的 ID。
• Value (值) 是你想写入其中的任何内容，只要类型匹配即可。

读取 (Read)

要读取云变量，请设置并生成 ProtoFlux 节点 Read Cloud Variable。（连接方式请参考图片）。

• Path (路径) 应该是变量名加上用户 ID 前缀：U-AmasterAmaster.MyVariable
• VariableOwnerId (变量所有者 ID) 应该是变量所有者的用户 ID，基本上就是希望在云端使用此数据表的任何人：U-AmasterAmaster。这不一定非要是你自己，可以是任何人的 ID。

总结

云变量本不该像看起来那么难，只要有足够的时间设置，并了解这些变量的工作原理，你就可以在项目中自如使用它们，而不会感到困惑。