{"id":19534848,"url":"https://github.com/feifeid47/unity-onlineprefs","last_synced_at":"2025-10-30T19:31:54.591Z","repository":{"id":142697598,"uuid":"600391304","full_name":"feifeid47/Unity-OnlinePrefs","owner":"feifeid47","description":"一个可以轻松将原本由PlayerPrefs存储的数据同步到云端的插件。提供和PlayerPrefs一样的接口。兼容新老用户，将PlayerPrefs替换成OnlinePrefs，老用户数据不会丢失。","archived":false,"fork":false,"pushed_at":"2023-04-25T01:51:42.000Z","size":19,"stargazers_count":10,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-29T07:22:49.874Z","etag":null,"topics":["csharp","unity","unity3d"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/feifeid47.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-11T10:52:02.000Z","updated_at":"2024-08-30T02:15:59.000Z","dependencies_parsed_at":"2023-05-19T10:31:15.557Z","dependency_job_id":null,"html_url":"https://github.com/feifeid47/Unity-OnlinePrefs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feifeid47%2FUnity-OnlinePrefs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feifeid47%2FUnity-OnlinePrefs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feifeid47%2FUnity-OnlinePrefs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/feifeid47%2FUnity-OnlinePrefs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/feifeid47","download_url":"https://codeload.github.com/feifeid47/Unity-OnlinePrefs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249685298,"owners_count":21310579,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csharp","unity","unity3d"],"created_at":"2024-11-11T02:15:53.943Z","updated_at":"2025-10-30T19:31:54.497Z","avatar_url":"https://github.com/feifeid47.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 特点\r\n\r\n（1）提供和PlayerPrefs一样的接口\r\n\r\n（2）可以轻松的将原本由PlayerPrefs存储的数据同步到云端\r\n\r\n（2）兼容新老用户，将PlayerPrefs替换成OnlinePrefs，老用户数据不会丢失\r\n\r\n# 注意\r\nOnlinePrefs依赖Newtonsoft.Json。(附Nuget地址：https://www.nuget.org/packages/Newtonsoft.Json)\r\n\r\n如果不想引入该库，可以修改`OnlinePrefs.cs`文件中`LoadAsync`方法和`Save`方法中关于序列化和反序列化的实现。\r\n\r\n\r\n# 如何使用\r\n\r\n使用OnlinePrefs前，需要注册`OnLoadRequest`事件和`OnSaveRequest`（用来定义如何将数据存储到云端，如何从云端获取数据），并且执行`LoadAsync`方法同步云端数据。\r\n\r\n完成这几个步骤就可以使用`SetInt`、`SetString`、`SetFloat`、`GetInt`、`GetString`、`GetFloat`等方法。\r\n\r\n以下是使用示例\r\n\r\n\r\n\r\n```C#\r\nprivate async void Awake()\r\n{\r\n    OnlinePrefs.OnLoadRequest += OnLoadRequest;\r\n    OnlinePrefs.OnSaveRequest += OnSaveRequest;\r\n    OnlinePrefs.OnValueChanged += OnValueChanged;\r\n    // 初始化OnlinePrefs\r\n    await OnlinePrefs.Initialize();\r\n\r\n    OnlinePrefs.SetInt(\"XXX\", 0);\r\n    OnlinePrefs.SetString(\"XXX\", \"XXX\");\r\n    OnlinePrefs.SetFloat(\"XXX\", 0);\r\n\r\n    _ = OnlinePrefs.GetInt(\"XXX\");\r\n    _ = OnlinePrefs.GetString(\"XXX\");\r\n    _ = OnlinePrefs.GetFloat(\"XXX\");\r\n}\r\n\r\nprivate Task\u003cbyte[]\u003e OnLoadRequest()\r\n{\r\n    string userID = \"XXX\";\r\n    var request = UnityWebRequest.Get($\"http://localhost:9005/record/{userID}\");\r\n    var completionSource = new TaskCompletionSource\u003cbyte[]\u003e();\r\n    request.SendWebRequest().completed += _ =\u003e\r\n    {\r\n        var data = request.result == UnityWebRequest.Result.Success ? request.downloadHandler.data : null;\r\n        completionSource.SetResult(data);\r\n        request.Dispose();\r\n    };\r\n    return completionSource.Task;\r\n}\r\n\r\n// 将数据保存到云端的示例实现\r\nprivate void OnSaveRequest(byte[] data)\r\n{\r\n    string userID = \"XXX\";\r\n    var request = UnityWebRequest.Post($\"http://localhost:9005/record/{userID}\", \"POST\");\r\n    request.uploadHandler = new UploadHandlerRaw(data);\r\n    request.SendWebRequest().completed += _ =\u003e\r\n    {\r\n        request.Dispose();\r\n    };\r\n}\r\n\r\nprivate void OnValueChanged()\r\n{\r\n    // 数据上传到云端\r\n    OnlinePrefs.Save();\r\n}\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffeifeid47%2Funity-onlineprefs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffeifeid47%2Funity-onlineprefs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffeifeid47%2Funity-onlineprefs/lists"}