AIGameAIGame
首页
API文档
UI框架
下载软件
首页
API文档
UI框架
下载软件
  • API文档

    • $global - 全局函数
    • $act - 手势动作
      • 01.手势动作 - $act
      • 02.节点选择器 - UiSelector
      • 03.节点 - Node
    • $ag - 图色框架
    • $app - 应用操作
    • $arc - 悬浮菜单按钮
      • 01.悬浮菜单 - $arc
      • 02.悬浮容器 - MenuBody
      • 03.菜单按钮 - MenuItem
    • $bus - 消息总线
    • $color - 颜色操作
    • $crypt - 加密算法
    • $date - 日期工具
    • $device - 设备信息
    • $ext - dex,jar,so文件加载
    • $draw - 全局绘制
    • $engine - 脚本引擎
      • 01.任务信息 - JsTaskInfo
      • 02.脚本对象 - $task
    • $fc - 文件选择器
    • $file - 文件操作
    • $floaty - 悬浮窗
      • 01.可调节悬浮窗 - AdjFloaty
      • 02.系统级悬浮窗 - SysFloaty
      • 03.应用级悬浮窗 - AppFloaty
    • $img - 图片操作
    • $log - 日志框架
    • $ocr - 文字识别
    • $permit - 权限工具
    • $qr - 二维码工具
    • $res - 资源管理器
    • $root - ROOT与Shell命令
    • $screen - 屏幕操作
    • $storage - 应用内存储
    • $str - 字符串工具类
    • $sys - 系统操作
    • $thread - 并发编程
    • $tip - 对话框
    • $tts - 文字阅读
    • $yolo - 目标检测
    • $yolox - 目标检测

$screen

  • 更新时间:2025-07-25 17:12:12

屏幕操作

getPermit()

获取截屏权限

  • 返回 : {boolean} 是否获取成功
  • 版本 : 1.0.0
//等待获取截屏权限
$screen.getPermit();

getPermitOnce()

获取截屏权限一次

hasPermit()

是否有截屏权限

  • 返回 : {boolean} 是否有截屏权限
  • 版本 : 1.1.5

getScreen()

获取屏幕截屏 此函数将优先使用无障碍截屏(安卓11+),否则将使用截屏权限来进行截屏。

  • 返回 : {Image} 截屏图片
  • 版本 : 1.0.0
//等待获取截屏权限
$screen.getPermit();
//如果不想用上面的方式,也可以使用 $act.getPermit(); //获取无障碍,也可以截屏(安卓11+以上才行)
let img = $screen.getScreen();//获得屏幕截屏
$img.show(img);//显示截屏

bright(bright)

设置屏幕亮度

  • 参数 : bright {int} 亮度值(0-255)
  • 版本 : 1.0.0
//设置屏幕亮度
$screen.bright(100);

dir(degree)

设置屏幕方向

  • 参数 : degree {string} 屏幕旋转度数
  • 版本 : 1.0.0
//设置屏幕方向
$screen.dir(0);//(强制)竖屏
$screen.dir(90);//(强制)右转横屏
$screen.dir(180);//(强制)倒置竖屏
$screen.dir(270);//(强制)左转横屏
$screen.dir(-1);//(不强制)自动旋转(任何其他数字都是自动旋转)
// 模拟器测试:
// 逍遥     安卓5  : 成功旋转屏幕 会闪退
// 逍遥     安卓7  : 成功旋转屏幕 会闪退
// 逍遥     安卓9  : 成功旋转屏幕 会闪退
// 逍遥     安卓12 : 完美!!!
// 雷电     安卓9  : 毫无反应
//真机测试:
// OPPO    安卓12 : 完美!!!

getHeight()

屏幕高

  • 返回 : {int} 屏幕高度
  • 版本 : 1.0.0
let w = $screen.getWidth();
let h = $screen.getHeight();
alert("屏幕宽高",w+"x"+h);

getWidth()

屏幕宽

  • 返回 : {int} 屏幕宽度
  • 版本 : 1.0.0
let w = $screen.getWidth();
let h = $screen.getHeight();
alert("屏幕宽高",w+"x"+h);

getScreenInfo()

屏幕信息

  • 返回 : {ScreenInfo} 屏幕宽高信息
  • 版本 : 1.0.0
let info = $screen.getScreenInfo();
alert("详细信息",info);

getDensity()

当前设备的密度

  • 返回 : {float} 密度因子
  • 版本 : 1.0.0
let density = $screen.getDensity();
alert("当前设备的密度",density);

isScreenOff()

判断屏幕是否息屏

  • 返回 : {boolean} 是否息屏
  • 版本 : 1.0.0
if($screen.isScreenOff()){
    toast("屏幕息屏");
}

isScreenOn()

判断屏幕是否亮屏

  • 返回 : {boolean} 是否亮屏
  • 版本 : 1.0.0
if($screen.isScreenOn()){
    toast("屏幕亮屏");
}

split(tranCut, vertCut, index)

屏幕分割后返回对应块的范围

  • 参数 : tranCut {int} 横向分割数量
  • 参数 : vertCut {int} 纵向分割数量
  • 参数 : index {int} 块的索引
  • 返回 : {Rect} 范围
  • 版本 : 1.1.2
$draw.closeAll();
//将屏幕分割成9份,找到最后一份的范围
let region = $screen.split(3, 3, 8);
//绘制出这个范围
$draw.rect(region);

save(path)

截屏并保存

  • 参数 : path {String} 保存路径
  • 版本 : 1.0.0
//截屏并且保存(支持相对路径写法)
let imgPath = "/sdcard/Pictures/截屏.png";
$screen.save(imgPath);

mustV()

强制竖屏截屏

  • 版本 : 1.1.8
$screen.mustV();//强制竖屏截屏

mustH()

强制横屏截屏

  • 版本 : 1.1.8
$screen.mustH();//强制横屏截屏

cancelMust()

取消强制横竖屏 默认情况下,$screen会根据当前屏幕状态自动检测截屏是横屏还是竖屏,所以一般情况下mustV、mustH、cancelMust这三个函数没必要调用。 之所以设计这三个函数,是为了更好的适配更多的设备,正常情况下手机的宽度都是小于高度的,但是也有那种宽度大于高度的情况,例如:平板设备,此时就可以使用强制横屏或竖屏来截屏了。

  • 版本 : 1.1.8
$screen.cancelMust();//取消强制横竖屏(默认是:自动检测)
最近更新: 2025/5/23 16:42
Contributors: 孑小白, Talent
Prev
$root - ROOT与Shell命令
Next
$storage - 应用内存储