Termux:API

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值。