设置 API¶
控制系统设置，包括屏幕、声音和网络设置。
屏幕设置¶
setScreenTimeout()¶
设置屏幕超时值。
参数：
- value (int): 屏幕超时时间（秒）
返回： 之前的超时值
getScreenTimeout()¶
获取当前屏幕超时。
返回： 当前屏幕超时时间（秒）
getScreenBrightness()¶
获取屏幕亮度值。
返回： 亮度值（0-255）
setScreenBrightness()¶
设置屏幕亮度。
参数：
- value (int, optional): 亮度值（0-255），或 None 表示自动
返回： 之前的亮度值
checkScreenOn()¶
检查屏幕是否亮着。
返回： 如果屏幕亮着则为 True，否则为 False
飞行模式¶
checkAirplaneMode()¶
检查飞行模式是否启用。
返回： 如果飞行模式开着则为 True
铃声设置¶
checkRingerSilentMode()¶
检查铃声是否处于静音模式。
返回： 如果静音模式开着则为 True
toggleRingerSilentMode()¶
切换铃声静音模式。
参数：
- enabled (bool, optional): True 启用，False 禁用，None 切换
返回： 新状态
toggleVibrateMode()¶
切换振动模式。
参数：
- enabled (bool, optional): 切换振动开/关
- ringer (bool, optional): 应用于铃声模式
返回： 新状态
getVibrateMode()¶
获取振动模式设置。
参数：
- ringer (bool, optional): 检查铃声振动模式
返回： 如果振动已启用则为 True
音量设置¶
getRingerVolume()¶
获取当前铃声音量。
返回： 铃声音量级别（通常为 0-7）
getMaxRingerVolume()¶
获取最大铃声音量。
返回： 最大铃声音量
setRingerVolume()¶
设置铃声音量。
参数：
- volume (int): 音量级别
getMediaVolume()¶
获取当前媒体音量。
返回： 媒体音量级别（通常为 0-15）
getMaxMediaVolume()¶
获取最大媒体音量。
返回： 最大媒体音量
setMediaVolume()¶
设置媒体音量。
参数：
- volume (int): 音量级别
系统信息¶
elapsedRealtimeNanos()¶
获取自系统启动以来的纳秒数。
返回： 纳秒数（可用于计时）
getTrafficStats()¶
获取网络流量统计。
参数：
- flags (int): 要检索的统计（默认：7 = 全部）
返回： 包含发送/接收字节的字典
getAppTxBytes()¶
获取 QPython 应用的发送字节。
参数：
- packageName (str): 包名
返回： 包含 tx/rx 字节的字典
使用示例¶
import androidhelper
droid = androidhelper.Android()
# 屏幕设置
current_timeout = droid.getScreenTimeout().result
print(f"Current timeout: {current_timeout}s")
droid.setScreenTimeout(30)
# 检查屏幕
if droid.checkScreenOn().result:
print("Screen is on")
# 音量控制
media_vol = droid.getMediaVolume().result
print(f"Media volume: {media_vol}")
droid.setMediaVolume(10)
# 检查飞行模式
if droid.checkAirplaneMode().result:
print("Airplane mode is on")