数据接入iOS SDK集成指南

Dominic · 发表于 2015-1-27 20:21:57

第一步：将 SDK 导入到你的工程中

登录机智云官方网站下载并解压最新版本的SDK。
将解压后的 GizDataAccess.framework 拖动并复制到项目的 Frameworks 目录即可

第二步：引入头文件和注册 SDK 的 AppID

登录机智云官方网站查看产品信息获得 AppID 。
初始化 SDK

打开 *AppDelegate.m(*代表你的工程名字) 导入文件头

#import <GizDataAccess/GizDataAccess.h>

在 - (BOOL)application:didFinishLaunchingWithOptions:方法中调用 startWithAppID 方法来初始化 SDK，指定APPID.

- (BOOL)application

UIApplication *)application didFinishLaunchingWithOptions

NSDictionary *)launchOptions { //Init SDK [GizDataAccess startWithAppID

“APP_ID”]; // …… return YES;}第三步：用户登录

注册用户登录委托

如下 GizDataAccessLogin* gdaLogin = [[GizDataAccessLogin alloc] initWithDelegate:YOUR_LOGIN_DELEGATE];

实现用户登录的委托方法

如下

- (void)gizDataAccessDidLogin

GizDataAccessLogin *)login uid

NSString *)uid token

NSString *)token result

GizDataAccessErrorCode)result message

NSString *)message { if(result == kGizDataAccessErrorNone) { // 登录成功 // …… } else { // 登录失败 // …… }}

用户登录
当前版本提供匿名登录方式，SDK会生成默认的用户名。

如下 [gdaLogin loginAnonymous];

第四步：数据接入

注册数据接入委托

如下 GizDataAccessSource* gdaSource = [[GizDataAccessSource alloc] initWithDelegate:YOUR_DATAACCESS_DELEGATE];

数据上传

实现数据上传的委托方法

如下

- (void)gizDataAccessDidSaveData

GizDataAccessSource *)source result

GizDataAccessErrorCode)result message

NSString *)message { if(result == kGizDataAccessErrorNone) { // 数据上传成功 // …… }}

数据上传
数据上传时，应指定数据的产生时间，数据格式为标准的JSON。

如下 [gdaSource saveData“YOUR_LOGIN_TOKEN” productKey“YOUR_BT_PRODUCT_KEY” deviceSN“YOUR_BT_DEVICE_SN” timestampATA_TIMESTAMP attributes“YOUR_DATA”];

获取数据

实现获取数据的委托方法
获取到的数据内容，按以下键值对方式提供：
@"attrs" : { [dynamic_keys] : [dynamic_values], ... },
@"uid" : [uid],
@"sn" : [sn],
@"ts" : [ts],
@"product_key" : [product_key]

如下

- (void)gizDataAccessDidLoadData:(GizDataAccessSource *)source data:(NSArray *)data result:(GizDataAccessErrorCode)result errorMessage:(NSString *)message { if(result == kGizDataAccessErrorNone) { // 获取数据成功 for(NSDictionary *dict in data) { NSString* sn = [dict valueForKey

"device_sn"]; NSString* productkey = [dict valueForKey

"product_key"]; NSString* uid = [dict valueForKey

"uid"]; NSNumber *nTS = [dict valueForKey

"ts"]; NSDictionary* attributes = [dict valueForKey

"attrs"]; NSLog(@"sn:%@ productkey:%@ uid:%@ nTS:%@ attributes:%@", sn, productkey, uid, nTS, attributes); } }}

获取数据
获取数据时，需指定起止时间段。如果limit值为0将只返回20条数据，若skip值为负数，则获取失败。

如下 [gdaSource loadData:@“YOUR_LOGIN_TOKEN” productKey:@“YOUR_BT_PRODUCT_KEY” deviceSN:@“YOUR_BT_DEVICE_SN” startTime:START_DATA_TIME endTime:END_DATA_TIME limit:20 skip:0];

Error codes