Google Assistant SDK
Google Assistant SDK集成使家庭助理可以与Google Assista必威是什么nt互动。如果您想使用Google Assistant(例如,从手机或Google Home设备中)与您的家庭助理托管设备进行交互,那么您需要必威是什么必威体育存款Google助手一体化。
此集成允许:
- 将文本命令发送到Google Assistant,以控制由Google Assistant支持的设备,而不是由家庭助理。必威是什么例子:
- 将Nest Guard设置为家并守卫
- 开始吸尘
- 溪流电视上的前门
- 关闭厨房电视
- 在卧室扬声器上播放雨声
- 向Google Assistant扬声器广播消息,并显示不中断音乐/视频播放。例子:
- 咖啡准备好了
- 有人在前门
- 在主卧室中检测到的烟雾
- 在主浴室中检测到的漏水
- 播放任何媒体播放器上任何查询的Google Assistans Audio响应。例子:
- 给我讲个笑话
- 说ABC
- 唱生日快乐
- 大象怎么说?
- 与Google Assistant进行对话对话通过文本或语音集成。
先决条件
您需要配置开发人员凭据,以允许家庭助理访问您的Google帐户。必威是什么这些证书与那些证书相同巢或者Google表。如果您已经设置了凭据,则可以执行步骤1,然后在以下说明中跳过步骤13。
本节说明了如何在Google开发人员控制台。
- 首先转到Google开发人员控制台以启用Google Assistant API
- 选择现有项目或从左上角的下拉菜单创建新项目。
- 单击以启用此API。
- 单击屏幕左侧的字段,OAuth同意屏幕。
- 选择外部的和创造。
- 设置应用名称(申请同意书的名称)到您想要的任何内容,例如必威是什么。
- 然后您需要选择一个支持电子邮件。为此,只需单击下拉框,然后选择您的电子邮件地址。
- 您最终需要完成该部分:开发人员联系信息。为此,只需输入您的电子邮件地址(与上述相同)。
- 滚动到底部,然后单击保存并继续。不必填写其他任何东西,也可能会启用其他审查。
- 然后,您将自动进入范围页面。您无需在此处添加任何范围,因此请单击“保存”并继续移动到可选信息页面。您无需将任何内容添加到“可选信息”页面中,因此单击“保存”并继续,将您带到摘要页面。单击返回仪表板。
- 点击OAuth同意屏幕再次设置发布状态到生产否则,您的凭据每7天就会到期。
- 确保出版状态设置为生产。
- 点击证书在屏幕左侧的菜单中,然后单击创建凭据(在屏幕顶部),然后选择OAUTH客户端ID。
- 将应用程序类型设置为Web应用程序并为此证书集一个名称(例如“家庭助理证书”)。必威是什么
- 添加https://my.home-assistant.io/redirect/oauth到授权重定向URI然后单击创造。
- 然后,您将出现一个弹出式说法创建了OAuth客户端展示您的客户ID和您的客户秘密。记下这些内容(例如,将它们复制并粘贴到文本编辑器中),因为您会很快需要这些。一旦注意到这些字符串,请单击好的。如果您需要在任何时候再次找到这些凭据,请简单地导航到API&Services>凭据你会看到必威是什么家庭助理证书(或您在上一步中提到的任何东西)OAuth 2.0客户端ID。要查看两个客户ID和客户秘密,单击铅笔图标,这将带您到这些凭据的设置页面,信息将在页面的右侧。
- 仔细检查Google Assistant API已自动启用。为此,选择图书馆从菜单中搜索Google Assistant API。如果启用了,您将看到启用API旁边有绿色滴答。如果未启用,请启用它。
配置
通过使用此MY按钮,可以通过用户界面添加Google Assi必威体育存款stant必威是什么 SDK到您的家庭助理实例:
集成设置将接下来为您提供指令,以输入应用程序凭据(OAuth客户ID和客户端秘密)并授权家庭助理访问您的Google Assistant API。必威是什么
继续通过选择要授权的帐户的步骤。
笔记:您可能会收到一条消息,告诉您该应用程序尚未验证,您需要确认才能继续进行。
现在,您可以查看您授权家庭助理的详细信息,可以在底部使用两个选项访问。必威是什么点击继续。
该页面现在将显示链接帐户与家庭助理?必威是什么, 笔记您的实例URL。如果这是不正确的,请参考我的家必威是什么庭助理。如果一切看起来都不错,请单击链接帐户。
您可以关闭窗户,然后返回家庭助理,在那里您应该看到一个必威是什么成功!来自家庭助理的消息。必威是什么
故障排除
如果您的凭据有错误,则可以在应用程序凭据用户界面。
如果命令不工作,请尝试删除诸如“ the”之类的多余单词。例如。“在卧室扬声器上播放雨声”,而不是“在卧室扬声器上播放雨声”。
如果广播不起作用,请确保:扬声器不在不打扰模式下,家庭助理服务器与扬声器在同一网络中,并且在路由器中禁用IPv6。必威是什么
限制/已知问题
不支持多个Google帐户。
列出了基础库的限制这里(媒体播放,例程和个人成果不起作用)。
配置
在“配置”页面上,您可以设置与Google Assistant的交互的语言代码。如果未配置,集成将根据家庭助理的配置语言和国家选择一个。必威是什么列出了支持的语言这里
服务
服务google_assistant_sdk.send_text_command
您可以使用该服务google_assistant_sdk.send_text_command
向Google Assistant发送命令。
服务数据属性 | 选修的 | 描述 | 例子 |
---|---|---|---|
命令 |
不 | 命令发送到Google Assistant。 | 关闭厨房电视 |
媒体播放器 |
是的 | 媒体播放器实体的名称要在 | Media_player.living_room_speaker |
例子:
服务:google_assistant_sdk.send_text_command数据:命令:“转动离开厨房电视”
#在客厅扬声器上开玩笑服务:google_assistant_sdk.send_text_command数据:命令:“告诉我A玩笑”媒体播放器:Media_player.living_room_speaker
您还可以在相同的对话上下文中发送多个命令,这些命令对于解锁门或需要PIN的打开盖非常有用。例子:
服务:google_assistant_sdk.send_text_command数据:命令:-“打开这车库门”-“1234“
服务notify.google_assistant_sdk
您可以使用该服务notify.google_assistant_sdk
向Google Assistant Speaker广播消息,并显示不中断音乐/视频播放的情况。
服务数据属性 | 选修的 | 描述 | 例子 |
---|---|---|---|
信息 |
不 | 消息传播。 | 有人在前门 |
目标 |
是的 | 房间(在Google Assistant中) | 卧室 |
向所有演讲者广播的例子:
服务:notify.google_assistant_sdk数据:信息:到晚餐时间
示例向选定房间中的演讲者广播:
服务:notify.google_assistant_sdk数据:信息:到晚餐时间目标:-卧室-地下室
对话代理
在集成的配置选项中,启用对话代理,然后您可以通过点击仪表板右上方的辅助图标来与Google助手交谈:
服务:对话数据:文本:“暗淡这家庭房间灯”
注意:由于Google Assistant API中的错误,并非所有响应都包含文本,尤其是对于家庭控制命令,例如打开灯。这些将显示为<空响应>
。对于这些,Google Assistant对HTML和家庭助理集成的回应是必威是什么不允许解析html。