Skip to content

Latest commit

 

History

History
207 lines (159 loc) · 5.93 KB

README.MD

File metadata and controls

207 lines (159 loc) · 5.93 KB
Raw

Android版本EasyLink SDK

请注意，Easylink AWS请使用v0.2.6版本

EasyLink SDK 主要功能:

  • 将手机端设置的Wi-Fi网络参数发送到设备端
    • 支持EasyLink模式
    • 支持EasyLink—AWS模式
  • 到新入网的设备，并且交互。实现参数设置，OTA等功能
    **注意：**EasyLink模式仅支持在IPv4网络中进行操作。

示例程序

  1. 简单EasyLink的示例程序：
    1）简单的示例程序：
    提供了一个简单的UI，展示EasyLink SDK的使用方法 ，主要功能是配网和设备发现。
    app链接如下：easylink-app-url
Android Studio引入的资源
dependencies {
    // 只发广播的版本
    compile 'io.fogcloud.sdk:easylinkv3:0.1.4'
    // 广播组播同时发的版本
    compile 'io.fogcloud.sdk:easylinkv3:0.1.5'
    // AWS配网版本
    compile 'io.fogcloud.sdk:easylinkv3:0.1.6'
}

一般情况使用只发广播的版本就可以了，特殊需求，比如广播收不到的情况可以使用0.1.5版本，广播组播一起发。

开启服务

需要现在manifest.xml中开启服务

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

功能列表

getSSID

获取当前手机连接的WIFI的名称，即ssid

String getSSID()
callback

ssid

  • 类型：String
  • 描述：当前WIFI的名称
示例代码
EasylinkP2P elp2p = new EasylinkP2P(mContext);
elink.getSSID()

startEasyLink

发送数据包(包含ssid和password)给设备，连续发10s，再停止3s，再继续发，如此反复

startEasyLink(EasyLinkParams easylinkPara, EasyLinkCallBack easylinkcb)
params
参数名 类型 描述
easylinkPara EasyLinkParams EasyLinkParams包含以下的信息
EasyLinkParams
参数名 类型 默认值 描述
ssid String 无默认值，不可为空 当前wifi的名称
password String 无默认值，可为空 当前wifi的密码(8-64个字节，越长配网速度越慢)
isSendIP Boolean 默认值为false，可为空 是否发送手机的IP，默认不发送，如果此参数为false，那么extraData也不可用
runSecond int 默认值50，可为空 发送持续的时间，到点了就停止发送, 单位s
sleeptime int 默认值50，可为空 每包数据的间隔时间，建议20-200, 单位ms
extraData String 无默认值，可为空 需要发送给设备的额外信息
rc4key String 无默认值，可为空 如果需要RC4加密，这里就输入字符串密钥
callback

easylinkcb

  • 类型：EasyLinkCallBack
  • 描述：接口调用成功后的回调函数
示例代码
EasyLinkParams easylinkPara = new EasyLinkParams();
easylinkPara.ssid = "mxchip";
easylinkPara.password = "12345678";
easylinkPara.runSecond = 60000;
easylinkPara.sleeptime = 20;

elink.startEasyLink(easylinkPara, new EasyLinkCallBack() {
    @Override
    public void onSuccess(int code, String message) {
        Log.d(TAG, code + message);
    }
    @Override
    public void onFailure(int code, String message) {
        Log.d(TAG, code + message);
    }
});

stopEasyLink

停止发送数据包

stopEasyLink(EasyLinkCallBack easylinkcb)
callback

easylinkcb

  • 类型：EasyLinkCallBack
  • 描述：接口调用成功后的回调函数
示例代码
elink.stopEasyLink(new EasyLinkCallBack() {
    @Override
    public void onSuccess(int code, String message) {
        Log.d(TAG, code + message);
    }
    @Override
    public void onFailure(int code, String message) {
        Log.d(TAG, code + message);
    }
});

实时更新SSID

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    ...
    listenwifichange();
}

private void listenwifichange() {
    IntentFilter intentFilter = new IntentFilter();
    intentFilter.addAction(WifiManager.NETWORK_STATE_CHANGED_ACTION);
    registerReceiver(broadcastReceiver, intentFilter);
}

BroadcastReceiver broadcastReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        if (action.equals(WifiManager.NETWORK_STATE_CHANGED_ACTION)) {
            NetworkInfo info = intent.getParcelableExtra(WifiManager.EXTRA_NETWORK_INFO);
            if (info.getDetailedState() == NetworkInfo.DetailedState.CONNECTED) {
                Log.d(TAG, "---heiheihei---");
                wifissid.setText(elink.getSSID());
            }
        }
    }
};

@Override
protected void onDestroy() {
    super.onDestroy();
    unregisterReceiver(broadcastReceiver);
}

设备发现

设备会在连上路由器后通过广播方式通知到手机，可以在easylink success callback
里面获取到相应的信息，在message中。

elp2p.startEasyLink(elp, new EasyLinkCallBack() {
                    @Override
                    public void onSuccess(int code, String message) {
                        Log.d(TAG, message);
                    }

                    @Override
                    public void onFailure(int code, String message) {
                        Log.d(TAG, message);
                    }
                });