Sonos
这Sonos集成使您可以控制自己的Sonos来自家庭助理的无线扬声器。必威是什么它还与宜家Symfonisk扬声器一起使用。
配置
可以通过使用此my按钮来通过用户必威体育存款界面添加S必威是什么onos到您的家庭助理实例：
Sonos可以由家庭助理自动发现。必威是什么如果发现实例，它将显示为“发现”，您可以选择立即设置它。
功能控制和传感器
扬声器级控件暴露为数字或者转变实体。另外，各种各样传感器和binary_sensor提供实体。
可控功能
- 所有设备：警报，低音，高音，交叉表，状态灯，触摸控制
- 家庭影院设备：音频延迟（又称“唇彩”），夜间声音，演讲增强，启用环绕
- 当与子配对时：启用低音炮，低音炮增益
传感器
- 每个Sonos系统：Sonos的最爱
- 带电池的设备：电池水平，电源状态
- 家庭影院设备：音频输入格式
- 支持语音的设备：启用麦克风
电池支撑笔记
电池传感器已完全支持Sonos漫游和Sonos移动S2固件上的设备。Sonos移动支持S1固件的扬声器受支持，但可能很少更新。
对于用电池电池的每个扬声器传感器显示当前的电池充电水平和binary_sensor创建了显示说话者的功率状态。这binary_sensor报告如果说话者目前由外部来源及其动力能量源属性显示哪些特定来源提供当前功率。此源属性可以是电池，，，，sonos_charing_ring如果使用无线充电，或USB_Power如果通过USB电缆充电。请注意，漫游将报告sonos_charing_ring即使使用通用的Qi充电器。
电池传感器依赖于工作变更事件或更新将延迟。S1电池传感器要求报告任何数据的工作事件。查看更多细节高级使用。
警报支持说明
Sonos集成添加了一个转变对于Sonos应用程序中的每个警报。检测到警报开关会自动检测，删除和分配，并带有几个有助于监视Sonos警报的属性。
麦克风支撑笔记
麦克风只能通过Sonos设备上的物理按钮启用/禁用，并且不能由家庭助手控制。必威是什么一个binary_sensor报告其当前状态。
Sonos收藏夹支持笔记
收藏夹传感器提供名称和Media_content_id每个收藏夹的值都保存在本地Sonos应用中。该传感器适用于需要在自定义模板中访问收藏夹的用户。对于大多数用户，建议使用媒体浏览器功能和“播放媒体”脚本/自动化操作访问收藏夹。
如果使用提供的Media_content_id与Media_player.play_media服务，MEDIA_CONTENT_TYPE必须设置为“ faste_item_id”。
示例模板：
＃获取所有喜欢的名称作为列表（旧行为）{{{state_attr（“ sensor.sonos_favorites”，，，，“项目”）.values（）|列表}}}＃按位置选择一个特定的喜欢的名字{{{（state_attr（“ sensor.sonos_favorites”，，，，“项目”）.values（）|列表）[[3这是给予的}}}＃选择一个随机项目的`Media_content_id`{{{state_attr（“ sensor.sonos_favorites”，，，，“项目”）列表|随机的}}}＃循环浏览并获取名称＆Media_content_id{％对于Media_id，，，，state_attr中的名称（“ sensor.sonos_favorites”，，，，“项目”）。项目（） ％}{{{姓名，，，，Media_id}}}{％endfor％}Sonos最爱传感器（Sensor.sonos_favorites默认情况下禁用）。可以从与Sonos集成相关的实体中找到并启用它设备和服务页。
玩媒体
Sonos接受了各种各样的Media_content_id格式中的格式Media_player.play_media服务，但最常见的是uris。例如，可以按原样提供Spotify和Tidal共享链接。播放的音乐托管在Plex服务器上可能。如果Sonos设备可以直接到达URI，则可以使用直接的HTTP/HTTPS链接到本地或远程媒体文件，但是特定的媒体编码支持可能会有所不同。
必须首先使用Sonos应用程序配置需要帐户的音乐服务（例如，Spotify）。
可选入住可以将参数添加到服务调用中。如果真的，媒体将附加到播放队列的结尾。如果未提供或错误的然后，队列将被替换。
例子：
这是一个示例服务调用，它从本地网络上的Web服务器（例如Home Assistant内置网络服务器）播放音频文件：必威是什么
服务：Media_player.play_media目标：ENTITY_ID：Media_player.sonos数据：MEDIA_CONTENT_TYPE：“音乐”Media_content_id：“http://192.168.1.50:8123/local/sound_files/doorbell-front.mp3“Sonos还可以从Spotify播放音乐或播放列表。Spotify URI和URL均可直接使用。使用播放列表URI的示例服务调用：
服务：Media_player.play_media目标：ENTITY_ID：Media_player.sonos数据：MEDIA_CONTENT_TYPE：“播放列表”Media_content_id：“Spotify：播放列表：abcdefghij0123456789xy”入住：真的使用Spotify URL的示例服务调用：
服务：Media_player.play_media目标：ENTITY_ID：Media_player.sonos数据：MEDIA_CONTENT_TYPE：“音乐”Media_content_id：“https://open.spotify.com/album/abcdefghij0123456789yz”运行PLEX Media Server在你家必威体育存款？Sonos集成也可以与之合作。此示例直接从您的PLEX服务器播放音乐：
服务：Media_player.play_media目标：ENTITY_ID：Media_player.sonos数据：MEDIA_CONTENT_TYPE：“音乐”Media_content_id：'plex：// {“ Library_name”：“音乐”，“ Artist_name”：“ M83”，“专辑_NAME”：“匆忙向上，我们正在做梦“}'服务
Sonos集成使各种自定义服务可用。
服务Sonos.snapshot
拍摄当前在一个或多个扬声器上播放的内容。如果您想播放门铃或通知声音并在之后恢复播放，则此服务以及以下一项服务非常有用。
队列没有被捕捉，必须保持不变，直到还原为止。使用Media_player.play_media安全，可用于播放通知声音，包括TTS公告。
| 服务数据属性 | 可选的 | 描述 |
|---|---|---|
ENTITY_ID |
是的 | 扬声器到快照。要针对所有Sonos设备，请使用全部。 |
with_group |
是的 | 如果我们还可以拍摄小组布局和小组中其他说话者的状态，默认为true。 |
服务Sonos.restore
还原一个或多个扬声器的先前拍摄的快照。
比赛队列没有快照。使用Sonos.restore在更换队列的扬声器上，将恢复比赛位置，但在新队列中！
| 服务数据属性 | 可选的 | 描述 |
|---|---|---|
ENTITY_ID |
是的 | 字符串或列表ENTITY_IDS应该恢复其快照。要针对所有Sonos设备，请使用全部。 |
with_group |
是的 | 如果我们还恢复了小组中的组布局和其他说话者的状态，则默认为true。 |
服务Sonos.join
在单个协调员下团结一致。这将成为一个新小组或加入现有组。
| 服务数据属性 | 可选的 | 描述 |
|---|---|---|
掌握 |
不 | 一个ENTITY_ID那将成为/留下协调员的演讲者。 |
ENTITY_ID |
是的 | 字符串或列表ENTITY_IDS加入主人。 |
服务Sonos.unjoin
从他们的扬声器组中删除一个或多个扬声器。
| 服务数据属性 | 可选的 | 描述 |
|---|---|---|
ENTITY_ID |
是的 | 字符串或列表ENTITY_IDS与他们的协调扬声器分开。 |
服务Sonos.set_sleep_timer
设置一个计时器，该计时器将在一定时间后通过将音量缩小到0来关闭扬声器。PROTIP：如果将Sleep_time值设置为0，则扬声器将立即开始缩小音量。
| 服务数据属性 | 可选的 | 描述 |
|---|---|---|
ENTITY_ID |
是的 | 字符串或列表ENTITY_IDS将设定其计时器。 |
睡觉时间 |
不 | 扬声器应等到开始逐渐变细的整数秒数。不能超过86399（一天）。 |
服务Sonos.clear_sleep_timer
如果设置了扬声器，请清除扬声器上的睡眠计时器。
| 服务数据属性 | 可选的 | 描述 |
|---|---|---|
ENTITY_ID |
不 | 字符串或列表ENTITY_IDS将清除计时器。必须是协调员。 |
服务Sonos.update_alarm
更新现有的Sonos警报。
| 服务数据属性 | 可选的 | 描述 |
|---|---|---|
ENTITY_ID |
是的 | 字符串或列表ENTITY_IDS将清除计时器。必须是协调员。 |
alarm_id |
不 | Sonos中使用的整数用于指您的警报。 |
时间 |
是的 | 是时候设置警报了。 |
体积 |
是的 | 浮子以达到音量水平。 |
已启用 |
是的 | 布尔值是否启用此警报。 |
包括_linked_zones |
是的 | 布尔值定义了警报是否还会在分组玩家身上播放。 |
服务Sonos.play_queue
开始玩Sonos队列。
力量开始播放队列，允许从另一个流（例如收音机）切换到队列。
| 服务数据属性 | 可选的 | 描述 |
|---|---|---|
ENTITY_ID |
是的 | 字符串或列表ENTITY_IDS将开始玩。如果针对组，则必须是协调员。 |
queue_position |
是的 | 歌曲的位置在队列中开始播放，从0开始。 |
服务Sonos.remove_from_queue
从队列中删除项目。
| 服务数据属性 | 可选的 | 描述 |
|---|---|---|
ENTITY_ID |
是的 | 字符串或列表ENTITY_IDS将从队列中删除项目。如果针对组，则必须是协调员。 |
queue_position |
是的 | 位于队列中以卸下。 |
＃示例自动化以删除刚从队列中播放的歌曲别名：“消除最后的玩歌曲从队列”ID：从队列中删除最后播放的歌曲扳机：-平台：状态ENTITY_ID：Media_player.kitchen-平台：状态ENTITY_ID：Media_player.bathroom-平台：状态ENTITY_ID：Media_player.move（健康）状况：（健康）状况：和条件：＃协调员-（健康）状况：模板value_template：>{{state_attr（trigger.entity_id，'group_members'）[0] == trigger.entity_id}}}＃从队列到队列-（健康）状况：模板value_template：>{{'queue_position'trigger.from_state.attributes和'queue_position'trigger.to_state.attributes}}＃ 向前进-（健康）状况：模板value_template：>{{{trigger.from_state.attributes.queue_position 行动：-服务：Sonos.remove_from_queue目标：ENTITY_ID：>{{trigger.entity_id}}数据：queue_position：>{{trigger.from_state.attributes.queue_position}}} 网络要求
为了最佳工作，Sonos设备必须能够连接回TCP端口1400上的主助手主机。这将允许基于推动的更新正常工作。必威是什么如果该端口被阻止或从SONOS设备上无法实现，则集成将返回到一个轮询模式，该模式更慢，效率较低。如果检测到此问题，则集成将提醒用户。
看高级使用下面的其他配置选项可能需要在具有更复杂的网络拓扑的设置中解决此问题。
高级使用
对于高级用途，有一些手动配置选项可用。通常仅在您拥有复杂的网络设置时才需要这些，而家庭助理和Sonos不在同一子网上。必威是什么
您可以通过指定Sonos IP地址来禁用自动发现：
＃示例配置Sonos：媒体播放器：主持人：-192.0.2.25-192.0.2.26-192.0.2.27如果您必威体育存款的家庭助理必威是什么实例有多个IP地址，则可以选择用于Sonos自动发现的特定IP地址网络一体化。仅当Sonos扬声器位于网络段上的网络段无法从默认接口到达网络段时，才有必要。
Sonos演讲者将尝试将其连接到家庭助理以提供变更活动。必威是什么默认情况下，家庭助理将在必威是什么端口1400上收听，但如果使用的话，将尝试1400上以上的接下来100个端口。您可以更改家庭助理向Sonos扬声器做广告的IP地址。必威是什么这可以在诸如何时的情况下有助于不是使用Docker选项-net =主机：
＃示例Configuration.yaml条目修改广告主机地址Sonos：媒体播放器：advertise_addr：192.0.2.1