插件使用指南

概述

平台当前提供的插件包括：配网页面（支持Wi-Fi、以太网、蜂窝网）、配置化界面、云端定时、本地定时、场景自动化、消息列表。

插件使用

1. 进入项目主页，单击创建的自有品牌App，进入App配置页面。
   
2. 在自有品牌App的App界面中，选择插件，生成代码（此处是插件更新的地方）。
   • 如果第一次使用插件，单击生成代码后，将插件代码和参数复制到App中，App才能打开该插件。
   • 当插件右侧出现“最新版本v1.0.xx”的更新字样，表明平台有新版本发布。如需使用最新版本插件功能，可单击进行更新。

   
3. 复制插件路由代码，粘贴到您的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]];
         }
     }];
     								

插件更新

如果插件配合您的设备固件（如本地定时），请确保固件升级与旧版本的兼容，再单击插件更新，否则会引起线上问题，请谨慎操作。

插件参数介绍

• 配置化界面

  参数	类型	描述
  iotId	String	设备ID，必选参数

• 配网插件

  参数	类型	描述
  productKey	String	产品ProductKey，必选参数
  deviceName	String	设备名称，GPRS设备必选

• 云端定时

  参数	类型	描述
  iotId	String	设备ID，必选参数

• 本地定时

  参数	类型	描述
  iotId	String	设备ID，必选参数

• 自动化场景

  参数	类型	描述
  sceneType	enum	场景的类型，请根据场景服务的版本选择对应的参数，默认为IFTTT 。 场景服务1.0仅支持 ilop（单品）、hc（全屋）。 场景服务2.0和家空间下的场景仅支持 IFTTT、CA。
  sceneId	String	仅在编辑时传入
  homeId	String	家空间Id 创建家空间场景必填 创建非家空间创建不要传

  • 不传sceneId时为新增场景
  • 传sceneId时为编辑场景
• 设备消息记录

  参数	类型	描述
  iotId	String	设备ID

  • 传设备ID时，单个设备的消息记录
  • 不传设备ID时，用户绑定的所有设备消息记录
• 意见反馈插件

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

意见反馈说明

• App端用户
  • 反馈首页显示和当前用户有关联的设备，单击设备选择反馈类型。
  • 选择设备的反馈类型（App的问题类型为：反馈故障，功能建议，其他问题）。
  • 填写反馈信息，问题描述为必填项
  • 反馈成功后可在反馈记录中查看。（当出现红点时说明有新的回复）
  • 在反馈记录中查看反馈
• PC端商家用户

  商家通过生活物联网的控制台，在运营中心中查看用户反馈（商家账号显示产品名称，小二账号不显示）。详细请参见用户反馈。