目录— 个文件
⌕
目录加载中…
…/module/adapt/UICanvasAdaptComponent.ts
1// 场景适配
2import {_decorator, Component, view, ResolutionPolicy, Canvas, UITransform} from 'cc';
3
4const {ccclass} = _decorator;
5
6@ccclass('UICanvasAdaptComponent')
7export class UICanvasAdaptComponent extends Component {
8 // 开发尺寸
9 designWidth!: number;
10 designHeight!: number;
11
12 onLoad() {
13 // 检查是否挂载在Canvas节点上
14 const canvas = this.node.getComponent(Canvas);
15 if (!canvas) {
16 console.error("UISceneAdaptComponent must be attached to a Canvas node!");
17 return;
18 }
19
20 // 获取节点的UITransform组件以获取设计尺寸
21 const uiTransform = this.node.getComponent(UITransform);
22 if (!uiTransform) {
23 console.error("UISceneAdaptComponent's node must have a UITransform component!");
24 return;
25 }
26
27 // 设置开发尺寸为UITransform的尺寸
28 this.designWidth = uiTransform.width;
29 this.designHeight = uiTransform.height;
30
31 // 获取设备屏幕尺寸
32 const screenSize = view.getFrameSize();
33 const screenWidth = screenSize.width;
34 const screenHeight = screenSize.height;
35 console.log("cc.view.getFrameSize():" + screenSize);
36 // 计算屏幕宽高比和设计宽高比
37 const screenRatio = screenHeight / screenWidth;
38 const designRatio = this.designHeight / this.designWidth;
39 // 更长的手机
40 if (screenRatio > designRatio) {
41 this.adaptWidth();
42 } else {
43 this.adaptHeight();
44 }
45 }
46
47 // 比较宽的手机 适配高度
48 adaptHeight() {
49 view.setDesignResolutionSize(this.designWidth, this.designHeight, ResolutionPolicy.FIXED_HEIGHT);
50 }
51
52 // 比较长的手机,适配宽度
53 adaptWidth() {
54 view.setDesignResolutionSize(this.designWidth, this.designHeight, ResolutionPolicy.FIXED_WIDTH);
55 }
56}
讲解56 行
画布适配人工通读
UICanvasAdaptComponent.ts
在 Canvas 节点加载时把 UITransform 尺寸记录为设计尺寸,比较设备与设计的高宽比后修改全局分辨率策略。长屏固定宽度,其余固定高度;设计尺寸只采样一次,缺少 Canvas 或变换组件就退出。
先看 onLoad 的组件检查与比例比较,再看两个分辨率策略方法。
特殊处理与易错点
- 特殊处理长屏使用 FIXED_WIDTH,比例相等也走 FIXED_HEIGHT。
- 易错点调用 view 改的是全局设计分辨率,不只是当前节点尺寸。
7注释UICanvasAdaptComponent:UICanvasAdaptComponent 是「屏幕适配」目录下的通用组件。可复用的表现组
9注释开发尺寸
12方法记录画布设计尺寸并按设备高宽比选择适配策略。
14注释检查是否挂载在Canvas节点上
21注释获取节点的UITransform组件以获取设计尺寸
28注释设置开发尺寸为UITransform的尺寸
32注释获取设备屏幕尺寸
37注释计算屏幕宽高比和设计宽高比
40注释更长的手机
48方法用已记录设计尺寸设置全局固定高度分辨率。
53方法用已记录设计尺寸设置全局固定宽度分辨率。