2025.3.4
首页 ▸ Integrations ▸

MusicCast

Yamaha MusicCast integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您从 Home Assistant 控制 Yamaha MusicCast 接收器。

受支持的设备在其 网站 上列出。

配置

要将 MusicCast integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

MusicCast 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

分组功能

Yamaha MusicCast integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 实现了分组操作。MusicCast 系统在分组方面有一些限制：

  • 不可能将同一设备的媒体播放器实体（例如，不同的区域）放置在不同的组中。
  • 如果非主区域是组的主控，则不可能让同一设备的其他媒体播放器加入该组。

播放媒体功能

MusicCast integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 支持所有流媒体服务的 Home Assistant 媒体浏览器，您的设备也支持这些服务。对于像 Deezer 这样的服务，您必须使用官方的 MusicCast 应用程序登录。此外，可以使用此操作播放本地 HTTP URL。这包括 Home Assistant 的文本转语音操作。

还可以使用播放媒体操作召回 NetUSB 预设。为此，必须在操作中将 “presets:<preset_num>” 作为 media_content_id 使用。

示例：

这是一个示例操作，从本地网络上的 Web 服务器播放音频文件（如 Home Assistant 内置的 Web 服务器）：

action: media_player.play_media
target:
  entity_id: media_player.sonos
data:
  media_content_type: "music"
  media_content_id: "http://192.168.188.18:8123/local/sound_files/doorbell-front.mp3"

此示例调用显示如何调用 netusb 预设 1：

action: media_player.play_media
target:
  entity_id: media_player.buro
data:
  media_content_id: "presets:1"
  media_content_type: "music"

配置 / 诊断实体

根据设备支持的功能，将为每个 MusicCast 设备添加多个实体。其中一些实体与 MusicCast 设备相关，另一些则与设备的某个区域相关。所有与设备和主区域相关的实体都将分配给主区域的 Home Assistant 设备。与其他区域相关的实体将分配给相应区域的 Home Assistant 设备。

数字实体

如果 MusicCast 设备支持，将添加以下实体：

  • 均衡器（配置、区域级别）
    • 为高、中、低分别添加一个数字 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more]
  • 音调控制（配置、区域级别）
    • 为低音和高音分别添加一个数字 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more]
  • 对话级别（配置、区域级别）
    • 设置对话音量与一般音量的关系
  • 对话提升（配置、区域级别）
    • 设置环绕系统中对话的垂直位置
  • DTS 对话控制（配置、区域级别）
    • 控制 DTS:X 内容的对话音量

选择实体

如果 MusicCast 设备支持，将添加以下实体：

  • 调光器（配置、设备级别）
    • 设置显示亮度
  • 环绕解码器类型（配置、区域级别）
    • 如果声音程序设置为环绕解码器，这里可以选择解码器类型
  • 睡眠（配置、区域级别）
    • 为设备设置一个睡眠定时器
  • 均衡器模式（配置、区域级别）
    • 一些设备支持多种不同的均衡器模式
  • 音调控制模式（配置、区域级别）
    • 一些设备支持多种不同的音调控制模式
  • 链接音频延迟（配置、区域级别）
    • 一些设备让用户选择是否希望音频和视频同步，或组内链接扬声器的音频
  • 链接控制（配置、区域级别）
    • 一些设备支持组的压缩音频
  • 链接音频质量（配置、区域级别）
    • 设置分组扬声器的音频质量

开关实体

如果 MusicCast 设备支持，将添加以下实体：

  • 扬声器 A（配置、设备级别）
    • 开关以打开扬声器组 A
  • 扬声器 B（配置、设备级别）
    • 开关以打开扬声器组 B
  • 聚会模式（配置、设备级别）
    • 让所有区域播放与主区域相同的内容
  • 低音扩展（配置、区域级别）
    • 将低音扩展到更多扬声器（在没有低音炮的配置中特别有用）
  • 额外低音（配置、区域级别）
    • 似乎与低音扩展相同，但在其他设备上
  • 增强器（配置、区域级别）
    • 增强压缩音频格式
  • 纯直通（配置、区域级别）
    • 让设备直接播放音频而不进行任何额外处理
  • 自适应 DRC（配置、区域级别）
    • 调整高低频级别的音量，以便在低音量下获得更好的音效

故障排除

本节记录已知问题及其解决方案。

处理 UDP 消息时的错误

Yamaha MusicCast integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 采用设备发送到 Home Assistant 的更新，而不是每隔几秒提取所有信息。这些消息没有错误校正机制，因此只能处理 100% 正确的消息。每当收到损坏的消息时，Yamaha MusicCast 集成将更新所有设备信息并记录错误消息，例如：

  • Received invalid message: <message>
  • Received non UTF-8 compliant message: b'<binary>'

如果您频繁收到这些错误，您应该首先尝试断开 MusicCast 设备的电源，等待 30 秒后再重新连接。如果这没有帮助，您可以尝试使用 LAN 电缆而不是 WiFi 将设备连接到网络。