APICloud SDK调用基础教程

boboP · 发表于 2016-8-31 17:31:57

本帖最后由 boboP 于 2016-8-31 17:33 编辑

1. 目标

为了让更多的企业、创客团队以及个人开发者能享受到机智云带来的优质服务与便利，我们一直在努力与各种优秀的平台进行合作。APICould 平台机智云移动端开发模块的上线，让广大开发者能用 JavaScript + HTML 写出完美的、跨平台的移动应用。

2. APICloud简介

APICloud 是中国首个“云端一体”的移动应用云服务提供商。APICloud 信仰“云端一体”的理念，重新定义了移动应用开发。APICloud 为开发者从“云”和“端”两个方向提供 API，简化移动应用开发技术，让移动应用的开发周期从一个月缩短到 7 天。APICloud 由“云 API”和“端 API”两部分组成，可以帮助开发者快速实现移动应用的开发、测试、发布、管理和运营的全生命周期管理。

基于 APICloud 提供的“云 API”和“端 API”，开发者甚至可以忘记繁杂的服务端编码，也可以忘记复杂的 Objective-C 和 Java，更可以忘记那数不清的屏幕适配。APICloud 重新定义移动应用开发，帮开发者搞定一切。

3. 开发指南3.1. 注册机智云账号

要在 APICloud 平台使用机智云GizWifiSDK模块，您首先要成为机智云的开发者。

阅读开发文档并观看视频教学有助于您快速理解机智云的业务体系。

阅读 Android SDK 集成指南或 iOS SDK 集成指南文档有助于您理解机智云智能硬件移动端的开发方法。

目前还没有 APICloud 平台的单独开发指南，阅读 Android SDK 集成指南有助于JavaScript 开发者理解机智云业务流程。

3.2. 注册APICloud账号

您的主要开发工作将在 APICloud 平台完成。APICloud 的官方网站为：http://www.apicloud.com

3.3. 相关开发文档

APICloud 模块商店 - 添加机智云 GizWifiSDK 模块

APICloud 机智云接入指南 - 注册机智云账号

APICloud 机智云 GizWifiSDK模块开发文档 - 机智云 GizWifiSDK 模块接口文档

3.4. gokit Demo开源代码

GoKit Demo开源工程提供了gizWifiSDK模块的使用范例。

链接地址为：https://github.com/gizwits/gokit_demo_in_apicloud

3.5. 接口使用指南

见附件文档。

附件：V4A2_SDK_APICloudModule集成指南.pdf • 1.53MB • 下载

boboP · 发表于 2016-8-31 17:34:58

本帖最后由 boboP 于 2016-8-31 17:41 编辑

→gizWifiSDK←接入指南

机智云为开发者提供智能设备开发套件GoKit。gizWifiSDK是机智云提供的物连接入SDK。开发者使用gizWifiSDK，需要在机智云网站上注册开发者账号。

注册后登录机智云网站，在硬件接入创建新产品，获得APPID和产品Productkey。根据模块描述文档，在APP的接口调用中，正确传入APPID和Productkey，就可以进行APP开发了。机智云还为开发者提供了虚拟设备作为硬件产品原型的调试方法。

具体流程如下：

1、注册开发者账号：

2、登录机智云网站，创建新产品、获取APPID和Productkey：

3、为产品新建数据点：

4、启动虚拟设备：

boboP · 发表于 2016-8-31 17:57:36

本帖最后由 boboP 于 2016-8-31 17:59 编辑

FAQ——持续更新中。。。。。

1.APICloud gizWifiSDK模块如何获取wifi列表。

答：用APICloud的gizWifiSDK模块开发时，同样也需要模组进入softap热点模式，才能获取到wifi列表。这个wifi列表是wifi模块在softap模式下搜索到的当前wifi热点后，返回给手机的。
如果返回的错误码是－45，一般都是模组没有工作在softap模式下。

2.在Android平台上，有时收不到接口回调？App需要保证请求机智云模块对象和接口调用是在同一个页面中执行的，以getBoundDevice接口举例：obj = api.require('gizWifiSDK');
obj.getBoundDevice(...) {...};
App执行完上面两个语句后，如果开启了一个新页面，并在新页面require了一个sdk模块对象，然后关闭新页面返回到这个页面时，会有一定的概率收不到回调。这是因为APICloud在每个页面关闭时会销毁当前已经申请的模块对象，导致接口回调时模块对象已经被清空而无法回调。

答：App关闭一个页面后加载其它页面时，要重新打开其它页面执行上述两条语句。这样就可以保证接口调用和回调是用同一个模块对象执行的，从而避免没有回调的情况。

3.APICloud 使用机智云的Demo 找不到 SDK 的解决方法

答：http://club.gizwits.com/thread-1865-1-1.html

Hunter_Ju · 发表于 2016-10-17 09:09:37

使用APICloud开发所遇到的问题，Demo无法进行设备发现：
http://club.gizwits.com/thread-3738-1-1.html