微信小游戏开发之CocosCreator多分辨率场景适配方案

主题

Cocos Creator不同手机分辨率的背景图像和场景内容适配

特别说明

CocosCreator微信小游戏开发系列文章,是我在逐步开发过程中,基于官方文档之上,记录一些重点内容,以及对官方文档中有些知识点的补充和分析。

正文

我在《微信小游戏开发之Cocos Creator系列文章》中,写Cocos Creator项目配置时,提到了Canvas默认分辨率设置,微信推荐使用的设计稿分辨率是750x1334(iphone6的屏幕尺寸),然后把模拟器的分辨率尺寸也设成了750x1334。

项目预览设置

当我发布构建,在微信开发者工具运行时,哦豁,怎么会有黑边呢,突然想起来现在市面上的手机分辨率五花八门的,肯定要做屏幕多分辨率适配的啊,大意了啊,我没有闪。

按照惯例,先看下当设计分辨率和屏幕分辨率出现差异时,Cocos Creator 官方建议如何进行适配呢?

有兴趣的可以去看下cocos官方文档《多分辨率适配方案》的详细介绍,我直接总结一下官方文档中的适配方案:

文档中的适配主要是靠Canvas组件节点上的两个选项:

  • 适配高度(Fit Height)
  • 适配宽度(Fit Width)

下面是这两个选项适合使用的情形:

  1. 设计分辨率宽高比大于屏幕分辨率宽高比,勾选Fit Height,可以避免屏幕可见区域内出现黑边,之后配合Widget(对齐挂件)调整 UI 元素的位置,来保证 UI 元素出现在屏幕可见区域内。

  2. 设计分辨率宽高比小于屏幕分辨率宽高比,勾选Fit Width,可以避免出现黑边,同样需要配合Widget(对齐挂件)来调整 UI 元素的位置,使UI 元素出现在屏幕可见区域内。

  3. 比例相同的情况,随便勾选哪一个都可以。

为什么是设计分辨率宽高比大于屏幕分辨率宽高比时,适配高度而不是适配高度呢?

来看看它的适配过程:

假设设计分辨率宽高是800 x 480,屏幕分辨率宽高是1024 x 768

1. 先算以下两个值:
    * A1: 屏幕分辨率宽 / 设计分辨率宽 = 1024 / 800 = 1.28
    * A2: 屏幕分辨率高 / 设计分辨率高 = 768 / 480 = 1.6
   
2. 适配实际是将场景图像放大 "A1或A2" 倍
    
3. 假设放到A1倍:分辨率变成 800*1.28 / 480*1.28 = 1024 / 614.4
可以看到高度其实还没有达到当前屏幕的高度,所以还是会出现黑边

4. 放到A2倍:分辨率变成 800*1.6 / 480*1.6 = 1280 / 768
可以看到宽高都达到当前屏幕宽高度,
只是宽度有部分超出屏幕被裁剪掉了,
但不会出现黑边

5. 所以,设计分辨率宽高比大于屏幕分辨率时,适配高度。

同理,如果是设计分辨率宽高比小于屏幕分辨率宽高比,就应当适配宽度。

文档中还提到了其他的几种适配策略,但是他们都有可能出现黑边:

  • SHOW_ALL模式:同时勾选Fit HeightFit Width,图像内容不会失真,场景图像等比进行缩放,缩放比例是取屏幕宽/设计分辨率宽屏幕高/设计分辨率高中较小的一个值。

  • NO_BORDER模式:Fit HeightFit Width两个都不勾选,图像内容不会失真,但会有裁剪,场景图像等比进行缩放,缩放比例是取屏幕宽/设计分辨率宽屏幕高/设计分辨率高 中较大的一个值。

  • EXACT_FIT模式:不详细介绍了,官方也是一笔带过。

看到这里,你会发现因为手机屏幕的分辨率实在太多,屏幕分辨率宽高比大于小于设计分辨率宽高比的手机屏幕都会有,所以在编辑器上勾选Fit HeightFit Width中的某一个或者多个,都没有办法适配所有屏幕,那应该怎么办呢?

方案一:动态选择启用 Fit Height 模式和 Fit Width 模式

既然编辑器上怎么勾选都会有问题,那我们可以动态地判断屏幕分辨率宽高比来选择启用Fit Height模式和Fit Width模式啊。

直接上代码:

//FullScreenAdapter.js
cc.Class({
    extends: cc.Component,

    onLoad () {
        //监听窗口大小变化时的回调,每次窗口变化都要自动适配
        cc.view.setResizeCallback(() => this.screenAdapter());
        this.screenAdapter();
    },

    /**
     * Fit Height 模式:适用于宽大于高的屏幕
     * Fit Width 模式:适用于高大于宽的屏幕
     */
    screenAdapter() {
        //当前屏幕分辨率比例
        let screenRatio = cc.winSize.width / cc.winSize.height;
        //设计稿分辨率比例
        let designRatio = cc.Canvas.instance.designResolution.width / cc.Canvas.instance.designResolution.height;
        
        if (screenRatio <= 1) {
            //屏幕高度大于或等于宽度,即竖屏
            if (screenRatio <= designRatio) {
                this.setFitWidth();
            } else {
                //此时屏幕比例大于设计比例
                //为了保证纵向的游戏内容不受影响,应该使用 fitHeight 模式
                this.setFitHeight();
            }
        } else {
            //屏幕宽度大于高度,即横屏
            this.setFitHeight();
        }
    },

    setFitWidth() {
        cc.Canvas.instance.fitHeight = false;
        cc.Canvas.instance.fitWidth = true;
    },

    setFitHeight() {
        cc.Canvas.instance.fitHeight = true;
        cc.Canvas.instance.fitWidth = false;
    }
});

把上面的js脚本挂载到Canvas节点上,就可以简单的实现所有屏幕适配了。

注意: 如果项目运行在可动态调整窗口大小的平台(比如浏览器),最好每次调整窗口都刷新一下页面。

方案二:基于SHOW_ALL模式,动态设置最大父节点的scale属性

这个方案比较麻烦,但是确实可以实现所有屏幕的适配,大家有兴趣可以去看看“Cocos Creator 多分辨率完美适配”系列文章。

刘海屏和水滴屏等手机状态栏的适配

现在市面上的手机额头上千奇百怪的状态,什么刘海啊、水滴啊、挖孔啊、伸缩啊,为了用户体验,没办法我们也要去适配它。

方法很简单,我们只要获取微信菜单按钮(右上角胶囊按钮)距离屏幕顶部的距离,然后设置一下顶部节点的paddingTop就可以了,直接上代码吧:

let menuInfo = wx.getMenuButtonBoundingClientRect();
let systemInfo = wx.getSystemInfoSync();
let paddingTop = this.node.parent.height * (menuInfo.top / systemInfo.screenHeight);

let widget = this.node.getComponent(cc.Widget);
widget.top = paddingTop;
widget.isAbsoluteTop = true;
widget.isAlignTop = true;
widget.updateAlignment();

介绍cocos提供的几个获取View的方法

cc.view.getDesignResolutionSize()
   获取的是你在编辑器中设计的分辨率,也就是canvas 组件下设置的设计分辨率。

cc.view.getFrameSize()
   获取各种手机、pad上的屏幕分辨率,也就是硬件分辨率。

cc.view.getVisibleSizeInPixel()
   获取的是 visibleSize 的基础上乘以各种适配策略下的缩放比例后的分辨率。

cc.view.getVisibleSize()
   返回视图窗口可见区域尺寸

总结

多分辨率适配的核心原理是动态改变Canvas节点或者其他节点的scale属性,熟悉Cocos Api文档的各个方法,能为我们解决各种疑难问题提供丰富的思路。

结尾

既然您看到这了,说明文章对你还有吸引力,帮忙点个赞再走吧,谢谢!

关注我的公众号「掉队程序员」,持续输出更多内容!

自己动手写,分解项目中的各个模块需求,通过查文档和搜索Cocos社区,解决碰到的问题,最终在微信上线了下面这款微信小游戏《成语锦衣卫》,欢迎大家扫码体验,并作为参考项目模版,开发出属于自己的小游戏

欢迎大家扫码体验

预告

下一节和朋友们说一说:Toast插件的使用,一直提示“readFile:fail permission denied”的原因

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,132评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,802评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,566评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,858评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,867评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,695评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,064评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,705评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,915评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,677评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,796评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,432评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,041评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,992评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,223评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,185评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,535评论 2 343

推荐阅读更多精彩内容