Overscan 概念
Overscan(过扫描)是一种独特的调整画面显示效果的方法,常见于老式电视机。它是通过裁剪画面外边缘的方式,将所需显示的内容填满整个电视屏幕,以达到全屏显示的要求。
Android 的 Overscan
如今的电视大多是基于 Android 系统的智能电视,因此 Google 也提供了与 Overscan 相关的 API,让开发者可以通过 Overscan 值的设置,使得所开发的应用在不同的电视上都能以最佳的显示效果呈现给用户。
Android 可通过 wm 工具中的 wm overscan [reset|LEFT,TOP,RIGHT,BOTTOM]
命令设置用于显示的 Overscan 区域,例如执行 wm overscan 50,50,50,50
命令后,会将显示界面往里缩小 50
像素;若将 50
改为 -50
,则显示界面会往外扩大 50
像素。
Tasker 实现 wm overscan 命令的原理
通过反射的方式调用 wm 工具中的 setOverscan
方法
Tasker 项目说明
Overscan
- 任务
-
*setOverscan
主任务,用于设置 Overscan 参数 1: 显示边缘距离屏幕边缘的左侧、上侧、右侧、下侧的 4 个参数, 它们之间必须以英文逗号进行分隔,如 0,0,0,-100
-
*$setOverscan@1
通过授予 WRITE_SECURE_SETTINGS 权限的方式设置 Overscan 参数 1: 同任务 *setOverscan 返回: 若设置成功,返回 true 若设置不成功,则显示错误信息,且不返回任何值
-
*$setOverscan@2
通过 Root 的方式设置 Overscan 参数 1: 同任务 *setOverscan 返回: 同任务 *$setOverscan@1
-
setOverscanSettingMode
设置当前可用的 Overscan 设置方式 有以下 2 种方式 方式 1:WRITE_SECURE_SETTINGS 权限 方式 2:Root 若这 2 种方式都可用,则优先使用方式 1, 若想改用方式 2,可手动将全局变量 %OVERSCAN_SETTING_MODE 设置为 2 若任一方式都不可用,将显示错误信息
-
$getOverscan
获取当前 Overscan 值 返回: 当前 Overscan 值,如 0,0,0,-100
- 全局变量
-
%OVERSCAN_SETTING_MODE
任务 *setOverscan 会根据该值调用设置 Overscan 的方式 1: WRITE_SECURE_SETTINGS 权限 2: Root 若没有值,则表示当前没有可用的 Overscan 设置方式
OverscanDemo
Overscan 的使用例子,仅供参考
- 任务
-
demo@Shrink Overscan
缩小 Overscan 区域的例子
-
demo@Expand Overscan
扩大 Overscan 区域的例子
-
demo@Reset Overscan
重置 Overscan 区域的例子
使用方法
注:对于 No Root 的设备,其所安装的 Tasker 必须为 5.2 及以上版本,并使用 ADB 命令授予 WRITE_SECURE_SETTINGS
权限
- 下载并导入所需的 Tasker 项目(Project)
- 通过
执行任务(Perform Task)
动作运行*setOverscan
任务(所传入的参数 1 为要设置的 Overscan 值)
下载
注:需导入以下所有带星号的项目(非星号项目可按需导入)
参考资料
更新日志
- 1/23/2019
- 发布
原创内容,转载请注明出处