HA 整合:Bravia / Soundbar / PS5 / Apple TV / Sonos

这一页与 home-ai-quickstart 的 HA 基础叠加用 —— 你已经在 HA 上能跑了,本页加装影院组件的 integration。

1. Sony Bravia TV(✓ 已核实)

1.1 HA 集成: bravia_tv(官方)

来源:home-assistant.io/integrations/braviatv/(2026-07 直接抓取)

  • 支持机型:几乎所有 2013 年起的 Bravia(从 KDL-W 系列往后),Bravia 9 / 8 / 7 全支持
  • 2013 年之前:不支持,要 HDMI-CEC 或 Broadlink IR Blaster 兜底
  • 认证方式:PSK(Pre-Shared Key) 比 PIN 稳(Bravia CAM Web UI 上生成,填 8-16 位)
  • 功能:
    • 切换信号源
    • 音量 + 静音
    • 启动 app(play_media → 应用 ID)
    • 全键 IR 模拟:home / exit / up / down / left / right / 播放键 / 数字键
  • IP Remote API:443 TCP(默认),Bravia 上需手动开”网络连接遥控” + IP Remote 钩子
  • Apple TV 风格 wake-on-lan 不支持,但 PSK 握手后可维持长连接,延迟 <100ms

1.2 配置步骤

  1. Bravia 上:Settings → Network → Home Network → IP Remote → ON,记下 PSK
  2. HA 上:Settings → Devices → Add Integration → “Sony Bravia TV”
  3. 填电视 IP + PSK → 完成
  4. 验证:Developer Tools → Services → media_player.turn_on entity_id: media_player.bravia_* → 应该启动

1.3 推荐自动化

# "看电影场景"
automation:
  - alias: "看电影场景 - 协作"
    trigger:
      - platform: state
        entity_id: media_player.bravia_living_room
        to: "playing"
    action:
      - service: light.turn_on
        target:
          entity_id: light.living_room_main
        data:
          brightness_pct: 15
          kelvin: 2000
      - service: media_player.unmute  # AVR 解静音
        target:
          entity_id: media_player.denon_x3800h
      # 触发 [[home-ai-predict]] 预热也可以连

1.4 Bravia CAM(⭐ 待人工核)

  • 预测精度:Bravia CAM 通过 AI 检测坐姿,自动调亮度 / 距离保护(成人 1-3m 内有效,小孩自动提示)
  • HA 整合状态:未取得一手 source — 推论 Sony IP Remote API 能拿到”人数” / “距离”数据
  • 本地录像 / 上传:默认不上 Sony 云,可手动开 PSN 同步

2. Sony PlayStation 5 / PS5 Pro(✓ 已核实)

2.1 HA 集成: playstation_network(2025.7 起)

来源:home-assistant.io/integrations/playstation_network/(2026-07)

  • 支持设备:PS5、PS4、PS3、PS Vita、PS PC
  • 认证:NPSSO token(从 PlayStation Network 登录页拿,HA 配置时给 URL 取)
  • 媒体播放器实体(media_player):当前播放游戏的标题 + 封面 + 进度
  • 媒体浏览器 + 启动项:HA 的 media browser 直接发 PS5 启动
  • 不能开关 PS5(HA 不控电源,只能联动 happy state)

2.2 装机

  1. HA → Add Integration → “PlayStation Network”
  2. 浏览器跳 psn 登录,拿 NPSSO token
  3. 填入 HA,选择你已加入的 PS5 account
  4. household_id(NPSSO)+ account_id:PS5 personal ID
  5. 完成,media_player.ps5_xxx 出现

2.3 场景

# 检测到 PS5 启动 → 切电视到 HDMI 3 + 关灯
automation:
  - alias: "PS5 启动 → 切到游戏模式"
    trigger:
      - platform: state
        entity_id: media_player.ps5_pro
        to: "playing"
    action:
      - service: media_player.select_source
        target:
          entity_id: media_player.bravia_living_room
        data:
          source: "HDMI 3/4"  # 强 VRR 端口
      - service: select.bravia_picture_mode
        # Bravia 9 接到 PS5 时,Dolby Vision Gaming 自动打开

3. Apple TV 4K(✓ 已核实)

3.1 HA 集成: apple_tv(官方)

来源:home-assistant.io/integrations/apple_tv/(2026-07)

  • 每个 Apple TV 提供 3 个 entities:media_player + remote + 二选一(三实体模式)
  • 功能:home / 上 / 下 / 左 / 右 / 选 / 菜单 / Play / Pause
  • 无法直接读取当前开关状态 — Apple 协议限制,HA 集成只能 toggle

3.2 装机 + 场景

  1. HA → Add → “Apple TV”
  2. 输 Apple TV 凭据(iCloud + 二步验证)
  3. 完成
- alias: "Netflix 一键观影"
  trigger:
    - platform: state
      entity_id: media_player.living_room_apple_tv
      to: "playing"
  action:
    - service: scene.turn_on
      target:
        entity_id: scene.movie_mode

4. Google Cast(50.7% HA 用户安装)

4.1 HA 集成: google_cast(官方)

来源:home-assistant.io/integrations/google_cast/

  • HA pre-0.7 起就在(老牌 IoT 集成)
  • 50.7% 用户安装(已核实 popularity)
  • 自动发现:mDNS / Bonjour,局域网 zero-config
  • 支持:Bravia(带 Cast)、Sony HT-A 系列带 Chromecast、Apple TV、Android TV / Google TV 设备、Chromecast Audio
  • 不控制电源 — Cast 是播放控制而非开关

4.2 实战

  • HT-A9 / A7000:Google Cast 集成自动发现 → 直接用 media_player.ht_a9_living_room
  • Apple TV 4K:不通过 Cast(走 Apple TV 集成)
  • Bravia 9:可作为 Cast 目标(浏览器 / 手机 投屏),但电视功能仍用 bravia_tv
# 厨房小爱 → 把播放推到客厅 HT-A9
- alias: "Tidal 推家庭影院"
  trigger:
    - platform: state
      entity_id: media_player.living_room_speaker
      to: "playing"
  action:
    - service: cast.media_seek
      target:
        entity_id: media_player.ht_a9_living_room
      data:
        position: "{{ states.media_player.living_room_speaker.attributes.media_position | int }}"

5. Sonos / 360SSM 多区

5.1 Sonos HA 集成(本地推送)

  • Local Push 集成(已核实):HA 主动推音频到 Sonos
  • UPnP 必须开(Sonos 上 Settings → System → 网络 → UPnP 开)
  • 端口:1400 / 1443 必须可被 HA 访问
  • 每个 Sonos 暴露为 media_player

5.2 实操路径

# "晚安"场景:关电视、Sonos 切白噪声
- alias: "晚安"
  trigger:
    - platform: time
        after: "23:30:00"
  action:
    - service: media_player.turn_off
      target:
        entity_id: media_player.bravia_living_room
    - service: media_player.play_media
      target:
        entity_id: media_player.sonos_bedroom
      data:
        media_content_type: playlist
        media_content_id: "https://www.example.com/rain.mp3"

6. AVR (Denon / Marantz) 集成

6.1 HA 集成:denonavrecv / marantz

  • HA 自带,Local Push,HEOS 网络发现
  • 提供 media_player + remote + select source
  • DENON 的 HEOS 集成是 Local Push,灵敏度 < 100 ms
  • ⚠️ 部分老款 Marantz 需要通过 HEOS Telnet API,2024 起改用 HTTPS — 见 HEOS 文档

6.2 场景

# 看电影:开 AVR、切 Dolby Atmos 模式、调音量
- alias: "启动影院"
  trigger:
    - platform: state
      entity_id: media_player.bravia_living_room
      to: "playing"
      for:
        seconds: 5
    condition:
      condition: state
      entity_id: media_player.ps5_pro
      state: "playing"
  action:
    - service: media_player.turn_on
      target:
        entity_id: media_player.denon_x3800h
    - service: media_player.select_sound_mode
      target:
        entity_id: media_player.denon_x3800h
      data:
        sound_mode: "Dolby Atmos"
    - service: media_player.volume_set
      target:
        entity_id: media_player.denon_x3800h
      data:
        volume_level: 0.55  # 中等

7. Bravia CAM 与 HA(待人工核)

  • Sony IP Remote API:getRemoteControllerInfo + enumAvailableSources —— 能读 TV 信息
  • CAM 数据:摄像头的 “personCount” / “viewingDistance” — Sony 未公开(2026-07 未取得一手 source)
  • HA bravia_tv 集成仅支持基础控制,不读 CAM 数据

留给未来:

  • 监听 PSN-CAM(若有人写 custom integration)
  • 用 ONVIF 拉 Bravia CAM 实时码流,直接走 HA Frigate / motion 检测

8. 全栈实战:一键看电影

scene:
  - name: "全屋影院场景"
    steps:
      - service: scene.turn_on
        target:
          entity_id: scene.living_room_movie
        # scene.yaml 里再嵌套

scene.yaml:

scene:
  - name: "living_room_movie"
    entities:
      light.living_room_main: state_on(brightness=10, kelvin=2000)
      light.living_room_back: state_on(brightness=5, kelvin=2000)
      climate.living_room: state_on(hvac_mode=cool, temperature=24)
      media_player.bravia_living_room: state_playing(source=HDMI_3)
      media_player.denon_x3800h: state_playing(volume=0.55)

触发:Apple TV 4K 启动 / PS5 启动 / UHD 蓝光机启动,全 HA 联动

9. 引用

下一步:HA 配置好 → 看 home-theater-shopping 怎么下单 + home-theater-decisions 三档预算装配样板。