Termux:API

Termux:API是一款功能强大的附加组件，它能把Termux终端模拟器的功能拓展至安卓系统本身。通俗来讲，Termux:API就如同连接安卓手机与Termux丰富软件生态的“粘合剂”。它让你可以借助命令行直接和手机互动，能够将那些重复且耗时的任务自动化，进而大幅提升效率。

借助 Termux:API 工具，你能够通过脚本对手机的多项功能进行操控。比如，你可以通过命令行推送通知、获取 GPS 定位信息、扫描二维码、读取剪贴板内容，还能控制手电筒的开关以及振动器的工作状态。尤为重要的是，你可以灵活组合运用这些命令，来定制安卓设备的各类高级功能，这极大地拓展了 Termux 的适用场景。此外，Termux:API 无需获取 root 权限，它借助安卓系统本身提供的标准公共 API 与权限机制，使得非 root 用户也能访问并控制设备的多种功能，有需求的用户可在本站免费使用该工具。

功能特色

1、连接手机硬件与命令行：

它让你的终端脚本能够直接访问和控制安卓设备的硬件功能，如摄像头、GPS 和手电筒等。

2、实现系统自动化：

它允许你通过命令行执行通常需要手动操作的任务，例如发送通知、读写剪贴板或获取电池信息，从而实现任务自动化。

3、整合虚拟环境与主机：

它在Termux里运行的Linux或其他虚拟环境和你的安卓手机系统之间扮演了桥梁的角色，使得虚拟机中的程序也可以和手机开展交互。

Termux:API命令大全

1、获取电池状态：

使用 `termux-battery-status` 命令可以获取设备的电池电量、充电状态和温度等详细信息。

2、控制屏幕亮度：

`termux-brightness` 允许你通过命令行设置屏幕亮度，范围从 0 到 255。

3、读写剪贴板：

借助 `termux-clipboard-get` 与 `termux-clipboard-set` 这两个工具，你能够在终端脚本里轻松实现对系统剪贴板内容的获取或设置操作。

4、显示系统通知：

`termux-notification` 可以在 Android 系统的通知栏显示自定义通知，支持标题、内容、图标等。

5、获取设备位置：

通过 `termux-location` 命令，可以获取设备的 GPS 或网络定位信息。

6、控制手电筒和振动：

`termux-torch` 和 `termux-vibrate` 提供了通过命令行控制设备手电筒开关和振动器的功能。

7、发送短信：

`termux-sms-send` 允许你通过命令行向指定号码发送短信，这对于自动化任务非常有用。

8、访问联系人列表：

`termux-contact-list` 可以列出设备上的所有联系人信息。

9、拍照和访问摄像头：

`termux-camera-photo` 可以让你通过命令行拍摄照片并保存到指定文件。

10、显示对话框：

`termux-dialog` 系列命令能够生成各类弹出式对话框，像文本输入框、确认框以及列表选择框等，以此在脚本里实现与用户的交互。

Termux:API使用教程

1、前期准备与安装

在使用 Termux:API 之前，你需要安装终端：

Termux：这是你的终端模拟器，本站可

2、核心软件包安装

打开Termux后，输入下述命令安装Termux:API的核心软件包，该软件包涵盖了所有可用于操控Android功能的命令行工具。

pkg install termux-api

3、授予必要的权限

这是最关键的一步。Termux:API 必须获得相应的Android权限才能工作。你可以通过以下命令来授权：

存储权限：这是最基础的权限，用于访问设备的内部和外部存储。运行此命令后，系统会弹出权限请求，你必须手动允许。

termux-setup-storage

关于其他特定权限：比如定位、摄像头这类功能，你可以手动前往“系统设置”→“应用”→“Termux:API”→“权限”页面进行授予。另外，在你首次执行相关命令时，系统也会弹出权限请求提示。

4、第一个实用范例：发送通知

从一个简单的例子开始，使用 `termux-notification` 命令发送一条通知。

termux-notification --title "Hello Termux:API" --content "这是我的第一个通知，来自命令行！"

这条命令会立即在你的通知栏显示一条新的通知，标题为“Hello Termux:API”，内容为你所设置的文字。

更新日志

v0.53.0版本

修复了BatteryStatusAPI里把null Integer转为batteryCurrentNow int时引发的NullPointerException问题，同时避免输出null值。