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