三星钻孔屏适配指导.PDF

三星钻孔屏适配指导 1. 前言 钻孔屏（Punch Hole ），即屏幕内相机开孔技术（Hole In Display ），官方 称其为 “黑瞳全视屏” ，相比刘海屏，可以带来保留窄边框的全面屏体验。 三星此次突破手机屏幕工艺，将钻孔屏作为 Galaxy A8s 上“首次采用”的 技术，而 Galaxy A8s 也成为首个采用钻孔屏的机型。 在钻孔的区域，要避免布局重要的控件、文本或其他内容 ，对于安卓 P OS ， 谷歌提供了统一的适配方案（Cutout API ）；然而由于Galaxy A8s 上线版本 为安卓 O OS ，O OS 在市场中仍会存在很长一段时间，因此强烈建议并感谢 第三方合作伙伴按照下文方式适配三星 O OS 方案。 2. 分辨率信息 型号 分辨率 屏幕纵横比 Dpi Galaxy A8s 1080*2340 19.5:9 403 （SM-G8870 ） 3. 三星钻孔屏手机安卓 O OS 适配方法 3.1 如何识别钻孔屏 资源 config_mainBuiltInDisplayCutout 中若包含一个有内容的 cutout spec ，可识别该型号为钻孔屏。 try { final Resources res = context.getResources(); final int resId = res.getIdentifier(config_mainBuiltInDisplayCutout, string, android); final String spec = resId 0 ? res.getString(resId): null; mHasDisplayCutout = spec != null !TextUtils.isEmpty(spec); } catch (Exception e) { Log.w(mLogTag, Can not update hasDisplayCutout. + e.toString()); } 3.2 如何获取钻孔屏区域 DisplayCutout API ListRect getBoundingRects() 返回 Rects 的列表，每个 Rects 都是屏幕上非功能 区域的边界矩形。 int getSafeInsetBottom() 返回安全区域距离屏幕底部的距离，单位是 px int getSafeInsetLeft () 返回安全区域距离屏幕左边的距离，单位是 px int getSafeInsetRight () 返回安全区域距离屏幕右边的距离，单位是 px int getSafeInsetTop () 返回安全区域距离屏幕顶部的距离，单位是 px Anroid8.1 可以通过代码反射调用 DisplayCutout 的主要API 1 ） 通 过 WindowInsets 的 getDisplayCutout 反 射 调 用 获 得 DisplayCutout 的实例。 (Sample) Reflection 1 Method method = WindowInsets.class.getDeclaredMethod(getDisplayCutout); Object displayCutoutInstance = method.invoke(windowInsets); 2 ） 通过实例做 getSafeInsetTop, getSafeInsetBottom,, getSafeIn