BadgeKeeper 0.2.9

BadgeKeeper 0.2.9

测试已测试
语言语言 Obj-CObjective C
许可 Apache 2
发布上次发布2015年10月

Badge Keeper 维护。



Badge Keeper

Badge Keeper iOS 库将帮助您轻松地将成就系统添加到您的应用中。

入门

要将 Badge Keeper 库集成到您的 iOS 项目中,请使用 CocoaPods 安装

platform :ios, '7.0'
pod 'BadgeKeeper'

使用方法

导入头文件

#import <BadgeKeeper/BadgeKeeper.h>

基本初始化

[BadgeKeeper instance].projectId       = @"Project Id from admin panel";
[BadgeKeeper instance].userId          = @"Your client id";
[BadgeKeeper instance].shouldLoadIcons = YES; // default is NO

以上是需要配置的所有设置。

回调函数

我们将使用四个回调函数从 Badge Keeper 服务接收结果

// 1 - Returns array of BKAchievement elements
typedef void (^BKAchievementsResponseCallback)(NSArray *achievements);

// 2 - Returns array of BKUserAchievement elements
typedef void (^BKUserAchievementsResponseCallback)(NSArray *achievements);

// 3 - Returns array of BKUnlockedAchievement elements
typedef void (^BKAchievementsUnlockedCallback)(NSArray *achievements);

// 4 - Returns error code and error message if something goes wrong
typedef void (^BKFailureResponseCallback)(int code, NSString *message);

获取项目成就(无需 userId)

[[BadgeKeeper instance]
    getProjectAchievementsWithSuccess:^(NSArray *achievements) {
        // Returns array of BKAchievement elements
    }
    withFailure:^(int code, NSString *message) {
        // Returns error code and error message if something goes wrong
    }];

获取用户成就

[[BadgeKeeper instance]
    getUserAchievementsWithSuccess:^(NSArray *achievements) {
        // Returns array of BKUserAchievement elements
    }
    withFailure:^(int code, NSString *message) {
        // Returns error code and error message if something goes wrong
    }];

上传用户变量并验证已完成的成就

[[BadgeKeeper instance] preparePostValue:0 forKey:@"key"];
[[BadgeKeeper instance]
    postPreparedValuesWithSuccess:^(NSArray *achievements) {
       // Returns array of BKUnlockedAchievement elements
    }
    withFailure:^(int code, NSString *message) {
        // Returns error code and error message if something goes wrong
    }];

增加用户变量并验证已完成的成就

[[BadgeKeeper instance] prepareIncrementValue:1 forKey:@"key"];
[[BadgeKeeper instance]
    incrementPreparedValuesWithSuccess:^(NSArray *achievements) {
       // Returns array of BKUnlockedAchievement elements
    }
    withFailure:^(int code, NSString *message) {
        // Returns error code and error message if something goes wrong
    }];

要求

  • Xcode 6.0 或更高版本。
  • iOS 7 或更高版本。

许可

Copyright 2015 Badge Keeper

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://apache.ac.cn/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.