请选择 进入手机版 | 继续访问电脑版

『瀚思彼岸』» 智能家居技术论坛

 找回密码
 立即注册
查看: 21806|回复: 766

[信息发布] 论坛新版天猫精灵接入技能正式发布!

  [复制链接]

105

主题

3620

帖子

1万

积分

管理员

囧死

Rank: 9Rank: 9Rank: 9

积分
11646
金钱
7946
HASS币
44
发表于 2019-4-9 01:17:18 | 显示全部楼层 |阅读模式
各位久等了!
首先说点废话,自从上次论坛被攻击以来,论坛的天猫精灵接入就不可用了,至今已经将近1个月了。为什么一直没恢复?原因很多,首先不想使用论坛服务器了,一来是因为在国外延迟较高,二来是怕暴露服务器ip,再受歹人攻击;其次,HASS已经支持Oauth认证很久了,官方也说了,api_password认证方式早晚要弃用,所以,是时候改用Oauth认证+长期令牌来接入天猫了!

所以狠下心来,认真研读了官方文档,又拾起了多年不用的php,重写了天猫精灵的接入代码,又精益求精、不断优化,提高响应速度,在开发、测试了将近20天后,终于有了现在这个比较满意的版本。同时接到官方的通知,得知天猫精灵APP即将改版(现在新版已经发布),技能一律以品牌形式展示,技能也作了相应调整。

先看部分测试视频:



就在今晚,欣喜的看到新技能已经通过审核,所以是时候通知大家来使用新版了(原技能已彻底弃用)!

闲话到此为止,下面是干货:

首先看一下隐私政策

一、关于本技能
1.1 关于品牌
接官方通知,天猫精灵APP将于近期进行改版,改版后将按品牌进行技能展示。因为Home Assistant(下简称HASS)为开源平台,并非智能设备品牌,故使用论坛原创硬件品牌“HASSMART”来作为技能名称。同时由于服务对象为HASS用户,并非所有用户都使用HASSMART设备,故Logo仍沿用HASS官方Logo。

1.2 费用
目前本服务完全免费,符合条件的用户可直接使用本技能;

1.3 可用性
我们将尽可能保证服务可用性,不排除由于不可抗外力或不可预测之破坏导致的服务不可用;

1.4 用户权限
由于服务器计算能力及网络带宽有限,无法满足大量无序增长用户的需求,因此为保证服务稳定可用,拟对使用用户进行权限控制。具体如下:

非瀚思彼岸会员且非HASSMART客户: 限接入1台设备;
瀚思彼岸中级会员以下(不含中级,阅读权限30以下):限接入5台设备;
瀚思彼岸中级会员及以上:限接入20台设备;
瀚思彼岸高级会员及以上:限接入30台设备;
瀚思彼岸金牌会员及以上:限接入50台设备;
瀚思彼岸技术达人、论坛元老、管理人员:接入设备不限
HASSMART一般客户:参考论坛中级会员
HASSMART VIP客户:另议

对于论坛恶意灌水、发布违规内容、淘宝不友好买家等用户(包括但不限于上述范围的不受欢迎人员),拒绝提供本服务。


二、隐私保护
2.1 保存数据
本技能全程使用HASS原生的OAuth认证进行登录,不需要用户设置密码,因此不保存用户密码。但是为了控制HASS中的设备,本技能会保存用户的HASS公网地址,以及长期访问令牌,以便区分不同用户及控制不同用户的设备。同时,为了安全认证需要,本技能会保存用户的email地址。

2.2 数据使用与保护
本技能所保存数据可能会被用作用户统计、行为分析等,除相关部门监管外,不会向任何第三方机构提供。

2.3 技能数据与论坛数据互通
前期采用用户申请、论坛批准的方式进行权限认证,待后期服务稳定后将考虑与论坛数据互通,自动授予相应权限。

2.4 解释权
本技能及相关说明最终解释权归瀚思彼岸论坛所有。


再来看接入教程

一、HASS准备
1.1 版本号
需要安装并配置好Home Assistant(下称HASS) v0.73及以上版本(0.89.2版测试通过);

1.2 公网访问
通过端口映射或内网穿透将HASS开放到公网(http或https均可);

1.3 Customize基本设置
在customize.yaml里,将想添加到天猫精灵的设备下加入一条 tmall_genie: true (friendly_name也必须添加,否则无法识别设备),注意目前技能已支持switch, light, cover, sensor, climate, input_boolean等domain,其余类型后续将陆续支持;

20190409003733.png
20190826更新支持新的参数(进阶设置,这里配置好,就不需要在app里指定类别,位置和名称了。请确保你按上述配置,能看到设备后再尝试):

1.png

如上图,新增三个参数如下:

tmall_genie_type: 设备类型,与天猫精灵官方支持的类型必须一致,看好,设备类型填英文,不是前面的中文;另外只有switch类型的,才支持设置此字段,其他的不要尝试;
tmall_genie_zone: 设备位置,也不可乱填,必须包含在官方所给的列表中;
tmall_genie_name: 设备名称,同样不可乱填,必须包含在官方给出的列表中。

供进阶用户尝试。


1.4 Customize高级设置
由于天猫精灵官方不支持同一位置多传感器,本技能通过高级设置可以达到虚拟传感器效果。具体代码如下:

sensor.temperature_158d00011111:
  friendly_name: 小米温度
  tmall_genie:
    enabled: true
    attach_sensor:
      - entity_id: sensor.humidity_158d0000000000


1.5 长效令牌获取
最后一步,需要在你的HASS实例中,生成一个长期访问令牌。具体方法如下,在HASS界面左上角,点击你的名字的首字母,滚动到页面最下方长期访问令牌处,点击创建令牌,名称随便输入(最好输入tmall以便记忆,且不要随意删除),然后点击确定会生成一长串字符,将以上字符拷贝出来,保存备用。


二、接入流程
2.1 搜索技能
打开天猫精灵APP,点击“我的”,点击“添加智能设备”,搜索设备品牌“HASSMART”,找到“HASSMART”相关产品,任意点击一个产品图标,点击绑定平台账号,跳转到授权页面;最新版APP里,还可在技能页,搜索HASSMART进行绑定。
IMG_2487.PNG

2.2 输入HASS地址
输入你的HASS公网地址,要包括http或https,如https://my.hass.com:8123。点击确定,系统会验证HASS地址的有效性,并跳转到你的HASS实例的OAuth登录页面;

222.png

2.3 OAuth登录
输入HASS用户名和密码授权登录,鉴权正确之后会提示授权成功,第一次使用需要填写昵称、邮箱地址(务必要填写论坛的用户名和邮箱)和长效令牌(1.5部分获取得到的),点击确定,系统会验证长效令牌的可用性,如果检查成功会提示token获取成功,并自动跳转到设备列表界面;

IMG_2491.PNG

2.4 设备列表中选择设备位置和别名
此时天猫精灵智能设备管理界面会显示HASS里已配置为tmall_genie: true的设备列表,默认都显示为客厅的设备。退回APP最初的“我的”界面,点击查看全部,应该可以看到设备列表了,这时需要在此列表中点击相应设备,设置其位置或别名(必须设置,否则天猫精灵无法识别,其中开关类设备,为万能设备,可设置为任意其它类型);

2.5 语音测试
设置完成后,就可以对天猫精灵说了:天猫精灵,打开卧室吸顶灯(假设你的设备是light,位置选的卧室,别名选的吸顶灯);

2.6 设备更新
如果HASS中设置进行了更新,在确保HASS已启动成功后,在天猫精灵设备管理界面,下拉刷新即可更新设备列表。注意:更新后可能需要重新选择位置和别名。


重要提示:如前所述默认用户仅可接入1个设备,所以如果想接入多个,请先绑定技能后,再回复此贴申请,我会根据你的会员级别,赋予相应的设备接入权限。
看好了,是先绑定技能,再回复申请,绑定技能时一定要用论坛的用户名和邮箱,回复时提供用户名或邮箱,让我发现没绑定就申请的,扣分扣分扣分!因为浪费我时间,明白否?


回帖申请权限时请写明你的邮箱地址(邮箱和昵称必须与论坛注册一致),同时我将检查你过往是否有灌水表现,若有严重灌水行为,一律不予通过。同时,保留因其它前述原因,拒绝特定人员使用本服务的权利。


最后,感谢c1pher等大神(大神太多,不一一列举了)对天猫精灵接入的开创性工作,感谢天猫精灵官方支持,特别感谢群内船长大佬为本技能捐赠国内服务器!!希望未来有更多有实力的大佬参与捐赠


感谢各位朋友的支持!


Happy automating with HASSMART!

常见问题:

1. 解除绑定后提示error: did not find user in db!或者提示forbidden
解决方法:完全退出APP,重新登录。

2. 写错邮箱或hass地址
解决方法:论坛或群里找我修改,提供给我原来的和要修改的邮箱和hass地址。

3. 自行修改hass地址或长效token解决方法:想自行修改的先决条件是原hass地址仍可用(因为需要授权),使用原hass地址和邮箱,登录https://tmall.hass.app:8888/login.php,然后在页面内修改新地址或新token。

4. 之前能正常控制,突然控制不了了,提示智能家居有点问题,稍后再试
解决方法:在天猫精灵app里刷新下设备列表即可(最新版貌似下拉刷新没效果,需要去添加设备页面点“设备同步”)。







评分

参与人数 18金钱 +189 收起 理由
evantalk + 10 越来越完善了,点赞,点赞
yangyi2587758 + 5 在下对你的景仰犹如滔滔长江之水,连绵不绝.
adxr + 20 厉害了word楼主!
lijun9701 + 2 感谢楼主分享!
yaosong100 + 7 纳尼,还有这种操作?
goldstep + 10 厉害了word楼主!
dream_1996 + 7 厉害了word楼主!
zhou5469730 + 7 收下我的膝盖吧!!!
893399065 + 10 金钱有什么用?
lawsongsong + 7 论坛有你更精彩!
lidicn + 20 论坛有你更精彩!
Milo + 20 膜拜大神!
flashsoft + 20 专门注册账号来顶你!
liqx + 2 大神666!
neroxps + 20
windgo + 10 大神666!
芯蓝科技 + 5 大神666!
chiunownow + 7 厉害了word楼主!

查看全部评分

回复

使用道具 举报

11

主题

435

帖子

1849

积分

金牌会员

Rank: 6Rank: 6

积分
1849
金钱
1409
HASS币
10
发表于 2019-4-9 01:26:09 | 显示全部楼层
沙发
回复

使用道具 举报

4

主题

88

帖子

526

积分

论坛技术达人

积分
526
金钱
438
HASS币
0
发表于 2019-4-9 01:26:49 | 显示全部楼层
前排顶大佬!
回复

使用道具 举报

11

主题

435

帖子

1849

积分

金牌会员

Rank: 6Rank: 6

积分
1849
金钱
1409
HASS币
10
发表于 2019-4-9 01:28:14 | 显示全部楼层
感谢组织、感谢大佬提供服务器…这样接入最简单实用…搞起来
回复

使用道具 举报

10

主题

275

帖子

1127

积分

金牌会员

Rank: 6Rank: 6

积分
1127
金钱
852
HASS币
10
发表于 2019-4-9 01:30:24 | 显示全部楼层
撒个花
回复

使用道具 举报

6

主题

254

帖子

934

积分

高级会员

Rank: 4

积分
934
金钱
680
HASS币
0
发表于 2019-4-9 01:30:33 来自手机 | 显示全部楼层
艹,沙发都没了
回复

使用道具 举报

13

主题

114

帖子

704

积分

论坛分享达人

积分
704
金钱
585
HASS币
40
发表于 2019-4-9 01:30:36 | 显示全部楼层
nbnbnbnbnb!感谢!申请一下提升数量!
回复

使用道具 举报

11

主题

435

帖子

1849

积分

金牌会员

Rank: 6Rank: 6

积分
1849
金钱
1409
HASS币
10
发表于 2019-4-9 01:35:22 | 显示全部楼层
qjiang 发表于 2019-4-9 01:30
艹,沙发都没了

那必须…………闹呢
回复

使用道具 举报

7

主题

205

帖子

1509

积分

论坛技术达人

积分
1509
金钱
1294
HASS币
60
发表于 2019-4-9 01:35:35 | 显示全部楼层
感谢各位大佬的无私奉献!

默认只支持1个设备,如果申请的人多了的话,囧大有的忙了
E5-2650L-V2+华南X79+32GB*2
回复

使用道具 举报

1

主题

44

帖子

258

积分

中级会员

Rank: 3Rank: 3

积分
258
金钱
214
HASS币
0
发表于 2019-4-9 01:42:24 | 显示全部楼层
囧帅,大半夜发帖辛苦啊
前排支持
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

Archiver|手机版|小黑屋|Hassbian

GMT+8, 2019-10-20 01:12 , Processed in 0.090002 second(s), 25 queries .

Powered by Discuz! X3.4

© 2001-2017 Comsenz Inc.

快速回复 返回顶部 返回列表