插件使用指南

更新时间:2019-01-09 20:22:25

平台为了让您更快搭建自有品牌App,提供了免开发的App页面插件,通过简单的调用即可呈现一个完整功能。
平台当前提供的插件包括:配网页面(支持WiFi、以太网、蜂窝网)、配置化界面、云端定时、本地定时、场景自动化、消息列表。

image.png | left | 747x535

插件使用

1. 进入项目主页,点击进入自有品牌App配置页面

image.png | left | 747x340

2. App界面配置

2.png | center | 747x145

3. 选择插件,生成代码(此处是插件更新的地方)

注意:

  • 如果第一次使用插件,点击“生成代码”后,将插件代码和参数复制到App中,App才能打开该插件;

  • 当插件右边出现“最新版本v1.0.xx”的更新字样,表明平台有新版本发布,如需使用最新版本插件功能,可点击进行更新

image.png | left | 747x437

4. 复制插件路由代码,粘贴到您的App中调用

  • SDK依赖:每个插件依赖一些SDK,也请确保在“SDK下载”中获得这些SDK。

  • 多语言:所有插件都已支持国际化,App语言切换,插件会跟着一起切换。

代码示例:

Android端

import android.os.Bundle;
import com.aliyun.iot.aep.component.router.Router;

...

String code = "link://router/devicenotices";
Bundle bundle = new Bundle();
bundle.putString("key","value"); // 传入插件参数,没有参数则不需要这一行
Router.getInstance().toUrlForResult(getActivity(), code, 1, bundle);

IOS 端

#import <IMSBoneKit/IMSRouter/IMSRouter.h>
[[IMSRouterService sharedService] openURL:[NSURL URLWithString:@"跳转的url"] options:nil];

...

NSURL *url = [NSURL URLWithString:@"link://router/connectConfig"];
NSDictionary *options = @{@"key": @"value"}; // 传入插件参数,没有参数则不需要这一行
[[IMSRouterService sharedService] openURL:url options:options completionHandler:^(BOOL success) {
    if (!success) {
        [self ims_showHUDWithMessage:[NSString ls_loadFailed]];
    }
}];

插件更新

如果插件配合您的设备固件(如本地定时),请确保您的固件升级以及旧版本的兼容,再点击插件更新,否则会引起线上问题,请谨慎操作

1. 设备标准界面 - 插件更新

如图的标准界面,在需要更新您自己APP中使用的插件时,切换一下选中别的选项,再重新选回该选项,即可完成测试版APP和正式版APP的同步更新。

image.png | left | 799x712

2. 配置化(自定义)界面 - 插件更新

image.png | left | 827x774

直接在界面工作台中,点击“保存”即可在测试版的APP中更新;点击“发布”即可完成在正式版的APP中更新。

image.png | left | 827x490

3. 其他界面 - 插件更新

如果其他插件有更新,会在此处标记出来,并展示更新版本号:

image.png | left | 827x601

点击后弹出更新内容的注意点,确认无误后,点击“确认更新”,即可完成测试版APP和正式版APP的同步更新。

image.png | left | 827x552

各插件参数介绍

配置化界面

参数 类型 描述
iotId String (必须)设备 ID

配网插件

参数 类型 描述
productKey String (必须)产品 ProductKey
deviceName String (必须)设备名称

云端定时

参数 类型 描述
iotId String (必须) 设备 ID

本地定时

参数 类型 描述
iotId String (必须)设备 ID

自动化场景

参数
类型
描述
sceneType
enum
场景的类型,支持 ilop(单品)、hc(全屋)。默认为 ilop
sceneId
String
仅在编辑时传入
groupId
String
仅全屋产品需要
  • 不传sceneId时为新增场景

1.png | left | 276x476

  • 传sceneId时为编辑场景

2.png | left | 266x463

设备消息记录

参数 类型 描述
iotId String 设备ID
  • 传设备ID时,单个设备的消息记录

3.png | left | 267x578

  • 不传设备ID时,用户绑定的所有设备消息记录 |

4.png | left | 266x576

意见反馈插件

参数 类型 描述
mobileModel String 手机型号
mobileSystem String 手机系统
appVersion String APP版本

官方SDK版本与 APILevel对应关系参考

配置化面板插件

官方SDK依赖 支持的最小 SDK Level 备注
账号及用户 3
API 通道 3
BoneMobile 容器 3
设备模型 3 若要使用蓝牙设备,请升级 APILevel到4以上,并且集成蓝牙 SDK
长连接通道 3

配网插件

官方SDK依赖 支持的最小 SDK Level 备注
账号及用户 3
API 通道 3
BoneMobile 容器 3
配网 SDK 3 若要使用蓝牙配网,请升级 APILevel到4以上,并且集成蓝牙 SDK
长连接通道 3

插座标准面板/灯标准面板/开关标准面板

官方SDK依赖 支持的最小 SDK Level 备注
API 通道 3
BoneMobile 容器 3
设备模型 3
长连接通道 3
移动应用推送 3

本地倒计时/本地定时/云端定时/设备消息记录/设备设置/自动化场景/

官方SDK依赖 支持的最小 SDK Level 备注
账号及用户 3
API 通道 3
BoneMobile 容器 3

意见反馈

官方SDK依赖 支持的最小 SDK Level 备注
API 通道 3
BoneMobile 容器 3
设备模型 3
长连接通道 3
移动应用推送 3

意见反馈使用说明

APP端用户

  • 反馈首页显示和当前用户有关联的设备,点击设备选择反馈类型。

image.png | left | 233x285

  • 选择设备的反馈类型(APP的问题类型为:反馈故障,功能建议,其他问题)。

image.png | left | 195x425

  • 填写反馈信息,问题描述为必填项

image.png | left | 193x417

  • 反馈成功后可在反馈记录中查看。(当有红点时说明有新的回复)

image.png | left | 237x322

  • 反馈记录查看反馈

image.png | left | 234x266

PC端商家用户

  • 商家通过飞燕控制台打开运营中心查看用户反馈(商家账号显示产品名称,小二账号不显示)

image.png | left | 615x281

  • 点击反馈内容可查看反馈详情

用户反馈.png | center | 616x360

  • 反馈详情页,可对用户反馈内容进行回复

反馈详情.png | center | 616x291

results matching ""

    No results matching ""