sgtcloud-html5-sdk
介绍
A html5 out-of-box sdk for damn cool mbaas.
了解更多, 请访问我们的主页 http://www.sgtcloud.cn
安装
-
直接下载最新版本的 release
-
解压该 release
-
在 $release/dist 目录中选择你需要的sdk
-
引入sdk到你的项目中
入门
将 sdk 引入到项目中 :
<script src="sgtcloud-html5-sdk.2.1.3.min.js"></script>
或则使用CDN的方式 :
<script src="http://www.sgtcloud.cn/dist/sgtcloud-html5-sdk.2.1.3.min.js"></script>
点击 申请应用标识
首次使用需要初始化应用标识 :
SgtApi.init({
appId: 'xxx' //填写应用标识
});
生成一个简单实体 :
var user = new sgt.User();
user.userName = 'xxx';
user.password = 'xxx';
再调用一个简单业务, 每个业务的最后一个参数都是一个回调函数 :
sgt.UserService.quickLogin(function(result, data) {
if (result) {
// .....
// 快速登录成功代码块
} else {
// .....
// 快速登录失败代码块
}
});
当登录/注册成功后, 解锁其他服务,这时可以操作该用户去执行其他服务
文档
技术架构
sdk 采用了 jsonrpc2.0 的通讯协议
业务模块
-
用户
User - UserService -
角色
Player - PlayerService -
角色扩展
PlayerExtra - PlayerExtraService -
成就
Achievement - AchievementService -
公告
Announcement - AnnouncementService -
活动
Campaign - CampaignService -
签到
CheckinBoard - CheckinBoardService -
任务
Task - TaskService -
日常任务
DailyTask - DailyTaskService -
好友
Friendship - FriendshipService -
好友扩展
FriendshipExtra - FriendshipExtraService -
黑名单
Blacklist - BlackListService -
抽奖
GachaBox - GachaBoxService -
排行榜
LeaderBoard - LeaderBoardService -
邮件
Mail - MailService -
通知
Notification - NotificationService -
充值
Purchase - PurchaseService -
商城
Store - StoreService -
计费点
ChargePoint - ChargePointService -
Boss
Boss - BossService -
文件存储
FileStorage - FileStorageService -
礼包
GiftCode - GiftCodeService -
个人通道
PrivateChannel - PrivateChannelService -
公共通道
PublicChannel - PublicChannelService -
第三方
DelegateDid - DelegateDidService -
结构化数据
StructuredDate - StructuredDateService -
反馈
Ticket - TicketService -
微信中控
WxCentralService -
用户留资
UserLeaveInfo - UserLeaveInfoService -
随机角色名
RandomNameGroupService -
Socketio服务 SocketService
定制sdk
我们目前版本的sdk经过uglify+gzip后约40kb,如果开发者觉得仍然太大的话,可以通过裁剪源码的方式来构建更小的sdk。我们所有的服务都是以模块化来构建的,开发者可以通过删除源码中没用到的模块,然后按照手册中的方式构建自己的sdk。目前的核心模块包含jsonrpc,init(上下文),常量和用户模块(UserService)和路由模块(RouterService),经过uglify+gzip后一共约10kb,是必须保留的,其他的服务模块可以根据自己的需要进行裁剪,更多的需求和技术支持请直接联系我们。
贡献
如果你有好的意见或建议,欢迎给我们提 issue 或 pull request,为提升 sgtcloud-html5-sdk 贡献力量
License
The MIT License(http://opensource.org/licenses/MIT) 请自由地享受和参与开源