开发文档_机智云

开发文档

平台公告

更新日志

常见问题

硬件接入

开放平台

统计分析

Gokit开发套件

第一步：导入文件¶

将GizAnalytics导入到你的工程中，并确保项目添加了ADSupport.framework、sqlite3.dylib 依赖框架。如图

第二步：引入头文件并注册你的AppKey¶

1、打开AppDelegate.m(代表你的工程名字)  导入文件头:GizAnalytics.h

#import <GizAnalytics/GizAnalytics.h>,

2、在- (BOOL)application: didFinishLaunchingWithOptions:方法中调用initWithAppKey方法来初始化GizAnalytics：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
[[GizAnalytics sharedInstance] initWithAppKey:@"YOUR_APP_KEY"];    //参数为机智云官网中添加应用后得到的AppKey

//……
return YES;
}

注：将"YOURAPPKEY"替换成你添加客户端时生成的 AppKey

第三步：配置机智云平台的统计分析¶

提示：机智云的统计分析为蓝牙操作提供了多种解决方案，以适应工程中不同的蓝牙业务：(仅选择适用您工程的方案即可)

工程还未有蓝牙模块：¶

方案一：使用单一的类来完成蓝牙所有的处理¶

1.为蓝牙处理类的.h文件添加(表示类名)

#import  <CoreBluetooth/CoreBluetooth.h>

2.实现以下delegate：

@interface ClassName:SuperClass <CBCentralManagerDelegate, CBPeripheralDelegate> //ClassName为您的类名，SuperClass为继承的超类

3.在该文件的@end语句上，添加两个属性：

 @property (nonatomic,strong) CBCentralManager *centralManger;
 @property (nonatomic,strong) CBPeripheral *peripheral;

4.在蓝牙处理类的.m文件的初始方法中添加代码：(表示类名)

-(id)init {
if(self = [super init]) {
     self.centralManager = [GizAnalytics createCentralManagerWithDelegate:self CBPeripheralDelegate:self queue:nil options:nil];
     //不需要再为peripheral设置delegate
}
return self;
}

方案二：使用两个或两个以上的类完成蓝牙处理¶

1.分别为处理蓝牙的central、peripheral类的.h文件添加：(表示类名)

#import  <CoreBluetooth/CoreBluetooth.h>

2.分别为处理蓝牙的central、peripheral类添加以下delegate：

@interface CentralClass:SuperClass <CBCentralManagerDelegate> //CentralClass为您处理蓝牙central类的类名，SuperClass为继承的超类
@interface PeripheralClass:SuperClass <CBPeripheralDelegate> //CentralClass为您处理蓝牙central类的类名，SuperClass为继承的超类

3.分别为处理蓝牙的central、peripheral类添加各自属性：

  //Central
  @property (nonatomic,strong) CBCentralManager *centralManger;

  //Peripheral
  @property (nonatomic,strong) CBPeripheral *peripheral;

4.在蓝牙处理Central类的.m文件的初始方法中添加代码：(表示类名)

-(id)init {
if(self = [super init]) {
     self.centralManager = [GizAnalytics createCentralManagerWithDelegate:self queue:nil options:nil];
}
return self;
}

5.在蓝牙处理Peripheral类的.m文件的初始方法中添加代码：(表示类名)

-(id)init {
if(self = [super init]) {
     self.peripheral = [GizAnalytics createCBPeripheralDelegate:self];
}
return self;
}

工程已有蓝牙模块：¶

方案一：使用单一的类来完成蓝牙所有的处理¶

1.将

self.centralManager = [[CBCentralManager alloc] initWithDelegate:self queue:nil options:nil];

修改为

self.centralManager = [GizAnalytics createCentralManagerWithDelegate:self CBPeripheralDelegate:self queue:nil options:nil];

2.删除设置Peripheral的delegate代码：

 //self. peripheral.degelate = self;

方案二：使用两个或两个以上的类完成蓝牙处理¶

1.在蓝牙处理Central类的.m文件的方法中：(表示类名)

将

self.centralManager = [[CBCentralManager alloc] initWithDelegate:self queue:nil options:nil];

替换为

self.centralManager = [GizAnalytics createCentralManagerWithDelegate:self queue:nil options:nil];
}

2.在蓝牙处理Peripheral类的.m文件的方法中：(表示类名)

将

 self. peripheral.degelate = self;

替换为

 self.peripheral = [GizAnalytics createCBPeripheralDelegate:self];

note: 1、options参数如果是nil，则iOS设备在没有蓝牙打开的情况下不会弹出提醒用户打开蓝牙的对话框，建议将参数填写为

{CBCentralManagerOptionShowPowerAlertKey:(YES)}。

2、此时已不再需要为peripheral属性设置degelate，即不需要以下代码：

self. peripheral.degelate = self;

3、不影响蓝牙的回调方法，业务逻辑； 4、在discoverServices:方法中，传入的发现服务数组中，必须包含UUID为180A的服务，代码如下：

  [slef.centralManager discoverServices:@[CBUUID UUIDWithString:@"180A",...]] ;

或：

   //当数组参数为nil表示搜索全部服务
   [slef.centralManager discoverServices:nil]。

温馨提醒：一般会实现的蓝牙回调方法¶

  centralManagerDidUpdateState:
  centralManager:didDiscoverPeripheral:advertisementData:RSSI:
  centralManager:didConnectPeripheral:
  centralManager:didDisconnectPeripheral:error:
  peripheral:didWriteValueForCharacteristic:error:
  peripheral:didUpdateValueForCharacteristic:error:
  peripheral:didDiscoverServices:
  peripheral:(CBPeripheral *)peripheral didDiscoverCharacteristicsForService:(CBService *)service error:(NSError *)error
  //.....
  //其他CBCentralManagerDelegate、CBPeripheralDelegate方法，如有需要，可自行添加。

另附：使用机智云IOTSDK蓝牙框架的集成¶

将XPGConnect、GizAnalytics添加到您的工程中，（此处只给出XPGConnect的添加过程，GizAnalytics的添加及引用过程参考以上） 1.从"打包结果":上下载XPGConnect相关文件；

2.将XPGConnect拖入工程中

1.注意事项¶

iOS版本要求: >= 5.0 设备支持BT 4.0 使用ARC

2.Framework依赖¶

Corebluetooth.framework

3.基本流程¶

创建XPGPeerID 创建XPGServiceBrowser 对XPGServiceBrowser对象调用搜索设备方法监听发现设备回调方法创建XPGSession 邀请搜索到的设备进入Session 监听状态改变回调方法 XPGSession可以对设备进行基本蓝牙BLE操作（Read，write，RSSI）通过XPGSession的回调方法，可以获得蓝牙BLE（Noty，Indicate）的回调

4.方法调用¶

在- (BOOL)application: didFinishLaunchingWithOptions:方法中调用initWithAppKey方法来初始化GizAnalytics：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
[[GizAnalytics sharedInstance] initWithAppKey:@"YOUR_APP_KEY"];    //参数为机智云官网中添加应用后得到的AppKey

//……
return YES;
}



 //初始化
@property (nonatomic, strong) XPGServiceBrowser *serviceBrowser;
@property (nonatomic, strong) XPGPeerID *peerID;
@property (nonatomic, strong) XPGPeerID *currentPeerID;

 - (XPGPeerID *)peerID {
if (_peerID == nil) {
_peerID = [[XPGPeerID alloc] initWithName:@"XPGConnectDemo"];
}
return _peerID;
}

- (XPGServiceBrowser *)serviceBrowser {
if (_serviceBrowser == nil) {
_serviceBrowser = [[XPGServiceBrowser alloc] initWithPeer:self.peerID serviceType:@"BLE" transportType:kXPGConnectTransportTypeBLE];
_serviceBrowser.delegate = self;
[_serviceBrowser setCentralManager:[XAnalytics createCentralManagerWithDelegate:                    [self.serviceBrowser getCentralManagerDelegate] queue:nil options:nil]];
}
return _serviceBrowser;
}





//搜索设备
[self.serviceBrowser startBrowsing];

//搜索设备回调
- (void)browser:(XPGServiceBrowser *)browser foundPeer:(XPGPeerID *)peerID withServiceInfo:(NSDictionary *)serviceInfo;



//连接设备
[self.serviceBrowser invitePeer:peerID toSession:session withContext:Nil timeout:5];

//连接设备状态回调
- (void)session:(XPGConnectSession *)session peer:(XPGPeerID *)peerID didChangeState:(XPGSessionState)state {
switch (state) {
    case kXPGSessionStateNotConnected:
        break;
    case kXPGSessionStateConnecting:
        break;
    case kXPGSessionStateConnected:
        //set up Device
        [XAnalytics createCBPeripheralDelegate:[session setupPeerForAnalytics:peerID]];       
        break;
    default:
        break;
    }
}

//断开设备连接
[session cancelConnectPeer:peerID];



//BLE基本操作
//读
- (BOOL)readDataFromCurrentPeerwithContext:(NSString *)Context error:(NSError **)error {
BOOL isSuccess = [self.currentSession readDataFromPeer:self.currentPeerID withContext:Context error:error];
return isSuccess;
}

//写
- (BOOL)sendData:(NSData *)data toCurrentPeerwithContext:(NSString *)Context error:(NSError **)error {
BOOL isSuccess = [self.currentSession sendData:data toPeer:self.currentPeerID withContext:Context error:error];
return isSuccess;
}




//读取信号强度
- (void)readRSSIValueFromCurrentPeer {
[self.currentSession updateRSSIToPeer:self.currentPeerID];
}

//回调函数

- (void)session:(XPGConnectSession *)session didReceiveData:(NSData *)data fromPeer:(XPGPeerID *)peerID withContext:(NSString *)context;

//发送数据确认
- (void)session:(XPGConnectSession *)session didSendData:(NSData *)data forPeer:(XPGPeerID *)peerID withContext:(NSString *)context;

//回调信号强度RSSI
- (void)session:(XPGConnectSession *)session didReceiveRSSI:(NSNumber *)rssi fromPeer:(XPGPeerID *)peerID;

5.常见问题¶

建立了连接后，仍然无法通信？

因为BLE设备还需要先对Service做setNotify的操作，才能收到信息。

如何知道信息是从哪个Service返回的？

通过 withContext:(NSString *)context，context包含了Service的信息。

如果想过滤搜索的设备，该如何设置？

只要对XPGServiceBrowser对象，设置serviceTargets属性。此数组包含的是带有目标Service的NSString。例如：["180A"];