brainCloud Objective-C/Swift库
感谢您下载brainCloud Objective-C/Swift客户端库!以下是一些建议以帮助您开始。有关brainCloud API的更多信息,包括示例教程,可在此处找到
http://getbraincloud.com/apidocs/
如果您尚未注册或想要登录到brainCloud门户,可以在此处操作
https://portal.braincloudservers.com/
发布
打包 | 描述 |
---|---|
Cocoapod | Cocoapod用于AppleTV、iOS、OSX |
brainCloudClient_ObjC_X.X.X.X.zip | AppleTV、iOS、OSX的Apple库 |
示例项目
在您的Swift项目中使用brainCloud的示例可以在这里找到:这里。
安装
该库通过CocoaPods
进行分发。为了安装该库,只需将以下内容添加到您的Podfile
中。
pod 'BrainCloud'
请注意,如果您使用的是Cocoapods 1.0.0及其use_frameworks!标志,请参阅项目设置页面以获取更多信息。
http://getbraincloud.com/apidocs/tutorials/objective-c-tutorials/
如果您是CocoaPods世界的初学者,您可以在此处找到如何在Xcode项目中设置项目的文档。
https://guides.cocoapods.org.cn/
故障排除
以下是在尝试连接到brainCloud时可能会遇到的几个常见错误。
- 未设置App id:请确认您已在
initialize()
方法中正确设置了App id和app密钥。 - 平台未启用:请确认您已在门户中启用了您的平台。
如果您仍然遇到问题,请登录门户并通过帮助系统(底部右边的问号和聊天气泡图标)给我们留言。
brainCloud概述
brainCloud是一个现成的丰富功能游戏、应用程序和设备后端平台。brainCloud提供了您所需的功能,以及全面的支持工具,以帮助您的团队在开发、测试和用户支持期间工作。
brainCloud包括
- 云服务 - 先进的高级软件即服务(SaaS)后端
- 客户端库 - 本地客户端库(SDK)
- 设计门户 - 允许您设计和调试应用程序的门户
- brainCloud架构
BrainCloud Wrapper和BrainCloud Client的区别是什么?
Wrapper包含了围绕BrainCloud Client的一些质量提升功能。它可能包含特定设备的代码,例如在Android或iOS设备上序列化用户的登录ID。建议默认使用Wrapper。
如何初始化BrainCloud?
如果使用Wrapper,请使用以下代码。
_bc = [[BrainCloudWrapper alloc] init]; // optionally pass in a _wrapperName
[_bc initialize: @"https://api.braincloudservers.com/dispatcherv2"
secretKey:_secret
appId:_appId
version:_version
companyName:_company
appName:_appName];
您的_appId, _secret在BrainCloud仪表板上设置。在Design | Core App Info > Application IDs下
_wrapperName为Wrapper将要执行的操作前缀。如果您计划运行多个BrainCloud实例,请使用_wrapperName。
刚刚升级?
如果您的应用已经上线,请不要指定_wrapperName,否则库会在错误的位置查找用户的存储匿名ID和profileID信息。只有当您打算更改保存数据时,才添加名称。
_companyName和_appName也用于确定文件名。例如:bitHeads.exampleApp或mainWrapper.bitHeads.exampleApp
_appVersion是应用程序的当前版本。如果_appVersion小于BrainCloud上您的最低应用版本,则会阻止用户访问服务,直到他们更新应用程序到您提供的最新版本。
如何保持brainCloud SDK更新?
在你的项目更新循环中,你想要更新brainCloud客户端,以便它可以检查响应。
要这么做,你需要调用runCallbacks。
[_bc runCallbacks];
如何使用brainCloud进行用户认证?
使用brainCloud Wrapper进行认证的最简单形式是匿名认证。
[_bc authenticateAnonymous:_successBlock errorCompletionBlock:_failureBlock cbObject:nil];
这种方法将创建一个账户,并继续使用本地保存的匿名ID。
你的_successBlock和_failureBlock将包含响应 brainCloud 服务器所需的处理代码块。
要使用特定的匿名ID进行登录,请使用brainCloud客户端。
[[[_bc getBCClient] authenticationService] setAnonymousID:_anonymousId]; // re-use an Anon id
[[[_bc getBCClient] authenticationService] setAnonymousID:[[[_bc getBCClient] authenticationService] generateAnonymousId]]; // or generate a new one
[[[[_bc getBCClient] authenticationService] authenticateAnonymous:_forceCreate completionBlock:_successBlock errorCompletionBlock:_failureBlock cbObject:nil]];
将_forceCreate设置为false将确保用户只能登录到现有的账户。将其设置为true将允许用户注册新账户。
如何将电子邮件附加到用户的brainCloud配置文件?
用户创建了匿名账户后,他们可能想附加电子邮件或用户名,这样他们的账户就可以通过其他平台访问,或者当本地数据被丢弃时。附加电子邮件认证看起来像这样。
[[_bc identityService] attachEmailIdentity:_email
authenticationToken:_password
completionBlock:_successCallback
errorCompletionBlock:_failureCallback
cbObject:nil];
有许多认证类型。您还可以合并配置文件和删除身份。有关更多信息,请参阅brainCloud文档:http://getbraincloud.com/apidocs/apiref/?java#capi-auth