游戏创意与功能

你的下一项功能

云端存档

保存游戏进度,在下次启动时加载。

需要玩家会话
Unity
云端存档功能示意图
可见的结果

重启游戏后,已保存的进度会重新加载。

查看云存档1:56

此教程以英语播放。

单独打开视频 ↗

准备同一个项目

  1. 在仪表盘中选择与游戏配置相同的项目。

    云端存档 →
  2. 首次请求不需要额外定义。没有对应游戏数据时,空结果也有效。

    使用测试玩家。此示例会将该玩家的存档替换为等级5和1000金币。

实现此功能

你可以预览指南。运行需要有效的项目密钥。 准备项目

已安装 SDK、导入项目配置,且玩家已登录。

保存C#文件并挂到GameObject,进入Play后检查Console。

C#
Assets/Scripts/CloudSaveDemo.cs
horizOn 调用准备
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Define your save structure
6[System.Serializable]
7public class GameData
8{
9 public int Level;
10 public int Coins;
11}
12​
13// 将此脚本挂到第一个场景中的某个 GameObject 上。
14public class CloudSaveDemo : MonoBehaviour
15{
16 async void Start()
17 {
18 // 准备:初始化、连接并登录玩家。
19 HorizonApp.Initialize();
20 await new HorizonServer().Connect();
21 if (!UserManager.Instance.IsSignedIn)
22 {
23 bool authenticated = UserManager.Instance.HasCachedAnonymousToken()
24 ? await UserManager.Instance.RestoreAnonymousSession()
25 : await UserManager.Instance.SignUpAnonymous("StatisticsPlayer");
26 if (!authenticated) return;
27 }
28​
29 // horizOn:保存玩家数据并重新加载。
30 var data = new GameData { Level = 5, Coins = 1000 };
31 bool saved = await CloudSaveManager.Instance.SaveObject(data);
32 if (!saved) { Debug.LogWarning("Cloud save failed"); return; }
33 var loaded = await CloudSaveManager.Instance.LoadObject<GameData>();
34 if (loaded == null) { Debug.LogWarning("Cloud load failed"); return; }
35 Debug.Log($"Loaded level={loaded.Level}, coins={loaded.Coins}");
36 }
37}
打开完整SDK示例 ↗

测试你的新功能。

重启游戏后,已保存的进度会重新加载。

在仪表盘中选择与游戏配置相同的项目。

接口
  • POST/cloud-save/save
  • POST/cloud-save/load
API 参考中的全部接口
排行榜功能示意图
下一步建议

为每一局添加最高分。

每局结束后保存分数并展示领先者。继续使用现有连接和玩家会话。

教程视频

云端存档Unity3:38

此教程以英语播放。

单独打开视频 ↗