QSL4A(Android 脚本层)API 文档¶
QSL4A 是 QPython 的 Android 脚本层,允许您使用 Python 控制 Android 设备功能。
快速开始¶
import androidhelper
droid = androidhelper.Android()
# 显示 toast 消息
droid.makeToast('Hello QPython!')
# 震动设备
droid.vibrate(500)
# 获取电池电量(先开始监控)
import time
droid.batteryStartMonitoring()
time.sleep(0.5) # 等待数据
battery = droid.readBatteryData().result
print(f"电池:{battery['level']}%")
文档结构¶
核心模块¶
- Android 基础 - 核心连接和 RPC
- Intent 系统 - Android Intent 操作
- 事件系统 - 事件处理和广播
UI 组件¶
系统¶
- 电池 - 电池监控
- 传感器 - 设备传感器
- 应用 - 应用管理
- 系统信息 - 设备信息
- 设置 - 系统设置
- 唤醒锁 - 唤醒锁控制
- QPython 接口 - 脚本执行
- Activity 结果 - Activity 结果处理
硬件¶
连接¶
存储¶
- DocumentFile - 文件操作
- 剪贴板 - 剪贴板操作
- 偏好设置 - 共享偏好设置
媒体¶
特殊功能¶
结果对象¶
大多数 QSL4A 方法返回一个带有以下属性的 Result 命名元组:
- id - 请求 ID
- result - 实际结果数据
- error - 如果失败则为错误消息