Skip to content

v1.4.0b1 — Multi-language support (beta)

Pre-release
Pre-release

Choose a tag to compare

@JoshADC JoshADC released this 22 Sep 01:28

v1.4.0 beta 1 — Multi-language support

This is a beta. It only shows up in HACS if you turn on "Show beta versions" for this integration. If you don't opt in, nothing changes for you.

Adds Home Assistant translation support for all entity names and dropdown options, with French, Simplified Chinese, and Traditional Chinese translations. Contributed by @baylanger (#10), with PTZ camera testing by @kou147258 (#6). English users should see no visible change.

Also adds names for 25 additional settings found on PTZ cameras (iris, focus, zoom limit, IR light, digital slow shutter, image stabilization, and others).

⚠️ Breaking change: dropdown values are now the camera's raw values

Dropdowns used to report friendly words as their state — Off, White Light, IR, Semi-automatic, 50 Hz. They now report the camera's own internal value — close, colorVuWhiteLight, irLight, SEMIAUTOMATIC, 50hz. The UI still displays the friendly name (that's what the translation files do), but automations and scripts that send or compare dropdown values must use the raw value.

Affected: Supplement Light, BLC Mode, Focus Mode, White Balance, Noise Reduction, Power Line Frequency, and any other dropdown that showed a nicer word than the camera uses. Shutter Speed (1/120 etc.) and Day/Night Mode (day/night/auto) are unaffected.

The Developer Tools → States page shows the raw value for any entity.

How to test

  1. In HACS, open Hikvision ISAPI Image Control → ⋮ → Redownload, turn on Show beta versions, and pick v1.4.0b1.
  2. Restart Home Assistant.
  3. Check that entity names look right, and open the BLC Mode and Iris Mode dropdowns specifically — those use capitalized raw values and are the most likely to show a raw value instead of a friendly one if something's off.
  4. Check Settings → System → Logs for a "Translation coverage gaps" warning. It's harmless, but paste it into #6 so the missing names can be added.

Report results on #10 or #6. Once this has been tested on a few more camera models it'll go out as v1.4.0.