ITADN
ngocjohn/vehicle-info-card
README.md
以下内容由 AI 翻译,如有问题请点此提交 issue 反馈

hacs hacs last-commit total-downloads latest-downloads buy_me_a_coffee

🚙 车辆信息卡片


此自定义卡片显示有关您的梅赛德斯-奔驰车辆的基本信息。它使用 ReneNulschDE 提供的适用于梅赛德斯-奔驰汽车的 Custom Component 来获取数据,该组件可在 mbapi2020 中找到。该卡片包含四个主要按钮:行程数据、车辆状态、节能显示和胎压。这些按钮可以轻松替换为 Home Assistant 中的任何 Lovelace 卡片,从而实现灵活且可定制的车辆数据显示。

卡片功能

  • 全面的车辆信息:在一个地方提供有关汽车的基本信息。

  • 车辆位置显示:在地图上显示车辆的当前位置,并可选择跟踪路线。

  • 视觉幻灯片:提供车辆的视觉幻灯片。

  • 集中式远程控制:提供可用的远程控制功能和设置,均可从单个卡片访问。

  • 独立子卡片自定义:允许针对每个独立子卡片进行自定义,以满足特定需求和偏好。

  • 多语言支持:该卡片包含多种翻译,使其可支持多种语言。

支持的语言本地化

本项目支持以下语言
Language CodeNameNative Name
cs捷克语Čeština
de德语Deutsch
en-GB英语English (GB)
en英语English
es西班牙语Español
fr法语Français
it意大利语Italian
lt立陶宛语Lietuvių
nl荷兰语Nederlands
pl波兰语Polski
sk斯洛伐克语Slovenčina
vi越南语Tiếng Việt
zh-Hanszh-hans简体中文
zh-Hantzh-hant繁體中文

查看选项

子卡片

安装

HACS (Home Assistant Community Store)

使用此链接直接前往 HACS 中的仓库

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

  1. If HACS is not installed yet, download it following the instructions on https://hacs.xyz/docs/use/#getting-started-with-hacs
  2. Open HACS in Home Assistant
  3. Search for Vehicle info card
  4. Click the download button. ⬇️
  5. Force refresh the Home Assistant page Ctrl + F5 / Shift + + R
  6. Add vehicle-status-card to your dashboard

手册

点击以展开安装说明
  1. 下载 vehicle-info-card.js.

  2. 将下载的文件放置在您的 Home Assistant 机器上的 config/www 文件夹中(如果 configuration.yaml 文件所在的文件夹中没有 www 文件夹,请创建该文件夹并将文件放置其中)。

  3. 在 Home Assistant 中前往 Configuration->Lovelace Dashboards->Resources(如果 Lovelace Dashboard 页面上没有 resources 标签,请在您的账户设置中启用高级模式,然后重试此步骤)。

  4. 添加一个新资源:

  • Url = /local/vehicle-info-card.js
    • Resource type = module
  1. 强制刷新 Home Assistant 页面 Ctrl + F5 / Shift + + R
  2. 将 vehicle-info-card 添加到您的页面。

配置

基本选项可在 GUI 编辑器中配置。此卡片还提供可选的高级功能以增强自定义。您可以启用幻灯片以显示您的车辆图片,并支持左右滑动以在图片之间切换。图片可以直接在编辑器中上传到 HA 实例。此外,您可以在地图上显示车辆的位置以及生成的地址。

[!TIP] 为了获得最佳质量的车辆图片,请使用 Mercedes-Benz API 服务 下载。您可以在 此处 找到用于下载图片的 Python 脚本。

Card UI Editor

选项

以下是自定义卡片的基本配置
名称类型要求描述
typestring必填custom:vehicle-info-card.
entitystring必填车辆传感器的实体 ID,例如 sensor.license_plate_car
namestring可选卡片上显示的名称。默认为车辆型号名称。
device_trackerstringOptional用于地图显示的设备跟踪器实体 ID。
google_api_keystringOptional用于从坐标生成地址的 Google Maps API 密钥。默认使用 OpenStreetMap 服务。
selected_languagestringOptional语言选项。默认 en
show_slidesbooleanOptional设置为 true 以启用汽车图片幻灯片。默认为 false
show_mapbooleanOptional设置为 true 以在地图上显示汽车位置。默认为 false
show_buttonsbooleanOptional设置为 true 以显示按钮。默认为 true
show_backgroundbooleanOptional设置为 true 以显示背景图像。默认为 true
enable_map_popupbooleanOptional设置为 true 以启用地图弹出功能。默认为 false
enable_services_controlbooleanOptional设置为 true 以启用远程控制选项卡。默认为 false
map_popup_configobjectOptional包含 theme_mode 以控制地图外观(light dark auto)、hours_to_show 以指定要显示的数据小时数,以及 default_zoom 以设置地图的初始缩放级别的配置。
imagesobject listOptional用于幻灯片的图片 URL 或来自 config/www 文件夹的路径列表。每张图片必须包含一个 "url" 属性。图片在透明背景且最大宽度为 500px 时渲染效果更佳,以适配卡片。
trip_cardobject listOptional行程卡片的配置对象。
vehicle_cardobject listOptional车辆卡片的配置对象。
eco_cardobject listOptional生态显示卡片的配置对象。
tyre_cardobject listOptional胎压卡片的配置对象。
servicesobject list可选配置集成的可用服务。此处列出了可启用或禁用的可用服务。

服务配置

[!NOTE] 某些服务要求您在移动 Android/IOS 应用中创建安全 PIN。请在集成的选项对话框中存储该 PIN。更多信息

服务配置
服务描述
charge管理充电过程。
auxheat控制辅助加热。
doorsLock锁定车门。
preheat控制零排放车辆的预热。
sigPos启动灯光信号。
sunroof控制天窗(打开、倾斜、关闭)。
sendRoute向车辆发送路线。
engine控制发动机(启动、停止)。
windows控制车窗(打开、关闭、移动)。
Yaml 配置
services:
  charge: true
  auxheat: true
  doorsLock: true
  preheat: true
  sigPos: true
  sunroof: true
  sendRoute: true
  engine: true
  windows: true

示例

以下是 Vehicle status 按钮的替换实体卡片配置。

[!TIP] 有关增强型图像元素卡片,请参阅 Home Assistant 论坛上的此教程。使用新版本的组件配合下载的图片可获得最佳效果。

Yaml 配置
- type: custom:vehicle-info-card
  entity: sensor.6z1_2359_car
  name: Mercedes-AMG E 43 4MATIC
  device_tracker: device_tracker.demo_paulus
  show_map: true
  show_slides: true
  show_buttons: true
  show_background: true
  enable_map_popup: false
  images:
    - url: /local/benz/benz-1.png
    - url: /local/benz/benz-2.png
    - url: /local/benz/benz-3.png
    - url: /local/benz/benz-4.png
    - url: /local/benz/benz-5.png
  vehicle_card:
    - type: entities
      show_header_toggle: false
      state_color: true
      title: Vehicle status
      entities:
        - entity: lock.6z1_2359_lock
        - entity: binary_sensor.6z1_2359_park_brake_status
        - entity: binary_sensor.6z1_2359_tire_warning
        - entity: binary_sensor.6z1_2359_low_brake_fluid_warning
        - entity: binary_sensor.6z1_2359_low_coolant_level_warning
        - entity: binary_sensor.6z1_2359_engine_light_warning
        - entity: binary_sensor.6z1_2359_low_wash_water_warning

屏幕截图

更多截图

贡献指南

我们欢迎贡献,并感谢您在改进本项目方面提供的支持。如果您希望参与贡献,请遵循我们的贡献指南开始。

支持

如果您喜欢这张卡片,请考虑支持开发者

Buy Me A Coffee


2024 越玉

https://github.com/ngocjohn/

(返回顶部)