asyncio HomeKit客户端

导航

已验证详情

这些详情已经由PyPI 验证
维护者

未验证详情

这些详情尚未由PyPI验证
项目链接
元数据
类别

项目描述

aiohomekit

CI codecov

此库实现了使用asyncio控制Homekit配件的HomeKit协议。

它主要用于与Home Assistant一起使用。我们针对与他们相同的python版本，并尝试遵循他们的代码标准。

目前我们不提供任何API保证。API稳定性和文档将在我们对Home Assistant内部工作情况满意后发生。

贡献

请注意，一些物流设备对HAP规范的解释较为宽松。一般来说，我们更喜欢匹配真实HAP控制器的行为，即使它们的行为没有严格规定。以下是我们不得不解决的某些问题的类型

  • 尽管JSON的精确格式在规范中未指定，但野外有一些设备无法在解析JSON时处理空格。例如，{"foo": "bar"}与{"foo":"bar"}。这意味着我们从不使用“漂亮”的JSON编码。
  • 尽管规范中明确将布尔值定义为0、1、true或false，但一些设备只支持这四种中的三种。这意味着布尔值必须编码为0或1。
  • 一些设备表明它们对缺少标题、标题顺序错误或存在额外标题非常敏感。因此，我们确保只有iOS发送的标题存在，并且大小写和顺序相同。
  • 一些设备对HTTP消息被分割成单独的TCP数据包非常敏感。因此，我们注意只将完整消息写入网络堆栈。

等等。一般来说，我们需要对发送的内容严格，对接收的内容宽松。

设备兼容性

aiohomekit主要通过Home Assistant与飞利浦Hue桥和Eve Extend桥进行测试。它在与许多其他设备的一些程度上已知可以工作，但这些目前尚未在任何地方明确记录。

您可以在home-assistant的问题列表中查看您的设备遇到的问题。

常见问题解答

我该如何使用它？

它作为aiohomekit发布在pypi上，但仍在早期开发阶段 - 请谨慎行事。

API的主要消费者是Home Assistant中的homekit_controller，因此这是了解API的最佳地方。

这个支持BLE配件吗？

不。我们最终希望通过aioble来实现，它提供了一个在Linux、macOS和Windows上工作的异步蓝牙抽象。

我可以用这个来制作HomeKit配件吗？

不，这只是一个客户端部分。您应该使用其他实现之一

为什么Home Assistant不使用库X而不是？

在编写本文时，这是唯一的Python 3.7/3.8异步HAP客户端，具有事件支持。

为什么aiohomekit不使用库X而不是？

尽可能，aiohomekit使用易于通过pip安装的库，作为轮子提供（包括通过piwheels在Raspberry Pi上），跨平台（包括Windows），并且已经被Home Assistant使用。它们不应该引入对不常见的系统库的硬依赖。这里的意图是避免在Home Assistant构建过程中的任何困难。

人们经常对手动编写的HTTP代码感到惊讶，并建议使用现有的HTTP库，如aiohttp。高级HTTP库几乎无法启动，因为

  • 在不进行猴子补丁的情况下添加HAP会话安全比较困难。
  • 它们不期望没有请求就有响应（即事件）。
  • 如上所述，一些设备非常敏感。我们不关心您的更改是否符合每个规范，只要它仍然使真实世界的设备崩溃。我们没有能力要求这些设备被修复。因此，我们努力在写入路径上实现字节数据的精确匹配。任何库都需要给我们这种灵活性。
  • 响应的部分实际上不是HTTP，尽管它们看起来像。

我们也不愿意对正在大量设备上运行的东西进行如此大的改动。有很大的可能引入回归问题。

当然，一个经过测试的工作原型（使用流行的、维护良好的库）将会很有趣，这些测试包括像Tado互联网桥（包括事件）这样的东西。

谢谢

没有homekit_python，这个库就不可能实现，它是HAP客户端和服务器部分的同步实现。

项目详情

已验证详情

这些详情已经由PyPI 验证
维护者

未验证详情

这些详情尚未由PyPI验证
项目链接
元数据
类别

发布历史 发布通知 | RSS订阅

本版本

3.2.3

3.2.2

3.2.1

3.2.0

3.1.5

3.1.4

3.1.3

3.1.2

3.1.1

3.1.0

3.0.9

3.0.8

3.0.7

3.0.6

3.0.5

3.0.4

3.0.3

3.0.2

3.0.1

3.0.0

2.6.16

2.6.15

2.6.14

2.6.13

2.6.12

2.6.11

2.6.10

2.6.9

2.6.8

2.6.7

2.6.6

2.6.5

2.6.4

2.6.3

2.6.2

2.6.1

2.6.0

2.5.0

2.4.6

2.4.5

2.4.4

2.4.3

2.4.2

2.4.1

2.4.0

2.3.6

2.3.5

2.3.4

2.3.3

2.3.2

2.3.1

2.3.0

2.2.19

2.2.18

2.2.17

2.2.16

2.2.15

2.2.14

2.2.13

2.2.12

2.2.11

2.2.10

2.2.9

2.2.8

2.2.7

2.2.6

2.2.5

2.2.4

2.2.3

2.2.2

2.2.1

2.2.0

2.1.1

2.1.0

2.0.2

2.0.1

2.0.0

1.5.12

1.5.11

1.5.10

1.5.9

1.5.8

1.5.7

1.5.6

1.5.5

1.5.4

1.5.3

1.5.2

1.5.1

1.5.0

1.4.0

1.3.0

1.2.11

1.2.10

1.2.9

1.2.8

1.2.7

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.10

1.1.9

1.1.8

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.0

1.0.0rc2 预发布

1.0.0rc1 预发布

0.7.22

0.7.21

0.7.20

0.7.19

0.7.18

0.7.17

0.7.16

0.7.15

0.7.14

0.7.13

0.7.12

0.7.11

0.7.10

0.7.9

0.7.8

0.7.7

0.7.6

0.7.5

0.7.4

0.7.3

0.7.2

0.7.1

0.7.0

0.6.11

0.6.10

0.6.9

0.6.8

0.6.7

0.6.6

0.6.5

0.6.4

0.6.3

0.6.2

0.6.1

0.6.0

0.5.1

0.5.0

0.4.3

0.4.2

0.4.1

0.4.0

0.3.0

0.2.67

0.2.66

0.2.65

0.2.64

0.2.63

0.2.62

0.2.61

0.2.60

0.2.59

0.2.57

0.2.56

0.2.55

0.2.54

0.2.53

0.2.52

0.2.51

0.2.50

0.2.49

0.2.48 已撤销

撤销此版本的原因

损坏

0.2.47

0.2.46

0.2.45

0.2.44

0.2.43

0.2.41

0.2.40

0.2.39

0.2.38

0.2.37

0.2.36

0.2.35

0.2.34

0.2.33

0.2.31

0.2.30

0.2.29.2

0.2.29.1

0.2.29

0.2.28

0.2.27

0.2.26

0.2.25

0.2.24

0.2.23

0.2.22

0.2.21

0.2.20

0.2.19

0.2.18

0.2.17

0.2.16

0.2.15

0.2.14

0.2.12

0.2.11

0.2.10

0.2.9

0.2.8

0.2.7

0.2.6

0.2.5

0.2.3

下载文件

下载您平台对应的文件。如果您不确定该选择哪个，请了解有关 安装包 的更多信息。

源代码分发

aiohomekit-3.2.3.tar.gz (122.0 kB 查看哈希值)

上传时间 源代码

构建分发

aiohomekit-3.2.3-py3-none-any.whl (163.1 kB 查看哈希值)

上传时间 Python 3

由以下支持