Termux:API是一款功能强大的附加组件，它把Termux终端模拟器的能力拓展到了安卓系统自身。打个比方，Termux:API就如同连接安卓手机与Termux强大软件生态的“黏合剂”。它让你拥有通过命令行直接和手机互动的能力，能够让你把那些重复且耗时的任务自动化，进而大幅提升效率。

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

功能特色

连接手机硬件与命令行：

它能让你的终端脚本直接访问并操控安卓设备的硬件功能，像摄像头、GPS以及手电筒之类的都包含在内。

实现系统自动化：

它能让你借助命令行来完成那些原本得手动操作的任务，像发送通知、读写剪贴板或者获取电池信息之类的，进而达成任务自动化的目标。

整合虚拟环境与主机：

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

Termux:API命令大全

获取电池状态：

借助 `termux-battery-status` 命令，能够获取到设备电池的电量情况、充电状态以及温度等具体信息。

控制屏幕亮度：

`termux-brightness` 可让你借助命令行来调整屏幕亮度，其数值范围在 0 至 255 之间。

读写剪贴板：

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

显示系统通知：

`termux-notification` 能够在 Android 系统的通知栏里展示自定义通知，并且支持设置标题、内容、图标等元素。

获取设备位置：

借助 `termux-location` 命令，能够获取设备的 GPS 定位信息或者网络定位信息。

控制手电筒和振动：

`termux-torch` 与 `termux-vibrate` 这两个工具，能够让用户借助命令行来实现对设备手电筒开关状态以及振动器的控制。

发送短信：

`termux-sms-send` 能够让你借助命令行给指定号码发送短信，这在自动化任务中十分实用。

访问联系人列表：

`termux-contact-list` 能够显示设备上存储的全部联系人信息。

拍照和访问摄像头：

`termux-camera-photo` 能够让你借助命令行拍摄照片，并将其保存到你指定的文件中。

显示对话框：

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

Termux:API使用教程

前期准备与安装

在使用 Termux:API 之前，你得先安装终端。

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

核心软件包安装

打开Termux后，输入下列命令以安装Termux:API的核心软件包，该软件包囊括了所有可用于控制Android功能的命令行工具。

pkg install termux-api

授予必要的权限

这是至关重要的一步。Termux:API 需要获取对应的 Android 权限才能够正常运行。你可以借助以下命令来进行授权：

存储权限是最基础的权限，作用是访问设备的内部与外部存储。执行该命令后，系统会弹出权限请求窗口，需要你手动进行允许操作。

termux-setup-storage

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

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

我们可以从一个简单的例子入手，借助 `termux-notification` 命令来发送一条通知。

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

执行这条命令后，通知栏会马上弹出一条新通知，标题固定为“Hello Termux:API”，通知内容则是你之前自行设定的文字。

更新日志

v0.53.0版本

已修复BatteryStatusAPI中因将null Integer转换为batteryCurrentNow的int类型而引发的NullPointerException问题，同时避免了null值的输出。