关于智能家居:如何使用-群晖Docker-安装教程运行智汀家庭云

本文档形容如何在群晖docker上运行智汀家庭云（以下简称SA），并应用浏览器体验SA。

1. 环境筹备#
   linux主机
   docker
   docker-compose
2. 运行SA#
   0

自行创立docker-compose文件运行#
抉择一个目录寄存SA所需文件，执行以下命令：

wget -O smartassistant.zip https://github.com/zhiting-tech/smartassistant/releases/download/v2.0.2/smartassistant.2.0.2.zip && unzip smartassistant.zip

cd zt-smartassistant

docker-compose up

备注：

您能够通过最新版本的公布地址：
https://github.com/zhiting-te…,获取最新版本zip文件

3. 测试运行状况#
   服务启动后能够通过以下命令查看SA的状态：
   curl http://localhost:9020/api/check

如果返回以下内容则阐明服务已运行起来并且未被绑定

{"status":0,"reason":"胜利","data":{"is_bind":false,"revision":""}}

4. 应用智汀App进行体验#
   SA体验演示#
   点击增加智能设施发现SA
   
   选中SA,点击增加
   
   点击增加设施

正在增加设施

设置是否容许找回用户凭证

增加设施胜利

点击反对品牌，界面中会列出SA内置的一些插件
查问反对品牌

点击其中的一个插件，点击增加对插件进行装置

增加插件

增加插件胜利

插件增加胜利后，返回到首页家居，点击右上角+按钮就能够增加插件反对的设施

选中其中的一个设施点击增加,增加实现后返回到首页的家居即可对设施进行操控

增加设施

增加设施胜利

5. 应用专业版进行体验#
   5.1 账号和明码设置#
   SA服务启动后，如果未绑定，须要发送以下申请对SA进行绑定：

curl -X POST -d '{"device": {"model": "smart_assistant"}}' http://localhost:37965/api/devices

绑定胜利后返回以下内容：

{
  "status": 0,
  "reason": "胜利",
  "data": {
    "device_id": 1,
    "plugin_url": "",
    "user_info": {
      "user_id": 1,
      "role_infos": null,
      "account_name": "",
      "nickname": "wyqicai",
      "token": "MTYzNTMxOTE1M3xOd3dBTkVoRE5WRXpTME5CV0VrMFVFOVFWa0pJUjA1UFNVRklRMEUxUkZaWVFsRkNWVWhUVWxWRFEwNUVTek5QU0VwVlJVVlJSMEU9fNXschLMFQtEogQo2AlJu4wfSJfLrsk994FwSGUhp-_3",
      "phone": "",
      "is_set_password": false
    },
    "area_info": {
      "id": "20763937284831135"
    }
  }
}

SA绑定胜利后设置用户名和明码：

curl -X PUT -d '{"account_name": "admin","password": "123456"}' --header 'smart-assistant-token:MTYzNTMxOTE1M3xOd3dBTkVoRE5WRXpTME5CV0VrMFVFOVFWa0pJUjA1UFNVRklRMEUxUkZaWVFsRkNWVWhUVWxWRFEwNUVTek5QU0VwVlJVVlJSMEU9fNXschLMFQtEogQo2AlJu4wfSJfLrsk994FwSGUhp-_3' http://localhost:37965/api/users/1

其中header参数smart-assistant-token值为绑定胜利后的token, 
申请url path（/api/users/:id）中的门路参数id为绑定胜利后返回的用户id。

设置胜利后返回：
{"status":0,"reason":"胜利"}

当用户账号和明码设置胜利后关上浏览器，拜访 http://localhost:9020 即可体验SA了。

5.2 SA体验演示#
应用账号密码登录

登录胜利后，切换到我的

点击反对品牌，界面中会列出SA内置的一些插件

点击其中的一个插件对插件进行装置

增加插件

胜利增加插件

插件增加胜利后，返回到首页家居，点击右上角+按钮就能够增加插件反对的设施

选中其中的一个设施点击增加,增加实现后返回到首页的家居即可对设施进行操控

设施增加胜利

管制设施

6. 进一步理解#

如果您手上有智汀家庭云反对的硬件设施，能够装置第三方插件，而后通过智汀APP接入您的设施。

智汀家庭云是一个开源我的项目，如果如果您相熟 go 编程语言，想进一步理解咱们的我的项目，能够拜访开发环境搭建

智汀家庭云提供插件零碎反对第三方设施接入，如果您的设施不在咱们的反对列表，能够参考 开发您的第一个插件理解插件开发的相干内容。