SaaSDemo使用说明

更新时间：2020-03-13 17:38:30

人居平台SaaS演示程序

基于阿里云智能人居开放平台开发的SaaS演示程序，用于演示平台的基础能力，以及如何使用人居平台的API。

演示程序是WebServer的形式，可以运行java -jar命令在本地启动一个服务器，默认9000端口。

程序启动后，可以看到租户下管理的所有设备、空间和场景，可以进行关系配置。

依赖

程序除了依赖Spring以外，还使用了以下与IoT相关的包：

智能人居开放平台SDK

这个工具包已经开源，用户可以根据自己的需求封装和修改，形成自己的SDK。

<dependency>
    <groupId>com.aliyun.iotx.homelink.service.sdk</groupId>
    <artifactId>homelink-service-sdk</artifactId>
    <version>1.0.1</version>
</dependency>

数据订阅相关工具包

<dependency>
    <groupId>com.aliyun.openservices</groupId>
    <artifactId>iot-client-message</artifactId>
    <version>1.1.3</version>
</dependency>

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>3.7.1</version>
</dependency>

启动

1. 下载jar包：https://github.com/aliyun/iotx-homelink-saas-demo/tree/master/release
2. 创建配置文件，见配置项一节

3. 启动命令行：

   java -jar -Dspring.config.location=xxx/application.properties iotx-homelink-saas-demo-1.0.0-SNAPSHOT.jar
   

4. -Dspring.config.location 用来指定加载的配置文件，全路径或相对路径

配置项

可以复制resources文件中的application.properties文件到磁盘上，修改配置：

# 启动端口
server.port = 9000

spring.http.encoding.force = true
spring.http.encoding.charset = UTF-8
spring.http.encoding.enabled = true
server.tomcat.uri-encoding = UTF-8

spring.devtools.restart.enabled = true
server.servlet.jsp.init-parameters.development = true

# ---- 应用配置 ----

# 线上数据订阅配置
# 获取accessKey
# 参考 https://homelink.iot.aliyun.com/doc#ks7z2y.html
footman.accessKey = xxxx
footman.accessSecret = xxxx
# 阿里云的用户ID，获取方法见上面链接
footman.aliyunUid = xxxx
# 接入区域（固定值，不要修改）
footman.regionId = cn-shanghai

# 从人居平台申请的AppKey，这是访问智能人居开放平台API的身份凭证
# 参考：https://homelink.iot.aliyun.com/doc#cynigt.html
footman.api.appKey = xxxx
# 与appKey配对的密钥，不能外泄
footman.api.appSecret = xxxx
# 访问域名（固定值，不要修改）
footman.api.host = api.link.aliyun.com
# 系统标记（固定值true，不要修改，会导致服务不稳定）
footman.api.system = true
# 默认管理员的hid
# 参考：https://gaic.alicdn.com/doc/homelink-aquarius2/td6gx8.html#10352440
footman.api.hid = xxxx
# HID类型
footman.api.hidType = OPEN

# 以下参数用于 ThirdPartyAccountImporter 类初始化账号
# 与footman.api.hid对应的账号登录名
footman.api.loginName = OPEN
# 手机号
footman.api.phone = OPEN
# 邮箱
footman.api.email = OPEN
# 账号密码
footman.api.password = OPEN

功能

场景管理

设备管理

空间管理

用户管理

品类管理

日志