Plyer

Plyer 是一个跨平台的 Python API，用于访问各种平台（Android、iOS、macOS、Linux 和 Windows）的硬件功能。

Plyer 由 Kivy 团队管理。它适用于 Kivy 应用程序，但也可以独立使用。

Plyer 如何工作？

Plyer 尽量不重复造轮子，会根据当前平台调用外部库以最简单的方式实现 API。

• 在 Android (python-for-android) 上，使用 PyJNIus。
• 在 iOS (kivy-ios) 和 macOS 上，使用 pyobjus。
• 在 Windows、macOS 和 Linux 上，使用其他常见的库和程序。

支持的 API

平台	Android	iOS	Windows	macOS	Linux
加速度计	✔	✔		✔	✔
音频录制	✔		✔	✔
气压计	✔	✔
电池	✔	✔	✔	✔	✔
蓝牙	✔			✔
亮度	✔	✔			✔
通话	✔	✔
相机（拍照）	✔	✔
指南针	✔	✔
CPU 核心数			✔	✔	✔
设备名称	✔		✔	✔	✔
电子邮件（打开邮件客户端）	✔	✔	✔	✔	✔
闪光灯	✔	✔
GPS	✔	✔
重力	✔	✔
陀螺仪	✔	✔
湿度	✔
红外发射器	✔
密钥存储	✔	✔	✔	✔	✔
光线	✔
地图		✔		✔
本地文件选择器	✔	✔	✔	✔	✔
通知	✔		✔	✔	✔
方向	✔				✔
接近传感器	✔
截图			✔	✔	✔
短信（发送消息）	✔	✔		✔
空间方向	✔	✔
语音转文字	✔
存储路径	✔	✔	✔	✔	✔
温度	✔
文字转语音	✔	✔	✔	✔	✔
唯一标识符	✔	✔	✔	✔	✔
振动器	✔	✔
WiFi			✔	✔	✔

文档

完整文档，包括 API 详细信息，可在在线获取。如果您使用的不是最新版本的 Plyer，可以从那里链接到早期版本的文档。

安装

桌面端使用：pip install plyer 在 python-for-android 和 Kivy for iOS 中使用，如有需要，请将 plyer 添加到您的依赖项中。

许可证

Plyer 采用 MIT 许可证，由一个优秀的社区积极开发，并得到 Kivy 组织管理的许多项目的支持。

支持

您在使用 Plyer 或 Kivy 生态系统中的任何相关项目时遇到问题吗？ 有您不理解的错误吗？您是否在尝试弄清如何使用它？我们有志愿者可以帮助您！

联系我们寻求支持的最佳渠道列在最新的联系我们文档中。

贡献

Plyer 是 Kivy 生态系统的一部分 - 一个被成千上万的开发者免费使用的大型产品集合，但它完全由志愿者的贡献构建而成。我们欢迎（并依赖于）希望通过为项目做出贡献来回馈社区的用户。

贡献可以有多种形式。请查看最新的贡献指南，了解如何帮助我们。

行为准则

为了培养一个开放和友好的社区，作为贡献者和维护者，我们需要确保参与我们的项目和姐妹项目是一种无骚扰和积极的体验。至关重要的是，所有互动都应以尊重、开放和感恩的态度进行。

请查阅最新的行为准则。

贡献者

本项目的存在要感谢所有贡献者。 [成为贡献者]。

<img src="https://contrib.nn.ci/api?repo=kivy/plyer&pages=5&no_bot=true&radius=22&cols=18">

支持者

感谢我们所有的支持者！ 🙏 [成为支持者]

<img src="https://yellow-cdn.veclightyear.com/0a4dffa0/ba53af05-3a85-4d67-8371-74c92e665600.svg?width=890&avatarHeight=44&button=false">

赞助商

特别感谢我们过去和现在的所有赞助商。 通过[成为赞助商]来支持这个项目。

以下是我们目前的顶级赞助商。请点击查看他们的网站，并支持这些支持我们的赞助商。

<!--- 有关此代码的解释，请参见 https://github.com/orgs/kivy/discussions/15 -->

<a href="https://opencollective.com/kivy/sponsor/0/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/0581bce9-fe7c-450e-b754-2fad6721d87f.svg"></a> <a href="https://opencollective.com/kivy/sponsor/1/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/4c480545-e6c5-446b-9ac9-9223b49a993b.svg"></a> <a href="https://opencollective.com/kivy/sponsor/2/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/54802413-d9cc-4a97-87b1-7378ef9a28ef.svg"></a> <a href="https://opencollective.com/kivy/sponsor/3/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/4e850281-76dc-4b82-8866-aa5547395b78.svg"></a>

<a href="https://opencollective.com/kivy/sponsor/4/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/54956112-4a18-414e-8f36-816a1842037a.svg"></a> <a href="https://opencollective.com/kivy/sponsor/5/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/7f38075b-f8c2-4e1c-81cf-f7d97887d4d8.svg"></a> <a href="https://opencollective.com/kivy/sponsor/6/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/af631e60-f636-4574-96bf-3053449aa887.svg"></a> <a href="https://opencollective.com/kivy/sponsor/7/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/35183247-ad09-49b2-a92d-3bda6fb84a01.svg"></a>

<a href="https://opencollective.com/kivy/sponsor/8/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/14c2990c-08f0-4201-a2e2-a677ea78c5c8.svg"></a> <a href="https://opencollective.com/kivy/sponsor/9/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/fdfc7562-81de-4120-a5ce-95ab6dff98b2.svg"></a> <a href="https://opencollective.com/kivy/sponsor/10/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/85af6113-2604-4d55-a1a0-ab5453f515f5.svg"></a> <a href="https://opencollective.com/kivy/sponsor/11/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/be33253e-fe4a-4ca3-a804-a9cbc5d1bde2.svg"></a>

<a href="https://opencollective.com/kivy/sponsor/12/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/c7d2d359-4e80-40bb-b689-d236a3f180ce.svg"></a> <a href="https://opencollective.com/kivy/sponsor/13/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/6f899d0b-2938-461c-b5b5-8a20f6e02119.svg"></a> <a href="https://opencollective.com/kivy/sponsor/14/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/c729b16b-30f2-4f93-bf2d-cc9d20e99417.svg"></a> <a href="https://opencollective.com/kivy/sponsor/15/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/480ec67b-2c81-4aee-9e20-81e938c89a89.svg"></a>