Skip to main content

设备信息

from ascript.android.system import Device

方法​

设备ID​

获取设备的唯一ID

  • 函数
Device.id()
  • 示例
# 获取设备ID
from ascript.android.system import Device
device_id = Device.id()
print(device_id)

设备名称​

获取手机名称

  • 函数
Device.name()
  • 示例
# 获取设备名称
from ascript.android.system import Device
device_name = Device.name()
print(device_name)

屏幕信息​

获取手机设备的屏幕分辨率与屏幕密度

  • 函数
Device.display()
  • 返回值
DisplayMetrics属性备注
heightPixels屏幕高度
widthPixels屏幕宽度
density屏幕密度
rotation屏幕旋转角度
  • 示例
# 获取屏幕信息
from ascript.android.system import Device
display = Device.display()
# 屏幕宽度
print(display.widthPixels)
# 屏幕高度
print(display.heightPixels)
# 屏幕密度
print(display.density)

获取状态栏高度​

获取手机状态栏高度

  • 函数
Device.status_bar_height()
  • 返回值

高度树值

  • 示例
# 获取屏幕信息
from ascript.android.system import Device
height = Device.status_bar_height()
print(height)

设备品牌​

获取设备品牌名称

  • 函数
Device.brand()
  • 示例
# 获取设备品牌
from ascript.android.system import Device
device_brand = Device.brand()
print(device_brand)

设备型号​

获取设备型号

  • 函数
Device.model()
  • 示例
# 获取设备型号
from ascript.android.system import Device
device_model = Device.model()
print(device_model)

设备SDK版本​

获取SDK版本

  • 函数
Device.sdk()
  • 示例
# 设备SDK版本
from ascript.android.system import Device
device_sdk = Device.sdk()
print(device_sdk)

设备Android版本​

设备Android版本

  • 函数
Device.version()
  • 示例
# 设备Android版本
from ascript.android.system import Device
device_version = Device.version()
print(device_version)

设备本地IP地址​

设备本地IP地址

  • 函数
Device.ip()
  • 示例
# 设备本地IP地址
from ascript.android.system import Device
device_ip = Device.ip()
print(device_ip)

设备运行信息​

获取当前设备运行的APP信息

  • 函数
Device.current_appinfo()
  • 返回值
DeviceInfo属性备注
name当前运行的APP名称
packageName当前运行APP的包名称
activity当前运行APP的Activity
  • 示例
# 获取当前设备运行的APP信息
from ascript.android.system import Device
device_info = Device.current_appinfo()
print(device_info.name)
print(device_info.packageName)
print(device_info.activity)

已安装程序列表​

获取所有已安装APP的信息

  • 函数
Device.apps()
  • 返回值

AppBean[]

AppBean属性备注
appName当前运行的APP名称
appSizeapp 大小
isSd()是否在SD卡中
isSystem()是否为系统应用
appPackageNameapp包名
apkPath安装路径
version版本号
versionName版本名称
  • 示例
#获取所有已安装APP的信息
from ascript.android.system import Device
apps = Device.apps()
print(len(apps)) #共安装了多个APP
for app in apps:
    print(app.appName) # app名称
    print(app.appSize) # app大小
    print(app.isSd()) # 是否在sd卡
    print(app.isSystem()) # 是否为系统应用
    print(app.appPackageName) # app包名
    print(app.apkPath) # app 安装地址
    print(app.version) # app 版本号
    print(app.versionName) # app 版本名称

电池电量​

获取当前电池电量数

  • 函数
Device.battery()
  • 返回值

int类型 电池电量 1-100 之间

  • 示例
# 获取当前设备运行的APP信息
from ascript.android.system import Device
num = Device.battery()
print(num)

应用内存​

获取当前APP内存信息

  • 函数
Device.memory()
  • 返回值

list 数组,其中包含3个元素 剩余内存,已用内存,总共内存 ,单位字节

  • 示例
# 获取当前设备运行的APP信息
from ascript.android.system import Device
info = Device.memory()
# 返回单位是字节
print(f"剩余内存:{info[0]},已用内存{info[1]},总共内存{info[2]}")

本机手机号​

获取当前设备的手机号码

使用前，请先授权 辅助权限> 手机号读取权限
  • 函数
Device.phone_numbers()
  • 返回值

list 数组，所有本机手机号的列表

  • 示例
# 获取当前手机的手机号码
from ascript.android.system import Device
nums = Device.phone_numbers()
# 所有本机手机卡号的列表
print(nums)

是否充电中​

判断设备是否正在充电(包括充满状态)

  • 函数
Device.is_charging()
  • 返回值

bool类型, True:充电中, False:未充电

  • 示例
from ascript.android.system import Device
if Device.is_charging():
    print("正在充电")
else:
    print("未充电")

屏幕是否亮着​

判断设备屏幕是否处于亮屏状态

  • 函数
Device.is_screen_on()
  • 返回值

bool类型, True:屏幕亮着, False:屏幕熄灭

  • 示例
from ascript.android.system import Device
if not Device.is_screen_on():
    print("屏幕已熄灭,准备唤醒...")
    Device.wake_up()

唤醒屏幕​

点亮设备屏幕

  • 函数
Device.wake_up()
  • 示例
# 如果屏幕灭了,唤醒屏幕
from ascript.android.system import Device
if not Device.is_screen_on():
    Device.wake_up()
    print("屏幕已唤醒")

保持屏幕常亮​

防止屏幕自动熄灭. 调用后屏幕将一直保持亮着,直到调用 keep_screen_off() 取消.

  • 函数
Device.keep_screen_on()
  • 示例
from ascript.android.system import Device
import time

# 保持屏幕常亮
Device.keep_screen_on()

# 执行你的任务...
time.sleep(60)

# 任务完成,取消常亮
Device.keep_screen_off()

取消屏幕常亮​

取消 keep_screen_on() 设置的屏幕常亮

  • 函数
Device.keep_screen_off()
  • 示例
from ascript.android.system import Device
Device.keep_screen_off()

处理器架构​

获取设备的CPU架构(如 arm64-v8a, armeabi-v7a, x86_64 等)

  • 函数
Device.abi()
  • 返回值

str类型, 设备首选的CPU架构名称

  • 示例
from ascript.android.system import Device
print("CPU架构:", Device.abi())

如需获取所有支持的架构列表:

from ascript.android.system import Device
print("支持的架构:", Device.abis())
# 例如: ['arm64-v8a', 'armeabi-v7a', 'armeabi']