文档

插件使用指南

更新时间:
一键部署

生活物联网平台为了让您更快搭建自有品牌App,提供了免开发的App页面插件。您只需通过简单的调用即可呈现一个完整功能。

概述

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

image

插件使用

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

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

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

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

    image

  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反馈

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

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

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

    • 在反馈记录中查看反馈查看反馈

  • PC端商家用户

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