收藏官网首页
查看: 6663|回复: 0

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

563

主题

1222

帖子

8097

积分

版主

Rank: 7Rank: 7Rank: 7

积分
8097
发表于 2016-7-7 16:30:53 | 显示全部楼层 |阅读模式
汉枫LPB120模块
3.1.        SDK初始化部分3.1.1.        初始化部分流程图
3.1.2.        配置AndroidManifest.xml请将下面权限配置代码复制到 AndroidManifest.xml 文件中:
1
2
3
4
5
6
7
8
9
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />

权限说明:
权限用途
ACCESS_NETWORK_STATE允许程序访问有关GSM网络信息
ACCESS_WIFI_STATE允许程序访问WiFI网络状态信息
READ_PHONE_STATE允许程序访问手机状态信息
ACCESS_COARSE_LOCATION允许程序访问CellID或WiFi热点来获取粗略的位置
ACCESS_FINE_LOCATION允许程序访问精良位置(如GPRS)
WRITE_EXTERNAL_STORAGE允许程序写入外部SD卡
INTERNET允许程序打开网络接口
CHANGE_WIFI_STATE允许程序改变WiFi连接状态
CHANGE_WIFI_MULTICAST_STATE允许程序改变WiFi多播状态3.1.3.        注册SDK通用**注册SDK通用**是为了能让APP收到来自GizWifiSDK类的响应事件,包含了注册、登录、配置设备、绑定设备等回调接口。该**是SDK使用中十分重要的一个**,与GizWifiSDK类相关的操作都会在这里会回调。如果没有正确注册通用**,将无法正常使用SDK。注册监听时,APP可以根据自己的需求实现回调接口。建议两种设置方式:
1、在每一个使用到的Activity中都实例化一次**并注册一次,且只实现需要的回调接口。该种方式比较灵活,可在service中使用。但要注意必须每次打开activity都监听一次, 且无法多个Activity同时收到回调。
【示例代码】
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// 实例化**
GizWifiSDKListener mListener = new GizWifiSDKListener() {

// 实现手机号注册用户回调
    @Override
    public void didRegisterUser(GizWifiErrorCode result, String uid, String token){
            if (result == GizWifiErrorCode.GIZ_SDK_SUCCESS) {
                // 注册成功,处理注册成功的逻辑
            } else {
                // 注册失败,处理注册失败的逻辑
            }
    }
};

public void onCreate() {
    super.onCreate();

    // 注册**
    GizWifiSDK.sharedInstance().setListener(mListener);
    // 调用SDK的手机号注册接口
    GizWifiSDK.sharedInstance().registerUser("HelloGizwits", "12345678");
}

2、在一个基类中实例化一次**,并把回调抛出,子类继承基类,这就不需要每个子类都实例化一次**。该种方式通过继承的方式,可以多个Activity都收到回调。但该种方式无法在Service中使用。如无特别说明,文档中的范例都是使用该方法注册**。
【示例代码】
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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
// 创建基类,在基类中实例化和注册**
public class BaseActivity extends Activity {
    private GizWifiSDKListener mListener = new GizWifiSDKListener() {
        @Override
        public void didRegisterUser(GizWifiErrorCode result, String uid, String token) {
                BaseActivity.this.didRegisterUser(result, uid, token);
        }
    };

    public void didRegisterUser(GizWifiErrorCode result, String uid, String token){
        // 实现逻辑
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        //每次启动activity都要注册一次sdk**,保证sdk状态能正确回调
        GizWifiSDK.sharedInstance().setListener(mListener);
    }
}

//子类继承基类,实现基类的回调接口。
public class TestActivity extends BaseActivity {
    protected void onCreate(android.os.Bundle savedInstanceState) {
    //调用父类方法
        super.onCreate(savedInstanceState);
        //调用用户注册方法
        GizWifiSDK.sharedInstance().registerUser ("your_phone_number", "your_ password", “your_verify_code”, GizUserAccountType.GizUserPhone);
    }

    @Override
    public void didRegisterUser(GizWifiErrorCode result, String uid,  String token) {
        if (result == GizWifiErrorCode.GIZ_SDK_SUCCESS) {
            // 注册成功
        } else {
            // 注册失败
        }
    }
}

3.1.4.        初始化 sdkSDK启动前,任何功能都是无法正常使用的。SDK启动时,会进行SDK初始化,并自动发现当前局域网设备。SDK将通过通用监听,上报已发现的设备以及相应的事件。APP可以先设置SDK的通用监听,再启动SDK,以便处理这些事件通知。
SDK启动时需要指定应用程序的AppID,开发者需要先在机智云网站上为自己的APP申请一个AppID,请在应用的Application或者第一个启动的Activity的onCreate中调用该方法指定应用的APPID。该方法只需要调用一次。
SDK的日志可以帮助开发者发现APP运行时发生的问题,SDK默认将所有日志信息输出到调试终端和日志文件中。如果手机有SD卡,则日志文件会保存在SD卡上,如果没有SD卡,就只保存在应用程序路径下。SD卡上的日志文件目录为手机SD卡路径下的app_package_name/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
public void onCreate() {
    super.onCreate();
    GizWifiSDK.sharedInstance().setListener(mListener);
    GizWifiSDK.sharedInstance().startWithAppID(getApplicationContext(), "your_app_id");

    GizWifiSDKListener mListener = new GizWifiSDKListener() {
        @Override
        public void didNotifyEvent(GizEventType eventType, Object eventSource, GizWifiErrorCode eventID, String eventMessage) {
            if (eventType == GizEventType.GizEventSDK) {
            // SDK的事件通知
                Log.i("GizWifiSDK", "SDK event happened: " + eventID + ", " + eventMessage);
            } else if (eventType == GizEventType.GizEventDevice) {
                // 设备连接断开时可能产生的通知
                GizWifiDevice mDevice = (GizWifiDevice)eventSource;
                Log.i("GizWifiSDK", "device mac: " + mDevice.getMacAddress() + " disconnect caused by eventID: " + eventID + ", eventMessage: " + eventMessage);
            } else if (eventType == GizEventType.GizEventM2MService) {
                // M2M服务返回的异常通知
                Log.i("GizWifiSDK", "M2M domain " + (String)eventSource + " exception happened, eventID: " + eventID + ", eventMessage: " + eventMessage);
            } else if (eventType == GizEventType.GizEventToken) {
                // token失效通知
                Log.i("GizWifiSDK", "token " + (String)eventSource + " expired: " + eventMessage);
            }
        }
    };
}


1、机智云QQ群: 287087942
机智云爱好者-APP开发群: 599735135
QQ群目前非常活跃,欢迎大家参与进来,交流,讨论,答疑,解惑~~
2、机智云微信公众号: 机智云 gizwits /   机智云智能宠物屋go-kit
关注机智云Gizwits官方公众号随时掌握最新资讯和活动信息
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

加入Q群 返回顶部

版权与免责声明 © 2006-2024 Gizwits IoT Technology Co., Ltd. ( 粤ICP备11090211号 )

快速回复 返回顶部 返回列表