Documentation for google_assistant media controls (#13677)

This commit is contained in:
Brynley McDonald 2020-06-23 07:40:33 +12:00 committed by Franck Nijhof
parent 6cfd010a91
commit 4a8ed9e245
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3

View File

@ -189,11 +189,17 @@ Currently, the following domains are available to be used with Google Assistant,
- light (on/off/brightness/rgb color/color temp) - light (on/off/brightness/rgb color/color temp)
- lock - lock
- cover (on/off/set position) - cover (on/off/set position)
- media_player (on/off/set volume (via set volume)/source (via set input source)) - media_player (on/off/set volume (via set volume)/source (via set input source)/control playback)
- climate (temperature setting, hvac_mode) - climate (temperature setting, hvac_mode)
- vacuum (dock/start/stop/pause) - vacuum (dock/start/stop/pause)
- sensor (temperature setting for temperature sensors and humidity setting for humidity sensors) - sensor (temperature setting for temperature sensors and humidity setting for humidity sensors)
<div class='note'>
Some of these devices may not display correctly in the Google Home app, such as media_player, however voice commands will still work.
</div>
### Secure Devices ### Secure Devices
Certain devices are considered secure, including anything in the `lock` domain, `alarm_control_panel` domain and `covers` with device types `door`, `garage` or `gate`. Certain devices are considered secure, including anything in the `lock` domain, `alarm_control_panel` domain and `covers` with device types `door`, `garage` or `gate`.
@ -202,15 +208,6 @@ By default these cannot be opened by Google Assistant unless a `secure_devices_p
For the Alarm Control Panel if a code is set it must be the same as the `secure_devices_pin`. If `code_arm_required` is set to `false` the system will arm without prompting for the pin. For the Alarm Control Panel if a code is set it must be the same as the `secure_devices_pin`. If `code_arm_required` is set to `false` the system will arm without prompting for the pin.
### Media Player Sources
Media Player sources are sent via the Modes trait in Google Assistant.
There is currently a limitation with this feature that requires a hard-coded set of settings. Because of this, the only sources that will be usable by this feature [are listed here](https://developers.google.com/actions/reference/smarthome/traits/modes).
#### Example Command
"Hey Google, change input source to TV on Living Room Receiver"
### Room/Area support ### Room/Area support
Entities that have not been explicitly assigned to rooms but have been placed in Home Assistant areas will return room hints to Google with the devices in those areas. Entities that have not been explicitly assigned to rooms but have been placed in Home Assistant areas will return room hints to Google with the devices in those areas.