Android TV Overscan
本文来自网易云社区
作者:孙有军
开发的TV应用发现在部分电视上可以显示完整,而其他部分电视显示不全,周围都会遮挡了。
原因
这是因为部分老的电视有一个overscan的概览,什么叫overscan呐?官方解释如下:
During the evolution of TV technology, overscan originally described an area of TV content outside of a safe zone that most TVs could reliably display. Even on some of today’s HDTV flat screens, areas outside that zone may not be visible.
整个展示的界面是外面整个矩形框,而可见区域是内部的矩形框,因此如果你布局的内容紧邻边界,就会导致部分电视不能完整显示整个内容。
解决方案
上面的问题,我们怎么解决呐?这里给出两种解决方案。
设置调整
虽然老的电视有overscan的概念,内容显示不全,但是电视可以设置他的显示内容距离电视边框的距离,这里主要依靠人为的手动设置,方式如下:
一般都是选择遥控板的设置,进入设置界面,选择显示,边距调整
经过上述方式的调整,可以设置内容与边框有一定的距离,这样可以让所有的内容都显示出来。
难点:该方式必须要用户手动调整,如果不调整则显示内容被遮挡体验效果比较差
UI调整
既然让大家都采用手动调整是比较困难的,那有没有从应用层面来解决该问题的方法,有,肯定有,官方的文档也给出了解决方案:
Build a 5% margin into your TV screen designs to account for overscan area the TV may not display correctly. On a 1920 x 1080 screen, this margin should be a minimum of 27 pixels from the top and bottom edges and a minimum of 48 pixels from the right and left edges of the picture.
上面的意思是,在设计界面的时候,就空出四周的overscan距离,以1920*1080为例上下27px,左右48px,让显示的内容完全处于安全区域,周围都是无关内容区域。
缺点:如果设计的内容需要靠近边界,比如说底部有一个导航条,可以显示与影藏,这种时候就需要贴近边界进行设计。如果再设计的时候空出一部分,那在overscan的电视上展示较好,无overscan的电视展示就比较差,如果不空,这效果相反
自适应?
既然上面的两种方案都是有缺点的
全部让用户手动设置不显示
空出部分内容,在有的时候会显示效果比较差
那有没有一种方法来解决上面面临的问题?能够根据电视状况自动缩放内容,在有overscan的电视上,拿到overscan的值,设置显示内容与边界为overscan的值,在没有overscan的电视上保持内容不调整。
方案探索
首先我们看代码,看看代码中是否有overscan的值,经过一番查找,在Android中有一个Display类,他包含了很多显示信息,其中有一个字段为DisplayInfo,DisplayInfo包含了其他的一些显示信息。其中有四个字段如下:
/** * Describes the characteristics of a particular logical display. * @hide */public final class DisplayInfo implements Parcelable { .... /** * @hide * Number of overscan pixels on the left side of the display. */ public int overscanLeft; /** * @hide * Number of overscan pixels on the top side of the display. */ public int overscanTop; /** * @hide * Number of overscan pixels on the right side of the display. */ public int overscanRight; /** * @hide * Number of overscan pixels on the bottom side of the display. */ public int overscanBottom; public DisplayInfo() { } .... }
这里我们省略了其他的代码,可以看到包含有overscanLeft, overscanTop,overscanRight,overscanBottom,这就是Overscan的值,到这里感觉有希望。既然有这四个值,那我们获取到这四个值再设置会界面应该就能达到我们想要的效果。
读取overscan
从上面的代码中我们可以看到DisplayInfo是被hide掉的,四个值也是被hide掉的,说明从正常的先拿到Display,再拿到DisplayInfo,之后再获取四个值是不行的了,那我们反射来获取该值,代码如下:
public static Rect getOverScan() { if (overScan == null) { overScan = new Rect(); try { WindowManager manager = (WindowManager) AppProfile.getContext().getSystemService(Context .WINDOW_SERVICE); Display display = manager.getDefaultDisplay(); Class clazz = Display.class; Field mDisplayInfo = clazz.getDeclaredField("mDisplayInfo"); mDisplayInfo.setAccessible(true); Object displayInfo = mDisplayInfo.get(display); Class displayInfoClazz = Class.forName("android.view.DisplayInfo"); Field overscanLeft = displayInfoClazz.getDeclaredField("overscanLeft"); overScan.left = overscanLeft.getInt(displayInfo); Field overscanTop = displayInfoClazz.getDeclaredField("overscanTop"); overScan.top = overscanTop.getInt(displayInfo); Field overscanRight = displayInfoClazz.getDeclaredField("overscanRight"); overScan.right = overscanRight.getInt(displayInfo); Field overscanBottom = displayInfoClazz.getDeclaredField("overscanBottom"); overScan.bottom = overscanBottom.getInt(displayInfo); } catch (Exception e) { } } return overScan; }
首先获取到Display,之后在反射获取DisplayInfo,最后在读取四个值。
也可以直接反射获取Display下的getOverscanInsets函数, getOverscanInsets函数如下:
/** * @hide * Return a rectangle defining the insets of the overscan region of the display. * Each field of the rectangle is the number of pixels the overscan area extends * into the display on that side. */public void getOverscanInsets(Rect outRect) { synchronized (this) { updateDisplayInfoLocked(); outRect.set(mDisplayInfo.overscanLeft, mDisplayInfo.overscanTop, mDisplayInfo.overscanRight, mDisplayInfo.overscanBottom); } }
反射获取方式如下:
public static Rect getOverScan1() { Rect overScan = new Rect(); try { WindowManager manager = (WindowManager) AppProfile.getContext().getSystemService(Context.WINDOW_SERVICE); Display display = manager.getDefaultDisplay(); Class clazz = Display.class; Method getOverscanInsets = clazz.getMethod("getOverscanInsets", Rect.class); getOverscanInsets.invoke(display, overScan); LogUtil.free(overScan.toString()); } catch (Exception e) { } return overScan; }
我们采用上面方法在debug状态下读取了一下DisplayInfo的内容:
Display id 0: DisplayInfo{"内置屏幕", app 1280 x 720, real 1280 x 720, largest app 1280 x 1255, smallest app 720 x 695, 50.0 fps, rotation0, density 160 (160.0 x 160.0) dpi, layerStack 0, type BUILT_IN, FLAG_SECURE, FLAG_SUPPORTS_PROTECTED_BUFFERS}, DisplayMetrics{density=1.0, width=1280, height=720, scaledDensity=1.0, xdpi=160.0, ydpi=160.0}, isValid=true
反射后获取,发现并没有overscan的值,很遗憾四个值都是0。可是我测试的电视是有overscan的。代码写错了?
我采用命令来设置overscan的内容:
adb shell wm overscan 10,20,30,40
分别设置overscan的值为10, 20, 30, 40,之后我再一次获取DisplayInfo的值,内容如下:
Display id 0: DisplayInfo{"内置屏幕", app 1280 x 720, real 1280 x 720, overscan (10,20,30,40), largest app 1280 x 1255, smallest app 720 x 695, 50.0 fps, rotation0, density 160 (160.0 x 160.0) dpi, layerStack 0, type BUILT_IN, FLAG_SECURE, FLAG_SUPPORTS_PROTECTED_BUFFERS}, DisplayMetrics{density=1.0, width=1280, height=720, scaledDensity=1.0, xdpi=160.0, ydpi=160.0}, isValid=true
这里可以看到明确有overscan的内容,并且就是我们命令设置的值,这就尴尬了,系统默认值获取不到,手动设置可以获取。希望之路破灭。
总结
如果有人实现了自适应的方式,麻烦请告知一下。目前只能采取UI界面调整的方式来避免该问题。
网易云免费体验馆,0成本体验20+款云产品!
更多网易研发、产品、运营经验分享请访问网易云社区
相关文章:
【推荐】 验证码示例代码演示——以java为例