Google助手

这Google__assistant集成使您可以通过手机，平板电脑或Google Home设备上的Google Assistant来控制事物。

自动设置通过家庭助理云必威是什么

和必威是什么家庭助理云，您可以简单地将家庭助理实例连接到G必威体育存款oogle必威是什么 Assistant。使用Hom必威是什么e Assistant Cloud，您无需处理动态DNS，SSL证书或路由器上的打开端口。只需通过用户界面登录并建立与云的安全连接。必威是什么家庭助理云需要经过30天的免费试用后需要付费订阅。

对于家庭必威是什么助理云用户，可以找到文档这里。

手动设置

Google Assistant集成（无家庭助理云）比Google需要设置助手应用程必威是什么序的方式需要更多的设置。

Google云平台配置

1. 在在Google控制台上的操作。

   1. 点击新项目并给您的项目一个名字。
   2. 单击聪明的家卡，然后单击开始建造按钮。
   3. 点击命名您的智能家庭动作在下面快速设置给您的行动一个名字 - 家庭助理将出现在Google Ho必威是什么me应用中[测试] <动作名称>
   4. 单击概述在页面顶部的标签要返回。
   5. 点击建立您的行动，然后单击添加动作。
   6. 添加您的必威体育存款家庭助理U必威是什么RL：https：// 必威体育存款[您的家庭必威是什么助理URL：port]/api/google_assistant在里面实现URL盒子，更换[必威体育存款您的家庭助必威是什么理URL：端口]域 / IP地址和您的家庭助理可到达的端口。必威是什么必威体育存款
   7. 点击节省。
   8. 单击右上角的三个小点（更多）图标，选择项目设置
   9. 记下项目ID在一般的标签设置页。

2. 帐户链接您的应用程序与家庭助理互动是必需的。必威是什么

   1. 首先回到概述标签。
   2. 点击设置帐户链接在下面快速设置部分概述页。
   3. 如果被问到，请留下默认选项不，我只想在我的网站上创建帐户并选择下一个。
   4. 然后，如果询问链接类型选择Oauth和授权代码。点击下一个
   5. 输入以下内容：
      1. 客户ID：https://oauth-redirect.googleusercontent.com/r/ [your_project_id]。（代替[your_project_id]从上方使用您的项目ID）
      2. 客户秘密：您喜欢的任何东西，家庭助理都不需要此领域。必威是什么
      3. 授权URL：https：// 必威体育存款[您的家庭必威是什么助理URL：port]/auth/授权。（代替[必威体育存款您的家庭助必威是什么理URL：端口]带有您的价值观。）
      4. 令牌URL（替换为您的实际URL）：https：// 必威体育存款[您的家庭必威是什么助理URL：port]/auth/token。（代替[必威体育存款您的家庭助必威是什么理URL：端口]带有您的价值。）单击下一个， 然后下一个再次。
   6. 在里面配置您的客户范围文本框，类型电子邮件然后单击添加范围，然后输入姓名然后单击添加范围再次。
   7. 做不是查看Google通过HTTP Basic Auth标题传输客户端和秘密。
   8. 点击下一个，然后单击节省
   

3. 选择开发在页面顶部的标签，然后在右上角选择测试按钮生成草稿版本测试应用程序。如果您看不到此选项，请转到测试代替，单击设置按钮右上方的标题下方，并确保在设备测试上已启用（如果不是，请启用）。

4. 添加Google__assistant集成配置与您的configuration.yaml文件和重新启动家庭助理之后必威是什么配置指南以下。

5. 在Google Home应用中添加服务（请注意，应用程序版本可能略有不同。）

   1. 打开Goog​​le Home应用程序。
   2. 点击+左上角的按钮，单击设置设备，在“设置设备”屏幕中，单击“与Google一起使用”。你应该有[测试] <动作名称>在“添加新”下列出。选择应该引导您进入浏览器以登录您的家庭助手实例，然后将其重定向回到屏幕，如果需要，您可以为设备设置房间和昵必威体育存款称。必威是什么

允许其他用户

如果您想允许其他家庭用户控制设备：

1. 打开您在在Google控制台上的操作。
2. 点击测试在页面顶部，然后单击模拟器位于左侧的页面，然后单击控制台右上角的三个小点（更多）图标。
3. 单击管理用户访问。这将您重定向到Google Cloud Platform IAM权限页面。
4. 单击页面顶部的添加。
   1. 输入要添加的用户的电子邮件地址。
   2. 单击选择角色，然后选择项目
   3. 单击保存
   4. 复制并共享操作项目链接（https://console.actions.google.com/project/your_project_id/simulator）与新用户。
5. 让新用户使用自己的Google帐户打开链接，同意服务弹出条款，然后选择“开始测试”，选择版本 - 在下拉列表中的草稿，然后单击“完成”。
6. 让新用户转到他们的Google助手要添加的应用[测试]您的应用程序名称到他们的帐户。

启用设备同步

如果您想支持状态向Google服务器的活动报告（配置选项report_state）并将家庭助理设备与Google H必威是什么ome App同步（google_assistant.request_sync服务），您需要创建一个服务帐户。建议设置此配置密钥，因为它还允许使用以下命令“ OK Google，同步我的设备”。设置此组件后，每次您希望通过Google Assistans Integration在Home Assistant中添加新设备时，都需要调用此服务（或命令）。必威是什么这使您可以在不链接和重新链接帐户的情况下更新设备（请参阅以下）。

1. 服务帐户
   1. 在Google Cloud Platform控制台中，转到创建服务帐户密钥页。
   2. 在“ Google Cloud Platform”徽标旁边的页面左上方，选择您在Google Console上的操作中创建的项目。通过查看项目ID并确保其匹配来确认这一点。
   3. 从服务帐户列表中选择创建服务帐户。
   4. 在“服务帐户名”字段中，输入名称。
   5. 在“服务帐户ID”字段中，输入ID。
   6. 从角色列表中选择服务帐户>服务帐户令牌创建者。
   7. 点击继续接着完毕。您将返回到服务帐户列表，并显示您的新帐户。
   8. 单击下面的三个点菜单动作在您的新帐户旁边，然后单击管理密钥。你被带到钥匙页。
   9. 点击添加密钥然后创建新密钥。离开钥匙类型作为JSON然后单击创造。一个包含您的密钥下载到计算机的JSON文件。
   10. 使用此文件中的信息或直接添加到该文件中的信息service_account配置中的键。
   11. 点击关。
2. Homegraph API
   1. 去Google API控制台。
   2. 在“ Google Cloud Platform”徽标旁边的页面左上方，选择您在Google Console上的操作中创建的项目。通过查看项目ID并确保其匹配来确认这一点。
   3. 单击启用HomeGraph API。
3. 尝试“ OK Google，同步我的设备” - Google Home应用程序应导入您的裸露家庭助理设备，并提示您将它们分配到房间。必威是什么

启用本地履行

Google Assistant设备可以将其本地命令发送给家庭助理，从而使他们更快地响应。必威是什么

必威体育存款您的家庭助必威是什么理实例需要与您与之交谈的Google Assistant设备连接到同一网络，以便可以通过MDNS Discovery（UDP广播）发现它。

您的Google Assistant设备仍将通过Internet通信：

• 同步实体。
• 获取凭证建立本地连接。
• 发送涉及一个的命令安全设备。
• 如果本地履行失败，请发送命令。

1. 打开您在在Google控制台上的操作。
2. 点击开发在页面顶部，然后单击动作位于左上方的汉堡菜单中。
3. 上传app.js从这里通过单击节点和chrome上传JavaScript文件按钮。
4. 添加设备扫描配置：
   1. 点击+新扫描配置如果不存在配置
   2. 选择mdns
   3. 放MDNS服务名称至_home-assistant._tcp.local
   4. 点击添加字段，然后在下面选择一个字段选择姓名
   5. 输入新价值字段设置为。*\。
5. 检查框支持本地查询在下面添加功能。
6. 节省您的更改。
7. 等待30分钟，或重新启动所有Google Assistant设备。
8. 重新启动家庭助理必威是什么核心。
9. 使用Google Assistant设备，尝试说“ OK Google，同步我的设备”。这可能有助于避免问题，尤其是如果您在添加Cloud Google Assistant支持后的某个时候启用本地履行。

您可以通过以下来调试设置这些说明。

YAML配置

现在将您的设置添加到您的configuration.yaml文件，例如：

＃示例Configuration.yaml条目Google__assistant：Project_ID：your_project_idservice_account：！包括service_account.jsonreport_state：真的exposed_domains：-转变-光ENTITY_CONFIG：switch.kitchen：姓名：custom_name_for_google_assistant别名：-明亮的灯光-entry_lightslight.living_room：暴露：错误的房间：客厅

可用域

当前，以下域可与Google Assistant一起使用，并列出了其默认类型：

• alarm_control_panel（ARM/DISARM）
• 相机（流媒体，需要兼容的相机）
• 组（开/关）
• input_boolean（开/关）
• input_select（选项/设置/模式/值）
• 场景（开）
• 脚本（打开）
• 打开（打开/关）
• 风扇（开/关/速度百分比/预设模式）
• 灯（开/关/亮度/RGB颜色/颜色温度）
• 锁
• 盖子（开/关/设置位置）
• MEDIA_PLAYER（开/关/设置卷（通过设置卷）/源（通过SET INPUT源）/控制播放）
• 气候（温度设置，HVAC_MODE）
• 真空（码头/启动/停止/暂停）
• 传感器（温度传感器的温度设置和湿度传感器的湿度设置）
• 加湿器（湿度设置/开/关/模式）

安全设备

某些设备被认为是安全的，包括锁领域，alarm_control_panel域和盖子使用设备类型门，，，，车库或者门。

默认情况下，除非Secure_devices_pin已设置。为了允许打开，设置Secure_devices_pin到达某些东西，打开设备时会提示您会发出销钉。关闭或锁定这些设备不需要销钉。

对于警报控制面板，如果设置了代码，则必须与Secure_devices_pin。如果code_arm_required被设定为错误的该系统将在不提示PIN的情况下进行武器。

房间/区域支撑

尚未明确分配到房间但已被放置在家庭助理区域的实体将返回房间的提示，并在这些区域的设备上向Google提示。必威是什么

气候操作模式

可用操作模式的家庭助理和Google助手之间没有确切的1-1匹配。必威是什么以下是当前可用的模式：

• 离开
• 热
• 凉爽的
• 热门（自动）
• 仅限粉丝
• 干燥
• 生态

电视频道

家庭助理中没有电视频道对象。必威是什么电视频道只能按数字更改，而不是按名称更改（例如，转向频道第二）。

故障排除

404要求同步要求

由于您在Google App上的操作在技术上处于测试模式并且从未发布过，因此同步可能会在一段时间后（可能大约30天）失败。最终，该测试似乎到期。对设备的控制将继续起作用，但同步可能不会。如果您说“ OK Google，同步我的设备”并获得响应“无法同步家庭助理”（或您命名的项目），通常可以通过返回到您的测试应用程序来解决此问题必威是什么在Google控制台上的操作并点击模拟器在下面测试。再生版本测试应用程序，并尝试要求Google再次同步您的设备。如果再生草稿不起作用，请回到行动截面进入URL重新创建预览的关键。

这request_sync服务要求Google的初始同步包括agent_user_id。如果没有，该服务将记录一个错误，该错误读取诸如“请求包含无效参数”之类的错误。如果发生这种情况，那就UNINK帐户从家庭控制和重新链接。

这request_sync如果如果是404，服务可能会失败Project_IDHomegraph API与Project_ID在项目的偏好中找到的SDK的动作在Google控制台上的操作。通过：

1. 将您的项目从Google Cloud API控制台。
2. 在在Google控制台上的操作在这里你得到一个新的Project_ID。
3. 通过前面提到的[Google Console上的操作]设置指令运行，直到创建一个步骤service_account。
4. 一旦您开始创建新的service_account在[Google Cloud API控制台]中，确保您通过验证该项目选择[Google Console上的操作]中创建的项目Project_ID。
5. 将HomeGraph API启用到新项目。

验证Google Assistant可用https：// 必威体育存款[您的家庭必威是什么助理URL：port]/api/google_assistant如果正在工作，应该返回405：不允许的方法在浏览器或通过卷发打开时。

403要求同步要求

这request_sync如果未启用HomeGraph API，则服务可能会失败。去Google API控制台并验证您的项目启用了HomeGraph API。

404报告状态错误

如果您收到与日志报告中的报告状态有关的404个错误，则家庭助理将为从未同步Google同步的实体报告状态。必威是什么向您的Google家询问同步我的设备或运行服务google_assistant.request_sync。

链接过程中的错误：“无法更新设置。请检查您的连接”

您的履行URL可能是无效的或无法到达的。重新检查实现URL如指定手动设置并验证它是否可以公开接触。

nginx

使用nginx时，请确保您proxy_pass线才不是有一个落后/，因为这将导致错误。您的生产线应该看起来像：

proxy_pass http：// localhost：8123;

UNLINK和重新链接

如果您遇到麻烦帐户链接失败Un -链接服务后，请尝试清除浏览器历史记录和缓存。

链接失败 - 无法更新设置。请检查您的连接

如果您在链接帐户时遇到困难，则使用错误消息无法更新设置。请检查您的连接登录您的家庭助理实例后，请尝试设置必威是什么必威体育存款expose_by_default：false然后曝光单个简单的设备（最好是照明或开关）。如果您有问题，也值得检查是否禁用任何家庭广告阻滞剂。