插件使用指南

概述

平台当前提供的插件包括：设备面板、云端定时、本地定时、设备消息记录、意见反馈。

插件使用

1. 插件使用前置条件请您先完成自有App创建，详情操作请参考创建自有App。

2. 在自有品牌App的App界面中的SDK和插件页面，选择插件，生成代码（此处是插件更新的地方）。

   • 如果第一次使用插件，单击生成代码后，将插件代码和参数复制到App中，App才能打开该插件。

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

   

3. 复制插件路由代码，粘贴到您的App中。

   • SDK依赖：每个插件依赖一些SDK，也请确保在App SDK中获这些SDK。

     说明

     如果登录控制台的账号为普通开发者，可通过发送邮件申请App SDK，详见获取App 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，必选参数

• 云端定时

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

• 本地定时

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

• 设备消息记录

  参数	类型	描述
  iotId	String	设备ID

  • 传设备ID时，单个设备的消息记录

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

• 意见反馈

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

意见反馈说明

• App端用户

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

  • 选择设备的反馈类型（App的问题类型为：反馈故障，功能建议，其他问题）。

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

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

  • 在反馈记录中查看反馈

• PC端商家用户

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