通过 Tasker 实现「wm overscan」命令 [No

Overscan 概念

Overscan（过扫描）是一种独特的调整画面显示效果的方法，常见于老式电视机。它是通过裁剪画面外边缘的方式，将所需显示的内容填满整个电视屏幕，以达到全屏显示的要求。

Android 的 Overscan

如今的电视大多是基于 Android 系统的智能电视，因此 Google 也提供了与 Overscan 相关的 API，让开发者可以通过 Overscan 值的设置，使得所开发的应用在不同的电视上都能以最佳的显示效果呈现给用户。

界面布局，来源：http://blog.csdn.net/longyc2010/article/details/41599209

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 权限

1. 下载并导入所需的 Tasker 项目（Project）
2. 通过 执行任务（Perform Task） 动作运行 *setOverscan 任务（所传入的参数 1 为要设置的 Overscan 值）

下载

注：需导入以下所有带星号的项目（非星号项目可按需导入）

• * Overscan (uri / xml)
• * Exception (uri / xml)
• OverscanDemo (uri / xml)

参考资料

1. Overscan - Wikipedia
2. Build layouts for TV | Android Developers
3. Kitkat小屏幕模式单手操作研究之wm命令的实现方式分析

更新日志

• 1/23/2019
  - 发布

其他

作者：sung
邮箱：sdfsung@gmail.com

原创内容，转载请注明出处