mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-26 03:56:50 +00:00
8c7ef7a2c0
* s-t integrations: apply sentence-style caps to categories * Apply suggestions from code review Co-authored-by: Joakim Sørensen <joasoe@gmail.com> * Apply suggestions from code review Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com> --------- Co-authored-by: Joakim Sørensen <joasoe@gmail.com> Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com>
94 lines
3.0 KiB
Markdown
94 lines
3.0 KiB
Markdown
---
|
|
title: Bose SoundTouch
|
|
description: Instructions on how to integrate Bose SoundTouch devices into Home Assistant.
|
|
ha_category:
|
|
- Media player
|
|
ha_release: 0.34
|
|
ha_iot_class: Local Polling
|
|
ha_domain: soundtouch
|
|
ha_config_flow: true
|
|
ha_codeowners:
|
|
- '@kroimon'
|
|
ha_platforms:
|
|
- media_player
|
|
ha_integration_type: integration
|
|
ha_zeroconf: true
|
|
---
|
|
|
|
The Bose SoundTouch integration allows you to control your [Bose SoundTouch](https://www.soundtouch.com/) speakers from Home Assistant.
|
|
|
|
{% include integrations/config_flow.md %}
|
|
|
|
## Playing media
|
|
|
|
You can switch between one of your 6 pre-configured presets using ```media_player.play_media```
|
|
|
|
```yaml
|
|
# Play media preset
|
|
- service: media_player.play_media
|
|
target:
|
|
entity_id: media_player.soundtouch_living_room
|
|
data:
|
|
media_content_id: 1..6
|
|
media_content_type: PLAYLIST
|
|
```
|
|
|
|
You can also play HTTP (not HTTPS) URLs:
|
|
|
|
```yaml
|
|
# Play media URL
|
|
- service: media_player.play_media
|
|
target:
|
|
entity_id: media_player.soundtouch_living_room
|
|
data:
|
|
media_content_id: http://example.com/music.mp3
|
|
media_content_type: MUSIC
|
|
```
|
|
|
|
### Text-to-speech services
|
|
|
|
You can use TTS services like [Google text-to-speech](/integrations/google_translate) or [Amazon Polly](/integrations/amazon_polly) only if your Home Assistant is configured in HTTP and not HTTPS (current device limitation, a firmware upgrade is planned).
|
|
|
|
A workaround if you want to publish your Home Assistant installation on Internet in SSL is to configure an HTTPS Web Server as a reverse proxy ([NGINX](/docs/ecosystem/nginx/) for example) and let your Home Assistant configuration in HTTP on your local network. The SoundTouch devices will be available to access the TTS files in HTTP in local and your configuration will be in HTTPS on the Internet.
|
|
|
|
## Services
|
|
|
|
### Service `play_everywhere`
|
|
|
|
Create a multi-room (zone) from a master and play same content on all other
|
|
devices (slaves)
|
|
|
|
| Service data attribute | Optional | Description |
|
|
| ---------------------- | -------- | ----------- |
|
|
| `master` | no | `entity_id` of the master device
|
|
|
|
### Service `create_zone`
|
|
|
|
Create a multi-room (zone) from a master and play on selected slaves
|
|
|
|
| Service data attribute | Optional | Description |
|
|
| ---------------------- | -------- | ----------- |
|
|
| `master` | no | `entity_id` of the master device|
|
|
| `slaves` | no | List of slaves `entity_id` |
|
|
|
|
### Service `add_zone_slave`
|
|
|
|
Add slave(s) to an existing zone
|
|
|
|
| Service data attribute | Optional | Description |
|
|
| ---------------------- | -------- | ------------ |
|
|
| `master` | no | `entity_id` of the master device |
|
|
| `slaves` | no | List of slaves `entity_id` to add|
|
|
|
|
### Service `remove_zone_slave`
|
|
|
|
Remove slave(s) from an existing zone.
|
|
|
|
Removing the last slave will destroy the zone. You will need to
|
|
create a new zone in order to be able to add slave(s) again
|
|
|
|
| Service data attribute | Optional | Description |
|
|
| ---------------------- | -------- | ---------------- |
|
|
| `master` | no | `entity_id` of the master device |
|
|
| `slaves` | no | List of slaves `entity_id` to remove |
|