数据存储 .NET SDK 配置指南
信息
.NET SDK 基于 .NET Standard 2.0 接口标准实现,支持框架如下:
- Unity 2018.1+
- .NET Core 2.0+
- .NET Framework 4.6.1+
- Mono 5.4+
更多支持框架可参考 .NET Standard 文档。
获取 SDK
通过 GitHub 仓库 Releases 下载最新版本 SDK。
各模块及依赖关系如下:
名称 | 模块描述 |
---|---|
LeanCloud-SDK-Storage | 存储服务。 |
LeanCloud-SDK-Realtime | 即时通信依赖于存储服务。 |
LeanCloud-SDK-Engine | 云引擎服务,依赖于存储,适用于云引擎服务端环境。 |
如只需使用某种服务,可下载最小依赖包,减小程序体积。
Unity 项目安装
-
直接导入:请下载 LeanCloud-SDK-XXX-Unity.zip,解压后为 Plugins 文件夹,拖拽至 Unity 即可。
-
UPM:请在项目的 Packages/manifest.json 中添加依赖项
"dependencies": {
"com.leancloud.storage": "https://github.com/leancloud/csharp-sdk-upm.git#storage-2.3.0",
"com.leancloud.realtime": "https://github.com/leancloud/csharp-sdk-upm.git#realtime-2.3.0"
}
注意:仅支持 Unity 2018+,即 Unity Api Compatibility Level 支持 .NET Standard 2.0 的版本。
非 Unity 项目安装
.NET Core 或其他支持 .NET Standard 2.0 的项目请下载 LeanCloud-SDK-XXX-Standard.zip,解压后设置依赖即可(XXX 指云服务,包括存储 Storage,云引擎 Engine)。
初始化
信息
TapSDK 初始化时,会自动执行这一节的初始化方法。
如果已经参考 快速开始 文档完成了 TapSDK 初始化,则不需要参考这里的初始化。
导入模块:
// 导入基础模块
using LeanCloud;
// 导入存储模块
using LeanCloud.Storage;
using LeanCloud.Realtime;
在使用服务前,先调用如下代码初始化 SDK:
LCApplication.Initialize("your-client-id", "your-client-token", "https://your_server_url");
应用凭证
在 开发者中心 > 你的游戏 > 游戏服务 > 应用配置 可以查看应用的基本信息:
- Client ID:又称
App ID
,在 SDK 初始化时用到。 - Client Token:又称
App Key
,客户端对服务端的调用凭证,在 SDK 初始化时用到。 - 域名配置 > 云服务 API:又称 API 域名或 Server URL,在客户端 SDK 初始化时用到。域名配置参考下一节域名。
- Server Secret:又称
Master Key
,用于在自有服务器、云引擎等受信任环境调用管理接口,具备跳过一切权限验证的超级权限。所以一定注意保密,千万不要在客户端代码中使用该凭证。