#Emulated Hue

# Google Home example configuration.yaml entry
emulated_hue:
  listen_port: 80
  # Google Home 无法在其他端口上工作。

# Amazon Echo example configuration.yaml entry
emulated_hue:
  listen_port: 80
  # Amazon Echo/Alexa 已无法在其他端口上工作。在 Alexa 应用中搜索 "Philips Hue Bridge V1 (round)" 以发现设备。

type:
  description: 要模拟的助手类型，可为 `alexa` 或 `google_home`。**此配置选项已弃用，并将在未来版本中移除。现在已不再需要定义 type。**
  required: false
  type: string
  default: google_home
host_ip:
  description: 您的 Home Assistant 安装所运行的 IP 地址。如果未指定此选项，集成会尝试自行确定该地址。
  required: false
  type: string
listen_port:
  description: "Hue bridge API Web 服务器运行的端口。可以使用系统上的任意空闲端口。不过，所有新的 Alexa 设备都要求 `listen_port: 80`。如果 Home Assistant 以非 root 用户运行且端口设置小于 `1024`，请参阅下方的 `setcap` 说明。"
  required: false
  type: integer
  default: 8300
advertise_ip:
  description: 如果您需要覆盖用于 UPnP 发现的 IP 地址。（例如，在 Docker 中使用网络隔离时。）
  required: false
  type: string
advertise_port:
  description: 如果您需要专门覆盖通告的 UPnP 端口。
  required: false
  type: integer
upnp_bind_multicast:
  description: 是否将 UPnP（SSDP）监听器绑定到组播地址（239.255.255.250），还是绑定到上方指定的（或自动确定的）单播 `host_ip` 地址。在某些特殊情况下，例如运行在 FreeBSD 或 FreeNAS jail 中时，您可能需要禁用此项。
  required: false
  type: boolean
  default: true
off_maps_to_on_domains:
  description: 会将 "off" 命令映射为 "on" 命令的域。例如，如果列表中包含 `script`，而您让 Alexa "turn off the *water plants* script"，该命令会按您要求她打开该脚本来处理。
  required: false
  type: list
  default: [script, scene]
expose_by_default:
  description: "实体是否默认通过网桥暴露，而不是显式指定暴露（请参见下方的 `emulated_hue` 自定义配置）。警告：如果您的设备很多（所有暴露域合计超过 49 个），请谨慎使用此选项。暴露的设备数量超过 Alexa 支持的上限时，可能会导致它一个设备都看不到。如果您在发现设备时遇到问题，请尝试禁用此项，并一次只显式暴露少量设备，看看能否解决问题。"
  required: false
  type: boolean
  default: true
exposed_domains:
  description: 当 `expose_by_default` 设为 true 时，默认暴露的域。
  required: false
  type: list
  default: [switch, light, group, input_boolean, media_player, fan, humidifier]
entities:
  description: 实体的自定义配置。
  required: false
  type: list

# Example configuration.yaml entry
emulated_hue:
  host_ip: 192.168.1.186
  listen_port: 8300
  advertise_ip: 10.0.0.10
  advertise_port: 8080
  off_maps_to_on_domains:
    - script
    - scene
  expose_by_default: true
  exposed_domains:
    - light
  entities:
    light.bedroom_light:
      name: "Bedside Lamp"
    light.ceiling_lights:
      hidden: true