# homebridge-ir-patio-heater 中文文档

规范地址：https://npmcn.com/package/homebridge-ir-patio-heater/

版本：1\.1\.4
npm 元数据更新时间：2026-11-03T19:43:04.126Z
中文译文更新时间：2026-11-03T20:48:46.727Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/homebridge-ir-patio-heater
原文对照：https://npmcn.com/package/homebridge-ir-patio-heater/?lang=original
项目主页：https://github.com/zmanuel1234/homebridge-ir-patio-heater#readme
源码仓库：https://github.com/zmanuel1234/homebridge-ir-patio-heater

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：40.9 kB，8 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：^18\.20\.0 \|\| ^20\.15\.0 \|\| ^22\.0\.0 \|\| ^24\.0\.0
- 运行依赖：0 个
- 首次发布：2026-11-03T04:47:50.624Z
- 最新版本发布：2026-11-03T19:43:03.978Z
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

在HomeKit中，只有远程遥控的露台加热器，通过Tuya IR发射器驱动：一个开/关瓷砖，一个功率水平滑块和一个不同步按钮。

## 安装

```sh
npm install homebridge-ir-patio-heater
```

也可以使用：`pnpm add homebridge-ir-patio-heater`、`yarn add homebridge-ir-patio-heater`、`bun add homebridge-ir-patio-heater`

## README

# homebridge-ir-patio-heater

[![npm](https://badgen.net/npm/v/homebridge-ir-patio-heater)](https://www.npmjs.com/package/homebridge-ir-patio-heater) [![license](https://badgen.net/github/license/zmanuel1234/homebridge-ir-patio-heater)](https://npmcn.com/package/homebridge-ir-patio-heater/LICENSE)

显示只有远程庭院加热器，通过Tuya红外爆炸控制，作为三个HomeKit 每个加热器的瓦片：

-   **加热器** （开关）：打开加热器的唯一开关。On =电源，等待，最后一层。 关=电源。
-   **水平** （风扇滑块，500w / 1000w / 1500w）：加热时改变电平。或 滑块到零与加热器关闭相同。它从来没有打开加热器：选择一个水平 当我离开的时候，我只记得下一次。
-   **不同步** （按钮）：不发送任何东西而翻转HomeKit显示的（On↔Off）。

重命名磁贴 `levelName` / `syncName`，或隐藏“不同步” `showSyncButton: false`。

## 需求

-   Homebridge 1.6或更高版本(包括2。Node.js 18.20或更高版本。
-   一个Tuya（智能生活）通用红外发射器，加热器的远程学习或添加在应用程序中。
-   一个图雅物联网平台云项目链接到您的应用程序帐户，与 **物联网的核心** 和 **IR控制中心开放服务** 授权。如果你已经使用了Tuya Homebridge插件， 重用它的项目。

## 安装

搜索 **IR天井加热器** 在Homebridge UI的Plugins选项卡中，或者运行：

```sh
npm install -g homebridge-ir-patio-heater
```

## 配置

在Homebridge UI中配置它，或者添加一个平台到 `config.json`：

```json
{
  "platform": "PatioHeater",
  "name": "Patio Heaters",
  "accessId": "<Access ID of your Tuya cloud project>",
  "accessKey": "<Access Secret>",
  "endpoint": "https://openapi.tuyaus.com",
  "heaters": [
    {
      "name": "Left Heater",
      "blasterId": "<IR blaster device ID>",
      "remoteId": "<IR remote device ID>",
      "powerKey": "power",
      "levelKeys": ["500W", "1000W", "1500W"]
    }
  ]
}
```

-   **blasterId / remoteId**：在途雅物联网平台，云→你的项目→设备。这个 你在爆炸装置下添加的遥控器是一个独立的设备。Tuya应用程序也会显示这两种情况 在“设备”下→设备信息→虚拟ID。
-   **powerKey / levelKeys**： Tuya app中遥控器显示的按钮名称 (不区分大小写匹配)。如果一个名称不匹配，日志将列出可用的名称。
-   **端点**：应用程序账户的数据中心（美洲、欧洲、印度或中国）。

每个其他选项都有一个合理的默认值，并在设置屏幕和下面解释。

## 加热器是如何驱动的

这些加热器有三种实际状态： **从**， **备用** （通电，不加热）和 **加热** 在某种程度上。遥控器的电源键在开与关之间切换；水平仪按钮 启动或改变加热，但仅当加热器有电源时。

| HomeKit显示 | 你做 | 红外按 |
| --- | --- | --- |
| 从 | 加热器上 | 电源→等待 `keyDelayMs` →等级×2 |
| 在 | 移动水平滑块 | 水平×2 |
| 在 | 加热器关闭，调平，或滑块到0 | 权力 |
| 从 | 移动水平滑块 | 关卡×2（记得下一关） |
| 从 | 任何关闭，或水平打开 | 没有什么 |

水平压力机发送两次(`levelRepeat`，默认为2)，因为加热器忽略了重复的 级别，因此错过的IR新闻获得了第二次机会。权力是一种切换，永远只发送一次。 如果加热器醒得慢或者离它的爆能器很远，提高它的 `keyDelayMs` (例如:2500)。

同时到达的请求（Home应用经常同时发送多个级别的请求）被合并 变成一个序列。如果按下失败，HomeKit将回滚到实际发生的情况。

## 恢复同步

IR是单向的，Power是一个开关，所以HomeKit只有被颠倒了才会出错。 看看加热器，然后：

| 加热器瓷砖显示 | 加热器本身 | 做。 |
| --- | --- | --- |
| 在 | 黑暗，没有光 | 利用 **不同步** →瓷砖展示 |
| 从 | 光在 | 利用 **不同步** →瓷砖显示打开，然后正常关闭，如果你想 |
| 在 | 灯亮着，不加热 | 移动 **水平** 滑块（没有按水平键） |

不要通过切换加热器瓷砖来修复它：每次点击都会发送另一个能量，所以它保持倒置。

出于同样的原因， `autoOffMinutes` 只有智能插头才能工作，你不应该添加 “当所有人都离开时关闭”，没有一个的自动化。

## 选配智能插头（建议无人值守使用）

集 `plugId` 连接到Tuya智能插头（室外，15a）。然后 **关掉插头**，这总是 正确，因为加热器在断电后不记得自己的状态。 **在** 接通电源； 等待 `plugPowerUpDelayMs`， Power, level。插头是轮询的，所以在任何地方都要关掉它 暖气关了。有了插头，自动关闭和离开自动化是安全的。

## 为什么请求不重试

由于网络错误，重新读取图雅。按下一个键不是一个计时的请求 可能还能到达爆炸装置，第二个电源按钮会打开加热器 回来。在日志中报告一次失败的按压，并且HomeKit回滚到已知的状态 已经发生了。

## 响应时间

每条日志线显示时间的去向，例如： `On at 1500W (power 640ms, 1500W 590ms; total 2410ms after HomeKit request)`。 预印时间是图雅的云接受命令；然后爆炸装置发射红外线， 通常在一秒钟之内。开启还包括 `keyDelayMs` （默认1000）之间的功率 加热器需要唤醒的温度。插件本身只添加 `debounceMs` （默认150）来组合上+级请求，并在后台更新其Tuya令牌。

## 平顶火山帐户

使用带有项目级令牌的Tuya云项目的访问ID /访问秘密。 它永远不会登录你的应用程序帐户，所以它可以与Tuya Homebridge共享一个项目 插件，而不注销该插件。云项目需要 **IR控制中心开放服务** API授权（图雅） 插件已经使用它为您的遥控器)。

## 常见问题

### homebridge-ir-patio-heater 是什么？

在HomeKit中，只有远程遥控的露台加热器，通过Tuya IR发射器驱动：一个开/关瓷砖，一个功率水平滑块和一个不同步按钮。

### 如何安装 homebridge-ir-patio-heater？

在项目目录运行 npm install homebridge-ir-patio-heater，或使用 pnpm add / yarn add / bun add。

### homebridge-ir-patio-heater 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/homebridge-ir-patio-heater 是否存在。

### homebridge-ir-patio-heater 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### homebridge-ir-patio-heater 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^18\.20\.0 \|\| ^20\.15\.0 \|\| ^22\.0\.0 \|\| ^24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### homebridge-ir-patio-heater 可以商用吗？

homebridge-ir-patio-heater 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### homebridge-ir-patio-heater 还在维护吗？

最新版本 1\.1\.4 发布于 2026/11/04（今天）；至今共发布 6 个版本，其中过去 12 个月发布了 6 个；首次发布于 2026/11/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。