云存储 API（已停用）

• 保存应用程序使用和安装之间的进度。用户可以卸载并重新安装而不会丢失已保存的数据。
• 跨设备共享进度。用户可以在不同设备之间同步数据。
• 提供灾难恢复。如果设备丢失、损坏或本地数据损坏，用户数据可以恢复。

注意：云存储在 Meta Quest 设备上可用。请避免使用云存储来存储用户的个人身份信息。

• 权限：由于默认位置是外部存储，因此使用云存储 v2 的 Android 应用将需要 WRITE_EXTERNAL_STORAGE 权限。如需了解更多信息，请参阅 Android 文档中的权限概述⁠和 WRITE_EXTERNAL_STORAGE⁠。

  注意： 在 Android 中，从 Meta Quest 软件版本 19 开始，不再需要 WRITE_EXTERNAL_STORAGE 权限。

• 冲突解决： 在应用启动时，如果云端和本地设备之间存在文件冲突，系统将提示用户选择设备数据或云数据，或者他们可以选择取消应用启动。
• 路径和文件名限制：为兼容所有平台，您必须将路径称名长度限制在 260 个字符以内，将文件名称限制在 255 个字符以内。
• 文件类型： 您可使用云存储存储任何文件类型。
• 文件数量/大小：每个应用程序或应用程序分组可同步 100 个文件，每个文件最大为 10 MB。
• 选择性同步：您可以选择性地指定某些文件夹和/或文件进行同步。选择性同步文件路径必须以正斜杠开头，且可在目录、文件名或文件扩展名中包含通配符 (*)。其他特殊字符和一些文件名是不允许的。如需了解详细要求，请参阅选择性同步。
• 获取本地存储位置：使用 Platform.CloudStorage2.GetUserDirectoryPath() 方法获取用户设备上文件的保存目录。

1. 登录 Meta Horizon 开发者面板⁠。
2. 选择您的应用。
3. 在左侧导航栏中选择开发 > 云存储。
4. 在云存储页面上，将启用自动云备份切换为开。
   现在，用户设备上的默认目录中的文件将自动同步到云端。
   注意：由于平台兼容性原因，以下名称的文件将不会同步到云端：CON、PRN、AUX、NUL、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM0、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、LPT0。如需了解更多信息，请参阅 Windows 桌面 - 命名文件⁠。

注意：若您未看到配置同步位置的选项，请确保在启用云存储 v2 选项后进行了保存。

• 输入路径。路径要求如下：
  • 必须以正斜杠开头。
  • 目录名中可包含一组通配符 (**)
  • 文件名和扩展名中可包含多个通配符 (*)。
  • 不能包含任何其他特殊字符 (\ :? “<> | &)，否则路径将被忽略。
  • 长度不能超过 260 个字符。单个文件名不得超过 255 个字符。
  例如，/scores/*.dat 是一个有效的选择性同步路径。
• 点击提交

• 在开发者控制面板中，找到您的应用程序或应用程序分组并转到云存储。
• 在云存储页面上，在云存储 2 下，在选择性同步表中找到您要修改的路径。
• 点击该行中的省略号 (...) 按钮并选择编辑或删除
• 在完成路径编辑或确认删除后点击提交。

1. 要检索设备保存位置，请调用 Platform.CloudStorage2.GetUserDirectoryPath() 方法。
2. 然后，使用 Message_GetString 解析此调用的结果。