20200710强力更新:支持小度音箱!
只划重点:添加设备搜索hassmart,customize里写:xiaodu: true,其他与猫精接入方法一样。目前支持不全,只能switch, light, cover.
20191109更新(其实这个功能早就更新了,今天才发出来而已):
大家真正用本技能接入的朋友,肯定知道,时不时需要重新刷新设备,首先这并不是BUG,而是为了极速控制体验。
如果你不想经常刷新,控制速度慢点无所谓,现在也提供了方法,登录此页面,然后看到下图所示页面,把图中的极速模式开关关掉,然后点击修改就ok了。
=====================================================================
各位久等了!
首先说点废话,自从上次论坛被攻击以来,论坛的天猫精灵接入就不可用了,至今已经将近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,其余类型后续将陆续支持;
20190826更新支持新的参数(进阶设置,这里配置好,就不需要在app里指定类别,位置和名称了。请确保你按上述配置,能看到设备后再尝试):
如上图,新增三个参数如下:
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进行绑定。
2.2 输入HASS地址
输入你的HASS公网地址,要包括http或https,如https://my.hass.com:8123。点击确定,系统会验证HASS地址的有效性,并跳转到你的HASS实例的OAuth登录页面;
2.3 OAuth登录
输入HASS用户名和密码授权登录,鉴权正确之后会提示授权成功,第一次使用需要填写昵称、邮箱地址(务必要填写论坛的用户名和邮箱)和长效令牌(1.5部分获取得到的),点击确定,系统会验证长效令牌的可用性,如果检查成功会提示token获取成功,并自动跳转到设备列表界面;
2.4 设备列表中选择设备位置和别名
此时天猫精灵智能设备管理界面会显示HASS里已配置为tmall_genie: true的设备列表,默认都显示为客厅的设备。退回APP最初的“我的”界面,点击查看全部,应该可以看到设备列表了,这时需要在此列表中点击相应设备,设置其位置或别名(必须设置,否则天猫精灵无法识别,其中开关类设备,为万能设备,可设置为任意其它类型);
2.5 语音测试
设置完成后,就可以对天猫精灵说了:天猫精灵,打开卧室吸顶灯(假设你的设备是light,位置选的卧室,别名选的吸顶灯);
2.6 设备更新
如果HASS中设置进行了更新,在确保HASS已启动成功后,在天猫精灵设备管理界面,下拉刷新即可更新设备列表。注意:更新后可能需要重新选择位置和别名。
重要提示:如前所述默认用户仅可接入1个设备,所以如果想接入多个,请先绑定技能后,再回复此贴申请,我会根据你的会员级别,赋予相应的设备接入权限。
看好了,是先绑定技能,再回复申请,绑定技能时一定要用论坛的用户名和邮箱,回复时提供用户名或邮箱,让我发现没绑定就申请的,扣分扣分扣分!因为浪费我时间,明白否?
另外,一个论坛账号对应一个天猫接入账号,如果你想更换hass地址,目前还没办法自行更换,请论坛私信我代为修改,记住千万不要重新注册,由于数据库字段唯一性要求,如果重复注册了,你这个新地址就没法修改了。
回帖申请权限时请写明你的邮箱地址(邮箱和昵称必须与论坛注册一致),同时我将检查你过往是否有灌水表现,若有严重灌水行为,一律不予通过。同时,保留因其它前述原因,拒绝特定人员使用本服务的权利。
最后,感谢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.hassmart.com:8888/login.php,然后在页面内修改新地址或新token。
请注意:本服务免费提供,但如果未按此要求操作更换hass地址,需要楼主帮助更换的,楼主平时也很忙,论坛私信不一定能及时看到,而且每次都要到数据库进行操作,比较麻烦。如果想更快得到处理,请淘宝拍这个链接10件,备注里写上你要改的信息,或发到旺旺上,楼主会第一时间进行处理。谢谢大家!
4. 之前能正常控制,突然控制不了了,提示智能家居有点问题,稍后再试
解决方法:在天猫精灵app里刷新下设备列表即可(最新版貌似下拉刷新没效果,需要去添加设备页面点“设备同步”)。
|