iOS SDK 2.0文档 3-SDK流程之初始化部分

Genius · 发表于 2016-7-7 16:40:30

3. SDK流程详解3.1. 初始化部分3.1.1. 初始化部分流程图

3.1.2. 引用头文件

1	import <GizWifiSDK/GizWifiSDK.h>

3.1.3. 设置SDK通用委托注册SDK通用委托是为了能让APP收到来自GizWifiSDK类的响应事件，包含了注册、登录、配置设备、绑定设备等回调接口。这是SDK使用中十分重要的一个委托，与GizWifiSDK类相关的操作都会在这里会回调。如果没有正确注册通用委托，将无法正常使用SDK。注册委托时，APP可以根据自己的需求实现回调接口。
3.1.4. 初始化SDKSDK启动前，任何功能都是无法正常使用的。SDK启动时，会进行SDK初始化，并自动发现当前局域网设备。SDK将通过通用委托，上报已发现的设备以及相应的事件。APP可以先设置SDK的通用委托，再启动SDK，以便处理这些事件通知。
SDK启动时需要指定应用程序的AppID，开发者需要先在机智云网站上为自己的APP申请一个AppID，请在应用的AppDelegate中调用该方法指定应用的AppID。该方法只需要调用一次。
SDK的日志可以帮助开发者发现APP运行时发生的问题。SDK默认将所有日志信息输出到调试终端和日志文件中，日志文件保存在应用程序的Documents\GizWifiSDK\GizSDKLog目录下。APP如果不希望在调试终端输出日志，可以通过日志级别设置接口，把日志输出级别修改为GizLogPrintNone。
【示例代码】

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

[GizWifiSDK shareInstance].delegate = self;
[GizWifiSDK startWithAppID

"your_app_id"];

// 实现系统事件通知回调
- (void)wifiSDK

GizWifiSDK *)wifiSDK didNotifyEvent

GizEventType)eventType eventSource

id)eventSource eventID

GizWifiErrorCode)eventID eventMessage: (NSString *)eventMessage {
if(eventType == GizEventSDK)
{
   // SDK发生异常的通知
NSLog(@"SDK event happened: [%@] = %@", @(eventID), eventMessage);
}
else if(eventType == GizEventDevice)
{
// 设备连接断开时可能产生的通知
GizWifiDevice* mDevice = (GizWifiDevice*)eventSource;
NSLog(@"device mac %@ disconnect caused by %@", mDevice.macAddress, eventMessage);
}
else if(eventType == GizEventM2MService)
{
   // M2M服务返回的异常通知
   NSLog(@"M2M domain %@ exception happened: [%@] = %@", (NSString*)eventSource, @(eventID), eventMessage);
}
else if(eventType == GizEventToken)
{
// token失效通知
NSLog(@"token %@ expired: %@", (NSString*)eventSource, eventMessage);
}