开发文档
平台公告
常见问题
硬件接入
开放平台
-
开放平台服务介绍
-
iOS SDK 集成指南
-
Android SDK 集成指南
-
蓝牙接入iOS SDK集成指南
-
蓝牙接入Android SDK集成指南
-
Websocket API 指南
-
Open API
- 微信硬件接入指南
-
APICloud开发接入文档
统计分析
Gokit开发套件
- GoKit介绍
-
GoKit上手指南
- GoKit 2 开箱
- 第一步:下载 IoE Demo App
- 第二步:将GoKit连接上网
- GoKit通过WiFi通信模块以无线的方式连接路由器并接入互联网,这里我们需要做的就是把可用WiFi的路由器SSID和密码告诉GoKit(就像你新买的手机需要输入家里的WiFi密码一样),但GoKit没有键盘和屏幕,如何做到呢?GoKit提供三种配置方式:AirLink 、WebConfig、 SoftAP。下面我们分别学习三种不同的配置方式,大家人选一种即可。
- AirLink配置入网
- AirLink配置就是说明书上介绍的方法,实现过程就是:通过按键触发开启设备“AirLink”模式,开启后设备会不断接收特定编码的WiFi广播包,手机连接可用的WiFi网络后,通过指定的App(如IoE Demo)发送编码后的WiFi网络的SSID和密码广播,设备接收到之后自动尝试连接此WiFi网络,连接成功即配置完成。下面一步步完成GoKit通过AirLink接入路由器连接网络吧。(注意:AirLink配置不支持5G的WiFi网络,请使用传统2.4G WiFi信号)
- 1.智能手机进入“系统设置”连接您附件可用的WiFi网络。
- 2.打开下载好的“IoE Demo” App,点击主屏幕右上角“菜单栏”中的“添加新设备”。如下图
- 3.使用USB线为GoKit供电,开机后长按[KEY2]直到[RGB LED]亮绿灯(Arduino版本GoKit短按[KEY2]),表示设备AirLink模式已经开启。如下图
- 4.IoE Demo APP上输入已连接WiFi的密码,点击配置按钮,等待30秒到一分钟,APP提示配置成功。在此期间,您可以看到GoKit的绿灯熄灭,WiFi模组两个指示灯瞬间熄灭,直到指示灯开始交叉闪烁,这表示GoKit已经连上路由器,配置完成。
- SoftAP配置入网
- 由于AirLink配置方式有一定的技术限制,GoKit支持另一种配置方式——SoftAP,实现过程就是将GoKit上的WiFi模组切换到AP模式,手机直接与GoKit连接,并将可用的WiFi网络SSID和密码发送给GoKit,GoKit接收到配置信息后自动尝试连接路由器。具体步骤如下:
- 1.GoKit正常供电情况下,长按[KEY1]直到[RGB LED]亮红灯(Arduino底板[RGB LED]蓝色闪一下),表示GoKit已经初始化。而GoKit在初始状态下将自动进入“SoftAP”模式。
- 2.手机进入“系统设置”中的“WiFi设置”,找到“XPG-GAgent-XXXX”(XXXX是你的GoKit MAC地址后4位)并连接此WiFi网络,如需密码请输入:123456789 。
- 3.打开“IoE Demo” App,此时App会自动进入SoftAP配置模式,选择或手动输入你附近的可用WiFi网络SSIS及密码,点击“确定”。
- 4.等待30秒到一分钟,当GoKit上WiFi模组的指示灯交叉闪烁时,表示配置完成。
- Web Config配置模式
- Web Config是SoftAP配置模式的一种升级,解决了智能硬件配置上网对独立专用App的依赖问题。实现原理与SoftAP类似,但直接使用手机自带的浏览器即可配置。具体步骤如下:
- 1.GoKit正常供电情况下,长按[KEY1]直到[RGB LED]亮红灯(Arduino底板[RGB LED]蓝色闪一下),表示GoKit已经初始化,而GoKit在初始状态下将自动进入“SoftAP”模式。
- 2.手机进入“系统设置”中的“WiFi设置”,找到“XPG-GAgent-XXXX”(XXXX是你的GoKit MAC地址后4位)并连接此WiFi网络,如需密码请输入:123456789 。
- 3.打开手机浏览器,并在地址栏输入“10.10.100.254”即可访问GoKit配置页面,根据提示输入可用WiFi网络SSID及密码,点击配置。
- 4.等待30秒到一分钟,当GoKit上WiFi模组的指示灯交叉闪烁时,表示配置完成。
- 第三步:使用IoE Demo控制GoKit
- 第四步:使用微信控制GoKit
- 微信从5.x版本开始,支持服务号设备功能。通过微信扫描设备二维码关注设备公众号后即可以实现对设备的控制。机智云作为微信设备号首批技术合作伙伴,在GoKit上也加入微信控制的功能,而GoKit也是目前世界上唯一一款开通了服务好设备功能的智能硬件开发板。使用微信控制GoKit具体步骤如下:
- 1.打开GoKit附带的说明书,找到一张白色二维码(此二维码每台设备唯一,请注意保管)。如图:
- 2.打开微信扫描说明书上的二维码,点击“关注”并进入公众号。
- 3.点击“窝窝”,公众号将返回你绑定的设备列表。点击进入设备主界面,如图
- 4.在此界面上你可以看到宠物屋(GoKit)当前的状态,并可以通过点击“送风”或“抽湿”对GoKit上的电机进行控制。
- 第五步:开始您的智能硬件开发之旅
使用APICloud开发智能硬件移动应用¶
为了让更多的企业、创客团队以及个人开发者能享受到机智云带来的优质服务与便利,我们一直在努力与各种优秀的平台进行合作。APICould 平台机智云移动端开发模块的上线,让广大开发者能用 JavaScript + HTML 写出完美的、跨平台的移动应用。
APICloud简介¶
APICloud 是中国首个“云端一体”的移动应用云服务提供商。APICloud 信仰“云端一体”的理念,重新定义了移动应用开发。APICloud 为开发者从“云”和“端”两个方向提供 API,简化移动应用开发技术,让移动应用的开发周期从一个月缩短到 7 天。APICloud 由“云 API”和“端 API”两部分组成,可以帮助开发者快速实现移动应用的开发、测试、发布、管理和运营的全生命周期管理。
基于 APICloud 提供的“云 API”和“端 API”,开发者甚至可以忘记繁杂的服务端编码,也可以忘记复杂的 Objective-C 和 Java,更可以忘记那数不清的屏幕适配。APICloud 重新定义移动应用开发,帮开发者搞定一切。
开发指南¶
1.1 注册机智云账号¶
要在 APICloud 平台使用机智云GizWifiSDK模块,您首先要成为机智云的开发者。
阅读 开发文档 并观看 视频教学 有助于您快速理解机智云的业务体系。
阅读 Android SDK 集成指南 或 iOS SDK 集成指南 文档有助于您理解机智云智能硬件移动端的开发方法。
目前还没有 APICloud 平台的单独开发指南,阅读 Android SDK 集成指南 有助于JavaScript 开发者理解机智云业务流程。
1.2 注册APICloud账号¶
您的主要开发工作将在 APICloud 平台完成。APICloud 的官方网站为:http://www.apicloud.com
1.3 相关开发文档¶
APICloud 模块商店 - 添加机智云 GizWifiSDK 模块
APICloud 机智云接入指南 - 注册机智云账号
APICloud 机智云 GizWifiSDK模块 开发文档 - 机智云 GizWifiSDK 模块接口文档
1.4 GoKit Demo开源代码¶
GoKit Demo开源工程提供了gizWifiSDK模块的使用范例。